Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma instância de agendamento de trabalho específica para um determinado dia ou período de tempo no seu plano de trabalho.
As ocorrências do plano de trabalho podem ser geradas automaticamente a partir de padrões de trabalho periódicos ou criadas manualmente para disposições especiais. Estas ocorrências são úteis para processar exceções às suas agendas regulares. A lista seguinte mostra exemplos:
- Trabalhar em horas diferentes para um dia específico
- Trabalhar a partir de uma localização diferente
- Tirar férias
Quando existe uma ocorrência de plano de trabalho para o mesmo período de tempo que um padrão periódico, 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 seu próprio plano de trabalho. |
| Atualizar | workPlanOccurrence | Atualize as propriedades de um objeto workPlanOccurrence no seu próprio plano de trabalho. |
| Delete | Nenhum | Elimine um objeto workPlanOccurrence do seu próprio plano de trabalho. |
| Definir localização atual | Nenhum | Atualize a sua localização de trabalho para o dia atual ou segmento ativo atual. |
| Vista de ocorrências | coleção workPlanOccurrence | Obtenha ocorrências do plano de trabalho a partir do seu próprio plano de trabalho dentro de um intervalo de datas especificado. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| end | dateTimeTimeZone | A data e hora de fim desta ocorrência. |
| id | Cadeia de caracteres | Identificador exclusivo para a ocorrência. |
| placeId | Cadeia de caracteres | Identificador de um local da API de Diretório de Places do Microsoft Graph. Aplicável apenas quando workLocationType está definido como office. |
| recurrenceId | Cadeia de caracteres | O identificador do padrão de periodicidade principal que gerou esta ocorrência. O valor destina-se null a ocorrências de tempo limite porque não têm uma periodicidade principal. |
| iniciar | dateTimeTimeZone | A data e hora de início desta ocorrência. |
| timeOffDetails | timeOffDetails | Os detalhes sobre as folgas. Aplicável apenas quando workLocationType está definido como timeOff. |
| workLocationType | workLocationType | O tipo de localização de trabalho. Os valores possíveis são: unspecified, office, remote, timeOff, unknownFutureValue. |
valores workLocationType
| Member | Descrição |
|---|---|
| não especificado | Indica que o utilizador não especificou a localização. |
| office | Indica que o utilizador trabalha a partir de uma localização do escritório. |
| remoto | Indica que o utilizador trabalha remotamente. |
| timeOff | Indica que o utilizador está com folga. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Relações
Nenhum
Representação JSON
A representação JSON seguinte 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"
}