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.

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:

• 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 e 18 inclusive 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.

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

• Abordagem de arquivo
• Abordagem de mapeamento direto

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": ""
                }
            ]
        }
    ]
}

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.