Atividade Upsert do ServiceMax

Introdução

Uma atividade Upsert do ServiceMax atualiza dados existentes e insere novos dados no ServiceMax, sendo destinada a ser usada como um destino para consumir dados em uma operação.

A atividade Upsert requer o uso de um campo de ID externo. Para informações sobre como criar um campo de ID externo no Salesforce, veja Criar um ID externo do Salesforce para Jitterbit.

A atividade Upsert é usada para atualizar dados se um registro já existir e criar um se não existir. Se você deseja apenas inserir novos registros, use uma atividade Insert do ServiceMax, ou se quiser atualizar registros existentes com base no ID do objeto no Salesforce, use uma atividade Update do ServiceMax.

Criar uma atividade Upsert do ServiceMax

Uma instância de uma atividade Upsert do ServiceMax é criada a partir de uma conexão do ServiceMax usando seu tipo de atividade Upsert.

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 Upsert do ServiceMax 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 Upsert do ServiceMax

Siga estas etapas para configurar uma atividade Upsert do ServiceMax:

• Etapa 1: Insira um nome, selecione um objeto e especifique as configurações
  Forneça um nome para a atividade e selecione o objeto a ser usado ao inserir dados.

• Etapa 2: Selecione o ID externo
  Selecione um campo existente do ServiceMax que você deseja que o Harmony use como o ID externo para associar registros.

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

Etapa 1: Insira um nome, selecione um objeto e especifique as configurações

Nesta etapa, você fornece um nome para a atividade e seleciona o objeto a ser usado ao inserir dados.

• Nome: Insira um nome para identificar a atividade Upsert do ServiceMax. O nome deve ser exclusivo para cada atividade Upsert do ServiceMax e não deve conter barras (/) ou dois pontos (:).

• Selecionar a Referência do Objeto: Use o menu suspenso para selecionar um objeto padrão ou personalizado do ServiceMax para inserir dados. Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa não diferencia maiúsculas de minúsculas.

  Nota

  Se a lista não for preenchida com objetos disponíveis, observe as seguintes dicas de solução de problemas:

  • A conexão do ServiceMax pode não ter sido bem-sucedida. Certifique-se de que você está conectado reabrindo a conexão e testando novamente as credenciais.

  • Uma senha do Salesforce que usa caracteres ASCII estendidos, como £, pode causar o seguinte erro ao buscar dados durante a configuração da atividade:

    Nome de usuário, senha, token de segurança inválidos; ou usuário bloqueado. [INVALID_LOGIN]
    

    Nesse caso, o teste de conexão pode ainda ser bem-sucedido. Se você receber esse erro durante a configuração da atividade e estiver usando caracteres especiais na senha, tente alterar a senha.

• Atualizar: Clique no ícone de atualizar para recarregar objetos e campos do endpoint ServiceMax. Isso pode ser útil se você adicionou recentemente objetos ou campos ao Salesforce.

• Configurações Opcionais: Clique para expandir configurações opcionais adicionais.

  • Opções de Operação: Essas opções se aplicam a uma operação em que uma atividade Upsert do ServiceMax é utilizada.

    Dica

    Opções adicionais podem ser definidas nas opções de operação de uma operação.

    • Inserir Valores Nulos: Selecione a caixa de seleção para permitir que valores nulos sejam upsertados. Se esta opção não estiver selecionada, se um valor sendo mapeado tiver um valor nulo ou estiver em branco (tiver uma string vazia), ele não será processado.

• Salvar & 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: Selecione o ID externo

Nesta etapa, você seleciona um campo existente do ServiceMax que deseja que o Harmony use como o ID externo para associar registros.

• ID Externo: Use o menu suspenso para selecionar o campo existente do ServiceMax que você deseja que o Harmony use como o ID externo para associar registros. Para informações sobre como criar um campo de ID externo no Salesforce, veja Criar um ID externo do Salesforce para Jitterbit.

  Aviso

  O campo usado como ID externo deve ter um valor único para cada registro. Se você tiver vários registros com o mesmo valor de ID externo, uma resposta de erro do ServiceMax será retornada e o upsert falhará para os registros com IDs duplicados.

• 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 solicita que você confirme que deseja descartar as alterações.

Etapa 3: Revisar os esquemas de dados

Nesta etapa, quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos:

• Esquema de Dados: Os esquemas de dados de solicitação e resposta são exibidos. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente mais tarde durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores personalizados e mais.

  A versão da API do Salesforce que é utilizada depende da versão do agente Jitterbit que você está usando. Consulte Pré-requisitos e versões de API suportadas para links para a documentação sobre os campos do esquema.

  Nota

  Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

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

• Concluído: Clique para salvar a configuração para 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 solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Upsert do ServiceMax, é possível utilizá-la dentro de uma operação conforme descrito abaixo. Após executar uma operação que contém uma atividade do ServiceMax em um agente privado, você pode baixar os arquivos de sucesso e falha da operação.

Complete a operação

Após configurar uma atividade Upsert do ServiceMax, 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 o menu de ações da atividade em Conceitos básicos do conector.

As atividades Upsert do ServiceMax podem ser usadas como um alvo com esses padrões de operação:

• Padrão de transformação
• Padrão de arquivo de dois alvos (como o primeiro alvo apenas)
• Padrão de duas transformações (como o primeiro ou o segundo alvo)

Operações que contêm uma atividade do ServiceMax podem ter apenas uma atividade do ServiceMax e não podem conter outras atividades, exceto aquelas associadas aos conectores de API, Banco de Dados, Compartilhamento de Arquivos, FTP, HTTP, Armazenamento Local, Armazenamento Temporário ou Variável.

Uma atividade ServiceMax pode ser usada como um passo de operação em apenas uma única operação. Ou seja, você não pode referenciar a mesma atividade várias vezes dentro de outras operações. Em vez disso, você pode fazer uma cópia de uma atividade ServiceMax para usar em outros lugares (veja Reutilização de componentes).

Outros padrões não são válidos ao usar atividades Upsert do ServiceMax. Veja os padrões de validação na página Validade da operação.

Dentro de uma transformação, se usar a opção de espelhar um esquema fornecido por uma atividade ServiceMax não em massa, o esquema espelhado resultante será automaticamente criado com um nó raiz adicional chamado records, com o(s) nó(s) filho(s) espelhando o esquema. Quando os campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam percorridos (veja Nódulos de loop sob Estruturas de dados).

Operações que usam atividades ServiceMax também podem ter ações de operação configuradas para serem acionadas em um erro SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. As ações de operação podem ser configuradas para executar uma operação ou enviar um email após a ocorrência de um erro SOAP. Para instruções sobre como acionar uma ação em erro SOAP, consulte Açõ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.

Visualizar arquivos de sucesso e falha

Se você estiver executando uma operação contendo uma atividade ServiceMax em um agente privado, arquivos de sucesso e falha estão disponíveis para download na página Operações em Tempo de Execução do Console de Gerenciamento. Selecione a operação relevante na tabela Operações em Tempo de Execução e clique na guia Logs de Atividade na seção inferior da tela para exibir links de download para os arquivos, se disponíveis:

• Baixar Arquivo de Sucesso: Se você estiver executando a operação em um agente privado, clique no link Baixar para salvar os registros de sucesso como um arquivo CSV.

• Baixar Arquivo de Falha: Se você estiver executando a operação em um agente privado, clique no link Baixar para salvar os registros de falha como um arquivo CSV.