Ir para o conteúdo

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:

Configurar uma atividade de Carga do Salesforce Einstein Analytics

Siga estas etapas para configurar uma atividade de Carga do Salesforce Einstein Analytics:

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

Se Usar Aplicativo Existente for selecionado para Aplicativo Existente ou Novo, esta interface é apresentada:

Configuração da atividade Load do Salesforce Einstein Analytics

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

Salesforce Einstein Analytics Load activity configuration step 1b

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

Configuração da atividade Load do Salesforce Einstein Analytics etapa 2

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

Configuração da atividade de carregamento do Salesforce Einstein Analytics etapa 2b

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 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.

Configuração da atividade de carregamento do Salesforce Einstein Analytics etapa 3

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

Configuração da atividade de carregamento do Salesforce Einstein Analytics passo 4 abordagem de arquivo

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

Configuração da atividade de carga do Salesforce Einstein Analytics passo 4 abordagem de mapeamento direto

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

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.