Início rápido

Visão geral

O objetivo deste guia é ajudá-lo a criar uma amostra funcional para verificar rapidamente a conexão com sua organização Salesforce e se familiarizar com os tipos de dados de entrada/saída de atividades incluídas.

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

Cria variáveis SecureString para suas credenciais do Salesforce e o métodode invocação.
Estabelece uma conexão com sua organização do Salesforce usando suas credenciais SecureString (Escopo do Aplicativo Salesforce)
Cria um novo registro de conta do Salesforce (Inserir Registro).
Carrega um arquivo para sua organização do Salesforce (Carregar arquivo).
Atribui o arquivo carregado ao seu novo registro de conta do Salesforce (Atribuir Arquivo).
Verifica os resultados das atividades Insert Record, Upload Filee Assign File gerando cada um de seus objetos SalesforceStatus ().

Pré-requisitos

Antes de você começar:

Conclua as etapas de Configuração do Salesforce.
Crie um novo projeto de automação.
1. Abra o UiPath Studio.
2. Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
3. Insira um Nome, Locale Descriçãodo projeto.
4. Clique em Criar.
Instale o pacote UiPath.Salesforce.Activities .
1. Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
2. Em Todos os pacotes, clique em Oficial.
3. Na barra de pesquisa , digite Salesforce.
4. Clique, instale e aceite a licença do UiPath.Salesforce.Activities.
  - Para obter mais informações sobre os pacotes do Uipath Studio, consulte Gerenciando pacotes no Guia do Studio.

Etapas

Crie seu projeto

A atividade Salesforce Application Scope requer tipos de dados SecureString para as propriedades de entrada Segredo do Consumidor, Senhae TokenDeSegurança . Para obter esses tipos de dados SecureString , você converte os valores String que você armazenou para essas propriedades ao concluir as etapas Obtenha suas credenciais no Guia de configuração .

Observação:

As etapas abaixo destinam-se a demonstrar como você pode converter um String em um SecureString. Para simplificar e ajudá-lo a criar rapidamente uma amostra de trabalho, a conversão é feita na sequência do projeto e exige que você insira os valores de credencial como variáveis. Isso não é recomendado ao criar projetos compartilháveis ou que não sejam de exemplo.

Ao criar projetos compartilháveis ou que não sejam de exemplo, você pode criar e fazer referência a fluxos de trabalho externos que obtêm seu segredo do consumidor, senhae token de segurança de uma fonte local (por exemplo, .txt, .xlsx arquivos) e execute a conversão usando os argumentos <in> e <out>.

Converter Strings em SecureStrings

Crie as três variáveis a seguir:
1. String com sua senha de login do Salesforce como valor padrão (por exemplo, Nome: textPassword, Padrão: "UiPath123")
2. SecureString com New SecureString() como o valor padrão (por exemplo, Name: securePassword, Default:New SecureString())
3. SecureString (por exemplo, Nome: senha)
  - Para todas as variáveis SecureString , selecione o tipo System.Security.SecurityString .
4. Adicionar uma nova instrução ao processo.
- Recomendação: altere o Display Name para "Create SecureString - Password" ou algo que facilite a identificação de sua finalidade.
Adicione uma atividade dentro da Sequence.
1. Na propriedade TypeArgument , selecione System.Char.
2. Na propriedade Values , insira a variável String (por exemplo, textPassword).
Em Para cada atividade, adicione a atividade InvokeMethod (Programação > Executar > InvokeMethod).
1. Na propriedade TargetObject , insira sua primeira variável SecureString (por exemplo, securePassword)
  - Certifique-se de que a propriedade TargetType seja (nula) ( TargetObject ou TargetType é permitido, não ambos).
2. Na propriedade MethodName , insira AppendChar.
  - O método AppendChar é usado para adicionar uma unidade de código UTF-16 após a string.
3. Na propriedade Parameters , adicione um novo parâmetro usando os seguintes valores: Direction: In, Type: System.Char, Value: item.
Adicione a atividade após a atividade InvokeMethod .
1. Na propriedade Para , digite sua segunda variável SecureString (por exemplo, senha).
2. Na propriedade Value , insira sua primeira variável SecureString (por exemplo, _securePassword).
Crie as três variáveis a seguir:
1. String com seu segredo do consumidor como o valor padrão (por exemplo, Nome: textPassword, Padrão: "4FA94...")
2. SecureString com New SecureString() como o valor padrão (por exemplo, Name: secureConsumerSeret, Default:New SecureString())
3. SecureString (por exemplo, Nome: consumerSecret)
  - Para todas as variáveis SecureString , selecione o tipo System.Security.SecurityString .
4. Repita as etapas 2 a 5 para converter seu Segredo do consumidor String em um SecureString.
Crie as seguintes 3 variáveis:
1. String com seu Token de segurança como valor padrão (por exemplo, Nome: textPassword, Padrão: ""MUc2B...")
2. SecureString com New SecureString() como o valor padrão (por exemplo, Name: secureSecurityToken, Default:New SecureString())
3. SecureString (por exemplo, Nome: securityToken)
  - Para todas as variáveis SecureString , selecione o tipo System.Security.SecurityString .
4. Repita as etapas 2 a 5 para converter seu token de segurança String em um SecureString.

Agora você deve ter três sequências Create Secure String em seu processo, semelhantes à imagem abaixo.

Agora que você tem suas variáveis SecureString , pode adicionar a atividade Salesforce Application Scope junto com as outras atividades Salesforce.

Adicione as atividades do Salesforce

Adicione a atividade Salesforce Application Scope ao seu projeto.
1. Antes de inserir os valores de sua propriedade, vamos testar sua conexão.
  1. Clique no botão Configurar (isso abre o assistente de conexão).
  2. Selecione seu servidor (se estiver se conectando a uma organização de desenvolvedor ou organização de produção não desenvolvedora - selecione "Ao vivo", uma sandbox/organização de teste - selecione "Teste").
  3. Insira sua Chave do consumidor, Segredo do consumidor, Nome de usuário, Senhae Token de segurança (necessário para logins de desenvolvedor).
  4. Clique no botão Testar conexão e aguarde a janela Conexão bem-sucedida .
    - Se você receber um erro, certifique-se de que selecionou o servidorcorreto. Em seguida, tente redefinir seu Token de segurança seguindo a última etapa em Obtenha suas credenciais no Guia de configuração e insira o novo valor que é enviado a você por e-mail.
  5. Após uma conexão bem-sucedida, agora você pode adicionar seus valores de propriedade, incluindo as variáveis SecureString que você criou nas etapas acima (os valores inseridos no assistente de conexão são independentes dos valores de propriedade e não são compartilhados).
2. Insira seu valor de ConsumerKey (String) que você copiou ao concluir as etapas de Obter suas credenciais .
3. Na propriedade ConsumerSecret , insira a segunda variável SecureString que você criou na etapa 6 acima (por exemplo, consumerSecret).
4. Na propriedade Password , digite a segunda variável SecureString que você criou na etapa 1 acima (por exemplo, password).
5. Insira o valor do servidor ("Live" ou "Test").
6. Digite seu nome de usuário de login do Salesforce (por exemplo, "nome@empresa.com")
7. Para a propriedade SalesforceConnection , crie e insira uma variável IConnectionService (por exemplo, salesforceConnection).
  - Você não usará essa variável ao concluir as etapas deste guia, mas é uma boa prática criar suas variáveis de saída para uso em atividades subsequentes.
8. Adicione a atividade Inserir Registro na atividade Escopo do Aplicativo do Salesforce .
9. Crie uma nova variável String para a propriedade de saída desta atividade (por exemplo, newAccountID).
10. Clique no botão Configurar (isso abre o Salesforce Object Wizard).
  - Para saber mais sobre como o assistente funciona, consulte a seção Assistente de Objeto do Salesforce na página Sobre as atividades do Salesforce .
11. Na lista suspensa Salesforce Object , selecione Account (os campos Account ID e Name devem aparecer).
12. Na caixa de texto Add Single Field , insira Type e clique Enter (agora você deve ter 3 campos).
13. No campo Account ID , insira a variável String que você criou na etapa 1 (por exemplo, newAcountID).
14. Insira um nome para a conta (por exemplo, "Início rápido do Salesforce").
15. Insira um tipo válido String (por exemplo, "Prospect").
  - Todos os campos com tipo de dados picklist requerem um valor String que corresponda a um item na lista conforme mostrado na interface de usuário do Salesforce.
    - Usando o campo Tipo como exemplo, por padrão, a lista de seleção inclui os valores mostrados na imagem abaixo (da tela Conta do Salesforce). Você pode usar a atividade Format Labels And Values para visualizar os valores String válidos (consulte o exemplo abaixo).
  - Clique em Concluído.
16. Na propriedade SalesforceOutput , crie e insira uma variável SalesforceStatus (por exemplo, insertRecordStatus).
Adicione a atividade Upload File após a atividade Insert Record .
1. Insira a descriçãodo arquivo, o caminho do arquivoe o título.
2. Na propriedade OutputID , crie e insira uma nova variável String (por exemplo, newFileID).
3. Na propriedade SalesforceStatus , crie e insira uma nova variável SalesforceStatus (por exemplo, uploadFileStatus).
Adicione a atividade Assign File após a atividade Get Record .
1. Na propriedade Id , insira a variável String que você criou para a atividade Carregar arquivo (por exemplo, newFileID).
2. Na propriedade RecordId , insira a variável String que você criou para a atividade Inserir atividade (por exemplo, newAccountID).
3. Insira um valor ShareType (por exemplo, "I" para Inferido).
4. Insira um valor de Visibilidade (por exemplo, "AllUsers").
5. Na propriedade SalesforceStatus , crie e insira uma nova variável SalesforceStatus (por exemplo, assignFileStatus).

Teste seu projeto

Para verificar se seu registro foi inserido, se foi carregado e atribuído ao registro inserido, adicione 3 atividades após a atividade Assign File .
1. Na primeira atividade Write Line , digite o seguinte texto: "Insert Record Success: "+insertRecordStatus.Success.ToString.
  - insertRecordStatus é a variável SalesforceStatus que você criou para a atividade Inserir registro .
2. Na segunda atividade Write Line , digite o seguinte texto: "Upload File Success: "+uploadFileSuccess.Success.ToString.
  - uploadFileStatus é a variável SalesforceStatus que você criou para a atividade Carregar arquivo .
3. Na terceira atividade Write Line , digite o seguinte texto: "Upload File Success: "+assignFileSuccess.Success.ToString.
  - assignFileStatus é a variável SalesforceStatus que você criou para a atividade Atribuir arquivo .
4. Clique em Iniciar e verifique os resultados na janela de saída.
Para verificar ainda mais seus resultados, faça login em sua organização do Salesforce e acesse suas contas e arquivos para ver suas novas adições.

Está feito! Agora você tem um projeto de automação que inclui atividades do Salesforce. Para saber mais sobre as atividades do Salesforce, consulte Atividades para obter links para as páginas de detalhes das atividades.

Para aprofundar sua automação do Salesforce, consulte a documentação do UiPath Connector for Salesforce . O UiPath Connector for Salesforce cria uma conexão “servidor – servidor” entre o Salesforce e o UiPath Orchestrator (instâncias locais ou na nuvem). Ele oferece a capacidade de enviar tarefas do UiPath ou adicionar itens de fila do Salesforce por meio do Flow Builder, do Process Builder ou do Workflow.

Nesta página