Atualização do Conector NetSuite¶

A atividade upsert do NetSuite disponível no Conector NetSuite permite atualizar registros existentes ou criar novos registros em uma instância NetSuite conectada usando Jitterbit. Um "upsert" é essencialmente uma operação de atualização ou criação, ou ambas, dependendo dos dados fornecidos.

Esta página descreve como atualizar registros existentes e criar novos registros NetSuite ao mesmo tempo, usando um exemplo de atualização do número de telefone de um cliente existente e criação de um novo cliente no NetSuite a partir de dados de origem fornecidos em um arquivo CSV por meio do Jitterbit.

Este exemplo demonstra a criação de um novo cliente e a atualização das informações do cliente em um registro que foi criado como exemplo durante o NetSuite Connector Create passo a passo. Este exemplo é utilizado apenas para fins de demonstração e não abrange todas as opções disponíveis no produto; consulte Design Studio para obter documentação mais abrangente.

As seções a seguir são divididas em início da atividade de upsert, definição dos componentes da operação e implantação e execução da operação.

Criando uma Operação NetSuite Upsert¶

1. Dentro do seu projeto no Jitterbit Studio, existem várias maneiras de iniciar uma nova atividade de upsert do NetSuite. Cada uma das opções a seguir iniciará o NetSuite Upsert Wizard para guiá-lo durante o processo.

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

2. A tela Endpoint do NetSuite Upsert Wizard deverá abrir na visualização principal do Studio. Esta tela pede para selecionar o endpoint no qual você gostaria de criar novos dados ou atualizar os dados existentes. Você já deve ter configurado seu endpoint em NetSuite Connector Endpoint. Use o menu suspenso para selecionar o endpoint apropriado. Clique em Avançar quando terminar.

   

3. A tela Object do NetSuite Upsert Wizard solicita que você selecione o objeto no qual deseja fazer o upsert dos dados. Neste exemplo, queremos criar um novo registro de cliente e atualizar um registro de cliente existente no Netsuite, então selecionamos o objeto "Cliente" e clicamos em Concluir para continuar.

   Nota

   Se você tiver muitos objetos disponíveis em sua conta NetSuite, pode ser necessário aguardar um momento para que eles sejam carregados. Você também pode inserir um nome de objeto no campo Filtro ou usar o menu suspenso Objetos para mostrar para limitar os resultados a "Objetos padrão" ou "Objetos personalizados". Experimente o botão Atualizar se os resultados não forem os esperados.

   

4. O Jitterbit prosseguirá com a criação de uma estrutura de solicitação e resposta da API NetSuite que permitirá o upsert de dados em sua conta NetSuite conectada. Uma nova aba deve aparecer no Studio chamada NetSuite Upserts. Você pode renomear sua atividade upsert aqui, se desejar; no exemplo, o nosso é chamado de "Exemplo NetSuite Upsert Customer". Você também pode usar os botões + - ou setas para expandir todos os elementos dentro de cada estrutura.

   

5. 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 fará o upsert dos dados do cliente no NetSuite.

6. Uma nova aba deverá abrir no Studio chamada Operations, contendo uma representação gráfica da atividade de upsert.

   

   Nota

   Os ícones de Origem, Solicitação, Resposta e Destino na imagem acima são espaços reservados 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 vários discos para salvar todas as alterações em seu projeto de integração. Você verá o asterisco na aba Operações e o título da operação desaparecerá à medida que sua nova atividade de upsert for 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 Origem, Solicitação, Resposta e Destino.

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

Para fins deste passo a passo, fornecemos os seguintes exemplos para referência acima: Jitterpak NetSuiteExample.jpk e os arquivos que acompanham 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 o Design Studio seção de nossa documentação.

• Fonte: No exemplo, usamos um arquivo CSV como solicitação de entrada para atualizar um cliente existente e criar um novo cliente com os valores de campo fornecidos abaixo. A tabela a seguir exibe o conteúdo do arquivo de exemplo CustomerUpsertRequest.csv.

  ID	Nome	E-mail	Telefone	Endereço	Cidade	Estado	CEP
  Teste Cliente 1	Cliente de teste 1	teste1@exemplo.com	1-999-999-9999	Rua Principal 1234	Denver	CO	80250
  Teste Cliente 2	Cliente de teste 2	test2@exemplo.com	1-888-888-8888	1234 Amostra Dr. São Francisco	AC	94101
  Teste Custo 3	Cliente de teste 3	test3@exemplo.com	1-777-777-7777	1234 Exemplo de Maneira	Houston	TX	77001

  Nota

  Um upsert do NetSuite deve incluir um campo de ID que mapeia para o cliente ExternalID no NetSuite. Se houver novos registros que precisam ser criados, usar apenas InternalID não será suficiente, pois este campo ainda não seria criado para novos registros no NetSuite.

  Nota

  Na tabela acima, Cliente de Teste 1 e Cliente de Teste 2 foram originalmente criados em NetSuite Connector Create passo a passo. O número de telefone do cliente de teste 1 foi atualizado durante a atualização do NetSuite Connector passo a passo. O exemplo de upsert nesta página inclui (1) o número de telefone atualizado do Cliente de Teste 1, portanto, esse registro será atualizado caso ainda não tenha sido; caso contrário, permanecerá o mesmo, (2) um número de telefone recém-atualizado para o Cliente de Teste 2 e (3) um novo registro de cliente para adicionar o Cliente de Teste 3.

  Nota

  Uma variedade de tipos de fontes estão disponíveis no Jitterbit. Veja Fontes para mais.

  Para usar o arquivo CSV, primeiro clique duas vezes no ícone Fonte, depois clique no botão Criar Nova Fonte e dê um Nome à sua fonte (por exemplo, CustomerUpsertRequest.csv). A seguir, para este exemplo, estamos usando um Agente Privado com arquivos locais habilitados e, portanto, selecione um Tipo de "Arquivo Local" e, em seguida, Procurar até o local. Se você estiver usando os arquivos de exemplo, Folder será 'C:\NetSuiteSampleFiles' e Get Files será 'CustomerUpsertRequest.csv'. Também expandiremos Options e definiremos Ignore Lines como First: '1' já que nosso arquivo CSV usa uma linha de cabeçalho.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta do NetSuite em um arquivo CSV para fornecer informações sobre sucesso/falha. Clique no botão Criar novo destino, dê um Nome ao seu destino (por exemplo, CustomerUpsertResponse.csv) e selecione novamente um Tipo de "Arquivo local" e Procurar até um local no Agente Privado onde queremos salvar os dados. No exemplo, Folder é 'C:\NetSuiteSampleFiles' e Filename é 'CustomerUpsertResponse.csv'.

  Nota

  Você também pode enviar para uma variedade de tipos de destino diferentes. O tipo não precisa ser igual ao tipo de origem. Consulte Metas 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 orientará você na criação da solicitação.

  Nota

  Informações adicionais sobre estruturas de solicitação são fornecidas em Transformações.

  1. Na primeira tela, Nome, forneça um Nome para sua transformação ou deixe como padrão. Em seguida, use o menu suspenso Fonte para selecionar o tipo de fonte. 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 mesma definição de formato de arquivo de origem criada durante NetSuite Connector Create (ou seja, "Exemplo de arquivo simples do cliente").

     Ou, se estiver criando do zero, você pode 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 Simples do Cliente"). Para criar a definição de texto com base em nosso arquivo CSV existente, selecione Criar do arquivo e, no pop-up, navegue até o arquivo local 'CustomerUpsertRequest.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 deseja mapear de uma árvore para outra.

     Nota

     Um upsert do NetSuite deve incluir um campo de ID que mapeia para o cliente ExternalID no NetSuite. Se houver novos registros que precisam ser criados, usar apenas InternalID não será suficiente, pois este campo ainda não seria criado para novos registros no NetSuite.

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

     

• Resposta: Clique duas vezes no ícone Resposta e selecione Criar nova Transformação. Isso abrirá o Assistente de Transformação que orientará você na criação da resposta.

  Nota

  Informações adicionais sobre estruturas de resposta são fornecidas em Transformações.

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

  2. Na próxima tela, Target, use o menu suspenso Available File Format Definitions para selecionar a mesma definição de formato de arquivo de destino criada durante NetSuite Connector Create (ou seja, "Estrutura de resposta do NetSuite ").

     Ou, se estiver criando do zero, você pode selecionar Criar novo. No exemplo, configuramos uma estrutura de resposta típica que gravará o ID externo, o status e a mensagem na resposta para que possamos receber feedback se a operação de upsert falhar. Na primeira tela, defina o Nome do novo formato de arquivo (no exemplo o nosso é chamado de "Estrutura de Resposta do NetSuite ") e clique no botão Criar Manualmente. Na próxima tela, clique em Novo e adicione três novos campos chamados “ExternalID”, “Status” e “Message”.

     Clique em Concluir para continuar.

  3. A aba Transformações deve abrir onde você pode completar seu mapeamento. Use o + para expandir os lados de origem e de destino. Neste exemplo, adicionaremos scripts para obter o ID externo no NetSuite para que, se a operação falhar, saibamos agora o ID do registro com falha para diagnosticar e resolver problemas. Para fazer isso:

     • Arraste e solte o campo "isSuccess" do lado de origem para o novo campo "Status" no lado de destino.

     • Clique duas vezes no campo "ExternalID" no lado do destino para abrir o Formula Builder e adicione as seguintes funções ao script e clique em OK.

       <trans>
       FindByPos(SourceInstanceCount(),jbroot$jbrequest$upsertList$record#.Customer$externalId)
       </trans>
       

       A função FindByPos encontra a instância nos dados solicitantes que corresponde à resposta.

     • Clique duas vezes no campo "Mensagem" no lado do destino para abrir o Formula Builder e adicione as seguintes funções ao script e clique em OK.

       <trans>
       SumString(jbroot$jbresponse$upsertListResponse$writeResponseList$writeResponse.status$statusDetail#.message$,"|",true)
       </trans>
       

       A função SumString irá concatenar um elemento que pode ter mais de uma instância em uma única string.

       Nota

       Encontre funções de script adicionais para usar durante sua Transformação mapeamento ou separadamente como Scripts no Formula Builder seção. Além disso, existem várias funções específicas do NetSuite documentadas em Funções do Conector que pode ser usado para mapeamentos ou scripts mais complexos.

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

     

• Scripts opcionais: Você pode encontrar funções de script adicionais para usar durante sua Transformação mapeamento ou separadamente como Scripts no Formula Builder seção. Para obter informações adicionais, consulte NetSuite Connector Avançado.

Implantando e Executando a Operação¶

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

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

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

3. Na parte inferior da tela, o Monitor de operação deverá indicar que sua operação foi executada com sucesso. Caso contrário, você pode clicar duas vezes no ícone Status para visualizar quaisquer mensagens de registro.

   

4. Agora você também deverá ver a resposta de saída que foi mapeada para seu arquivo de destino. No exemplo, o arquivo agora é criado em 'C:\NetSuiteSampleFiles\CustomerUpsertResponse.csv'. Como a operação foi executada com sucesso, vemos o campo ID seguido por um status ‘1’, indicando sucesso. Se a operação falhasse, veríamos um '0' junto com uma terceira coluna mostrando a mensagem de erro do log.

   ID externo	Estado	Mensagem
   Teste Cliente 1	1
   Teste Cliente 2	1
   Teste Cliente 3	1

5. Além disso, ao verificar sua conta NetSuite, você deverá encontrar as informações do Cliente de Teste 2 atualizadas com o novo número de telefone e o registro do Cliente de Teste 3 criado.

   

   Nota

   Você pode encontrar mais informações sobre a chamada de API para NetSuite no Web Services Usage Log disponível no NetSuite em Setup > Integration > Web Registro de uso de serviços. Isso fornece informações detalhadas sobre sucesso/falha, bem como a solicitação e resposta que foi enviada ao Jitterbit.