Atividade de carregamento do Salesforce Einstein Analytics

Introdução

Uma atividade Carregar do Salesforce Einstein Analytics, usando sua conexão Salesforce Einstein Analytics, coloca um objeto no Salesforce CRM Analytics e se destina a ser usado como um alvo para consumir dados em uma operação.

Criar uma atividade de carregamento do Salesforce Einstein Analytics

Uma instância de uma atividade Carregar do Salesforce Einstein Analytics é criada a partir de uma conexão do Salesforce Einstein Analytics usando seu tipo de atividade Carregar.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente do Salesforce Einstein Analytics Carregar pode ser editada nestes locais:

• A quadro de design (veja menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).

Configurar uma atividade de carregamento do Salesforce Einstein Analytics

Siga estas etapas para configurar uma atividade Carregar 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 carregar dados.

• Etapa 2: especifique as configurações do conjunto de dados
  Especifique o conjunto de dados existente ou novo para carregar dados.

• Etapa 3: Selecione a abordagem de carregamento
  Selecione a abordagem de upload entre um arquivo bruto ou mapeamento direto de uma transformação.

• Etapa 4: Revise os esquemas de dados
  Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: insira um nome e especifique as configurações do aplicativo

Nesta etapa, forneça um nome para a atividade e especifique o aplicativo (pasta) existente ou novo para carregar dados. Cada elemento da interface do usuário desta etapa é descrito abaixo.

A interface usada nesta etapa da configuração de uma atividade Carregar do Salesforce Einstein Analytics depende da opção Aplicativo existente ou novo selecionada:

• Usar aplicativo existente: Para esta opção, você selecionará em uma lista de aplicativos preenchidos a partir da instância do Salesforce.
• Criar aplicativo se ele não existir: Para esta opção, você digitará 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 será apresentada:

• Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade do Salesforce Einstein Analytics Load e não deve conter barras / ou dois pontos :.

• Aplicativo existente ou novo: Especifique o aplicativo existente ou novo a ser usado, um dos seguintes: Usar aplicativo existente ou Criar aplicativo se ele não existir.

  • Usar aplicativo existente: Para esta opção, você selecionará em uma lista de aplicativos preenchidos a partir da instância do Salesforce.
  • Criar aplicativo se ele não existir: Para esta opção, você digitará o nome de um novo aplicativo a ser criado na instância do Salesforce.

• Selecione uma pasta: Selecione um aplicativo existente. Se nenhum existir, você precisará alternar para Criar aplicativo se ele não existir: Ou criar um novo aplicativo manualmente no Salesforce CRM Analytics.

• Salvar e sair: Se habilitado, clique para salvar a configuração desta 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Criar aplicativo se ele não existir

Se Criar aplicativo se ele não existir estiver selecionado para Aplicativo existente ou novo, esta interface será apresentada:

• Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade do Salesforce Einstein Analytics Load e não deve conter barras / ou dois pontos :.

• Aplicativo existente ou novo: Especifique o aplicativo existente ou novo a ser usado, um dos seguintes: Usar aplicativo existente ou Criar aplicativo se ele não existir.

  • Usar aplicativo existente: Para esta opção, você selecionará em uma lista de aplicativos preenchidos a partir da instância do Salesforce.
  • Criar aplicativo se ele não existir: Para esta opção, você digitará 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 desta 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: especificar as 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 usada nesta etapa da configuração de uma atividade Carregar do Salesforce Einstein Analytics depende da opção Usar conjunto de dados existente ou novo selecionada:

• Use um conjunto de dados existente: Para esta opção, você selecionará de uma lista de conjuntos de dados preenchidos da instância do Salesforce. Os conjuntos de dados mostrados são associados ao aplicativo selecionado na etapa anterior.
• Criar conjunto de dados se ele não existir: Para esta opção, você digitará o nome de um novo conjunto de dados a ser criado na instância do Salesforce.

Use 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 será apresentada:

• Usar conjunto de dados existente ou novo: Especifique o uso do conjunto de dados existente ou novo a ser usado, um dos seguintes: Usar um conjunto de dados existente ou Criar conjunto de dados se ele não existir.

  • Usar um conjunto de dados existente: Para esta opção, você selecionará de uma lista de conjuntos de dados preenchidos da instância do Salesforce. Os conjuntos de dados mostrados são associados ao aplicativo selecionado na etapa anterior.
  • Criar conjunto de dados se ele não existir: Para esta opção, você digitará o nome de um novo conjunto de dados a ser criado na instância do Salesforce.

• Selecione 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 ele 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 usada no conjunto de dados existente, uma de Substituir, Acrescentar, Upsert ou Excluir. Substituir é selecionado por padrão.

• Voltar: Clique para armazenar temporariamente a configuração desta 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 nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Criar conjunto de dados se ele não existir

Se Criar conjunto de dados se ele não existir estiver selecionado para Usar conjunto de dados existente ou novo, esta interface será apresentada:

• Usar conjunto de dados existente ou novo: Especifique o uso do conjunto de dados existente ou novo a ser usado, um dos seguintes: Usar um conjunto de dados existente ou Criar conjunto de dados se ele não existir.

  • Usar um conjunto de dados existente: Para esta opção, você selecionará de uma lista de conjuntos de dados preenchidos da instância do Salesforce. Os conjuntos de dados mostrados são associados ao aplicativo selecionado na etapa anterior.
  • Criar conjunto de dados se ele 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 obter mais informações, consulte 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 permitidos para campos numéricos no novo conjunto de dados. Este valor deve estar entre 1 e 18 inclusivamente e está definido para 2 por padrão. Para obter mais informações, consulte 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 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 obter mais informações, consulte Referência de formato de metadados de dados externos na documentação do Salesforce.

• Formato de data: Especifique o formato de data a ser usado no novo conjunto de dados. O formato é definido como yyyy-MM-dd por padrão, mas novas opções podem ser adicionadas com base em 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 da variável somente no modo de edição. Para que os valores variáveis desses campos sejam preenchidos em tempo de execução, a versão do agente deve ser pelo menos 10.75 / 11.13.

• Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

• Próximo: Clique para armazenar temporariamente a configuração desta 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 nenhuma etapa. Uma mensagem solicita que você confirme se 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 de interface do usuário desta etapa é descrito abaixo.

• Abordagem: Selecione a abordagem de upload a ser usada, uma de Arquivo ou Mapeamento Direto. Esta configuração afeta o esquema de dados resultante.

• Voltar: Clique para armazenar temporariamente a configuração desta 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 nenhuma 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 do endpoint são exibidos. Cada elemento de 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

Estas 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 usa a Salesforce SOAP API. Consulte a documentação da API para obter informações sobre os nós e campos do esquema.

• Atualizar: Clique no ícone de atualização ou a palavra Refresh para regenerar esquemas do endpoint do Salesforce Einstein Analytics. Esta ação também regenera um esquema em outros locais ao longo do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

• Voltar: Clique para armazenar temporariamente a configuração desta 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 nenhuma 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 nestes nós e campos:

• Solicitação

  Campo/Nó do Esquema de Solicitação	Notas
  loadRequest	Nó que representa a solicitação de carga.
  data	Dados associados à solicitação de carga.
  metadata	Metadados obrigatórios associados à solicitação de carga. Para obter mais informações, consulte Formato de metadados do Salesforce.

• Resposta

  Campo/Nó do Esquema de Resposta	Notas
  loadResponse	Nó que representa a resposta de carga.
  id	ID associado à resposta de carga.
  errors	Nó que representa erros na resposta de carga.
  item	Nó que representa 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 nestes nós e campos:

• Solicitação

  Campo/Nó do Esquema de Solicitação	Notas
  loadRequest	Nó que representa a solicitação de carga.
  dataset	Nó que representa o conjunto de dados na solicitação de carga.
  item	Nó que representa 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 obter mais informações, consulte Formato de metadados do Salesforce.

• Resposta

  Campo/Nó do Esquema de Resposta	Notas
  loadResponse	Nó que representa a resposta de carga.
  id	ID associado à resposta de carga.
  errors	Nó que representa erros na resposta de carga.
  item	Nó que representa 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 esquema de solicitação metadata campo) 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 External Data Metadata Format Reference na documentação do Salesforce.

Próximos passos

Após configurar uma atividade Carregar do Salesforce Einstein Analytics, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas de operação. Você também pode configurar as configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em workflows diferentes.

As ações de menu para uma atividade são acessíveis a partir do painel do projeto e da quadro de design. Para obter detalhes, consulte menu de ações de atividade em Noções básicas do conector.

As atividades Carregar 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, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.