Atividade de Pesquisa do NetSuite¶

Introdução¶

Uma atividade NetSuite Search recupera registros existentes do NetSuite e destina-se a ser usada como uma fonte para fornecer dados para uma operação. Depois de configurar uma conexão NetSuite, você pode configurar quantas atividades NetSuite desejar para cada conexão NetSuite.

Em uma atividade de Pesquisa do NetSuite, você pode configurar estes tipos de pesquisas:

Busca Básica: Filtra todos os campos disponíveis para um objeto selecionado.
Pesquisa expandida: Filtra todos os campos disponíveis para um objeto selecionado e objetos relacionados. O objeto selecionado deve ter objetos relacionados.
Pesquisa avançada: Filtra em uma coluna específica um objeto selecionado e objetos relacionados e é mais rápido que uma pesquisa básica ou expandida. O objeto selecionado deve ter objetos relacionados.
Pesquisa Salva: Usa uma pesquisa reutilizável que você já definiu no NetSuite.

Criar uma Atividade do NetSuite¶

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 componente.

Uma atividade existente pode ser editada a partir destes locais:

A quadro de design (consulte Menu de ações do componente em Quadro de Design).
A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).

Configurar uma Atividade de Pesquisa do NetSuite¶

Siga estas etapas para configurar uma atividade de pesquisa do NetSuite:

Etapa 1: Digite um nome e selecione um objeto
Etapa 2: selecione um tipo de pesquisa
Etapa 3: Selecione Campos e Crie Condições
Etapa 4: Revise os Esquemas de Dados

Etapa 1: Digite um Nome e Selecione um Objeto¶

Nome: Digite um nome a ser usado para identificar a atividade de pesquisa do NetSuite. O nome deve ser exclusivo para cada atividade de pesquisa do NetSuite e não deve conter barras (/) ou dois pontos (:).
Selecione um objeto: Esta seção exibe os objetos disponíveis no endpoint NetSuite. Ao reabrir uma configuração de atividade existente, apenas o objeto selecionado é exibido em vez de recarregar toda a lista de objetos.
- Objeto NetSuite selecionado: Depois que um objeto é selecionado, ele é listado aqui.
- Pesquisar: Digite qualquer parte do nome do objeto na caixa de pesquisa para filtrar a lista de objetos. A busca não diferencia maiúsculas de minúsculas. Se os objetos já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada pressionamento de tecla. Para recarregar objetos do endpoint durante a pesquisa, insira os critérios de pesquisa e atualize, conforme descrito abaixo.
- Atualizar: Clique no ícone de atualização ou a palavra Atualizar para recarregar objetos do endpoint NetSuite. Isso pode ser útil se você adicionou recentemente objetos ou campos ao NetSuite. Esta ação atualiza todos os metadados usados para construir a tabela de objetos exibidos na configuração.
- Selecionando um objeto: Dentro da tabela, clique em qualquer lugar em uma linha para selecionar um objeto. Apenas um objeto pode ser selecionado. As informações disponíveis para cada objeto são buscadas no endpoint NetSuite:
  - Nome: O nome do objeto do NetSuite.
    
    Nota
    
    Se selecionar o Transaction ou Item objeto diretamente, você pode especificar subtipos na etapa 2. Isso se aplica somente aos objetos com um Nome de Transaction ou Item e não se aplica geralmente a todos os objetos com um Tipo de transação (tran) ou item.
  - Tipo: O tipo de objeto do NetSuite. Isso inclui todos os objetos padrão, transação (tran), item e personalizados que estão disponíveis para pesquisa no endpoint NetSuite.
  - Descrição do Objeto: A descrição do objeto do NetSuite.
  Dica
  
  Se a tabela não for preenchida com objetos disponíveis, a conexão NetSuite pode não ser bem-sucedido. Verifique se você está conectado reabrindo a conexão e testando novamente as credenciais.
  - Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
  - Next: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. A configuração não é salva até que você clique no botão Concluído na última etapa.
  - 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.

Etapa 2: Selecione um Tipo de Pesquisa¶

Selecionar tipo de pesquisa: Selecione o tipo de pesquisa a ser realizada:
- Busca Básica: Filtra apenas o objeto selecionado. Este tipo de pesquisa sempre retorna todos os campos disponíveis para o objeto selecionado. Por exemplo, uma pesquisa básica para o Transaction objeto consulta todos os campos no Transaction objeto. Para obter detalhes, consulte Pesquisa básica abaixo.
- Pesquisa expandida: Filtra o objeto selecionado e objetos relacionados. Este tipo de pesquisa sempre retorna todos os campos disponíveis para o objeto selecionado e objetos relacionados, podendo ser selecionado apenas para objetos que possuam objetos relacionados no NetSuite. Por exemplo, uma pesquisa expandida para o Transaction O objeto também inclui objetos relacionados adicionais no NetSuite, como accountJoin, caseJoin, opportunityJoin, purchaseOrderJoin, userJoin, etc. Para obter detalhes, consulte Pesquisa expandida abaixo.
- Pesquisa Avançada: Filtra o objeto selecionado e objetos relacionados. Este tipo de pesquisa retorna resultados apenas para uma coluna específica e pode ser selecionada apenas para objetos que tenham objetos relacionados no NetSuite. Uma pesquisa avançada pode ser muito mais rápida do que uma pesquisa básica ou pesquisa expandida, mesmo que você não queira consultar objetos relacionados, pois permite limitar a consultar a campos específicos no NetSuite. Para obter detalhes, consulte Pesquisa Avançada abaixo.
  
  Aviso
  
  Em uma pesquisa avançada, segmentos personalizados do tipo List/Record conforme definido no NetSuite não são suportados. No entanto, o tipo Seleção Múltipla é suportado em uma pesquisa avançada. Essa limitação não se aplica a outros tipos de pesquisas do NetSuite (buscas básicas, expandidas e salvas), que suportam os tipos Lista/Registro e Seleção Múltipla. Para obter mais informações, consulte Segmentos personalizados do NetSuite.
- Pesquisa salva: Filtra usando uma pesquisa reutilizável que você já definiu no NetSuite. Este tipo de pesquisa pode ser selecionado apenas para objetos que suportam pesquisas salvas do NetSuite. Em vez de criar a pesquisa no Jitterbit, a pesquisa já está configurada no NetSuite e pode ser puxada para o Harmony. Para obter informações adicionais sobre as pesquisas salvas do NetSuite, consulte a documentação do NetSuite em Using Saved Searches. Para obter detalhes, consulte Pesquisa salva abaixo.
Selecione Subtipos para Pesquisa de Item ou Transação. Você deve selecionar pelo menos um quando aplicável: Esta seção é exibida apenas quando o objeto selecionado na etapa anterior é o Transaction ou Item objeto. Isso se aplica apenas aos objetos com um Nome de Transaction ou Item e não se aplica geralmente a todos os objetos com um Tipo de transação (tran) ou item. Se esta seção for exibida, use a caixa de seleção Selecionar todos os objetos para selecionar todos os subtipos a serem incluídos na pesquisa ou selecione cada subtipo individualmente.
Voltar: Clique para retornar ao passo anterior e armazenar temporariamente a configuração.
Avançar: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. 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 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.

Passo 3: Selecione Campos e Crie Condições¶

A interface utilizada nesta etapa da configuração de uma atividade NetSuite Search depende do tipo de pesquisa selecionado na etapa anterior:

Pesquisa básica
Pesquisa expandida
Busca Avançada
Pesquisa salva

Pesquisa Básica¶

Se uma pesquisa básica foi selecionada na etapa 2, esta interface é apresentada:

Pesquisar: Digite qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real com cada pressionamento de tecla.
Especificar critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível no objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações de campo e objeto para União selecionada e Campo selecionado, respectivamente.
Adicionar condição: Selecione um campo à esquerda para preencher os campos União selecionada e Campo selecionado na seção Adicionar condição à direita. Em seguida, clique no botão Adicionar condição para abrir uma caixa de diálogo para qualquer seleção apropriada ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado caso você já tenha adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Ao concluir, clique no botão Adicionar condição na caixa de diálogo para adicionar o campo à tabela Condições atuais.

Dica

Se pesquisar dentro de um objeto status campo, os valores de pesquisa que correspondem aos status internos no NetSuite são fornecidos para sua conveniência em uma lista em Pesquisando por status no NetSuite. Para valores de pesquisa a serem inseridos em outros campos, consulte a documentação do NetSuite.
Condições atuais: Conforme você seleciona campos e adiciona condições usando os métodos descritos acima, esta tabela é preenchida com um resumo dos objetos e campos selecionados. Estas colunas são exibidas na tabela:
- Objeto: O objeto NetSuite selecionado.
- Campo: O campo NetSuite selecionado.
- Operator: O operador usado para a pesquisa, se houver.
- Valor de pesquisa: O primeiro valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
- Valor de pesquisa 2: O segundo valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
- Ações: Na coluna Ações, passe o mouse sobre uma linha para mostrar os ícones das ações que você pode realizar na linha:
  - Editar: Clique no ícone de edição para reabrir a caixa de diálogo Adicionar condição, onde você pode editar qualquer seleção para a condição.
  - Excluir: Clique no ícone de remoção para remover uma condição da tabela Current Conditions.
Dica

Você pode adicionar qualquer número de condições à sua pesquisa. Desta forma, você pode efetivamente criar qualquer combinação de várias pesquisas de registro.
Test Query: Clique para validar a consultar. Se a consultar for válida, um resumo dos resultados da pesquisa será exibido em uma mensagem informativa semelhante à mostrada abaixo. Se a consultar não for válida, serão exibidas mensagens de erro relevantes.
Voltar: Clique para retornar ao passo anterior e armazenar temporariamente a configuração.
Next: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. A configuração não é salva até que você clique no botão Concluído na última etapa.
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.

Pesquisa Expandida¶

Se uma pesquisa expandida foi selecionada na etapa 2, esta interface é apresentada:

Pesquisar: Digite qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real com cada pressionamento de tecla.
Especificar critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível no objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações de campo e objeto para União selecionada e Campo selecionado, respectivamente.
Adicionar condição: Selecione um campo à esquerda para preencher os campos União selecionada e Campo selecionado na seção Adicionar condição à direita. Em seguida, clique no botão Adicionar condição para abrir uma caixa de diálogo para qualquer seleção apropriada ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado caso você já tenha adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Ao concluir, clique no botão Adicionar condição na caixa de diálogo para adicionar o campo à tabela Condições atuais. (Consulte a documentação sobre pesquisa básica para uma captura de tela desta caixa de diálogo.)

Dica

Se pesquisar dentro de um objeto status campo, os valores de pesquisa que correspondem aos status internos no NetSuite são fornecidos para sua conveniência em uma lista em Pesquisando por status no NetSuite. Para valores de pesquisa a serem inseridos em outros campos, consulte a documentação do NetSuite.
Condições atuais: Conforme você seleciona campos e adiciona condições usando os métodos descritos acima, esta tabela é preenchida com um resumo dos objetos e campos selecionados. Estas colunas são exibidas na tabela:
- Objeto: O objeto NetSuite selecionado.
- Campo: O campo NetSuite selecionado.
- Operator: O operador usado para a pesquisa, se houver.
- Valor de pesquisa: O primeiro valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
- Valor de pesquisa 2: O segundo valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
- Ações: Na coluna com um ícone de menu de ações , passe o mouse sobre uma linha para mostrar os ícones das ações que você pode realizar na linha:
  - Editar: Clique no ícone de edição para reabrir a caixa de diálogo Adicionar condição, onde você pode editar qualquer seleção para a condição.
  - Excluir: Clique no ícone de remoção para remover uma condição da tabela Current Conditions.
Dica

Você pode adicionar qualquer número de condições à sua pesquisa. Desta forma, você pode efetivamente criar qualquer combinação de várias pesquisas de registro.
Consulta de teste: Clique para validar a consultar. Se a consultar for válida, um resumo dos resultados da pesquisa será exibido. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. (Consulte a documentação sobre pesquisa básica para obter uma captura de tela dos resultados da consultar.)

Cuidado

Pesquisas expandidas devem incluir uma consultar sobre um objeto relacionado ou o botão Test Query será desativado. Se a pesquisa for sobre o mesmo objeto, use uma pesquisa básica.
Voltar: Clique para retornar ao passo anterior e armazenar temporariamente a configuração.
Next: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. A configuração não é salva até que você clique no botão Concluído na última etapa.
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.

Busca Avançada¶

Se uma pesquisa avançada foi selecionada na etapa 2, esta interface é apresentada:

Nesta etapa, diferentes opções de configuração são mostradas dependendo se Selected Columns to Return ou Define Filter Criteria está selecionado.

Aviso

Embora esses botões de opção possam fazer parecer que você deve selecionar uma opção ou outra, eles são na verdade duas especificações diferentes, e ambas precisam ser revisadas e configuradas. Certifique-se de selecionar cada um para configurar as opções em cada tela.

Selecionar Colunas a Retornar: Quando esta opção é selecionada, as colunas a serem retornadas podem ser especificadas:
- Pesquisar: Digite qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real com cada pressionamento de tecla.
- Selecionar colunas para retornar: Marque as caixas de seleção dos campos específicos a serem incluídos na pesquisa. Você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma vez.
Definir Critérios de Filtro: Ao selecionar esta opção, pode-se especificar os critérios de filtro a serem utilizados na busca:
- Pesquisar: Digite qualquer parte do nome do campo na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A busca não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real com cada pressionamento de tecla.
- Especificar critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível no objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações de campo e objeto para União selecionada e Campo selecionado, respectivamente.
Adicionar condição: Selecione um campo à esquerda para preencher os campos União selecionada e Campo selecionado na seção Adicionar condição à direita. Em seguida, clique no botão Adicionar condição para abrir uma caixa de diálogo para qualquer seleção apropriada ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado caso você já tenha adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Ao concluir, clique no botão Adicionar condição na caixa de diálogo para adicionar o campo à tabela Condições atuais. (Consulte a documentação sobre pesquisa básica para uma captura de tela desta caixa de diálogo.)
```
!!! tip "Dica"
    Se pesquisar dentro de um objeto `status` campo, os valores de pesquisa que correspondem aos status internos no NetSuite são fornecidos para sua conveniência em uma lista em [Pesquisando por status no NetSuite](/pt/cloud-studio/cloud-studio-reference/connectors/netsuite/netsuite-how-tos/search-by-status-in-netsuite). Para valores de pesquisa a serem inseridos em outros campos, consulte a documentação do NetSuite.
```
- Condições atuais: Conforme você seleciona campos e adiciona condições usando os métodos descritos acima, esta tabela é preenchida com um resumo dos objetos e campos selecionados. Estas colunas são exibidas na tabela:
  - Objeto: O objeto NetSuite selecionado.
  - Campo: O campo NetSuite selecionado.
  - Operator: O operador usado para a pesquisa, se houver.
  - Valor de pesquisa: O primeiro valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
  - Valor de pesquisa 2: O segundo valor de pesquisa inserido como entrada ao adicionar a condição, se houver.
  - Ações: Na coluna com um ícone de menu de ações , passe o mouse sobre uma linha para mostrar os ícones das ações que você pode realizar na linha:
    - Editar: Clique no ícone de edição para reabrir a caixa de diálogo Adicionar condição, onde você pode editar qualquer seleção para a condição.
    - Excluir: Clique no ícone de remoção para remover uma condição da tabela Current Conditions.
  Dica
  
  Você pode adicionar qualquer número de condições à sua pesquisa. Desta forma, você pode efetivamente criar qualquer combinação de várias pesquisas de registro.
Consulta de teste: Clique para validar a consultar. Se a consultar for válida, um resumo dos resultados da pesquisa será exibido. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. (Consulte a documentação sobre pesquisa básica para obter uma captura de tela dos resultados da consultar.)
Voltar: Clique para retornar ao passo anterior e armazenar temporariamente a configuração.
Avançar: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. A configuração não é salva até que você clique no botão Concluído na última etapa.
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.

Pesquisa Salva¶

Se uma Pesquisa salva foi selecionada na etapa 2, esta interface é apresentada:

Selecionar uma pesquisa salva: Use o menu suspenso para selecionar uma pesquisa salva do NetSuite que já existe no endpoint do NetSuite para o objeto selecionado.

Aviso

Se estiver pesquisando em um objeto com mais de 1.000 pesquisas salvas, pode parecer que não há pesquisas salvas disponíveis no objeto. Para obter mais informações, incluindo uma solução alternativa, consulte NetSuite Saved Search Limits.
Consulta de teste: Clique para validar a consultar. Se a consultar for válida, um resumo dos resultados da pesquisa será exibido. Se a consultar não for válida, serão exibidas mensagens de erro relevantes.
Voltar: Clique para retornar ao passo anterior e armazenar temporariamente a configuração.
Next: Clique para passar para a próxima etapa e armazenar temporariamente a configuração. A configuração não é salva até que você clique no botão Concluído na última etapa.
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.

Etapa 4: Revisar os Esquemas de Dados¶

Esquema de Dados: O esquema de dados de resposta para NetSuite é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente durante o processo de mapeamento de transformação, onde você pode mapear para campos de destino usando objetos de origem, scripts, variáveis, valores customizados e muito mais.

O conector NetSuite usa a API de serviços da web SOAP da versão do NetSuite WSDL que você configurou. Isso é especificado durante a configuração da conexão NetSuite. Consulte a documentação fornecida no NetSuite Help Center para obter informações sobre os campos de esquema.

Nota

Para atualizar um esquema de dados em uma atividade existente, você deve avançar por cada etapa de configuração da atividade novamente, 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 retornar ao passo anterior e armazenar temporariamente a configuração.
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 de pesquisa do NetSuite, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da 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 estão no mesmo ou em workflows diferentes.

Após a criação de uma atividade de pesquisa do NetSuite, as ações de menu para essa atividade podem ser acessadas 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 do NetSuite Search podem ser usadas como fonte com estes padrões de operação:

Padrão de arquivo
Padrão de transformação
Padrão de arquivo de dois alvos (como a primeira ou a segunda fonte)
Padrão de duas transformações (como a primeira ou a segunda fonte)

As operações que contêm uma atividade NetSuite podem ter apenas uma atividade NetSuite e também não podem conter nenhum Salesforce, Salesforce Service Cloud, SAP, ServiceMax ou SOAP Atividades.

Outros padrões não são válidos usando as atividades de pesquisa do NetSuite. Veja os padrões de validação na Validade da Operação página.

Um caso de uso típico é usar uma atividade de pesquisa do NetSuite no Padrão de Transformação. Neste exemplo, a atividade NetSuite Search (Search) fornece dados dentro da operação que são passados para a transformação (Search to Variable). A atividade Variable Write (Write Search Response) é usada como destino, recebendo dados dentro da operação e uma mensagem é registrada pelo script Write to Operation Log:

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 da operação.