Início rápido — registros

Visão geral

O objetivo deste guia é ajudá-lo a criar um exemplo de trabalho que usa as seguintes atividades do Microsoft Dynamics 365:

Este exemplo de trabalho permite que você verifique rapidamente a conexão com seu aplicativo do Microsoft Dynamics 365 e se familiarize com os tipos de dados de entrada/saída da atividade.

Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte:

Estabelece uma conexão com seu aplicativo do Microsoft Dynamics 365 (Obter credencial e Escopo de aplicativo do Microsoft Dynamics).
Insere um novo registro de conta (Insert Record).
Pesquisa o registro de conta inserido (Pesquisar Registros).
Atualiza o campo do site do registro da conta (Update Record).
Verifica se o registro da conta foi atualizado com sucesso (Get Record).
Exclui o registro da conta inserida (Excluir Registro).

Observação: embora possa haver maneiras mais eficientes de obter o mesmo resultado, o objetivo dessa sequência é demonstrar todas as atividades de registro.

Pré-requisitos

Antes de você começar:

Conclua as etapas de configuração do Microsoft Dynamics 365.
Use o Gerenciador de Pacotes para instalar o pacote Microsoft.Activities.Extensions (isso é para a atividade Search Records ).

Observação: este guia usa CredenciaisDoCliente como o TipoDeAutenticação na atividade Microsoft Dynamics Application Scope . Se você preferir usar PasswordCredentials, ignore a etapa 1 (adicione uma atividade Get Credential ) e siga as subetapas com marcadores na etapa 2 (adicione a atividade Microsoft Dynamics Application Scope ).

Etapas

Crie seu projeto

Adicione uma atividade Obter credencial .
Insira o AssetName para o ativo de credencial que você criou (durante a configuração) para o aplicativo Client Secret (por exemplo, "MicrosoftDynamics365ClientCredentials").
Crie e insira uma variável SecureString para a propriedade Senha (por exemplo, clientSecret).
Crie e insira uma variável String para a propriedade Username (por exemplo, clientId).
Adicione a atividade Microsoft Dynamics 365 Application Scope após a atividade Get Credential .
Clique no botão Configurar (isso abre o Assistente de conexão), selecione seu AuthenticationType, insira suas credenciais e clique no botão Testar conexão . Para obter mais informações sobre a finalidade e o comportamento desse assistente, consulte a seção.
- Esta etapa é apenas para fins de tempo de design. Para preencher as propriedades do escopo do aplicativo do Microsoft Dynamics , siga as etapas abaixo.
Na propriedade AuthenticationType , selecione seu tipo de autenticação preferencial.
- Se você selecionar PasswordCredentials, crie uma variável String para ClientId (por exemplo, Name: clientId Default: "56X9aXXX-b5d9-4a90-XXXX-13XX9643XXXX")
Na propriedade ClientId , insira a variável String que você criou para a atividade Get Credential ou a subetapa acima (por exemplo, clientId).
Na propriedade ClientSecret , insira a variável SecureString que você criou para a atividade Get Credential (por exemplo, clientSecret).
- Se você selecionou PasswordCredentials, deixe a propriedade ClientSecret vazia.
Na propriedade EndpointUrl , crie e insira uma variável String com a URL da instância do CRM à qual deseja se conectar (por exemplo, Nome: endpointURL Padrão: "https://uipath.crm4.dynamics.com/" )
Na propriedade TenantId , crie e insira uma variável String para o ID do diretório (locatário) atribuído ao seu locatário do Azure Active Directory (ADD) (por exemplo, Nome: tenantId Padrão: "d8353d2a-b153-4d17-8827-902cXXXXXXX") .
- Se você selecionou CredenciaisDaSenha, selecione sua preferência de Solicitação de senha (opções).
Adicione a atividade Insert Record dentro da atividade Microsoft Dynamics Application Scope .
1. Clique no botão Configurar dentro da atividade Inserir registro (isso abre o Assistente de objeto).
  1. Na lista suspensa Selecionar entidade , selecione Conta.
  2. No campo accountId , crie e insira uma variável String (por exemplo, accountId).
  3. Na caixa de texto Add Single Field , insira o nome e clique em Enter.
  4. No campo de nome , digite um nome de conta (por exemplo, "Quickstart_Account").
  5. Clique no botão Concluído .
2. Adicione uma atividade Adicionar ao dicionário após a atividade Inserir registro .
3. Na propriedade Dictionary , crie e insira uma variável Dictionary<String,String> apropriadamente: Name: queryOption, Default: new Dictionary(Of String, String) (você pode usar um valor de Name diferente, mas o valor Default é obrigatório).
4. Na propriedade Key , insira "$filter".
5. Na propriedade Value , insira "name eq 'Quickstart_Account'" (Quickstart_Account é o nome da conta que você inseriu nas etapas acima. Se você inseriu um nome diferente, use esse valor).
  - Para obter mais informações sobre valores de consulta, consulte as páginas de metadados de consulta e/ou dados de consulta na documentação da Microsoft.
6. Adicione a atividade Search Records após a atividade Add to Dictionary .
7. Na propriedade Objeto , selecione Conta.
8. Na propriedade Query Options , insira a variável Dictionary<String,String> que você criou acima (por exemplo, queryOption).
9. Na propriedade Result , crie e insira uma variável DataTable (por exemplo, searchResults).
Adicione uma atividade Atribuir após a atividade Pesquisar registros .
1. Na propriedade Para , crie e insira uma variável String (por exemplo, webURL).
2. Na propriedade Value , insira o seguinte: searchResults.Rows(0).Item("websiteurl").ToString.
  - Para obter mais informações sobre os nomes das colunas para cada entidade, consulte a Referência do EntityType da API da Web na documentação da Microsoft.
3. Adicione uma atividade If após a atividade Atribuir .
4. Crie uma variável String com um valor padrão de um URL (por exemplo, Nome: website, Padrão: "www.uipath.com").
5. Na propriedade Condição , insira o seguinte: webURL = website.
6. Na caixa Then statement, adicione uma atividade Write Line com o seguinte Text: "Website present".
7. Na caixa da instrução Else , adicione a atividade Update Record .
  1. Clique no botão Configurar dentro da atividade Atualizar registro (isso abre o Assistente de objeto).
    1. Na lista suspensa Selecionar entidade , selecione Conta.
    2. No campo accountId , insira a variável String que você criou para a atividade Inserir registro (por exemplo, accountId).
    3. Na caixa de texto Add Single Field , digite websiteurl e clique em Enter.
    4. No campo de nome , insira a variável String que você criou na etapa acima (por exemplo, website).
    5. Clique no botão Concluído .

Teste seu projeto

Adicione a atividade Get Record após a atividade Update Record (dentro da caixa da instrução Else ).
1. Clique no botão Configurar dentro da atividade Obter registro (isso abre o Assistente de objeto).
  1. Na lista suspensa Selecionar entidade , selecione Conta.
  2. No campo accountId , insira a variável String que você criou para a atividade Inserir registro (por exemplo, accountId).
  3. Na caixa de texto Add Single Field , digite websiteurl e clique em Enter.
  4. No campo websiteurl , crie e insira uma variável String (por exemplo, websiteVerification).
  5. Clique no botão Concluído .
2. Adicione uma atividade If após a atividade Get Record (dentro da caixa de instrução Else ).
3. Na propriedade Condition , insira o seguinte: website = websiteVerification.
4. Na caixa Declaração Then , adicione uma atividade Write Line com o seguinte Texto: "Atualização do site bem-sucedida!".
5. Na caixa Then statement, adicione uma atividade Write Line com o seguinte texto: "Website update failed".
Adicione a atividade Delete Record fora da primeira atividade If .
1. Na propriedade Objeto , selecione Conta.
2. No campo Id , insira a variável String que você criou para a atividade Inserir registro (por exemplo, accountId).
3. Na propriedade MicrosoftDynamicsStatus , crie e insira uma variável ResponseStatus (por exemplo, responseStatus).
Adicione uma atividade Write Line após a atividade Delete Record .
1. Na propriedade Text , insira o seguinte: "Registro excluído: "+responseStatus.Success.ToString.
Clique em Executar e verifique se a janela Saída inclui os valores esperados da linha de gravação.

Está feito!

Para saber mais sobre as atividades do Microsoft Dynamics 365 (incluindo exemplo de entradas/saídas de propriedades), consulte a página Atividades para uma lista completa de atividades e links para as páginas de detalhes das atividades.

Nesta página