Ir para o conteúdo

Guia de conexão do NetSuite para o Jitterbit App Builder

Visão geral

Este guia descreve os requisitos do sistema e fornece instruções para conectar o App Builder a um servidor de banco de dados em nuvem do Oracle NetSuite.

Requisitos do sistema

Estas são as versões mínimas dos navegadores necessárias:

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

  • Internet Explorer: 11+

Instruções de conexão

Para conectar o App Builder ao NetSuite, é necessário configurar uma integração no NetSuite e obter tokens dele, que serão usados para estabelecer a conexão. As seções a seguir descrevem como realizar cada uma dessas etapas.

Configurar uma nova integração do NetSuite

Siga estas etapas para criar uma nova integração no NetSuite com a qual o App Builder possa se conectar. Você precisará de acesso administrativo ao NetSuite.

  1. Faça login no NetSuite como administrador.

    attachment

  2. Navegue até Configuração > Integração > Gerenciar Integração > Novo.

    attachment

  3. Insira as informações necessárias e clique no botão Salvar. Quando a integração estiver configurada, o NetSuite gera um ID do Cliente e um Segredo exclusivos. Anote esses valores. Você os usará para configurar a conexão do App Builder.

    Importante

    O ID do Cliente e o Segredo são exibidos apenas uma vez. Certifique-se de copiar seus valores antes de prosseguir.

Gerar tokens de acesso

Depois de configurar a integração do NetSuite, você deve gerar tokens de acesso para permitir que o App Builder se conecte a ele.

Siga as etapas na documentação do NetSuite para gerar tokens. Você precisará tanto do ID do Token quanto do Segredo do Token.

Adicionar um servidor de dados

Agora que você configurou uma integração com o NetSuite e obteve seus tokens de acesso, está pronto para conectar o App Builder a ele. Abra o App Builder e siga estas etapas:

  1. Selecione IDE > Servidores de Dados.

  2. Clique no botão + Servidor.

  3. Os seguintes campos são exibidos:

    1. Na seção Configurações do Servidor:

      1. Nome do Servidor: Insira um nome para este servidor.

      2. Tipo: Clique para abrir o menu, depois encontre e selecione NetSuite.

      3. Nome da Instância: Insira o ID contido na sua URL única do NetSuite. Por exemplo, se sua URL for https://1234567.app.netsuite.com/, então o nome da sua instância é 1234567.

    2. Na seção Configurações de Segurança:

      1. Provedor de Segurança: (Opcional) Selecione um provedor de segurança no menu.

    3. Na seção Teste:

      1. Testar Conexão: Clique para verificar suas credenciais de conexão. Observe que o teste falhará se você ainda não tiver concluído as Configurações Avançadas abaixo. Complete a configuração primeiro, depois retorne a este diálogo e teste a conexão.

      2. Permitir Desafio: Selecione esta caixa de seleção para permitir que o App Builder redirecione o navegador quando receber um desafio OAuth.

  4. Clique no botão Salvar.

  5. Clique no botão Configurações Avançadas na seção Configurações do Servidor. O diálogo Servidor (Configurações Avançadas) é aberto.

  6. Clique no botão Editar. Os seguintes campos são exibidos:

    1. Avançado: Neste campo, insira as seguintes informações:

      Schema={{ Schema }};
OAuthClientId={{ OauthClientID }};
OAuthClientSecret={{ OauthClientSecret }};
OAuthAccessToken={{ AccessToken }};
OAuthAccessTokenSecret={{ AccessSecret }};
IncludeChildTables=true;

      Faça as seguintes substituições:

      1. Substitua Schema por SuiteQL ou SuiteTalk. Veja SuiteQL e SuiteTalk para ajuda na escolha.

      2. Substitua OauthClientID pelo ID do Cliente que você anotou durante a configuração da integração (veja Configurar uma nova integração com o NetSuite).

      3. Substitua OauthClientSecret pelo Segredo que você anotou durante a configuração da integração (veja Configurar uma nova integração com o NetSuite).

      4. Substitua AccessToken pelo ID do Token que você gerou anteriormente (veja Gerar tokens de acesso).

      5. Substitua AccessSecret pelo Segredo do Token que você gerou anteriormente (veja Gerar tokens de acesso).

      6. O parâmetro IncludeChildTables é necessário apenas se você escolheu SuiteTalk como seu esquema e precisa gravar em tabelas com relacionamentos para ver as sub-tabelas.

      Nota

      Outros parâmetros são suportados, se você precisar deles. Consulte a documentação do NetSuite para saber mais.

    2. Tempo Limite de Ping: A quantidade de tempo (em segundos) que o App Builder aguardará por um retorno do servidor antes de expirar. O valor padrão é 10.

    3. Escapar Nome do Parâmetro de Consulta: Selecione para usar parâmetros com valores de nome reservados. Esta caixa de seleção está habilitada por padrão.

  7. Clique em Salvar para confirmar e salvar todas as suas configurações.

Adicionar uma fonte de dados

Depois que o servidor foi adicionado, ele precisa ser adicionado no App Builder como uma fonte de dados. Para fazer isso, siga estas etapas:

  1. Navegue até IDE > Servidores de Dados.

  2. Na tabela Servidores de Dados, localize o servidor que você adicionou (veja Adicionar um servidor de dados acima) e selecione sua linha. O painel Fontes de Dados à direita exibirá a nova fonte de dados, que terá sido adicionada automaticamente. Clique em Detalhes.

    Nota

    Clicar no botão Detalhes na linha do servidor na tabela Servidores de Dados não exibe as mesmas opções.

  3. A seção superior terá o nome que você digitou em Nome do Servidor quando você adicionou o servidor. Clique no botão Editar se você quiser alterar o Nome da Fonte de Dados e ter um nome de exibição exclusivo. (Por padrão, ele tem o mesmo nome que o servidor.)

  4. Na seção Camada de Armazenamento de Dados, clique em Importar. A caixa de diálogo Importar Esquema será aberta.

  5. No campo Importar do Padrão, insira o subconjunto de tabelas que você deseja importar do banco de dados usando a sintaxe mvSQL. Se este campo for deixado em branco, todas as tabelas serão importadas.

  6. Clique em Importar, depois em Prosseguir. A importação será agendada para rodar em segundo plano. Assim que você receber uma mensagem de confirmação bem-sucedida, as tabelas importadas serão exibidas abaixo.

NetSuite SuiteQL vs. SuiteTalk Web Services

Quando você adiciona o NetSuite como um servidor de dados no App Builder, precisa escolher entre usar o SuiteQL ou os Serviços Web SuiteTalk como seu esquema. As informações abaixo podem ajudá-lo a determinar qual deles atende melhor às suas necessidades.

SuiteQL é uma linguagem de consulta baseada na linguagem de consulta de banco de dados SQL e usada para consultar dados do NetSuite. O serviço padrão suportado no SuiteTalk é projetado usando uma série de solicitações SOAP para recuperar dados em um formato mais próximo da pesquisa salva no NetSuite. Isso significa que o SuiteQL pode ser usado para lidar com consultas muito mais complicadas do que o SuiteTalk. Por exemplo, joins, agregações, group by, order by e fórmulas podem ser todos tratados no lado do servidor usando o SuiteQL. Dentro do próprio App Builder, o SuiteQL permitirá que você exiba Objetos como Visões.

attachment

SuiteTalk Web Services é um serviço web baseado em SOAP usado para integração com sistemas externos, neste caso, o App Builder. Por design, o SuiteTalk suportará apenas alguns joins e predicados. O SuiteTalk fornecerá endpoints de tabela com base em endpoints SOAP no NetSuite.

attachment

Em geral, o SuiteQL é uma opção mais poderosa para executar consultas mais rapidamente contra o NetSuite devido ao seu suporte avançado para manipulação de SQL. Nossa recomendação é usar o SuiteQL para leitura e construção de objetos e o SuiteTalk para gravação e atualização de dados.

Limitações

  • O NetSuite limita a concorrência de consultas que são executadas contra ele por conexão e licenças por pool de conexão, o que impacta o desempenho de leitura.

  • O NetSuite possui algumas regras personalizadas sobre filtros que você precisará manipular no formato dos seus dados para poder filtrar corretamente.

  • O NetSuite não suporta o uso de parênteses em nomes de objetos.

Solução de Problemas

Se você encontrar problemas com o servidor Oracle NetSuite, as seguintes etapas de solução de problemas são recomendadas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do CData ADO.NET Provider para NetSuite para informações detalhadas.