Atividade de pesquisa do NetSuite

Introdução

Uma atividade NetSuite Search recupera registros existentes do NetSuite e tem a intenção de ser usada como uma fonte para fornecer dados a uma operação. Após configurar uma conexão NetSuite, você pode configurar quantas atividades NetSuite quiser para cada conexão NetSuite.

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

• Pesquisa básica: Filtra todos os campos disponíveis para um objeto selecionado.
• Busca Expandida: Filtra todos os campos disponíveis para um objeto selecionado e objetos relacionados. O objeto selecionado deve ter objetos relacionados.
• Busca Avançada: Filtra em uma coluna específica para um objeto selecionado e objetos relacionados, e é mais rápido do que uma busca 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 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 Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade existente pode ser editada a partir destes locais:

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

Configurar uma atividade de pesquisa do NetSuite

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

• Etapa 1: Insira 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: insira um nome e selecione um objeto

• Nome: Insira um nome a ser usado para identificar a atividade do NetSuite Search. O nome deve ser exclusivo para cada atividade do NetSuite Search e não deve conter barras (/) ou dois pontos (:).

• Selecione um objeto: Esta seção exibe objetos disponíveis no endpoint do NetSuite. Ao reabrir uma configuração de atividade existente, somente o objeto selecionado é exibido em vez de recarregar a lista inteira de objetos.

  • Objeto NetSuite selecionado: Depois que um objeto é selecionado, ele é listado aqui.

  • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de objetos. A pesquisa 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 ao pesquisar, insira os critérios de pesquisa e atualize, conforme descrito abaixo.

  • Atualizar: Clique no ícone de atualização ou a palavra Refresh para recarregar objetos do endpoint do 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 exibida 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 obtidas do endpoint do 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 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.

    • Tipo: O tipo de objeto do NetSuite. Isso inclui todos os objetos padrão, de transação (tran), de item e personalizados que estão disponíveis para pesquisa no endpoint do 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. Certifique-se de que você esteja conectado reabrindo a conexão e testando novamente as credenciais.

• 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 continuar 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 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

• Selecione o tipo de pesquisa: Selecione o tipo de pesquisa a ser realizada:

  • Pesquisa básica: Filtra apenas no 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.

  • Busca Expandida: Filtra no objeto selecionado e objetos relacionados. Este tipo de busca sempre retorna todos os campos disponíveis para o objeto selecionado e objetos relacionados, e pode ser selecionado somente para objetos que tenham objetos relacionados no NetSuite. Por exemplo, uma busca expandida para o Transaction objeto também inclui objetos relacionados adicionais no NetSuite, como accountJoin, caseJoin, opportunityJoin, purchaseOrderJoin, userJoin, etc. Para obter detalhes, consulte Pesquisa expandida abaixo.

  • Busca Avançada: Filtra o objeto selecionado e objetos relacionados. Este tipo de busca retorna resultados somente para uma coluna específica e pode ser selecionado somente para objetos que tenham objetos relacionados no NetSuite. Uma busca avançada pode ser muito mais rápida do que uma busca básica ou uma busca expandida, mesmo se você não quiser consultar objetos relacionados, porque ela permite que você limite a consultar a campos específicos no NetSuite. Para detalhes, veja Busca avançada abaixo.

    Aviso

    Em uma pesquisa avançada, segmentos personalizados do tipo Lista/Registro 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 (pesquisas 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: Filtros usando uma pesquisa reutilizável que você já definiu no NetSuite. Esse tipo de pesquisa pode ser selecionado apenas para objetos que suportam pesquisas salvas do NetSuite. Em vez de construir a pesquisa dentro do Jitterbit, a pesquisa já está configurada dentro do NetSuite e pode então ser puxada para o Harmony. Para obter informações adicionais sobre pesquisas salvas do NetSuite, consulte a documentação do NetSuite em Usando pesquisas salvas. 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 somente quando o objeto selecionado na etapa anterior é o Transaction ou Item objeto. Isso se aplica somente aos objetos com um Nome de Transaction ou Item e não se aplica geralmente em 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 à etapa anterior e armazenar temporariamente a configuração.

• Próximo: Clique para continuar 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 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 3: Selecione campos e crie condições

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

• Pesquisa básica
• Pesquisa expandida
• Pesquisa avançada
• Pesquisa salva

Pesquisa básica

Se uma Pesquisa Básica foi selecionada em etapa 2, esta interface é apresentada:

• Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.

• Especifique critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível dentro do objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações do objeto e do campo para Junção selecionada e Campo selecionado, respectivamente.

• Adicionar condição: Selecione um campo à esquerda para preencher os campos Junçã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 quaisquer seleções apropriadas ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado se você já tiver adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Quando concluído, clique no botão Adicionar condição na caixa de diálogo para adicionar o campo à tabela Condições atuais.

  

  Dica

  Se estiver pesquisando dentro de um objeto status campo, os valores de pesquisa que correspondem aos status internos do 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.
  • Operador: 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 ícones de 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 quaisquer seleções para a condição.
    • Excluir: Clique no ícone de remoção para remover uma condição da tabela Condições Atuais.

  Dica

  Você pode adicionar qualquer número de condições à sua pesquisa. Dessa forma, você pode efetivamente criar qualquer combinação de pesquisas de múltiplos registros.

• Consulta de teste: 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, mensagens de erro relevantes serão exibidas.

  

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

• Próximo: Clique para continuar 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme se deseja descartar as alterações.

Pesquisa expandida

Se uma Busca Expandida foi selecionada em etapa 2, esta interface é apresentada:

• Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.

• Especifique critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível dentro do objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações do objeto e do campo para Junção selecionada e Campo selecionado, respectivamente.

• Adicionar condição: Selecione um campo à esquerda para preencher os campos Junçã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 quaisquer seleções apropriadas ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado se você já tiver adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Quando concluído, 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 estiver pesquisando dentro de um objeto status campo, os valores de pesquisa que correspondem aos status internos do 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.
  • Operador: 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 ícones de 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 quaisquer seleções para a condição.
    • Excluir: Clique no ícone de remoção para remover uma condição da tabela Condições Atuais.

  Dica

  Você pode adicionar qualquer número de condições à sua pesquisa. Dessa forma, você pode efetivamente criar qualquer combinação de pesquisas de múltiplos registros.

• Test Query: 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, mensagens de erro relevantes serão exibidas. (Consulte a documentação sobre pesquisa básica para uma captura de tela dos resultados da consultar.)

  Cuidado

  As pesquisas expandidas devem incluir uma consultar sobre um objeto relacionado, ou o botão Test Query será desabilitado. Se a pesquisa for sobre o mesmo objeto, use uma pesquisa básica.

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

• Próximo: Clique para continuar 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 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.

Pesquisa avançada

Se uma Pesquisa Avançada foi selecionada em etapa 2, esta interface é apresentada:

Nesta etapa, diferentes opções de configuração são mostradas dependendo se Colunas Selecionadas para Retornar ou Definir Critérios de Filtro está selecionado.

• Selecionar colunas para retornar: Quando esta opção é selecionada, as colunas a serem retornadas podem ser especificadas:

  

  • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.

  • Selecionar colunas para retornar: Selecione as caixas de seleção dos campos específicos para incluir na pesquisa. Você também pode selecionar um objeto inteiro para selecionar todos os seus campos de uma vez.

• Definir critérios de filtro: Quando esta opção é selecionada, os critérios de filtro a serem usados na pesquisa podem ser especificados:

  

  • Pesquisar: Insira qualquer valor de coluna na caixa de pesquisa para filtrar a lista de campos para o objeto selecionado e quaisquer objetos relacionados. A pesquisa não diferencia maiúsculas de minúsculas. Os resultados listados são filtrados em tempo real a cada pressionamento de tecla.

  • Especifique critérios para restringir sua pesquisa: Um de cada vez, clique em um campo disponível dentro do objeto selecionado para selecionar o campo. Quando você seleciona um campo, a área Adicionar condição é preenchida com as informações do objeto e do campo para Junção selecionada e Campo selecionado, respectivamente.

• Adicionar condição: Selecione um campo à esquerda para preencher os campos Junçã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 quaisquer seleções apropriadas ou entrada do usuário para o campo selecionado. (O botão Adicionar condição é desabilitado se você já tiver adicionado o número máximo de condições permitidas pelo NetSuite WSDL.) As opções apresentadas variam dependendo do campo selecionado. Quando concluído, 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 estiver pesquisando dentro de um objeto status campo, os valores de pesquisa que correspondem aos status internos do 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.
    • Operador: 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 ícones de 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 quaisquer seleções para a condição.
      • Excluir: Clique no ícone de remoção para remover uma condição da tabela Condições Atuais.

    Dica

    Você pode adicionar qualquer número de condições à sua pesquisa. Dessa forma, você pode efetivamente criar qualquer combinação de pesquisas de vários registros.

• Test Query: 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, mensagens de erro relevantes serão exibidas. (Consulte a documentação sobre pesquisa básica para uma captura de tela dos resultados da consultar.)

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

• Próximo: Clique para continuar 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 alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.

Pesquisa salva

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

• Selecione uma pesquisa salva para a conta: Use o menu suspenso para selecionar uma pesquisa salva existente do NetSuite para o objeto selecionado.

  Aviso

  Ao pesquisar em um objeto com mais de 1.000 pesquisas salvas, pode parecer que não há pesquisas salvas disponíveis no objeto (devido a um limite de 1.000 registros imposto NetSuite em solicitações de API). Como solução alternativa, use a opção Fornecer ID do Script de pesquisa salva (descrita abaixo).

• Fornecer ID do Script de pesquisa salva: Selecione para especificar uma pesquisa salva com seu ID de script. Esta opção pode ser usada para superar uma limitação da API do NetSuite, onde a seleção suspensa Selecionar uma pesquisa salva é limitada a 1.000 pesquisas salvas. Quando selecionado, este campo é habilitado:

  • ID do script de pesquisa salvo: Insira o ID do script para a pesquisa salva.

• Test Query: 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, mensagens de erro relevantes serão exibidas.

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

• Próximo: Clique para continuar 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 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 4: Revise os esquemas de dados

• Data Schema: 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 personalizados e muito mais.

  O conector NetSuite usa a API de serviços 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 do 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 à etapa 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 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.

Próximos passos

Após configurar uma atividade do NetSuite Search, 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 configurar 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 do NetSuite Search é criada, as ações de menu para essa atividade são acessíveis no painel do projeto nas guias Workflows ou Components e na quadro de design. Consulte menu de ações da atividade para mais detalhes.

As atividades do NetSuite Search podem ser usadas como uma 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 segunda fonte)
• Padrão de duas transformações (como primeira ou segunda fonte)

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

Outros padrões não são válidos usando atividades do NetSuite Search. Veja os padrões de validação em Validade da operação página.

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.