tipo de recurso workPlanOccurrence

Namespace: microsoft.graph

Representa uma instância de horário de trabalho específica para um determinado dia ou período de tempo no plano de trabalho de um usuário.

As ocorrências do plano de trabalho podem ser geradas automaticamente a partir dos padrões de trabalho recorrentes de um usuário ou criadas manualmente para arranjos especiais. Essas ocorrências são úteis para lidar com exceções aos agendamentos regulares do usuário. A lista a seguir mostra exemplos:

  • Trabalhando em horários diferentes para um dia específico
  • Trabalhando em um local diferente
  • Tirando uma folga

Quando existe uma ocorrência de plano de trabalho para o mesmo período de tempo que um padrão recorrente, a ocorrência tem precedência, permitindo ajustes de agendamento flexíveis.

Métodos

Método Tipo de retorno Descrição
Criar workPlanOccurrence Crie um novo objeto workPlanOccurrence no plano de trabalho de um usuário.
Atualizar workPlanOccurrence Atualize as propriedades de um objeto workPlanOccurrence no plano de trabalho de um usuário.
Delete Nenhum Exclua um objeto workPlanOccurrence do plano de trabalho de um usuário.
Definir o local atual Nenhum Atualize o local de trabalho de um usuário para o dia atual ou segmento ativo atual.
Exibição de ocorrências Coleção workPlanOccurrence Obtenha as ocorrências do plano de trabalho do plano de trabalho de um usuário em um intervalo de datas especificado.

Propriedades

Propriedade Tipo Descrição
end dateTimeTimeZone A data e a hora de término dessa ocorrência.
id Cadeia de caracteres Identificador exclusivo para a ocorrência.
placeId Cadeia de caracteres Identificador de um local da API do Microsoft Graph Places Directory. Aplicável somente quando workLocationType está definido como office.
recurrenceId Cadeia de caracteres O identificador do padrão de recorrência pai que gerou essa ocorrência. O valor é null para ocorrências de folga porque elas não têm uma recorrência pai.
iniciar dateTimeTimeZone A data e a hora de início para essa ocorrência.
timeOffDetails timeOffDetails Os detalhes sobre a folga. Aplicável somente quando workLocationType está definido como timeOff.
workLocationType workLocationType O tipo de local de trabalho. Os valores possíveis são: unspecified, office, remote, timeOff, unknownFutureValue.

valores workLocationType

Member Descrição
não especificado Indica que o usuário não especificou o local.
office Indica que o usuário trabalha em um escritório.
ponto de extremidade Indica que o usuário trabalha remotamente.
timeOff Indica que o usuário está de folga.
unknownFutureValue Valor sentinela de enumeração evolutiva. Não usar.

Relações

Nenhum

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "placeId": "String",
  "recurrenceId": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "timeOffDetails": {"@odata.type": "microsoft.graph.timeOffDetails"},
  "workLocationType": "String"
}
  • Última atualização em