Conexão ServiceMax¶

Introdução¶

Uma conexão ServiceMax é configurada usando o conector ServiceMax, estabelecendo acesso ao endpoint ServiceMax. Depois que uma conexão é estabelecida, você pode configurar uma ou mais atividades ServiceMax associadas a essa conexão para serem usadas como uma fonte para fornecer dados a uma operação ou como um destino para consumir dados em uma operação. Além disso, a conexão ServiceMax pode ser usada em scripts.

Criar Ou Editar uma Conexão ServiceMax¶

Uma nova conexão ServiceMax é criada usando o conector ServiceMax de um destes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A página Conexões globais (consulte Criar um endpoint global em Conexões Globais).

Uma conexão ServiceMax existente pode ser editada nestes locais:

• A aba endpoints e conectores do projeto da paleta de componentes de design (consulte paleta de componentes de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
• A página Conexões globais (consulte Editar um endpoint global em Conexões Globais).

Configurar uma Conexão ServiceMax¶

A configuração de uma conexão ServiceMax inclui estes campos:

• Nome do Endpoint: Insira um nome a ser usado para identificar a conexão ServiceMax. O nome deve ser exclusivo para cada conexão ServiceMax e não deve conter barras (/) ou dois pontos (:). Este nome também é usado para identificar o endpoint do ServiceMax, que se refere a uma conexão específica e suas atividades.

• Host do servidor: Insira a URL do servidor Salesforce. Se estiver usando uma instância de produção, deixe a URL padrão como https://login.salesforce.com. Se você estiver usando uma instância de sandbox, marque a caixa de seleção Sandbox abaixo.

• Sandbox: Se você estiver usando uma instância de sandbox do Salesforce, marque esta caixa de seleção para alternar o campo Host do servidor acima para https://test.salesforce.com.

• Nome de usuário e Senha: Insira o nome de usuário e a senha associados à conta do Salesforce. É 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 O MFA é necessário para meus usuários de integração? em sua documentação perguntas frequentes sobre autenticação multifator do Salesforce.

• Token de segurança: Se necessário, insira o token de segurança associado à conta do Salesforce. Dependendo da sua configuração de segurança do Salesforce, você pode limpar este campo. Verifique com seu administrador do Salesforce. Para obter mais informações, consulte a documentação do Salesforce para Redefinir seu token de segurança.

• Teste: Clique para verificar a conexão usando as credenciais fornecidas.

• Salvar alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (consulte Dependências, exclusão e remoção de componentes). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximos Passos¶

Após uma conexão ServiceMax ter sido criada, as ações de menu para essa conexão ficam acessíveis na aba Componentes do painel do projeto. Veja menu de ações de conexão para mais detalhes.

Depois de configurar uma conexão ServiceMax, você pode configurar uma ou mais atividades ServiceMax associadas a essa conexão para serem usadas como uma origem para fornecer dados a uma operação ou como um destino para consumir dados em uma operação, ou você pode usar a conexão ServiceMax em um script.

Configurar Atividades¶

As atividades do ServiceMax interagem com a conexão do ServiceMax para atuar como fontes (fornecendo dados dentro de uma operação) ou destinos (recebendo dados dentro de uma operação).

Depois de configurar uma conexão ServiceMax, use o menu suspenso Mostrar para filtrar por Endpoints e, em seguida, clique no bloco de conexão ServiceMax para exibir atividades que estão disponíveis para serem usadas com uma conexão ServiceMax:

Para informações, veja estas atividades:

Atividades Padrão do ServiceMax¶

• Consulta: Consulta dados de um endpoint do ServiceMax e deve ser usado como uma fonte em uma operação.
• Inserir: Insere novos dados em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.
• Atualizar: Atualiza dados existentes em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.
• Inserir: Atualiza dados existentes e insere novos dados em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.
• Excluir: Exclui dados em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.

Atividades em Massa do ServiceMax¶

As atividades em massa do ServiceMax são mais rápidas e dimensionáveis melhor 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 dados antes de atingir o destino.

• Consulta em massa: Consulta um grande número de registros de um endpoint do ServiceMax e deve ser usado como uma fonte em uma operação.
• Inserir em massa: Insere um grande número de novos registros em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.
• Atualização em massa: Atualiza um grande número de registros existentes em um endpoint do ServiceMax e deve ser usado como um alvo em uma operação.
• Upsert em massa: Ambos atualizam um grande número de registros existentes e inserem um grande número de novos registros em um endpoint do ServiceMax e devem ser usados como um alvo em uma operação.
• Exclusão em massa: Exclui um grande número de registros de um endpoint do ServiceMax e deve ser usado como um alvo em uma operação. Os registros excluídos são armazenados na Lixeira do Salesforce antes de serem excluídos permanentemente.
• Exclusão em massa definitiva: Exclui permanentemente um grande número de registros de um endpoint do ServiceMax e deve ser usado como um alvo em uma operação. Registros excluídos permanentemente se tornam automaticamente qualificados para exclusão.

Usando Conexões ServiceMax em Scripts¶

As conexões ServiceMax podem ser referenciadas em um script usando funções de script que usam um salesforceOrg como parâmetro:

• LoginToSalesforceAndGetTimeStamp()

• SalesforceLogin()

• SetSalesforceSession()

• SfCacheLookup()

• SfLookup()

• SfLookupAll()

• SfLookupAllToFile()

Para obter mais detalhes sobre como referenciar endpoints em scripts, consulte Endpoints no Jitterbit Script página.