Conector ServiceMax¶

Resumo¶

O conector ServiceMax para Harmony Cloud Studio fornece uma interface para inserir informações fornecidas pelo usuário, como credenciais, para criar uma conexão ServiceMax autenticada. Essa conexão fornece a base para configurar atividades associadas do conector ServiceMax que interagem com a conexão. Juntos, uma conexão ServiceMax específica e suas atividades são chamadas de endpoint ServiceMax.

Pré-requisitos e Versões de API Suportadas¶

O conector ServiceMax suporta o uso de Harmony Cloud ou Agentes Privados versão 9.4.2 ou superior.

É necessária uma conta do Salesforce que não tenha autenticação multifator (MFA) habilitada. Para configurar uma conta do Salesforce sem MFA, certifique-se de que o Conjunto de permissões atribuído ao login de integração do sistema Salesforce não tenha a seleção Autenticação multifator para logins de API. Os tipos de login de integração do sistema estão isentos do requisito de MFA do Salesforce, conforme descrito pelo Salesforce em A MFA é necessária para meus usuários de integração? em sua documentação perguntas frequentes sobre autenticação multifator do Salesforce.

Como o ServiceMax usa a plataforma Salesforce, o conector ServiceMax usa a API Salesforce.

A versão da API que o conector usa para atividades não em massa depende da versão do Harmony Agente:

A API em massa do Salesforce baseada em SOAP é usado para atividades em massa.

A API em massa do Salesforce usa um X-SFDC-Session cabeçalho preenchido com um ID de sessão obtido usando uma API SOAP do Salesforce login() ligue para solicitações válidas.

As atualizações de Agente que ignoram as versões da API SOAP do Salesforce incluem implicitamente suporte para versões intermediárias da API.

Consulte a documentação fornecida nos links acima para obter informações sobre os campos do esquema.

Visão Geral do Conector¶

Este conector é usado para primeiro configurar uma conexão ServiceMax, estabelecendo acesso ao ServiceMax e, em seguida, usado para configurar uma ou mais atividades do ServiceMax associadas a essa conexão como origem ou destino em uma operação.

Atividades Padrão do ServiceMax¶

• Consulta: Consulta dados de um endpoint ServiceMax e destina-se a ser usado como fonte em uma operação.
• Inserir: Insere novos dados em um endpoint ServiceMax e se destina a ser usado como destino em uma operação.
• Atualizar: Atualiza os dados existentes em um endpoint ServiceMax e destina-se a ser usado como destino em uma operação.
• Inserir: Atualiza os dados existentes e insere novos dados em um endpoint ServiceMax e destina-se a ser usado como destino em uma operação.
• Excluir: Exclui dados em um endpoint ServiceMax e deve ser usado como destino em uma operação.

Atividades ServiceMax em Massa¶

As atividades em massa do ServiceMax são mais rápidas e melhor dimensionadas do que as atividades não em massa do ServiceMax, mas devem ser usadas somente se você não precisar usar uma transformação para alterar os dados antes de atingir o objetivo.

• Consulta em massa: Consulta um grande número de registros de um endpoint ServiceMax e destina-se a ser usado como origem em uma operação.
• Inserção em massa: Insere um grande número de novos registros em um endpoint ServiceMax e destina-se a ser usado como destino em uma operação.
• Atualização em massa: Atualiza um grande número de registros existentes em um endpoint ServiceMax e destina-se a ser usado como destino em uma operação.
• Inserção em massa: Ambos atualizam um grande número de registros existentes e inserem um grande número de novos registros em um endpoint ServiceMax e devem ser usados como alvo em uma operação.
• Exclusão em massa: Exclui um grande número de registros de um endpoint ServiceMax e deve ser usado como destino em uma operação. Os registros excluídos são armazenados na Lixeira do ServiceMax antes de serem excluídos permanentemente.
• Exclusão forçada em massa: Exclui permanentemente um grande número de registros de um endpoint ServiceMax e destina-se a ser usado como destino em uma operação. Os registros excluídos permanentemente tornam-se automaticamente elegíveis para exclusão.

Acessando o Conector¶

O conector ServiceMax é acessado na aba Conexões da paleta de componentes de design (consulte Paleta de Componentes de Design).

Crie um Campo Personalizado/id Externo ServiceMax para Jitterbit¶

Recomenda-se usar um campo personalizado no ServiceMax para associar registros a um ID externo para Jitterbit. Estas etapas mostram como criar um campo personalizado no ServiceMax no objeto Account para criar um ID externo chamado "Jitterbit_Account_ID":

1. Faça login em sua instância ServiceMax com suas credenciais.

2. Navegue até Configuração > Ferramentas da plataforma > Objetos e campos > Gerenciador de objetos.

3. Na aba Gerenciador de objetos, selecione o objeto Conta padrão.

4. Na visualização do objeto Conta, vá para a seção Campos e relacionamentos e clique em Novo no canto superior direito.

   1. Na Etapa 1. Escolha o tipo de campo, selecione Texto como o tipo de dados e clique em Avançar.
   2. Na Etapa 2. Insira os detalhes, configure seu novo campo personalizado da seguinte maneira. Em seguida, clique em Avançar.
      • Etiqueta do campo: Jitterbit_Account_ID
      • Comprimento: 50
      • Nome do campo: Jitterbit_Account_ID

5. ID externo: Verificado (muito importante)**
   

   1. Na Etapa 3. Estabelecer segurança em nível de campo, aceite as configurações padrão clicando em **Avançar.
   2. Na Etapa 4. Adicionar aos layouts de página, aceite os padrões clicando em Salvar.

6. Você deverá retornar à tela Campos e Relacionamentos do objeto Conta. Verifique se você vê o novo campo personalizado com os mesmos parâmetros mostrados abaixo.

   

Para obter mais informações, consulte a documentação do Salesforce para Criar campos personalizados.

Funções do Salesforce e Variáveis jitterbit¶

Várias funções do Salesforce podem ser usadas em scripts para fornecer informações de login e sessão e pesquisas para instâncias ServiceMax, incluindo estas:

• GetSalesforceTimestamp
• LoginToSalesforceAndGetTimeStamp
• SalesforceLogin
• SetSalesforceSession
• SfCacheLookup
• SfLookup
• SfLookupAll
• SfLookupAllToFile

Além disso, certas variáveis Jitterbit são fornecidas especificamente para uso com endpoints ServiceMax e Salesforce, incluindo estas:

• jitterbit.sfdc.auto_fieldsToNull
• jitterbit.sfdc.dbsource.sfheader
• jitterbit.sfdc.failure_record_count
• jitterbit.sfdc.query.record_count
• jitterbit.sfdc.success_record_count

Para obter detalhes sobre como usar essas funções e variáveis, consulte Funções do Salesforce e Variáveis SFDC Jitterbit, respectivamente.

Solução de Problemas¶

Se você tiver problemas com o conector ServiceMax, estas etapas de solução de problemas são recomendadas:

1. Certifique-se de que a conexão ServiceMax é bem-sucedido usando o botão Test na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado poderá fornecer uma indicação do problema.

2. Verifique os logs de operação para qualquer informação escrita durante a execução da operação.

3. Habilite o registro de depurar de operação (para Agentes em Nuvem ou para Agentes Privados) para gerar arquivos de log e dados adicionais.

4. Se estiver usando Agentes Privados, você pode verificar os logs do agente Para maiores informações.