Atividade de Exclusão do ServiceMax¶

Introdução¶

Uma atividade ServiceMax Delete exclui dados em um endpoint ServiceMax e deve ser usada como um destino para consumir dados em uma operação. Depois de configurar uma conexão ServiceMax, você pode configurar quantas atividades ServiceMax desejar para cada conexão ServiceMax.

Durante o processamento de registros para uma atividade Upsert, se algum registro falhar, nenhuma alteração adicional será processada e todas as alterações processadas anteriormente serão revertidas. Se você quiser que o processamento continue quando um registro falhar, considere usar uma atividade ServiceMax Bulk Delete ou Bulk Hard Delete.

Crie uma Atividade ServiceMax¶

Uma instância de uma atividade é criada a partir de uma conexão usando um tipo de atividade.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada nestes locais:

• A quadro de design (consulte menu de ações do componente em Tela de design).
• A aba Componentes do painel do projeto (consulte menu de ações do componente em aba Componentes do painel Projeto).

Configurar uma Atividade ServiceMax Delete¶

Siga estas etapas para configurar uma atividade ServiceMax Delete:

• Etapa 1: Digite um nome Forneça um nome para a atividade.
• Etapa 2: Revise os esquemas de dados Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.

Etapa 1: Insira um Nome¶

Nesta etapa, você fornece um nome para a atividade.

• Nome: Insira um nome a ser usado para identificar a atividade ServiceMax Delete. O nome deve ser exclusivo para cada atividade ServiceMax Delete e não deve conter barras (/) ou dois pontos (:).
• Salvar e sair: Se habilitado, clique para salvar a configuração para esta etapa e fechar a configuração da atividade.
• Próximo: Clique para armazenar temporariamente a configuração para esta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.
• Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem pede para você confirmar que deseja descartar as alterações.

Etapa 2: Revise os Esquemas de Dados¶

Nesta etapa, todos os esquemas de solicitação ou resposta gerados no endpoint são exibidos:

• Data Schema: Os esquemas de dados de solicitação e resposta são exibidos. Dentro do nó ids no lado da solicitação da estrutura há um valor de texto representado por um campo, que se destina a ser usado para fornecer os ID(s) de registro do ServiceMax. Mais tarde, durante o mapeamento de transformação processo, você pode mapear para o ids no lado do destino para fornecer os IDs de registro ServiceMax a serem excluídos.

  A versão da API REST do Salesforce usada depende da versão do agente Harmony que você está usando. Consulte Pré-requisitos e versões de API compatíveis para obter links para documentação sobre os campos do esquema.

  Nota

  Para atualizar um esquema de dados em uma atividade existente, você deve avançar novamente em cada etapa de configuração da atividade, fazendo pelo menos uma alteração (como adicionar e remover um caractere do final do nome da atividade) para forçar uma atualização do esquema.

• Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

• Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

• Descartar alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximos Passos¶

Depois de configurar uma atividade ServiceMax Delete, você poderá usá-la em uma operação conforme descrito abaixo. Depois de executar uma operação contendo uma atividade ServiceMax em um agente privado, você pode baixar os arquivos de sucesso e falha da operação.

Conclua a Operação¶

Depois de configurar uma atividade ServiceMax Delete, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas de operação. Você também pode definir as configurações de operação de uma operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.

Depois que uma atividade ServiceMax Delete for criada, as ações de menu para essa atividade estarão acessíveis no painel do projeto nas guias Workflows ou Componentes e na quadro de design. Consulte menu de ações de atividade para detalhes.

As atividades ServiceMax Delete podem ser usadas como destino com estes padrões de operação:

• Padrão de transformação
• Padrão de arquivo de dois alvos (apenas como o primeiro alvo)
• Padrão de duas transformações (como primeiro ou segundo alvo)

As operações que contêm uma atividade ServiceMax podem ter apenas uma atividade do Salesforce e também não podem conter quaisquer outras atividades, exceto aquelas associadas à API, Base de dados, Compartilhamento de arquivo, FTP, HTTP, Armazenamento local, Armazenamento temporário, ou Variável conectores.

Uma atividade ServiceMax pode ser usada como uma etapa de operação em apenas uma única operação. Ou seja, não é possível fazer referência à mesma atividade diversas vezes em outras operações. Em vez disso, você pode fazer uma cópia de uma atividade ServiceMax para usar em outro lugar (consulte Reutilização de componentes).

Outros padrões não são válidos usando atividades ServiceMax Delete. Veja os padrões de validação na página Validade da operação página.

Para usar uma atividade ServiceMax Delete, você fornece os IDs ServiceMax para os registros que deseja excluir durante o mapeamento de transformação processo. Um caso de uso típico é encontrar os registros que você deseja excluir configurando primeiro uma atividade de consulta ServiceMax, recupere os IDs da consultar e use-os como origem para a atividade de exclusão.

Neste exemplo, a primeira operação Get ServiceMax IDs usa uma atividade ServiceMax Query em um Padrão de transformação. A atividade de consulta ServiceMax (Solicitação de IDs de consulta) fornece dados dentro da operação, que são então recebidos pela transformação (IDs de consulta para variável). A atividade Variable Write (Write Query Response) é usada como alvo, recebendo dados dentro da operação.

Se a operação Get ServiceMax IDs for bem-sucedida, a operação ServiceMax Delete será executada. Uma atividade de exclusão ServiceMax é usada em um padrão de duas transformações. A atividade de leitura de variável (Solicitação de IDs de leitura) usa os dados coletados da primeira operação para fornecer os dados na segunda operação. A primeira transformação (Variable to SM Delete) cria uma estrutura de solicitação que é passada para a atividade ServiceMax Delete (Delete). A segunda transformação (Delete to Variable) recebe a estrutura de resposta, que é então escrita em uma variável por uma atividade Variable Write (Write Response):

Dentro de uma transformação, se estiver usando a opção de espelhar um esquema fornecido por uma atividade ServiceMax não em massa, o esquema espelhado resultante será criado automaticamente com um nó raiz adicional chamado records com o(s) nó(s) filho(s) espelhando o esquema. Quando os campos dentro do(s) nó(s) filho(s) são mapeados, o nó se torna um nó de loop para permitir que todos os registros sejam repetidos (consulte Nós de loop em Estruturas de dados).

As operações que usam atividades ServiceMax também podem ter ações operação configuradas para serem acionadas em uma falha SOAP — um erro resultante de um formato de mensagem incorreto, processamento de cabeçalho ou incompatibilidade. As ações de operação podem ser configuradas para executar uma operação ou enviar um email após ocorrer uma falha SOAP. Para obter instruções sobre como disparar uma ação em caso de falha SOAP, consulte Ações de operação.

Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implantar e execute a operação e valide o comportamento verificando os logs de operação.

Exibir Arquivos de Sucesso e Falha¶

Se você estiver executando uma operação contendo uma atividade ServiceMax em um agente privado, os arquivos de sucesso e falha estão disponíveis para download na página Runtime Operations do Management Console. Selecione a operação relevante na tabela Operações de tempo de execução e clique na aba Logs de atividades na seção inferior da tela para exibir links de download para os arquivos, se disponíveis:

• Baixar arquivo com sucesso: Se você estiver executando a operação em um agente privado, clique no link Download para salvar os registros de sucesso como um arquivo CSV.

• Falha no download do arquivo: Se você estiver executando a operação em um agente privado, clique no link Download para salvar os registros de falhas como um arquivo CSV.