Sobre o pacote de atividades Salesforce

O pacote UiPath.Salesforce.Activities permite automatizar processos do Salesforce. Ele pode se conectar a uma organização do Salesforce por meio do escopo do aplicativo Salesforce e, juntamente com o restante das atividades, permite executar Actions como manipulação de arquivos, manipulação de registros, execução de relatórios e execução de comandos SOQL.

Uma vez estabelecida, a conexão com a Salesforce Org pode ser armazenada em um objeto IConnectionService e facilmente reutilizada em todas as atividades subseqüentes do Scope filho. As credenciais para a conexão são criptografadas pelo uso do Microsoft .NET Data Protection API (DPAPI) e só podem ser acessadas pelo mesmo usuário e na mesma máquina em que foram inseridas.

Pré-requisitos

Uma conta do Salesforce , bem como um aplicativo Salesforce Connected, são necessários para usar as atividades do Salesforce. Eles podem ser adquiridos com o administrador do Salesforce.

Como alternativa, os desenvolvedores de RPA podem usar uma conta de desenvolvedor do Salesforce para automatizar processos no Salesforce.

O objeto SalesforceStatus

Todas as atividades que realizam manipulação de dados no Salesforce retornam um tipo de dados proprietário, chamado SalesforceStatus. Este objeto contém detalhes sobre o status de execução de cada atividade em interação com o Salesforce. O objeto é estruturado para conter as seguintes propriedades:

• Success - Informa se a ação foi bem-sucedida ou se ocorreu um erro.
• ErrorCode - Caso ocorra um erro durante a execução, retorna o código de erro do Salesforce.
• Mensagem - Caso ocorra um erro durante a execução, retorna a mensagem de erro do Salesforce.

O assistente de objeto do Salesforce

As atividades Get Record, Insert Recorde Update Record podem ser configuradas usando o assistente de Objeto do Salesforce . Clicar no botão Configurar presente no corpo das atividades abre essa janela.

O menu suspenso Objeto do Salesforce permite selecionar o objeto com o qual você deseja interagir, exibindo todos os seus detalhes. O primeiro registro nesse objeto também é recuperado como um registro de amostra. A coluna Valor de amostra mostra o valor do campo para esse registro.

Observação: quando um objeto Salesforce é selecionado, a lista de campos é preenchida com a lista de campos marcados como obrigatórios em todos os layouts do objeto no Salesforce. Devido à limitação dos detalhes de configuração disponíveis no Salesforce, pode haver mais campos obrigatórios, mas não adicionados por padrão. Use o teste com valores de amostra para testar a atividade.

Usando a caixa de texto Add Single Field , você pode adicionar campos ao objeto selecionado. O botão Adicionar vários campos abre uma seção diferente do assistente, que permite escolher vários campos para adicionar ao objeto. Isso pode ser feito marcando as marcas de seleção de todos os campos que deseja adicionar e clicando em Concluído.

Nota: Na atividade Inserir registro , apenas os campos identificados como tendo permissão para serem criados pela API do Salesforce Lightning estão disponíveis. Na atividade Atualizar Cadastro , estão disponíveis apenas os campos identificados como passíveis de atualização.

Clicar em Concluído novamente salva as alterações feitas na atividade que estava sendo configurada.

As atividades Inserir Registro e Atualizar Registro também possuem a opção de testar a operação com valores amostrais. Isso pode ser feito clicando no botão Testar com valores de amostra . Isso executa as operações com os valores na coluna Sample Value e relata sucessos ou erros.

Campos de objeto Salesforce e tipo de dados

Nas atividades Get Record, Insert Recorde Update Record , todos os valores de campo são passados como String.

Para campos com o tipo de dados Picklist , a string passada deve ser o valor válido e não o rótulo como visto no aplicativo. Use a atividade Format Labels And Values para configurar a string corretamente.

Para campos com o tipo de dados Multiplicklist , a string passada deve ser uma lista dos valores válidos separados por ponto e vírgula, e não os rótulos como visto no aplicativo. Use a atividade Format Labels And Values para configurar a string corretamente.

Para campos com o tipo de dados Boolean , a string transmitida deve ser true ou false. Observe que quando o Salesforce retorna esses valores na atividade Get Record , os valores exibidos na coluna Valor de Exemplo podem ser: Verdadeiro, Verdadeiro, Falsoou Falso, dependendo de como os dados foram originalmente inseridos no Salesforce.

Para campos com o tipo de dados Date , a string passada deve estar no formato YYYY-MM-DD.

Funções de extensão do Salesforce

Implementamos duas novas funções que acompanham o pacote de atividades do Salesforce , que ajudam você a automatizar melhor os processos no Salesforce:

Formatar como Booleano

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceFormatAsBoolean(String Value)

A inserção de um valor de tipo booleano que não esteja no formato compatível com o Salesforce gera um erro no tempo de execução. A função SalesforceFormatAsBoolean permite converter qualquer tipo de valor booleano em uma string para o formato compatível com o Salesforce.

Valores suportados

Para True, os seguintes valores são conversíveis: 1, x, t, true, yes, y.

Para False, os seguintes valores são conversíveis: 0, null, f, false, no, n.

Observação: todos os valores mencionados acima não diferenciam maiúsculas de minúsculas (o que significa que são identificados independentemente de estarem em maiúsculas ou não) e são reconhecidos a partir de qualquer alfabeto disponível.

Termo de pesquisa de escape

UiPath.Salesforce.Utilities.UtilityFunctionExtension

String SalesforceEscapeSearchTerm(String SearchTerm, Boolean IsLike = true)

Essa função escapa dos termos de pesquisa que podem ser usados na propriedade SOQLCommand na atividade Executar SOQL , conforme exigido pelo Salesforce. Para mais informações sobre Quoted String Escape, você pode ir aqui.