Ir para o conteúdo

Conector ServiceMax no Jitterbit Studio

Resumo

O conector ServiceMax estabelece acesso ao ServiceMax.

O conector ServiceMax fornece uma interface para criar uma conexão ServiceMax, a base usada para gerar instâncias de atividades ServiceMax. Essas atividades, uma vez configuradas, interagem com o ServiceMax através da conexão.

O conector ServiceMax é acessado pela guia Endpoints e conectores do projeto da paleta de componentes de design (consulte Paleta de componentes de design).

Nota

As informações fornecidas em Solução de problemas do conector Salesforce e Guias práticos do conector Salesforce também podem se aplicar ao conector ServiceMax, pois ele é construído a partir da base de código do conector Salesforce.

Dica

Receitas de integração estão disponíveis para este conector através do Jitterbit Marketplace.

Visão geral do conector

Este conector é usado para configurar primeiro uma conexão ServiceMax. Os tipos de atividade associados a essa conexão são então usados para criar instâncias de atividades destinadas a serem usadas como fontes (para fornecer dados em uma operação) ou destinos (para consumir dados em uma operação).

Juntos, uma conexão ServiceMax específica e suas atividades são chamados de endpoint ServiceMax:

Tipos de atividade ServiceMax

Existem onze atividades disponíveis, cinco padrão e seis em massa. As atividades em massa devem ser usadas apenas se você não precisar usar uma transformação para alterar dados antes de chegar ao destino.

  • Consulta: Consulta dados do ServiceMax e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

  • Inserir: Insere novos dados no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Atualizar: Atualiza dados existentes no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Upsert: Tanto atualiza dados existentes quanto insere novos dados no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Excluir: Exclui dados do ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Consulta em Massa: Consulta um grande número de registros do ServiceMax e é destinada a ser usada como uma fonte para fornecer dados em uma operação.

  • Inserção em Massa: Insere um grande número de novos registros no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Atualização em Massa: Atualiza um grande número de registros existentes no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Upsert em Massa: Tanto atualiza um grande número de registros existentes quanto insere um grande número de novos registros no ServiceMax e é destinada a ser usada como um destino para consumir dados em uma operação.

  • Exclusão em Massa: Exclui um grande número de registros do ServiceMax e é destinado a ser usado como um destino para consumir dados em uma operação. Os registros excluídos são armazenados na Lixeira do ServiceMax antes de serem permanentemente deletados.

  • Exclusão Permanente em Massa: Exclui permanentemente um grande número de registros do ServiceMax e é destinado a ser usado como um destino para consumir dados em uma operação. Os registros excluídos permanentemente se tornam automaticamente elegíveis para exclusão.

Este conector é um conector nativo: suas atualizações são lançadas com a aplicação Studio ou o agente, em vez de separadamente. Consulte Atualizações de conectores do Studio.

Os endpoints criados com este conector estão incluídos no relatório de uso de endpoints e contam para sua licença.

Pré-requisitos e versões de API suportadas

O conector ServiceMax suporta o uso de agentes Harmony na nuvem ou privados com versão 9.4.2 ou superior.

Se configurar uma conexão ServiceMax usando autenticação básica, é necessária uma conta Salesforce que não tenha autenticação multifator (MFA) ativada. Para configurar uma conta 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? na documentação Perguntas Frequentes sobre Autenticação Multifator do Salesforce.

Se configurar uma conexão ServiceMax usando autenticação OAuth 2.0 de 2 pernas, consulte os pré-requisitos do OAuth 2.0 de 2 pernas para obter mais informações. Como o conector ServiceMax compartilha a mesma base de código do conector Salesforce, os mesmos pré-requisitos se aplicam.

Nota

A versão do agente 11.59 (para agentes 11.x) ou 12.4 ou posterior (para agentes 12.x) é necessária para usar OAuth 2.0 de 2 pernas com o conector ServiceMax.

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 agente Jitterbit:

Versão do agente Jitterbit Versão da API SOAP Salesforce Versão Salesforce
12.4 ou posterior (OAuth 2.0) 65.0 Winter '26
12.3 ou posterior (Básico ou sem autenticação)
11.47 a 11.59 (Básico ou sem autenticação)		 64.0 Summer '25
11.41 a 11.46 63.0 Spring '25
11.35 a 11.40 62.0 Winter '25
11.30 a 11.34 61.0 Summer '24
11.23 a 11.29
10.85 a 10.87		 60.0 Spring '24
11.18 a 11.22
10.80 a 10.84		 59.0 Winter '24
11.11 a 11.17
10.73 a 10.79		 58.0 Summer '23
11.7 a 11.10
10.69 a 10.72		 57.0 Spring '23
11.0 a 11.6
10.55 a 10.68		 54.0 Spring '22
10.44 a 10.54 52.0 Summer '21
10.42 a 10.43 51.0 Fall '21
10.28 a 10.41 50.0 Winter '21
10.23 a 10.27 49.0 Summer '20
10.17 a 10.22 48.0 Spring '20
10.11 a 10.16 47.0 Winter '20
10.3 a 10.10 45.0 Spring '19
9.8 a 10.2 44.0 Winter '19
9.4.2 a 9.7 41.0 Winter '18

A Salesforce Bulk API baseada em SOAP é usada para atividades em massa.

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

As atualizações de agente que pulam versões da Salesforce SOAP API 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 de esquema.

Solução de problemas

Se você enfrentar problemas com o conector ServiceMax, recomenda-se seguir estas etapas de solução de problemas:

  1. Garanta que a conexão ServiceMax seja bem-sucedida usando o botão Testar na tela de configuração. Se a conexão não for bem-sucedida, o erro retornado pode fornecer uma indicação do problema.

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

  3. Ative o log de depuração de operação (para agentes na 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 obter mais informações.

  5. Para considerações adicionais de solução de problemas, consulte Solução de problemas de operação. As informações de solução de problemas do conector Salesforce também podem ser aplicáveis.