Mensajes y entidades admitidos para complementos

En este tema se identifican las combinaciones de mensaje y entidad que admiten la ejecución sin conexión de complementos para Dynamics 365 for Microsoft Office Outlook con acceso sin conexión. Para obtener información sobre complementos registrados en el servidor que no requieren la ejecución sin conexión, consulte Eventos disponibles.

La columna de Disponibilidad de mensajes de la tabla inferior indica si un mensaje está disponible en línea, sin conexión, o de ambas maneras. La columna Implementación de entidad indica si la entidad esté implementada en el servidor, en el cliente, o ambos. Un valor de null en la columna Entidad principal significa que no hay ninguna entidad principal asociada al mensaje. Lo mismo se aplica a la columna Entidad secundaria.

En el código de complementos, puede enviar cualquier mensaje a los servicios web a excepción de los mensajes que crean o actualizan metadatos.

Las entidades personalizadas admiten los mismos mensajes base que las entidades del sistema, en función de si la entidad pertenece a la organización o al usuario. Para obtener más información, consulte Acciones de registros de entidad.

Nota

El término sin conexión se aplica a Dynamics 365 for Microsoft Office Outlook con acceso sin conexión. El término cliente se puede aplicar a Dynamics 365 for Outlook Online o Dynamics 365 for Microsoft Office Outlook con acceso sin conexión.

Si un mensaje está disponible en línea o sin conexión se determina mediante programación o una consulta, inspeccionando el atributo SdkMessage.Availability. Para ver los metadatos de las entidades de su organización, instale la solución Explorador de metadatos que se describe en Exploración de los metadatos de su organización. También puede examinar la documentación de referencia para las entidades en la Referencia de entidad.

Mensajes admitidos por entidades personalizadas

Las entidades personalizadas pueden ser propiedad del usuario o de la organización, lo que define el conjunto de mensajes disponibles para la entidad. La siguiente tabla muestra los mensajes de las entidades personalizadas que admiten la ejecución de complementos.

Nombre de mensaje	Tipo de propiedad	Disponibilidad de mensajes	Implementación compatible de entidad
Asignar	Solo entidades propiedad de usuario	Servidor	Servidor
Crear	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor
Eliminar	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor
GrantAccess	Solo entidades propiedad de usuario	Servidor	Servidor
ModifyAccess	Solo entidades propiedad de usuario	Servidor	Servidor
Recuperar	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor
RetrieveMultiple	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor
RetrievePrincipalAccess	Solo entidades propiedad de usuario	Ambos	Servidor
RetrieveSharedPrincipalsAndAccess	Solo entidades propiedad de usuario	Ambos	Servidor
RevokeAccess	Solo entidades propiedad de usuario	Servidor	Servidor
SetState	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor
Actualización	Entidades propiedad del usuario o propiedad de la organización	Ambos	Servidor

Mensajes admitidos por entidades predeterminadas

Antes de que tenga en cuenta escribir un complemento, debe comprobar si el mensaje de destino y la solicitud de la entidad admite la ejecución de complementos. Puesto que Dynamics 365 se actualiza periódicamente con los nuevos mensajes y entidades, es mejor ver la organización para esta información. Esto se puede hacer mediante la herramienta de registro de complementos o ejecutando una consulta de fetchXML como se describe a continuación.

Para comprobar si una combinación de mensaje y entidad admiten la ejecución de complementos mediante el registro de complementos, siga estos pasos.

1. Ejecute la herramienta y conéctese a una organización D365.
2. En la lista Complementos y actividades de flujo de trabajo personalizadas registradas , expanda un montaje que contenga complementos registrados. Puede realizar este paso incluso en un montaje del sistema, ya que no completará realmente el paso del registro.
3. Haga clic con el botón secundario en un complemento en la lista y elija Registrar nuevo paso.
4. Escriba el mensaje de destino y la entidad principal en los campos correspondientes para ver si la combinación se admite para el registro de complementos.
5. Cancelar (Cerrar) el formulario de registro del paso y salga la herramienta.

Para comprobar si una combinación de mensaje y entidad admite la ejecución de complementos usando una consulta de base de datos, usa Búsqueda avanzada o una herramienta de la comunidad (p. ej., Creador de FetchXML) para ejecutar la siguiente consulta fetchXML. Cuando se usa Búsqueda avanzada, debe crear la consulta de forma interactiva.

Para los complementos sin conexión del cliente de Outlook:

<fetch>
  <entity name='sdkmessage' >
    <attribute name='name' />
    <link-entity name='sdkmessagefilter' alias='filter' to='sdkmessageid' from='sdkmessageid' link-type='inner' >
      <filter type='and' >
        <condition attribute='iscustomprocessingstepallowed' operator='eq' value='1' />
        <condition attribute='isvisible' operator='eq' value='1' />
        <condition attribute='availability' operator='ne' value='0' />
      </filter>
      <attribute name='primaryobjecttypecode' />
    </link-entity>
    <filter>
      <condition attribute='isprivate' operator='eq' value='0' />
      <condition attribute='name' operator='not-in' >
        <value>SetStateDynamicEntity</value>
        <value>RemoveRelated</value>
        <value>SetRelated</value>
        <value>Execute</value>
      </condition>
    </filter>
    <order attribute='name' />
  </entity>
</fetch>

Vea también

Escriba complementos para ampliar los procesos de negocio
Eventos disponibles
Desarrollo de complementos