Compartir a través de

Considerar los horarios de libre/ocupado de Outlook en la API de búsqueda de disponibilidad de recursos

  • Artículo

La API de disponibilidad de recursos de búsqueda de Universal Resource Scheduling ahora puede considerar citas de Outlook en Exchange, además de la disponibilidad definida en Dynamics (a través de Reservas y citas de Dataverse). Ahora los recursos no tienen que sincronizar manualmente sus citas de Outlook con Dataverse. La inclusión de una vista completa de la disponibilidad tanto de Exchange como de Dynamics aumenta la productividad del programador y reduce los errores de programación evitables.

Algunos puntos clave:

  • Esta característica de extensibilidad solo funciona cuando se llama directamente a la API de disponibilidad de recursos de búsqueda con ConsiderOutlookSchedules como true. Las búsquedas de disponibilidad listas para usar que se activan desde el tablero de programación o desde el botón Reservar en cualquier entidad programable no consideran los programas de Outlook.
  • La lectura de programas de Exchange aumentará el tiempo que tarda la API de disponibilidad de recursos de búsqueda en recuperar resultados, según la cantidad de recursos y el período de tiempo que se esté considerando. Recomendamos que esta funcionalidad se utilice con prudencia a partir de interfaces personalizadas diseñadas para evitar el tiempo de recuperación.
  • La función está disponible para las API de disponibilidad de recursos de búsqueda para ambos requisitos (msdyn_SearchResourceAvailability) y grupos de requisitos (msdyn_SearchResourceAvailabilityForRequirementGroup).
  • Para proteger su privacidad, solo se leerán las horas de inicio y finalización de los elementos de programación de recursos y su estado de disponibilidad.
  • El estado "Ocupado" de Outlook se considera no disponible para la programación.
  • Las citas de Outlook se consideran independientes de la ubicación.

Requisitos previos

  • Universal Resource Scheduling 3.12.64.x +, disponible en Field Service 8.8.52.x + (Oleada 2 de octubre de 2021)

Paso 1: habilitar la configuración para incluir libre/ocupado de Outlook en la API de búsqueda de disponibilidad de recursos

Al nivel de organización

  1. Ir a Programación de recursos>Ajustes>Administración>Parámetros de programación y establezca Incluir Outlook libre/ocupado en la API de disponibilidad de recursos de búsqueda en Sí.

Screenshot of organization level setting.

  1. Aparecerá un cuadro de diálogo informativo. Seleccione Entendido. Lo activaré. Después guarde y cierre.

Screenshot of dialog.

Todos los recursos se habilitan automáticamente la primera vez que habilita la función. Puede optar por no recibir recursos mediante la configuración de nivel de recursos, que solo es visible si la configuración de nivel de organización está establecida en Sí.

Los recursos recibirán automáticamente una notificación por correo electrónico cada vez que se inscriban, del usuario que los habilita, si ese usuario tiene un buzón de correo con sincronización del lado del servidor.

A nivel de recursos

La configuración del nivel de recursos solo se mostrará si la configuración del nivel de organización está habilitada, es decir, si Incluir Outlook libre/ocupado en la API de disponibilidad de recursos de búsqueda en Programación de recursos>Ajustes>Administración>Parámetros de programación se establece en Sí.

Para controlar los recursos individuales, vaya a la pestaña Planificación del formulario de recursos y cambie el campo Incluir Outlook libre/ocupado en la API de disponibilidad de recursos de búsqueda.

Screenshot of resource level setting.

Paso 2: Llame a la API de disponibilidad de recursos de búsqueda con ConsiderOutlookSchedules como true

Llame a la API de disponibilidad de recursos de búsqueda con ConsiderOutlookSchedules como true. La función está disponible para las API de disponibilidad de recursos de búsqueda para ambos requisitos (msdyn_SearchResourceAvailability) y grupos de requisitos (msdyn_SearchResourceAvailabilityForRequirementGroup).