Microsoft Dynamics Application Scope

UiPath.MicrosoftDynamics.Activities.MicrosoftDynamicsScopeActivity

As atividades Dynamics 365 usam o protocolo OAuth com Common Data Service para estabelecer uma conexão autenticada entre o UiPath e seu aplicativo Dynamics 365. Essa conexão autoriza um Robot a chamar as APIs da Web e acessar recursos em seu nome.

Para habilitar a autenticação, você usa o Azure Active Directory (AAD) para registrar seu aplicativo Dynamics 365 no tenant de sua conta. O registro de seu aplicativo gera um ID de aplicativo (cliente) que é usado junto com outros identificadores para estabelecer o acesso autenticado à sua instância. Para obter mais informações e antes de criar seu primeiro projeto de automação, consulte o guia de Configuração .

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).

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione uma atividade se seu AuthenticationType for ClientCredentials; caso contrário, será N/A.
   • Para obter mais informações, consulte Gerenciamento de credenciais neste guia.
3. Add the Microsoft Dynamics Application Scope activity to your project.
4. Insira valores para as propriedades de entrada da conexão .
5. Crie e insira uma variável MicrosoftDynamicsConnection para popr de Saída.

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

     

No corpo da atividade

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

Para saber mais sobre o Assistente de Conexão, consulte a página Estruturas de atividades de negócios .

Observação:

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.

Propriedades

Comum

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

Conexão

• 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.
  • ClientCredentials - Se selecionado, a autenticação é feita por meio de um ClientSecret. Essa opção é para automação assistida e não assistida. Para obter mais informações sobre credenciais do cliente, consulte Usar segredos e certificados do cliente na documentação da Microsoft.
• ClientId - The auto-generated, Application (client) ID assigned to your registered application. This field supports only String variables.
  • O ClientId é gerado quando você registra seu aplicativo usando o Azure Active Directory (AAD). Para obter mais informações, consulte a seção Registrar seu aplicativo do guia de Configuração .
  • Se seu valor de TipoDeAutenticação for CredenciaisDoCliente, o IdDoCliente será associado ao SegredoDoCliente. Por causa desse relacionamento, é recomendável que você crie uma variável String para essa propriedade seguindo a seção Criar ativo de credenciais do guia de Configuração .
  • Para criar e inserir sua variável String para essa propriedade, use uma atividade para gerar seu ativo Credential (consulte o exemplo abaixo).
• ClientSecret - The password (associated with the Username) to your ServiceNow instance. Enter a SecureString variable.
  • O ClientSecret pode ser gerado quando você registra seu aplicativo usando o Azure Active Directory (AAD). Para obter mais informações, consulte a seção Criar segredo do cliente do guia de Configuração .
  • Para criar uma variável SecureString , consulte a seção Criar ativo de credenciais do guia de Configuração .
  • Para inserir sua variável SecureString , use uma atividade que gere seu ativo Credential (consulte o exemplo abaixo).
• 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.

Conexão 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.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.

Opções

• 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.

Saída

• MicrosoftDynamicsConnection - Um registro de sua conexão estabelecida que você pode usar em outras atividades Microsoft Dynamics Application Scope que estão incluídas nessa atividade de escopo. Insira uma variável MicrosoftDynamicsConnection . Você pode passar essa variável para uma atividade de escopo em um fluxo de trabalho que seja de dentro da atividade do escopo pai.

  • Por exemplo, você pode ter 3 fluxos de trabalho. A primeira inclui a atividade do escopo pai que estabelece a conexão com seu aplicativo registrado (ou seja, fluxo de trabalho pai). O segundo fluxo de trabalho cria um novo registro de contato e o terceiro cria um novo registro de conta; ambos estão incluídos na atividade do escopo pai.

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

    

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.