Conector NetSuite Excluir no Jitterbit Design Studio

A atividade de exclusão do NetSuite disponível dentro do conector NetSuite permite excluir registros existentes em uma instância do NetSuite conectada usando o Jitterbit.

Esta página descreve como excluir registros existentes do NetSuite por ID usando um exemplo simples com IDs externos fornecidos em um arquivo CSV através do Jitterbit. Isso completa a demonstração usando registros de exemplo criados e atualizados durante os tutoriais para criação do conector NetSuite, atualização do conector NetSuite e upsert do conector NetSuite.

As seções a seguir estão divididas em iniciar a atividade de exclusão, definir os componentes da operação e implantar e executar a operação.

Criando uma operação de exclusão do NetSuite

1. Dentro do seu projeto no Jitterbit Studio, existem várias maneiras de iniciar uma nova atividade de exclusão do NetSuite. Cada uma das opções a seguir iniciará o Assistente de Exclusão do NetSuite para guiá-lo pelo processo.

   • Vá para Arquivo > Novo > Conectores > Nova Exclusão do NetSuite.
   • Na árvore à esquerda, sob Conectores, clique com o botão direito na categoria NetSuite, e selecione Nova Exclusão do NetSuite.
   • Na árvore à esquerda, sob Conectores, clique duas vezes na categoria NetSuite, depois clique com o botão direito em Nova Exclusão do NetSuite e selecione Nova Exclusão do NetSuite.
   • Na barra de ferramentas superior, clique no ícone do conector (peça de quebra-cabeça laranja) . No pop-up, selecione NetSuite, depois selecione Exclusão do NetSuite.

2. A tela Endpoint do Assistente de Exclusão do NetSuite deve abrir na visualização principal do Studio. Esta tela solicita que você selecione o endpoint do qual deseja excluir registros. Você já deve ter configurado seu endpoint em endpoint do conector NetSuite. Use o menu suspenso para selecionar o endpoint apropriado. Clique em Concluir para finalizar o assistente.

   

3. O Jitterbit então prosseguirá com a criação de uma estrutura de solicitação e resposta da API do NetSuite que permitirá que os registros sejam excluídos dentro da sua conta do NetSuite conectada. Uma nova aba deve aparecer no Studio chamada NetSuite GetLists. Você pode renomear sua atividade GetList aqui, se desejar; no exemplo, a nossa é chamada de "Exclusão de Exemplo do NetSuite." Você também pode usar os botões + - ou setas para expandir todos os elementos dentro de cada estrutura.

   

4. Em seguida, na mesma tela, clique no botão Criar Operação localizado em Usar em uma Integração no canto superior direito. Isso criará a operação Jitterbit que excluirá os dados de clientes existentes no NetSuite.

5. Uma nova aba deve abrir no Studio chamada Operações, contendo uma representação gráfica da atividade de exclusão.

   

   Nota

   Os ícones para Fonte, Requisição, Resposta e Alvo na imagem acima são marcadores para os componentes da operação, que definiremos na próxima seção.

   Salve sua operação clicando no ícone de disco único para salvar apenas esta operação ou no ícone de discos múltiplos para salvar todas as alterações em seu projeto de integração. Você deve ver o asterisco na aba Operações e o título da operação desaparecer, pois sua nova atividade de exclusão agora foi criada e salva em seu projeto.

Definindo os componentes da operação

Em seguida, precisamos definir os outros componentes da operação que aparecem na representação gráfica, incluindo Fonte, Requisição, Resposta e Alvo.

Para cada um, as instruções abaixo orientam você a retornar à representação gráfica da operação que você criou e clicar duas vezes em cada ícone para configurar cada componente. Como alternativa, você também pode criar a Resposta e o Alvo separadamente e, em seguida, arrastá-los e soltá-los da árvore à esquerda diretamente sobre os ícones na representação visual de sua operação.

Para fins deste guia, fornecemos os seguintes exemplos para referência acima: Jitterpak NetSuiteExample.jpk e arquivos acompanhantes em NetSuiteSampleFiles.zip. Muitos tipos diferentes de dados podem ser usados para cada componente da operação. Para saber mais sobre opções adicionais de personalização, consulte a seção Design Studio de nossa documentação.

• Fonte: No exemplo, usamos um arquivo CSV como a solicitação de entrada para excluir registros de clientes existentes por ID. Esses mesmos IDs foram mapeados para o ID Externo do NetSuite durante os exemplos de operações de criação, atualização e upsert do NetSuite.

  Nota

  A exclusão do NetSuite suporta a exclusão de dados de objetos por ExternalID ou InternalID.

  Para este exemplo, usaremos a mesma fonte criada no exemplo de GetList do conector NetSuite. Se você seguiu este guia, para usar o mesmo arquivo CSV, clique duas vezes no ícone Fonte e selecione a fonte existente CustomerGetListRequest.csv.

  Se estiver criando do zero, primeiro clique duas vezes no ícone Fonte, depois clique no botão Criar Nova Fonte e dê um Nome à sua fonte (por exemplo, CustomerDeleteRequest.csv). Em seguida, para este exemplo, estamos usando um agente privado com arquivos locais habilitados, e assim selecione um Tipo de "Arquivo Local" e depois Navegar até a localização. Se você estiver usando os arquivos de exemplo, a Pasta é 'C:\NetSuiteSampleFiles' e o Obter Arquivos é 'CustomerGetListRequest.csv'. Também expandiremos as Opções e definiremos Ignorar Linhas para Primeiro: '1', uma vez que nosso arquivo CSV usa uma linha de cabeçalho.

  Nota

  Uma variedade de tipos de fonte estão disponíveis no Jitterbit. Veja Fontes para mais informações.

• Alvo: Clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta do NetSuite em um arquivo XML. Clique no botão Criar Novo Alvo, dê um Nome ao seu alvo (por exemplo, CustomerDeleteResponse.xml) e novamente selecione um Tipo de "Arquivo Local" e Navegar até uma localização no agente privado onde queremos salvar os dados. No exemplo, a Pasta é 'C:\NetSuiteSampleFiles' e o Nome do Arquivo é 'CustomerDeleteResponse.xml'.

  Nota

  Você também pode exportar para uma variedade de tipos de destino diferentes. O tipo não precisa ser o mesmo que o tipo de origem. Veja Destinos para opções.

• Solicitação: Clique duas vezes no ícone Solicitação e selecione Criar Nova Transformação. Isso abrirá o Assistente de Transformação, que o guiará na criação da solicitação.

  Nota

  Informações adicionais sobre estruturas de solicitação estão disponíveis em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como o padrão. Em seguida, use o menu suspenso Fonte para selecionar o tipo de origem. Para o exemplo, usamos um arquivo CSV, que é considerado "Texto." Clique em Próximo para continuar.

  2. Na próxima tela, Fonte, use o menu suspenso Definições de Formato de Arquivo Disponíveis para selecionar a definição existente "Exemplo de Arquivo Plano de Cliente ID Somente" que foi criada no exemplo do conector NetSuite GetList.

     Se estiver criando do zero, use o menu suspenso Definições de Formato de Arquivo Disponíveis para selecionar Criar Novo. Isso abrirá opções adicionais para definir um novo formato de arquivo. Forneça um Nome para o novo formato de arquivo (no exemplo, chamamos o nosso de "Exemplo de Arquivo Plano de Cliente ID Somente"). Para criar a definição de texto com base em nosso arquivo CSV existente, selecione Criar a Partir do Arquivo, em seguida, na janela pop-up, navegue até o arquivo local 'CustomerGetListRequest.csv'. Clique em Concluir para continuar.

  3. A aba Transformações deve abrir onde você pode completar seu mapeamento. Use o + para expandir os itens de origem e destino em cada árvore. Em seguida, arraste e solte cada campo que você gostaria de mapear de uma árvore para a outra. Neste caso, o ID fornecido em nosso arquivo CSV mapeia para o campo 'externalId' no NetSuite.

     Em seguida, precisamos definir o objeto para a exclusão. Para fazer isso, clique duas vezes no campo 'type' abaixo de 'externalId' e insira "customer" entre aspas duplas no Construtor de Fórmulas para excluir os registros de Cliente associados aos IDs fornecidos:

<trans>
"cliente"
</trans>

Seu mapeamento de transformação final deve ser semelhante ao mostrado abaixo:

• Resposta: Clique com o botão direito no ícone Resposta e selecione Pass-Through. Isso nos permitirá passar todos os dados associados aos registros excluídos para o arquivo de saída.

• Scripts Opcionais: Você pode encontrar funções de script adicionais para usar durante seu mapeamento de Transformação ou separadamente como Scripts na seção Construtor de Fórmulas. Para informações adicionais, consulte conector do NetSuite avançado.

Implantando e executando a operação

Com a atividade de exclusão do NetSuite totalmente configurada, estamos prontos para implantar e executar a operação.

1. Na aba Operações, clique no ícone de implantar .

2. Em seguida, clique no ícone de executar para colocar a operação na fila para execução.

3. Na parte inferior da tela, o Monitor de Operação deve indicar que sua operação foi executada com sucesso. Se não, você pode clicar duas vezes no ícone Status para visualizar quaisquer mensagens de log.

4. Você também deve ver agora a resposta de saída que foi passada para o seu arquivo de destino. No exemplo, o arquivo agora é criado em 'C:\NetSuiteSampleFiles\CustomerDeleteResponse.xml'. O arquivo deve conter todos os dados dos registros de clientes excluídos por ID.

5. Além disso, ao verificar sua conta do NetSuite, você deve perceber que os registros de clientes excluídos não existem mais.

   Nota

   Você pode encontrar mais informações sobre a chamada da API para o NetSuite no Registro de Uso de Serviços Web disponível no NetSuite em Configuração > Integração > Registro de Uso de Serviços Web. Isso fornece informações detalhadas sobre sucesso/falha, bem como a solicitação e a resposta que foram enviadas para o Jitterbit.