Entidades de calendario

La entidad de calendario almacena datos para los calendarios de servicio de atención al cliente y para las programaciones de vacaciones además de para negocios. Cada calendario se establece para una zona horaria específica.

Un calendario describe la disponibilidad de un servicio o un recurso. Los calendarios están relacionados con los registros calendarrule, que incluyen detalles acerca de la duración, la hora de inicio y de finalización, y los patrones periódicos de los eventos incluidos en el calendario.

Existen dos tipos de reglas de calendario en Dynamics 365 Customer Engagement (on-premises):

  • Raíz: una regla de calendario que contiene un calendario interno o que tiene reglas (hoja) anidadas. Puede especificar un calendario interno para una regla de calendario raíz mediante el atributo CalendarRule.InnerCalendarId. El valor de atributo de CalendarRule.InnerCalendarId de una regla raíz es el mismo que el valor de atributo de CalendarRule.CalendarId de sus reglas hoja.

  • Hoja: una regla de calendario que no contiene un calendario interno y, por consiguiente, es el final de la "rama".

    Las reglas de calendario se ordenan, o clasifican, para describir su prioridad, y las reglas se pueden solapar. La expansión de reglas anidadas define el intervalo de tiempo, o el alcance, de una regla. Puede usar el atributo CalendarRule.ExtentCode para definir cómo se administra la superposición de la expansión de reglas, por ejemplo, si se muestran el intervalo de tiempo y el alcance de una regla o solo se incluye uno de ellos. Estas características proporcionan a los patrones de periodicidad, por ejemplo, diferentes programaciones de turnos para los meses de invierno y de verano en un solo calendario de servicios.

    Un calendario puede ser un árbol complejo de reglas y calendarios anidadas que representan una abstracción de alto nivel de la programación del trabajo. La entidad de calendario admite el mensaje ExpandCalendarRequest para convertirse en una vista básica, que es una matriz de bloques horarios que determinan la disponibilidad sobre intervalos específicos.

Nota

No es posible realizar operaciones GET, POST, PATCH y DELETE con la entidad calendarrule. Más información: CalendarRule EntityType.

En esta sección

Tipos de calendarios

Entidad Calendar

Entidades de cita

Entidades de cita periódica

Entidades de recursos

Entidad Service

Código de ejemplo para las entidades de programación y cita