Á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 Robot a llamar a las API web y acceder a los recursos en tu nombre.

Para habilitar la autenticación, utiliza Azure Active Directory (AAD) para registrar tu aplicación Dynamics 365 en tu tenant de 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 .

After completing your application registration, you select the type of authentication that you want to use (AuthenticationType) and enter your Application (client) ID (ClientId), Dynamics 365 application endpoint (EndpointUrl), Directory (tenant) ID (TenantId), and depending on the authentication type that you select, your client secret (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. Añade una actividad si tu TipoDeAutenticación es CredencialesDeCliente; de lo contrario, será N/A.
   • Para obtener más información, consulta Gestión de credenciales en esta guía.
3. Add the Microsoft Dynamics Application Scope activity to your project.
4. Introduce valores para las propiedades de entrada de conexión .
5. Crea e introduce una variable MicrosoftDynamicsConnection para la propiedad Salida.

   • You can use this variable in subsequent uses of the Microsoft Dynamics Application Scope activity.

     

En el cuerpo de la actividad

To build your project and enable the Object Wizard in other activities, you must use the Connection Wizard by clicking the Configure button.

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

Nota:

Configuring the fields in the Connection Wizard does not populate the Microsoft Dynamics Application Scope properties. The wizard establishes a connection to your Microsoft Dynamics 365 application during design time only; enabling the Object Wizards in the other Microsoft Dynamics 365 activities.

Propiedades

Común

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Conexión

• AuthenticationType - The type of authentication that you want to use to connect to your Dynamics 365 application. Select an item from the drop-down list. There are two options:
  • PasswordCredentials - If selected, authentication is done via a user prompt (according to the option that you select in the Prompt property) to enter the password to their Dynamics 365 account. This option is for attended automation only.
  • 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 unattended. 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 - The auto-generated, Application (client) ID assigned to your registered application. This field supports only String variables.
  • El IDDeCliente se genera al registrar tu aplicación utilizando Azure Active Directory (AAD). Para obtener más información, consulta la sección Registra tu aplicación de la guía de Configuración .
  • Si tu valor de AuthenticationType es ClientCredentials, el ClientId se asocia con el ClientSecret. Debido a esta relación, se recomienda crear una variable String para esta propiedad siguiendo la sección Crear activo de credenciales de la guía Configuración .
  • Para crear e introducir tu variable String para esta propiedad, utiliza una actividad para generar tu activo de credenciales (consulta el ejemplo a continuación).
• ClientSecret - The password (associated with the Username) to your ServiceNow instance. Enter a SecureString variable.
  • El SecretoDeCliente puede generarse al registrar tu 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 Configuración .
  • Para crear una variable SecureString , consulta la sección Crear activo de credenciales de la guía Configuración .
  • Para introducir tu variable SecureString , utiliza una actividad que genere tu activo de credenciales (consulta el ejemplo a continuación).
• EndpointUrl - The URL of the CRM instance that you want to connect to. This field supports only Strings or String variables.
• Prompt - Specifies the password prompt behavior for the PasswordCredentials authentication. Select an item from the drop-down list. There are three options:
  • Auto - The prompt only appears when credentials are necessary.
  • SelectAccount - The prompt requires a user to select an account and then enter their credentials (used when there are multiple accounts).
  • Always - The prompt appears each time the activity is run (even when there is a token in the cache).
• TenantId - The Directory (tenant) ID assigned to your Azure Active Directory (ADD) tenant. This field supports only Strings or String variables.

Conexión Existente

• ExistingMicrosoftDynamicsConnection - A connection record from a parent Microsoft Dynamics Application Scope activity that you can use instead of establishing a new connection. Enter a MicrosoftDynamicsConnection variable.
  • The MicrosoftDynamicsConnection variable must be from a previously run Microsoft Dynamics Application Scope activity (parent) that still has an active connection.
  • If you're unable to establish a connection using this property, try re-running your parent Microsoft Dynamics Application Scope activity.

Otros

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

Opciones

• ReportApiErrorAsException - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Salida

• MicrosoftDynamicsConnection : un registro de tu conexión establecida que puedes utilizar en otras actividades del ámbito de aplicación de Microsoft Dynamics que se incluyen en esta actividad de ámbito. Introduce una variable MicrosoftDynamicsConnection . Puedes pasar esta variable a una actividad de ámbito en un flujo de trabajo que esté 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.

  • When the workflows run, the parent scope activity passes theMicrosoftDynamicsConnection variable to the ExistingMicrosoftDynamicsConnection property in the second and third workflows (see image below).

    

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.