Atividade de Pesquisa do NetSuite¶

Introdução¶

Uma atividade NetSuite Search recupera registros existentes do NetSuite e deve ser usada como 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 NetSuite Search, você pode configurar estes tipos de pesquisas:

• Pesquisa 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ápida 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.

Crie 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 Criando uma instância de atividade em Reutilização de componentes.

Uma atividade existente pode ser editada nestes locais:

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

Configurar uma Atividade de Pesquisa do NetSuite¶

Siga estas etapas para configurar uma atividade do NetSuite Search:

• 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: 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 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: Insira o valor de qualquer coluna 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 Refresh 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: Na tabela, clique em qualquer lugar de uma linha para selecionar um objeto. Apenas um objeto pode ser selecionado. As informações disponíveis para cada objeto são obtidas 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 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 é 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.

  • 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 possuem objetos relacionados no NetSuite. Por exemplo, uma pesquisa expandida para o Transaction object 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, podendo ser selecionada apenas para objetos que possuem objetos relacionados no NetSuite. Uma pesquisa avançada pode ser muito mais rápida que uma pesquisa básica ou 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 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. Esta 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: 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 construir a pesquisa no Jitterbit, a pesquisa já está configurada no 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 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 em etapa 2, esta interface é apresentada:

• Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos do objeto selecionado. A busca 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 no 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 fica 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 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: À medida que 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 criar efetivamente 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, serão exibidas mensagens de erro relevantes.

  

• 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 o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos do 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 a cada pressionamento de tecla.

• Especifique 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 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 fica 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. (Veja 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: À medida que 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 criar efetivamente 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. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. (Veja a documentação sobre pesquisa básica para uma captura de tela dos resultados da consultar.)

  Cuidado

  As pesquisas expandidas devem incluir uma consultar em um objeto relacionado ou o botão Testar consulta será desativado. 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 é 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 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 a serem retornadas: Quando esta opção é selecionada, as colunas a serem retornadas podem ser especificadas:

  

  • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos do 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 a cada pressionamento de tecla.

  • Selecionar colunas para retornar: Marque 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 só vez.

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

  

  • Pesquisar: Insira o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de campos do 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 a cada pressionamento de tecla.

  • Especifique 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 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 fica 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. (Veja 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: À medida que 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 criar efetivamente 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. Se a consultar não for válida, serão exibidas mensagens de erro relevantes. (Veja 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 que 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 pelo 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 NetSuite onde a seleção suspensa Selecionar uma pesquisa salva é limitada a 1.000 pesquisas salvas. Quando selecionado este campo fica habilitado:

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

• 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 à 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 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: Revise os Esquemas de Dados¶

• Esquema de dados: O esquema de dados de resposta do NetSuite é exibido. Se a operação usar uma transformação, os esquemas de dados serão exibidos novamente durante o processo de mapeamento da transformação, onde você poderá 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 na Central de Ajuda do NetSuite para obter informações sobre os campos do esquema.

  Nota

  Para atualizar um esquema de dados em uma atividade existente, você deve avançar novamente em cada etapa de configuração da atividade, 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 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 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 definir 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 for criada, as ações de menu para essa atividade estarão acessíveis 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 segunda fonte)
• Padrão de duas transformações (como a primeira ou a segunda fonte)

As operações que contêm uma atividade do NetSuite podem ter apenas uma atividade do NetSuite e também 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 na página 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.