tipo de recurso workPlanOccurrence

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

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.

Las ocurrencias de su plan de trabajo se pueden generar automáticamente a partir de patrones de trabajo recurrentes o crearse manualmente para arreglos especiales. Estas ocurrencias son útiles para gestionar excepciones a tus programaciones regulares. 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 Cree un nuevo objeto workPlanOccurrence en su propio plan de trabajo.
Actualizar workPlanOccurrence Actualice las propiedades de un objeto workPlanOccurrence en su propio plan de trabajo.
Delete Ninguno Eliminar un objeto workPlanOccurrence de su propio plan de trabajo.
Establecer ubicación actual Ninguno Actualice la ubicación de trabajo para el día actual o el segmento activo actual.
Vista Ocurrencias colección workPlanOccurrence Obtenga las repeticiones del plan de trabajo de su propio plan de trabajo 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"
}
  • Last updated on