Conexão ServiceMax
Introdução
Uma conexão ServiceMax, criada usando o conector ServiceMax, estabelece acesso ao ServiceMax. Após configurar uma conexão, você pode criar instâncias de atividades Salesforce associadas a essa conexão para usar como fontes (para fornecer dados em uma operação) ou como destinos (para consumir dados em uma operação).
Nota
É necessário ter a versão 11.59 do agente (para agentes 11.x) ou 12.4 ou posterior (para agentes 12.x) para usar OAuth 2.0 com dois estágios com o conector ServiceMax.
Este conector suporta a política organizacional Habilitar Re-autenticação ao Alterar. Se habilitada, uma alteração no Host do Servidor ou Nome de Usuário nesta conexão exigirá que os usuários insiram novamente a Senha e o Token de Segurança da conexão.
Criar ou editar uma conexão ServiceMax
Uma nova conexão ServiceMax é criada usando o conector ServiceMax em 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 Endpoints Globais (consulte Criar um endpoint global em Endpoints 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 de componentes em Aba Componentes do painel do projeto).
- A página Endpoints Globais (consulte Editar um endpoint global em Endpoints Globais).
Configurar uma conexão ServiceMax
Cada elemento da interface do usuário da tela de configuração da conexão ServiceMax é descrito abaixo.
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete de abertura [ no campo ou clique no ícone de variável para exibir um menu listando as variáveis existentes para escolher.
-
Nome da Conexão: Digite um nome para identificar a conexão ServiceMax. O nome deve ser único para cada conexão ServiceMax e não deve conter barras (
/) ou dois-pontos (:). Este nome também é usado para identificar o endpoint ServiceMax, que se refere tanto a uma conexão específica quanto às suas atividades. -
Tipo de autenticação: Selecione o tipo de autenticação para conectar ao ServiceMax, Autenticação Básica ou Credenciais do Cliente OAuth 2.0.
Selecione Autenticação Básica para exibir estes campos:
-
Host do Servidor: Digite 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 estiver usando uma instância sandbox, marque a caixa de seleção Sandbox abaixo.
-
Sandbox: Se estiver usando uma instância 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: Digite o nome de usuário da conta Salesforce. É necessária uma conta Salesforce que não tenha autenticação multifator (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 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.
-
-
Senha: Digite a senha da conta do Salesforce.
-
Token de Segurança: Se necessário, digite o token de segurança associado à conta do Salesforce. Dependendo da configuração de segurança do Salesforce, você pode conseguir limpar este campo. Consulte o administrador do Salesforce. Para mais informações, consulte a documentação do Salesforce em Redefinir seu Token de Segurança.
Selecione OAuth 2.0 Client Credentials para exibir estes campos:
-
URL da Instância: Digite a URL da instância do Salesforce.
-
ID do Cliente: Digite o ID do cliente do seu aplicativo Salesforce configurado.
-
Segredo do cliente: Digite o segredo do cliente do seu aplicativo Salesforce configurado.
Consulte os pré-requisitos do OAuth 2.0 de 2 pernas para mais informações.
Nota
A versão do Agent 11.59 (para agents 11.x) ou 12.4 ou posterior (para agents 12.x) é necessária para usar OAuth 2.0 de 2 pernas com o conector ServiceMax.
-
Testar: Clique para verificar a conexão usando as credenciais fornecidas.
-
Salvar: Clique para salvar e fechar a configuração de 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 solicita que você confirme 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 de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.
Próximas etapas
As ações de menu para uma conexão e seus tipos de atividade são acessíveis no painel do projeto e na paleta de componentes de design. Para detalhes, consulte Menus de ações em Noções básicas do conector.
Após 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
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 origem 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: Atualiza dados existentes e 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 origem 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 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 destino para consumir dados em uma operação.
-
Upsert em Massa: Atualiza um grande número de registros existentes e insere um grande número de novos registros no ServiceMax, sendo destinada a ser usada como destino para consumir dados em uma operação.
-
Exclusão em Massa: Exclui um grande número de registros do ServiceMax e é destinada a ser usada como 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 é destinada a ser usada como destino para consumir dados em uma operação. Os registros excluídos permanentemente se tornam automaticamente elegíveis para exclusão.
Usar conexões do ServiceMax em scripts
As conexões do ServiceMax podem ser referenciadas em um script usando funções de script que usam um salesforceOrg como parâmetro. Para mais informações, consulte Usar funções do Salesforce; as mesmas informações se aplicam às conexões do ServiceMax também.