Ámbito de aplicación de Microsoft Dynamics

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

Las actividades de Dynamics 365 utilizan el protocolo OAuth con Common Data Service para establecer una conexión autenticada entre UiPath y tu aplicación de Dynamics 365. Esta conexión autoriza a un UiPath Robot a llamar a las API web y acceder a los recursos en tu nombre.

Para habilitar la autenticación, use Azure Active Directory (AAD) para registrar su aplicación de Dynamics 365 en el tenant de su cuenta. El registro de tu aplicación genera un ID de aplicación (cliente) que se utiliza junto con otros identificadores para establecer el acceso autenticado a tu instancia. Para obtener más información y antes de crear tu primer proyecto de automatización, consulta la guía de configuración .

Después de completar el registro de su aplicación, seleccione el tipo de autenticación que desea usar (AuthenticationType) e introduzca su ID de aplicación (cliente) (ClientId), el punto final de la aplicación de Dynamics 365 (EndpointUrl), el ID de directorio (tenant) (TenantId) y dependiendo del tipo de autenticación que seleccione, su secreto de cliente (ClientSecret).

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .

2. Agregue una actividad si su AuthenticationType es ClientCredentials; de lo contrario, esta opción es N / A.

   • Para obtener más información, consulta Gestión de credenciales en esta guía.
3. Agrega la actividad Ámbito de aplicación de Microsoft Dynamics a tu proyecto.
4. Introduce valores para las propiedades de entrada de Conexión .
5. Crea e introduce una variable MicrosoftDynamicsConnection para Propiedad de salida .

   • Puede utilizar esta variable en los usos posteriores de la actividad Ámbito de aplicación de Microsoft Dynamics .

     
     

     

     
     

En el cuerpo de la actividad

Para crear tu proyecto y habilitar el Asistente para objetos en otras actividades, debes usar el Asistente de conexión haciendo clic en el botón Configurar .

Para obtener más información sobre el Asistente de conexión, consulta la página Marcos de actividad empresarial .

Nota: La configuración de los campos en el Asistente de conexión no rellena las propiedades del ámbito de la aplicación Microsoft Dynamics . El asistente establece una conexión con su aplicación Microsoft Dynamics 365 solo durante el tiempo de diseño; habilitar los asistentes para objetos en las otras actividades de Microsoft Dynamics 365.

Propiedades

Común

• NombreParaMostrar: el nombre de la actividad que se muestra. Este campo solo admite variables Strings o String.

Conexión

• TipoDeAutenticación : el tipo de autenticación que quieres usar para conectarte a tu aplicación de Dynamics 365. Selecciona un elemento de la lista desplegable. Hay dos opciones:

  • Credenciales decontraseña : si se selecciona, la autenticación se realiza a través de una solicitud de usuario (de acuerdo con la opción que seleccione en la propiedad Solicitar ) para ingresar la contraseña en su cuenta de Dynamics 365. Esta opción es solo para automatización atendida.
  • CredencialesDeCliente : si se selecciona, la autenticación se realiza a través de un SecretoDeCliente. Esta opción es tanto para la automatización atendida como para la desatendida. Para obtener más información sobre las credenciales de cliente, consulta Usar secretos y certificados de cliente en la documentación de Microsoft.
• ClientId : el ID de aplicación (cliente) generado automáticamente asignado a tu aplicación registrada. Este campo solo admite String variables.
  • El ClientId se genera cuando registra su aplicación con Azure Active Directory (AAD). Para obtener más información, consulta la sección Registrar tu aplicación en la guía de configuración .
  • Si tu valor de AuthenticationType es ClientCredentials, ClientId está asociado con ClientSecret. Debido a esta relación, se recomienda crear una variable String para esta propiedad siguiendo la sección Crear activo de credencial de la guía de configuración .
  • Para crear e introducir tu variable String para esta propiedad, usa una actividad para generar tu Activo de credencial (consulta el ejemplo a continuación).
• ClientSecret : la contraseña (asociada con el nombre de usuario) de la instancia de ServiceNow. Introduce una variable SecureString .
  • ClientSecret se puede generar al registrar su aplicación utilizando Azure Active Directory (AAD). Para obtener más información, consulta la sección Crear secreto de cliente de la guía de configuración .
  • Para crear una variable SecureString , consulta la sección Crear activo de credencial de la guía de configuración .
  • Para introducir tu variable SecureString , utiliza una actividad que genere tu Activo de credencial (consulta el ejemplo a continuación).
• URLDePuntoFinal : la URL de la instancia de CRM a la que quieres conectarte. Este campo solo admite variables Strings o String .

• Solicitar : especifica el comportamiento de la solicitud de contraseña para la autenticación de Credenciales de contraseña. Selecciona un elemento de la lista desplegable. Hay tres opciones:

  • Automático : el mensaje solo aparece cuando se necesitan credenciales.
  • Seleccionar cuenta : el mensaje requiere que el usuario seleccione una cuenta y luego introduzca sus credenciales (se usan cuando hay varias cuentas).
  • Siempre : el mensaje aparece cada vez que se ejecuta la actividad (incluso cuando hay un token en la caché).
• TenantId : el identificador de directorio (tenant) asignado al tenant de Azure Active Directory (ADD). Este campo solo admite variables Strings o String .

Conexión Existente

• ConexiónDeMicrosoftDynamicsexistente : un registro de conexión de una actividad principal del ámbito de aplicación de Microsoft Dynamics que puedes usar en lugar de establecer una nueva conexión. Introduce una variable MicrosoftDynamicsConnection .
  • La variable MicrosoftDynamicsConnection debe ser de una actividad del ámbito de aplicación de Microsoft Dynamics (principal) ejecutada anteriormente que aún tenga una conexión activa.
  • Si no puede establecer una conexión usando esta propiedad, intente volver a ejecutar su actividad principal del ámbito de la aplicación de Microsoft Dynamics .

Otros

• Privado : si se selecciona, los valores de variables y argumentos ya no se registran en el nivel Detallado.

Opciones

• ReportApiErrorAsException : cuando se selecciona, las respuestas de error de la API se notifican en BusinessActivityExecutionException por todas las actividades secundarias que usan este ámbito de aplicación. Cuando se borra, la actividad secundaria rellena el mensaje de error de la API en la propiedad de salida EstadoDeRespuesta y la ejecución del flujo de trabajo continúa. Comprueba la propiedad EstadoDeRespuesta para confirmar que la ejecución se ha realizado correctamente.

Salida

• MicrosoftDynamicsConnection : un registro de la conexión establecida que puedes usar en otras actividades del ámbito de la aplicación Microsoft Dynamics que se incluyen en esta actividad de ámbito. Introduce una variable MicrosoftDynamicsConnection . Puede pasar esta variable a una actividad de ámbito en un flujo de trabajo que se encuentra dentro de la actividad de ámbito principal.
  • Por ejemplo, puede tener 3 flujos de trabajo. La primera incluye la actividad de ámbito principal que establece la conexión con su aplicación registrada (es decir, el flujo de trabajo principal). El segundo flujo de trabajo crea un nuevo registro de contacto y el tercero crea un nuevo registro de cuenta; ambos están incluidos en la actividad de ámbito principal.
  • Cuando se ejecutan los flujos de trabajo, la actividad de ámbito principal pasa la variableMicrosoftDynamicsConnection a la propiedad ExistingMicrosoftConnection en el segundo y tercer flujo de trabajo (vea la imagen a continuación).
    
    

    

    
    

Ejemplo

La siguiente imagen muestra un ejemplo de la relación de dependencia de la actividad y los valores de las propiedades de entrada / salida.