Atividade de Carga do Salesforce Einstein Analytics
Introdução
Uma atividade de Carga do Salesforce Einstein Analytics, utilizando sua conexão do Salesforce Einstein Analytics, coloca um objeto no Salesforce CRM Analytics e é destinada a ser usada como um alvo para consumir dados em uma operação.
Nota
Salesforce Einstein Analytics é o antigo nome do Salesforce CRM Analytics.
Criar uma atividade de Carga do Salesforce Einstein Analytics
Uma instância de uma atividade de Carga do Salesforce Einstein Analytics é criada a partir de uma conexão do Salesforce Einstein Analytics usando seu tipo de atividade Carga.
Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, veja Criar uma instância de atividade ou ferramenta em Reutilização de componentes.
Uma atividade de Carga do Salesforce Einstein Analytics existente pode ser editada a partir destes locais:
- A tela de design (veja Menu de ações do componente em Tela de design).
- A aba Componentes do painel do projeto (veja Menu de ações do componente em Aba Componentes do painel do projeto).
Configurar uma atividade de Carga do Salesforce Einstein Analytics
Siga estas etapas para configurar uma atividade de Carga do Salesforce Einstein Analytics:
-
Etapa 1: Insira um nome e especifique as configurações do aplicativo
Forneça um nome para a atividade e especifique o aplicativo (pasta) existente ou novo para fazer o upload de dados. -
Etapa 2: Especifique as configurações do conjunto de dados
Especifique o conjunto de dados existente ou novo para fazer o upload de dados. -
Passo 3: Selecione a abordagem de upload
Selecione a abordagem de upload entre um arquivo bruto ou mapeamento direto de uma transformação. -
Passo 4: Revise os esquemas de dados
Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.
Passo 1: Insira um nome e especifique as configurações do aplicativo
Neste passo, forneça um nome para a atividade e especifique o aplicativo (pasta) existente ou novo para fazer o upload dos dados. Cada elemento da interface deste passo é descrito abaixo.
A interface utilizada neste passo da configuração de uma atividade Load do Salesforce Einstein Analytics depende da opção Aplicativo Existente ou Novo selecionada:
- Usar aplicativo existente: Para esta opção, você selecionará de uma lista de aplicativos preenchida a partir da instância do Salesforce.
- Criar aplicativo se não existir: Para esta opção, você inserirá o nome de um novo aplicativo a ser criado na instância do Salesforce.
Usar aplicativo existente
Se Usar Aplicativo Existente for selecionado para Aplicativo Existente ou Novo, esta interface é apresentada:
-
Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Load do Salesforce Einstein Analytics e não deve conter barras
/
ou dois pontos:
. -
Aplicativo Existente ou Novo: Especifique o aplicativo existente ou novo a ser utilizado, um dos Usar Aplicativo Existente ou Criar Aplicativo se Não Existir.
- Usar Aplicativo Existente: Para esta opção, você selecionará de uma lista de aplicativos preenchida a partir da instância do Salesforce.
- Criar Aplicativo se Não Existir: Para esta opção, você inserirá o nome de um novo aplicativo a ser criado na instância do Salesforce.
-
Selecionar uma Pasta: Selecione um aplicativo existente. Se nenhum existir, você precisará alternar para Criar Aplicativo se Não Existir: ou criar um novo aplicativo manualmente no Salesforce CRM Analytics.
-
Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.
-
Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Criar aplicativo se não existir
Se Criar Aplicativo se Não Existir estiver selecionado para Aplicativo Existente ou Novo, esta interface é apresentada:
-
Nome: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Load do Salesforce Einstein Analytics e não deve conter barras
/
ou dois pontos:
. -
Aplicativo Existente ou Novo: Especifique o aplicativo existente ou novo a ser utilizado, um dos Usar Aplicativo Existente ou Criar Aplicativo se Não Existir.
- Usar Aplicativo Existente: Para esta opção, você selecionará de uma lista de aplicativos populada a partir da instância do Salesforce.
- Criar Aplicativo se Não Existir: Para esta opção, você inserirá o nome de um novo aplicativo a ser criado na instância do Salesforce.
-
Nome do Aplicativo: O nome do novo aplicativo.
-
Salvar e Sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.
-
Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Etapa 2: Especificar configurações do conjunto de dados
Nesta etapa, especifique o conjunto de dados existente ou novo para carregar dados. Cada elemento da interface do usuário desta etapa é descrito abaixo.
A interface utilizada nesta etapa da configuração de uma atividade Load do Salesforce Einstein Analytics depende da opção Usar Conjunto de Dados Existente ou Novo selecionada:
- Usar um conjunto de dados existente: Para esta opção, você selecionará a partir de uma lista de conjuntos de dados preenchidos a partir da instância do Salesforce. Os conjuntos de dados exibidos estão associados ao aplicativo selecionado na etapa anterior.
- Criar conjunto de dados se não existir: Para esta opção, você inserirá o nome de um novo conjunto de dados a ser criado na instância do Salesforce.
Usar um conjunto de dados existente
Se Usar Conjunto de Dados Existente ou Novo for selecionado para Usar Conjunto de Dados Existente ou Novo, esta interface é apresentada:
-
Usar Conjunto de Dados Existente ou Novo: Especifique o uso do conjunto de dados existente ou novo a ser utilizado, um de Usar um Conjunto de Dados Existente ou Criar Conjunto de Dados se Não Existir.
- Usar um Conjunto de Dados Existente: Para esta opção, você selecionará a partir de uma lista de conjuntos de dados preenchidos a partir da instância do Salesforce. Os conjuntos de dados exibidos estão associados ao aplicativo selecionado na etapa anterior.
- Criar Conjunto de Dados se Não Existir: Para esta opção, você inserirá o nome de um novo conjunto de dados a ser criado na instância do Salesforce.
-
Selecionar um Conjunto de Dados: Selecione um conjunto de dados existente com base no aplicativo escolhido na etapa anterior. Se nenhum existir, você precisará alternar para Criar Conjunto de Dados se Não Existir: ou criar um novo conjunto de dados manualmente no Salesforce CRM Analytics.
-
Operação: Especifique a operação de dados a ser utilizada no conjunto de dados existente, uma de Substituir, Adicionar, Upsert ou Excluir. Substituir é selecionado por padrão.
-
Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.
-
Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Criar conjunto de dados se não existir
Se Criar Conjunto de Dados se Não Existir estiver selecionado para Usar Conjunto de Dados Existente ou Novo, esta interface é apresentada:
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [
no campo ou clicando no ícone de variável para exibir uma lista das variáveis existentes para escolher.
-
Usar Conjunto de Dados Existente ou Novo: Especifique o uso de um conjunto de dados existente ou novo, sendo um de Usar um Conjunto de Dados Existente ou Criar Conjunto de Dados se Não Existir.
- Usar um Conjunto de Dados Existente: Para esta opção, você selecionará de uma lista de conjuntos de dados populados a partir da instância do Salesforce. Os conjuntos de dados mostrados estão associados ao aplicativo selecionado na etapa anterior.
- Criar Conjunto de Dados se Não Existir: Para esta opção, você inserirá as informações para um novo conjunto de dados a ser criado na instância do Salesforce.
-
Nome do Conjunto de Dados a Ser Criado: O nome do novo conjunto de dados.
-
Descrição: A descrição do novo conjunto de dados.
-
Valor Padrão Numérico: O valor padrão para campos numéricos no novo conjunto de dados. Este valor é definido como
0
por padrão. Para mais informações, consulte a Referência de Formato de Metadados de Dados Externos na documentação do Salesforce. -
Precisão Numérica: O número máximo de dígitos permitido para campos numéricos no novo conjunto de dados. Este valor deve estar entre
1
e18
inclusive e é definido como2
por padrão. Para mais informações, consulte a Referência de Formato de Metadados de Dados Externos na documentação do Salesforce. -
Escala Numérica: O número de dígitos à direita do ponto decimal em campos numéricos no novo conjunto de dados. Este valor deve ser menor que o valor definido em Precisão Numérica e é definido como
2
por padrão. Para mais informações, consulte a Referência de Formato de Metadados de Dados Externos na documentação do Salesforce. -
Formato de Data: Especifique o formato de data a ser utilizado no novo conjunto de dados. O formato é definido como
yyyy-MM-dd
por padrão, mas novas opções podem ser adicionadas com base nas Diretrizes para Formatação de Datas na documentação do Salesforce. -
Campos de Metadados do Conjunto de Dados: Especifique os campos de metadados a serem incluídos no upload associado ao novo conjunto de dados.
Importante
Os campos na tabela Campos de Metadados do Conjunto de Dados exibem o ícone de variável apenas no modo de edição. Para que os valores das variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.
Os campos na tabela Campos de Metadados do Conjunto de Dados não suportam o uso de variáveis para passar JSON bruto. Se seu caso de uso não suportar a definição de JSON bruto nos campos diretamente, escape o conteúdo JSON antes de passá-lo com uma variável. Por exemplo, escapando
{"success": "true"};
torna-se{\"success\": \"true\"};
. -
Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.
-
Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Etapa 3: Selecione a abordagem de upload
Nesta etapa, selecione a abordagem de upload entre um arquivo bruto ou mapeamento direto de uma transformação. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Abordagem: Selecione a abordagem de upload a ser utilizada, uma de Arquivo ou Mapeamento Direto. Esta configuração afeta o esquema de dados resultante.
-
Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.
-
Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Etapa 4: Revise os esquemas de dados
Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.
Estas subseções descrevem as estruturas de solicitação e resposta para cada combinação de abordagem e tipo de estágio:
Essas ações estão disponíveis com cada abordagem:
-
Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.
Nota
Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.
O conector Salesforce Einstein Analytics utiliza a API SOAP do Salesforce. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.
-
Atualizar: Clique no ícone de atualizar ou na palavra Atualizar para regenerar esquemas do endpoint do Salesforce Einstein Analytics. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.
-
Voltar: Clique para armazenar temporariamente a configuração para esta etapa e retornar à etapa anterior.
-
Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.
-
Descartar Alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em qualquer etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.
Abordagem de Arquivo
Se a abordagem for Arquivo, os esquemas de dados de solicitação e resposta consistem nesses nós e campos:
-
Solicitação
Campo/Nó do Esquema de Solicitação Notas loadRequest
Nó representando a solicitação de carregamento. data
Dados associados à solicitação de carregamento. metadata
Metadados obrigatórios associados à solicitação de carregamento. Para mais informações, consulte formato de metadados do Salesforce. -
Resposta
Campo/Nó do Esquema de Resposta Notas loadResponse
Nó representando a resposta de carga. id
ID associado à resposta de carga. errors
Nó representando erros na resposta de carga. item
Nó representando um único erro. errorCode
Código associado a um erro. errorMessage
Mensagem associada a um erro.
Abordagem de Mapeamento Direto
Se a abordagem for Mapeamento Direto, os esquemas de dados de solicitação e resposta consistem nesses nós e campos:
-
Solicitação
Campo/Nó do Esquema de Solicitação Notas loadRequest
Nó representando a solicitação de carga. dataset
Nó representando o conjunto de dados na solicitação de carga. item
Nó representando um item do conjunto de dados. field
Um campo nomeado associado ao conjunto de dados. metadata
Metadados obrigatórios associados à solicitação de carga. Para mais informações, consulte o formato de metadados do Salesforce. -
Resposta
Campo/Nó do Esquema de Resposta Notas loadResponse
Nó representando a resposta de carga. id
ID associado à resposta de carga. errors
Nó representando erros na resposta de carga. item
Nó representando um único erro. errorCode
Código associado a um erro. errorMessage
Mensagem associada a um erro.
Formato de metadados do Salesforce
A atividade Load requer metadados (no campo metadata
do esquema de solicitação) para carregar dados no Salesforce CRM Analytics.
Um exemplo de metadados formatados corretamente:
{
"fileFormat": {
"charsetName": "UTF-8",
"numberOfLinesToIgnore": 0
},
"objects": [
{
"connector": "Jitterbit",
"description": "",
"fullyQualifiedName": "Record",
"label": "Record",
"name": "Record",
"fields": [
{
"description": "",
"fullyQualifiedName": "Record.Name",
"label": "Name",
"name": "Name",
"isSystemField": false,
"defaultValue": "",
"isUniqueId": false,
"isMultiValue": false,
"type": "Text",
"precision": null,
"scale": null,
"format": ""
},
{
"description": "",
"fullyQualifiedName": "Record.Id",
"label": "Id",
"name": "Id",
"isSystemField": false,
"defaultValue": "",
"isUniqueId": false,
"isMultiValue": false,
"type": "Text",
"precision": null,
"scale": null,
"format": ""
}
]
}
]
}
Importante
Os metadados podem conter apenas uma definição de objeto.
Para informações detalhadas sobre cada campo de metadados possível, consulte Referência de Formato de Metadados de Dados Externos na documentação do Salesforce.
Próximos passos
Após configurar uma atividade Load do Salesforce Einstein Analytics, complete a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estão no mesmo ou em diferentes fluxos de trabalho.
As ações do menu para uma atividade estão acessíveis a partir do painel do projeto e da tela de design. Para detalhes, consulte Menu de ações da atividade em Conceitos básicos do conector.
As atividades de Carga do Salesforce Einstein Analytics podem ser usadas como um alvo com esses padrões de operação:
- Padrão de transformação
- Padrão de duas transformações (como o primeiro ou segundo alvo)
Para usar a atividade com funções de script, escreva os dados em um local temporário e, em seguida, use esse local temporário na função de script.
Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.