Pesquisa de Conector NetSuite¶

A atividade de pesquisa do NetSuite disponível no NetSuite Connector permite pesquisar registros existentes em uma instância NetSuite conectada usando Jitterbit.

Esta página descreve como pesquisar registros NetSuite existentes, demonstrando com os mesmos registros de exemplo criados e atualizados durante as orientações para NetSuite Connector Create, Atualização do conector NetSuite e Inserção do conector NetSuite.

As seções a seguir são divididas em início da atividade de pesquisa, definição dos componentes da operação e implementação e execução da operação. Informações específicas para cada tipo de pesquisa NetSuite disponível também são fornecidas abaixo.

Criando uma Operação de Pesquisa NetSuite¶

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

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

2. A tela Endpoint do NetSuite Search Wizard deverá abrir na visualização principal do Studio. Esta tela pede para selecionar o endpoint no qual você gostaria de pesquisar 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 Search Wizard solicita que você selecione o objeto no qual deseja pesquisar dados existentes. Neste passo a passo, queremos pesquisar registros de clientes existentes no Netsuite, então selecionamos o objeto "Cliente" e clicamos em Concluir para continuar.

   Nota

   Você pode notar diferenças na lista de objetos exibidos durante uma operação de pesquisa do NetSuite em comparação com os objetos disponíveis durante a NetSuite criar, atualizar e upsert operações. Isso se deve ao acesso permitido pelo NetSuite para adicionar ou modificar registros versus acesso para pesquisar registros.

   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", "Objetos personalizados", "Objetos de pesquisa de transação" ou "Item Pesquisar objetos." Experimente o botão Atualizar se os resultados não forem os esperados.

   

   Nota

   Se você estiver pesquisando em um objeto de transação e quiser pesquisar por status, consulte as notas especiais fornecidas em "Pesquisa de transação do NetSuite por status" em NetSuite Connector Advanced.

4. A tela Tipo de pesquisa do Assistente de pesquisa do NetSuite solicita que você selecione o tipo de pesquisa que deseja realizar.

   

   Um exemplo usando cada um desses tipos de pesquisa é fornecido nas subseções a seguir. - Pesquisa Básica: Uma pesquisa básica limitará a pesquisa apenas ao objeto selecionado na tela anterior. Uma pesquisa básica sempre retornará todos os campos disponíveis para o objeto selecionado. Por exemplo, uma pesquisa básica pelo objeto "Cliente" selecionado consultar campos no objeto "Cliente"

   • Pesquisa Expandida: Uma pesquisa expandida incluirá o objeto selecionado junto com quaisquer objetos relacionados no NetSuite. Por exemplo, uma pesquisa expandida para o objeto "Cliente" selecionado também incluirá objetos relacionados adicionais no NetSuite, como billingAccountJoin, contactJoin, OpportunityJoin, transactionJoin, etc.

     Nota

     As pesquisas expandidas devem incluir uma consultar sobre um objeto relacionado, ou você receberá um erro no Jitterbit. Se os critérios e campos recuperados estiverem no mesmo objeto, use uma pesquisa básica.

     Nota

     Pesquisas expandidas e avançadas podem ser desativadas para objetos personalizados ou outros objetos que não possuem objetos relacionados no NetSuite.

   • Pesquisa Avançada: Uma pesquisa avançada incluirá o objeto selecionado junto com quaisquer objetos relacionados e, na próxima tela, apresentará uma opção adicional para selecionar os campos específicos que você deseja consultar. Uma pesquisa avançada pode ser muito mais rápida que uma pesquisa básica ou pesquisa avançada, mesmo que você não queira consultar objetos relacionados, pois permite limitar a consultar a campos específicos no NetSuite.

     Nota

     Pesquisas expandidas e avançadas podem ser desativadas para objetos personalizados ou outros objetos que não possuem objetos relacionados no NetSuite.

     Aviso

     Em uma pesquisa avançada, segmentos personalizados do tipo Lista/Registro não são suportados. Saiba mais em Usando segmentos personalizados do NetSuite em Conector NetSuite Avançado.

   • Pesquisa salva: Uma pesquisa salva é uma pesquisa reutilizável que você já definiu no NetSuite. Em vez de construir a pesquisa no Jitterbit, a pesquisa já está configurada no NetSuite e pode então ser puxada para o Jitterbit. Para obter informações adicionais sobre pesquisas salvas do NetSuite, consulte a documentação do NetSuite em Usando pesquisas salvas.

Pesquisa Básica¶

Uma pesquisa básica limitará a pesquisa apenas ao objeto selecionado na tela anterior. Uma pesquisa básica sempre retornará todos os campos disponíveis para o objeto selecionado.

O exemplo a seguir demonstra uma pesquisa básica do objeto "Cliente" selecionado. Os critérios utilizados no exemplo retornam registros com campo "lastModifiedDate" após "ontem" para retornar os registros modificados durante os exemplos utilizados no NetSuite create, atualizar e upsert operações.

1. A tela Tipo de pesquisa do Assistente de pesquisa do NetSuite solicita que você selecione o tipo de pesquisa que deseja realizar. Selecione Pesquisa básica e clique em Avançar para continuar.

2. A tela Build Query do NetSuite Search Wizard é onde você inserirá os critérios para sua pesquisa. Cada opção configurável é explicada a seguir.

   

   • Especifique critérios para restringir sua pesquisa: No lado esquerdo da tela há uma lista dos campos disponíveis dentro do objeto selecionado. Por exemplo, role para baixo até “lastModifiedDate”. Clique duas vezes no campo para adicionar uma condição ou selecione o campo e clique no botão Adicionar Condição.

   • Adicionar Condição: No pop-up Adicionar Condição, use o menu suspenso para selecionar um Operador. No exemplo escolheremos “depois”. Abaixo, selecione o botão de opção para Usar valor predefinido e selecione "ontem". Alternativamente, você pode especificar uma data exata conforme instruído na caixa de diálogo. Clique em Adicionar condição para continuar.

   • Condições Atuais: Um resumo das condições que você selecionou atualmente aparecerá como uma lista. Use os botões Editar ou Excluir para gerenciar a seleção atual.

     Nota

     Você pode adicionar qualquer número de condições à sua pesquisa simplesmente selecionando outro campo à esquerda e adicionando outra condição. Dessa forma, você pode criar efetivamente qualquer combinação de pesquisas de múltiplos registros.

   • Tamanho da página de pesquisa: Defina o número de registros por página, se necessário.

   • Consulta de teste: Clique no botão Consulta de teste no canto inferior direito para testar sua consultar. Para nosso exemplo usado durante o NetSuite create, atualizar e upsert, a consultar de teste indica que há três registros modificados desde ontem. Se os resultados parecerem corretos, clique em Concluir.

3. O Jitterbit prosseguirá com a criação de uma estrutura de resposta da API NetSuite que mostra a estrutura da resposta. Uma nova aba deve aparecer no Studio chamada NetSuite Searches. Você pode renomear sua atividade de pesquisa aqui, se desejar; no exemplo, o nosso é chamado de "Exemplo de cliente de pesquisa básica do NetSuite ". Você também pode usar os botões + - ou setas para expandir todos os elementos da 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 realizará a pesquisa.

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

   

   Nota

   Os ícones de Response e Target 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 atualização for criada e salva em seu projeto.

Pesquisa Expandida¶

Uma pesquisa expandida incluirá o objeto selecionado junto com quaisquer objetos relacionados no NetSuite. Por exemplo, uma pesquisa expandida para o objeto "Cliente" selecionado também incluirá objetos relacionados adicionais no NetSuite, como billingAccountJoin, contactJoin, OpportunityJoin, transactionJoin, etc.

O exemplo a seguir demonstra uma pesquisa expandida para o objeto "Cliente" selecionado e objetos relacionados. Os critérios usados no exemplo retornam registros do objeto relacionado "contactJoin" com um campo "lastModifiedDate" após "ontem" para retornar registros. Se você está acompanhando os exemplos usados para NetSuite create, atualizar e upsert, observe que um contato também foi adicionado a um dos clientes de teste no NetSuite para fins deste exemplo.

1. A tela Tipo de pesquisa do Assistente de pesquisa do NetSuite solicita que você selecione o tipo de pesquisa que deseja realizar. Selecione Pesquisa Expandida e clique em Avançar para continuar.

2. A tela Build Query do NetSuite Search Wizard é onde você inserirá os critérios para sua pesquisa. Cada opção configurável é explicada a seguir.

   

   • Especifique critérios para restringir sua pesquisa: No lado esquerdo da tela está o objeto selecionado e quaisquer objetos relacionados. Utilize as setas para expandir os campos do objeto relacionado que você deseja consultar. Por exemplo, expanda o objeto "contactJoin" e selecione o campo "lastModifiedDate". Clique duas vezes no campo para adicionar uma condição ou selecione o campo e clique no botão Adicionar Condição.

   • Adicionar Condição: No pop-up Adicionar Condição, use o menu suspenso para selecionar um Operador. No exemplo escolheremos “depois”. Abaixo, selecione o botão de opção para Usar valor predefinido e selecione "ontem". Alternativamente, você pode especificar uma data exata conforme instruído na caixa de diálogo. Clique em Adicionar condição para continuar.

   • Condições Atuais: Um resumo das condições que você selecionou atualmente aparecerá como uma lista. Use os botões Editar ou Excluir para gerenciar a seleção atual.

     Nota

     Você pode adicionar qualquer número de condições à sua pesquisa simplesmente selecionando outro campo à esquerda e adicionando outra condição. Dessa forma, você pode criar efetivamente qualquer combinação de pesquisas de múltiplos registros.

   • Tamanho da página de pesquisa: Defina o número de registros por página, se necessário.

   • Consulta de teste: Clique no botão Consulta de teste no canto inferior direito para testar sua consultar. Os resultados devem indicar o número de registros que você modificou o objeto Contact desde ontem. Se os resultados parecerem corretos, clique em Concluir.

3. O Jitterbit prosseguirá com a criação de uma estrutura de resposta da API NetSuite que mostra a estrutura da resposta. Uma nova aba deve aparecer no Studio chamada NetSuite Searches. Você pode renomear sua atividade de pesquisa aqui, se desejar; no exemplo, o nosso é chamado de "Exemplo de cliente de pesquisa NetSuite expandido". Você também pode usar os botões + - ou setas para expandir todos os elementos da 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 realizará a pesquisa.

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

   

   Nota

   Os ícones de Response e Target 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 atualização for criada e salva em seu projeto.

Busca Avançada¶

Uma pesquisa avançada incluirá o objeto selecionado junto com quaisquer objetos relacionados e, na próxima tela, apresentará uma opção adicional para selecionar os campos específicos que você deseja consultar. Uma pesquisa avançada pode ser muito mais rápida que uma pesquisa básica ou pesquisa avançada, mesmo que você não queira consultar objetos relacionados, pois permite limitar a consultar a campos específicos no NetSuite.

O exemplo a seguir demonstra uma pesquisa avançada do objeto "Cliente" selecionado e objetos relacionados. No exemplo, também limitamos os campos retornados àqueles para os quais mapeamos durante a transformação da solicitação no exemplo NetSuite create, atualizar e upsert operações. Este exemplo retorna registros do objeto "Cliente" com um campo "lastModifiedDate" após "ontem". Este exemplo não consultar objetos relacionados, mas você pode fazer isso facilmente definindo os critérios de filtro da mesma forma que no objeto principal.

1. A tela Tipo de pesquisa do Assistente de pesquisa do NetSuite solicita que você selecione o tipo de pesquisa que deseja realizar. Selecione Pesquisa avançada e clique em Avançar para continuar.

2. A tela Build Query do NetSuite Search Wizard é onde você inserirá os critérios para sua pesquisa. Esta tela contém duas abas Selecionar colunas para retornar e Definir critérios de filtro, explicadas abaixo.

   • Selecionar colunas a serem retornadas: Nesta aba, selecione os campos dentro do(s) objeto(s) que deseja consultar. No exemplo selecionaremos todos os campos mapeados durante a transformação da solicitação no exemplo NetSuite create, atualizar e upsert operações.

     Nota

     Se houver um grande número de campos, talvez seja mais fácil encontrá-los usando o Filtro localizado abaixo da lista. Tenha cuidado ao selecionar o campo correto – No NetSuite pode haver vários campos com nomes semelhantes. Observe também que ao usar o filtro, todos os campos que você já selecionou permanecerão mostrados.

     

   • Definir critérios de filtro: Nesta aba, insira os critérios para sua pesquisa. Cada opção é explicada abaixo.

     

     • Especifique critérios para restringir sua pesquisa: No lado esquerdo da tela está o objeto selecionado e quaisquer objetos relacionados. Utilize as setas para expandir os campos do objeto que você deseja consultar. Por exemplo, expanda o objeto "Cliente" e selecione o campo "lastModifiedDate". Clique duas vezes no campo para adicionar uma condição ou selecione o campo e clique no botão Adicionar Condição.

     • Adicionar Condição: No pop-up Adicionar Condição, use o menu suspenso para selecionar um Operador. No exemplo escolheremos “depois”. Abaixo, selecione o botão de opção para Usar valor predefinido e selecione "ontem". Alternativamente, você pode especificar uma data exata conforme instruído na caixa de diálogo. Clique em Adicionar condição para continuar.

     • Condições Atuais: Um resumo das condições que você selecionou atualmente aparecerá como uma lista. Use os botões Editar ou Excluir para gerenciar a seleção atual.

       Nota

       Você pode adicionar qualquer número de condições à sua pesquisa simplesmente selecionando outro campo à esquerda e adicionando outra condição. Dessa forma, você pode criar efetivamente qualquer combinação de pesquisas de múltiplos registros.

     • Tamanho da página de pesquisa: Defina o número de registros por página, se necessário.

     • Consulta de teste: Clique no botão Consulta de teste no canto inferior direito para testar sua consultar. Para nosso exemplo usado durante o NetSuite create, atualizar e upsert, a consultar de teste indica que há três registros modificados desde ontem. Se os resultados parecerem corretos, clique em Concluir.

3. O Jitterbit prosseguirá com a criação de uma estrutura de resposta da API NetSuite que mostra a estrutura da resposta. Uma nova aba deve aparecer no Studio chamada NetSuite Searches. Você pode renomear sua atividade de pesquisa aqui, se desejar; no exemplo, o nosso é chamado de "Exemplo de cliente de pesquisa avançada do NetSuite ". Você também pode usar os botões + - ou setas para expandir todos os elementos da estrutura.

   

   Nota

   Em uma pesquisa avançada, observe que ao expandir o objeto (neste exemplo, a linha "Cliente" acima), você pode expandir ainda mais cada objeto para revelar propriedades adicionais. Dependendo do tipo de campo do objeto, as propriedades disponíveis no campo podem ser diferentes.

   Por exemplo, companyName é um campo de string e inclui as propriedades customLabel e searchValue. A propriedade searchValue conterá o resultado da consultar. No entanto, externalId é uma pesquisa e possui searchValues expansíveis, incluindo internalId, externalId, tipo e nome. Tenha em mente que ao fazer o mapeamento da transformação na próxima seção abaixo, pode ser necessário mapear propriedades diferentes dependendo do tipo.

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 realizará a pesquisa.

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

   

   Nota

   Os ícones de Response e Target 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 atualização for criada e salva em seu projeto.

Pesquisa Salva¶

Uma pesquisa salva é uma pesquisa reutilizável que você já definiu no NetSuite. Em vez de construir a pesquisa no Jitterbit, a pesquisa já está configurada no NetSuite e pode então ser puxada para o Jitterbit. Para obter informações adicionais sobre pesquisas salvas do NetSuite, consulte a documentação do NetSuite em Usando pesquisas salvas.

O exemplo a seguir demonstra o uso de uma pesquisa salva do NetSuite em uma operação Jitterbit. Neste exemplo, a consultar salva dentro do NetSuite retorna novos registros do objeto “Cliente” que foram criados na data de hoje.

1. A tela Tipo de pesquisa do Assistente de pesquisa do NetSuite solicita que você selecione o tipo de pesquisa que deseja realizar. Selecione Pesquisa salva e clique em Avançar para continuar.

2. A tela Build Query do NetSuite Search Wizard solicita que você selecione uma pesquisa salva para o objeto selecionado. Essas pesquisas são obtidas diretamente de sua instância NetSuite conectada. Selecione aquele que você deseja usar para sua consultar e clique em Testar consulta para ter certeza de que o número de registros é o esperado. Clique em Concluir para continuar.

   

   Nota

   Se este menu suspenso não estiver preenchido, mas você espera ver muitas pesquisas salvas, você pode estar atingindo o limite de 1.000 registros imposto pelo NetSuite em solicitações de API. Neste caso, consulte Limitações da pesquisa salva do NetSuite para confirmar a limitação e sugerir soluções alternativas.

3. O Jitterbit prosseguirá com a criação de uma estrutura de resposta da API NetSuite que mostra a estrutura da resposta. Uma nova aba deve aparecer no Studio chamada NetSuite Searches. Você pode renomear sua atividade de pesquisa aqui, se desejar; no exemplo, o nosso é chamado de "Exemplo de cliente de pesquisa NetSuite salvo". Você também pode usar os botões + - ou setas para expandir todos os elementos da estrutura.

   

   Nota

   Como em uma pesquisa avançada, em uma pesquisa salva, ao expandir o objeto (neste exemplo, a linha "Cliente" acima), você pode expandir ainda mais cada objeto para revelar propriedades adicionais. Dependendo do tipo de campo do objeto, as propriedades disponíveis no campo podem ser diferentes.

   Por exemplo, companyName é um campo de string e inclui as propriedades customLabel e searchValue. A propriedade searchValue conterá o resultado da consultar. No entanto, externalId é uma pesquisa e possui searchValues expansíveis, incluindo internalId, externalId, tipo e nome. Tenha em mente que ao fazer o mapeamento da transformação na próxima seção abaixo, pode ser necessário mapear propriedades diferentes dependendo do tipo.

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 realizará a pesquisa.

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

   

   Nota

   Os ícones de Response e Target 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 atualização 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 Resposta e Target.

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 Response e Target separadamente e arrastá-los e soltá-los da árvore à esquerda diretamente nos ícones na representação visual de 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.

Pesquisa Básica¶

A seguir, explicamos como definir os componentes Target e Response para a operação de pesquisa básica que foi usada como exemplo em Criando uma operação de pesquisa.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta da consultar do NetSuite em um arquivo CSV. Clique no botão Criar novo destino e atribua um Nome ao seu destino (por exemplo, CustomerBasicSearchResponse.csv). Neste exemplo, estamos usando um Agente Privado com arquivos locais habilitados, e assim selecionar um Tipo de "Arquivo Local" e depois Navegar até o local onde queremos salvar os dados. No exemplo, Folder é 'C:\NetSuiteSampleFiles' e Filename é 'CustomerBasicSearchResponse.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.

• 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 origem criada durante NetSuite Connector Create (ou seja, "Exemplo de arquivo simples do cliente"). 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

     Durante o mapeamento de transformação usado neste exemplo, um nó de loop tornou-se presente no elemento "addressbook", conforme indicado pela localização da linha preta grossa mostrada abaixo. Qualquer elemento de dados que possa ter vários registros, como "addressbook" em NetSuite, pode fazer com que o nó do loop saia desse objeto em vez do objeto principal, como Customer.

     

     Nota

     Para corrigir o nó do loop, neste exemplo especificamos em um script para usar o primeiro registro apenas adicionando '#1' após o nó do loop no nome da variável de campo. As alternativas incluem especificar uma lógica personalizada para obter o endereço de cobrança ou entrega padrão ou modificar sua estrutura de dados de destino para também oferecer suporte a vários endereços.

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

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$addr1$
       </trans>
       

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

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$city$
       </trans>
       

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

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$state$
       </trans>
       

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

       <trans>
       searchResponse$searchResult$recordList$record.Customer$addressbookList$addressbook#1.addressbookAddress$zip$
       </trans>
       

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

     

Pesquisa Expandida¶

A seguir, explicamos como definir os componentes Target e Response para a operação de pesquisa expandida que foi usada como exemplo em Criando uma operação de pesquisa.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta da consultar do NetSuite em um arquivo CSV. Clique no botão Criar novo destino e atribua um Nome ao seu destino (por exemplo, CustomerExpandedSearchResponse.csv). Neste exemplo, estamos usando um Agente Privado com arquivos locais habilitados, e assim selecionar um Tipo de "Arquivo Local" e depois Navegar até o local onde queremos salvar os dados. No exemplo, Folder é 'C:\NetSuiteSampleFiles' e Filename é 'CustomerExpandedSearchResponse.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.

• 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, precisaremos criar uma nova definição de formato de arquivo porque a pesquisa expandida inclui um campo adicional para Contato não usado nos outros exemplos.

     Para criar o novo formato de arquivo, selecione 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 com contato"). Podemos começar com uma definição de texto baseada em nosso arquivo CSV existente usado para os outros exemplos e depois adicionar o campo adicional. Para fazer isso, selecione Criar do arquivo e, no pop-up, navegue até o arquivo local 'CustomerCreateRequest.csv'. Na próxima tela, clique em Novo e adicione um campo adicional chamado “Contato” à definição do formato do arquivo.

     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

     Durante o mapeamento de transformação usado neste exemplo, um nó de loop tornou-se presente tanto no elemento "addressbook" quanto no elemento "contact", conforme indicado pela localização das linhas pretas grossas. Para corrigir os nós do loop, neste exemplo especificamos em um script para usar o primeiro registro apenas adicionando '#1' após o nó do loop no nome da variável do campo. O '#1' foi adicionado no script nos campos Endereço, Cidade, Estado, CEP e Contato de destino. Para obter instruções mais explícitas sobre como fazer isso, consulte o exemplo fornecido na Pesquisa Básica acima, que também apresentou um problema de nó de loop, ou faça referência ao mapeamento final no Jitterpak.

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

     

Busca Avançada¶

A seguir, explicamos como definir os componentes Target e Response para a operação de pesquisa avançada que foi usada como exemplo em Criando uma operação de pesquisa.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta da consultar do NetSuite em um arquivo CSV. Clique no botão Criar novo destino e atribua um Nome ao seu destino (por exemplo, CustomerAdvancedSearchResponse.csv). Neste exemplo, estamos usando um Agente Privado com arquivos locais habilitados, e assim selecionar um Tipo de "Arquivo Local" e depois Navegar até o local onde queremos salvar os dados. No exemplo, a Pasta é 'C:\NetSuiteSampleFiles' e o Nome do arquivo é 'CustomerAdvancedSearchResponse.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.

• 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 origem criada durante NetSuite Connector Create (ou seja, "Exemplo de arquivo simples do cliente"). 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. Observe que do lado da origem você só tem os campos que selecionou na pesquisa. Em seguida, arraste e solte cada campo que deseja mapear de uma árvore para outra.

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

     

Pesquisa Salva¶

A seguir, explicamos como definir os componentes Target e Response para a operação de pesquisa salva que foi usada como exemplo em Criando uma operação de pesquisa.

• Alvo: clique duas vezes no ícone Alvo. No exemplo, registraremos a resposta da consultar do NetSuite em um arquivo CSV. Clique no botão Criar novo destino e atribua um Nome ao seu destino (por exemplo, CustomerSavedSearchResponse.csv). Neste exemplo, estamos usando um Agente Privado com arquivos locais habilitados, e assim selecionar um Tipo de "Arquivo Local" e depois Navegar até o local onde queremos salvar os dados. No exemplo, Folder é 'C:\NetSuiteSampleFiles' e Filename é 'CustomerSavedSearchResponse.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.

• 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 origem criada durante NetSuite Connector Create (ou seja, "Exemplo de arquivo simples do cliente"). 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.

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

     

Implantando e Executando a Operação¶

Com a atividade de pesquisa 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\' com o nome do tipo de pesquisa realizada. O arquivo deve conter dados para sua pesquisa específica em cada coluna mapeada para o arquivo de saída.