Ir para o conteúdo

Conector ServiceMax para Jitterbit Integration Studio

Resumo

O conector ServiceMax estabelece acesso ao ServiceMax.

O conector ServiceMax fornece uma interface para criar uma conexão ServiceMax, que é a base utilizada para gerar instâncias de atividades do ServiceMax. Essas atividades, uma vez configuradas, interagem com o ServiceMax por meio da conexão.

O conector ServiceMax é acessado na aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).

Nota

As informações fornecidas em Solução de problemas do conector Salesforce e Como fazer 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 primeiro configurar uma conexão ServiceMax. Os tipos de atividades associados a essa conexão são então usados para criar instâncias de atividades que se destinam a ser usadas como fontes (para fornecer dados em uma operação) ou alvos (para consumir dados em uma operação).

Juntas, uma conexão ServiceMax específica e suas atividades são referidas como um endpoint ServiceMax:

Tipos de atividades do ServiceMax

Existem onze atividades disponíveis, cinco padrão e seis atividades em massa. As atividades em massa devem ser usadas apenas se não for necessário usar uma transformação para alterar os dados antes de chegar ao alvo.

  • 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 alvo para consumir dados em uma operação.

  • Atualizar: Atualiza dados existentes no ServiceMax e é destinada a ser usada como um alvo 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 alvo para consumir dados em uma operação.

  • Excluir: Exclui dados do ServiceMax e é destinada a ser usada como um alvo 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.

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

  • Atualizar em Massa: Atualiza um grande número de registros existentes no ServiceMax e é destinada a ser usada como um alvo 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 alvo para consumir dados em uma operação.

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

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

Nota

Este conector é um conector nativo do Integration Studio, que pode ser mencionado pela Jitterbit ao comunicar alterações feitas nos conectores. O cronograma de lançamentos para conectores nativos do Integration Studio é baseado na cadência das aplicações web do portal Harmony.

Pré-requisitos e versões de API suportadas

O conector ServiceMax suporta o uso de agentes da nuvem Harmony ou privados que sejam da versão 9.4.2 ou superior.

É necessário ter uma conta Salesforce que não tenha a autenticação multifatorial (MFA) habilitada. 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 Multifatorial para Logins de API. Os tipos de login de integração do sistema estão isentos do requisito de MFA da Salesforce, conforme descrito pela Salesforce em A MFA é necessária para meus usuários de integração? em sua documentação FAQ sobre Autenticação Multifatorial da Salesforce.

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

A versão da API que o conector utiliza para atividades não em massa depende da versão do agente Jitterbit:

Versão do agente Jitterbit Versão da API SOAP do Salesforce Lançamento do Salesforce
11.47 ou superior 64.0 Verão '25
11.41 a 11.46 63.0 Primavera '25
11.35 a 11.40 62.0 Inverno '25
11.30 a 11.34 61.0 Verão '24
11.23 a 11.29
10.85 a 10.87		 60.0 Primavera '24
11.18 a 11.22
10.80 a 10.84		 59.0 Inverno '24
11.11 a 11.17
10.73 a 10.79		 58.0 Verão '23
11.7 a 11.10
10.69 a 10.72		 57.0 Primavera '23
11.0 a 11.6
10.55 a 10.68		 54.0 Primavera '22
10.44 a 10.54 52.0 Verão '21
10.42 a 10.43 51.0 Outono '21
10.28 a 10.41 50.0 Inverno '21
10.23 a 10.27 49.0 Verão '20
10.17 a 10.22 48.0 Primavera '20
10.11 a 10.16 47.0 Inverno '20
10.3 a 10.10 45.0 Primavera '19
9.8 a 10.2 44.0 Inverno '19
9.4.2 a 9.7 41.0 Inverno '18

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

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

Atualizações de agente que pulam 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 informações sobre os campos do esquema.

Solução de Problemas

Se você encontrar problemas com o conector ServiceMax, as seguintes etapas de solução de problemas são recomendadas:

  1. Certifique-se de que a conexão ServiceMax foi 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 registro de depuração da 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 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 se aplicar.