Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Espacio de nombres: microsoft.graph
Representa una instancia de programación de trabajo específica para un día o período de tiempo determinado en el plan de trabajo de un usuario.
Las ocurrencias del plan de trabajo se pueden generar automáticamente a partir de los patrones de trabajo recurrentes de un usuario o crearse manualmente para arreglos especiales. Estas ocurrencias son útiles para controlar excepciones a las programaciones regulares del usuario. En la lista siguiente se muestran ejemplos:
- Trabajar en diferentes horas durante un día específico
- Trabajar desde una ubicación diferente
- Tomarse un tiempo libre
Cuando existe una ocurrencia del plan de trabajo para el mismo período de tiempo que un patrón recurrente, la ocurrencia tiene prioridad, lo que permite ajustes de horario flexibles.
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| Crear | workPlanOccurrence | Crear un nuevo objeto workPlanOccurrence en el plan de trabajo de un usuario. |
| Actualizar | workPlanOccurrence | Actualizar las propiedades de un objeto workPlanOccurrence en el plan de trabajo de un usuario. |
| Delete | Ninguno | Eliminar un objeto workPlanOccurrence del plan de trabajo de un usuario. |
| Establecer ubicación actual | Ninguno | Actualizar la ubicación de trabajo de un usuario para el día actual o el segmento activo actual. |
| Vista Ocurrencias | colección workPlanOccurrence | Obtenga las repeticiones del plan de trabajo de un usuario dentro de un intervalo de fechas especificado. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| finalización | dateTimeTimeZone | La fecha y hora de finalización de este suceso. |
| id | Cadena | Identificador único de la ocurrencia. |
| placeId | Cadena | Identificador de un lugar desde la API del directorio Microsoft Graph Places. Solo se aplica cuando workLocationType se establece en office. |
| recurrenceId | Cadena | Identificador del patrón de periodicidad principal que generó esta ocurrencia. El valor es null para las repeticiones de tiempo libre porque no tienen una recurrencia principal. |
| start | dateTimeTimeZone | La fecha y hora de inicio de este suceso. |
| timeOffDetails | timeOffDetails | Los detalles sobre el tiempo libre. Solo se aplica cuando workLocationType se establece en timeOff. |
| workLocationType | workLocationType | El tipo de ubicación de trabajo. Los valores posibles son: unspecified, office, remote, timeOff, unknownFutureValue. |
valores de workLocationType
| Member | Descripción |
|---|---|
| Sin especificar | Indica que el usuario no especificó la ubicación. |
| oficina | Indica que el usuario trabaja desde una ubicación de oficina. |
| punto de conexión | Indica que el usuario trabaja de forma remota. |
| timeOff | Indica que el usuario está en tiempo libre. |
| unknownFutureValue | Valor centinela de enumeración evolutiva. No usar. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el 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"
}