Guia de conexão NetSuite para Jitterbit App Builder

Visão geral

Este guia descreve os requisitos do sistema e as instruções para conectar o App Builder a um servidor de banco de dados em nuvem Oracle NetSuite. Dois componentes diferentes do NetSuite serão abordados neste guia: Suite QL e SuiteTalk Web Services.

SuiteQL é uma linguagem de consultar baseada na linguagem de consultar 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 intimamente associado à 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, junções, agregações, agrupar por, ordenar por e fórmulas podem ser manipulados no lado do servidor usando o SuiteQL.

SuiteTalk Web Services, por design, suporta apenas algumas junções e predicados. Em geral, SuiteQL é uma opção mais poderosa para executar consultas mais rapidamente contra NetSuite devido ao seu suporte avançado para lidar com SQL.

Nossa recomendação é usar o Suite QL para leitura e construção de objetos e o SuiteTalk para gravação e atualização de dados.

Requisitos do sistema

Servidor de banco de dados

Oracle NetSuite

Navegador da web do cliente

Chrome: 84+
Firefox: 73+
Safari: 13.0.1+
Borda: 84+
Internet Explorer: 11+

Instruções de conexão

Integração NetSuite

Antes de iniciar a configuração do App Builder para a conexão, você precisa primeiro configurar uma nova integração no NetSuite. Esta configuração requer acesso administrativo ao NetSuite. Esta configuração de integração emitirá um ClientID e um Secret exclusivos, informações necessárias para a configuração do App Builder.

Faça login no NetSuite como administrador
Navegue até Configuração > Integração > Gerenciar integração > Novo
Ao finalizar a configuração da integração, o NetSuite gerará um Client ID e um Secret exclusivos. Certifique-se de armazenar essas informações com segurança, pois você só pode buscá-las uma vez e elas são necessárias para configurar o App Builder.

Adicionando um servidor

Navegue até o App Builder Centro de Controle
Clique no link Conexões no menu Conectar
Clique no botão Criar no canto superior esquerdo do painel Servidores de Dados. Isso abrirá a página Adicionar Servidor.

Preenchendo credenciais

Para se conectar a um servidor de banco de dados NetSuite, forneça as seguintes informações:

Nome do servidor: Um nome de servidor identificável e exclusivo.
Tipo: Selecione "Net Suite" no menu.
Nome do host: O nome do host do seu servidor.
Porta: O número da porta para o servidor. A porta padrão é 1433.
Nome da Instância: Informações necessárias - esta é a parte do ID do seu URL exclusivo do NetSuite. Por exemplo: < https://4201843.app.netsuite.com/ > traduz para 4201843 como o Nome da Instância.
Configurações avançadas: Inclui opções de configuração adicionais, incluindo a configuração de tempo limite de ping, que determina a quantidade de tempo (em segundos) que o App Builder aguardará um ping de volta do servidor antes de declarar um tempo limite.
- Avançado: Este campo deve ser preenchido corretamente para dar suporte à conexão
  - Esquema={{ Schema }}; //Isso é definido como SuiteQL ou SuiteTalk (Suite Talk é usado para escrever e atualizar dados). Tem um esquema totalmente diferente do SuiteQL.
  - OAuthClientId={{ OauthClientID }}; //Emitido quando você registra sua integração NetSuite
  - OAuthClientSecret={{ OauthClientSecret }}; //Emitido quando você registra sua integração com o NetSuite
  - Token de acesso OAuth={{ AccessToken }}; //Emitir uma chamada de teste para gerar isso inicialmente
  - OAuthAccessTokenSecret={{ AccessSecret }}; //Emitir uma chamada de teste para gerar isso inicialmente
  - IncludeChildTables=true; // Parâmetro opcional, mas é necessário se o Schema estiver definido como SuiteTalk e você precisar gravar em tabelas com relacionamentos para ver as subtabelas
Nota

Há parâmetros adicionais suportados, se necessário. Eles são elaborados em: https://cdn.cdata.com/help/DNG/ado/pg_suiteql.htm
Tempo limite de ping: {o valor padrão é 10}
Nome do parâmetro de consulta de escape: {o padrão é habilitado}

Após preencher todas as credenciais necessárias, clique no botão Salvar para salvar as configurações.

Testando a conexão

Clique no botão Testar conexão abaixo das informações do servidor para certificar-se de que o servidor esteja conectado corretamente. Você verá uma mensagem "Sucesso" do App Builder se a configuração estiver correta.

Adicionando uma fonte de dados

Após as configurações do servidor NetSuite terem sido salvas, o banco de dados precisa ser conectado ao App Builder. Os bancos de dados que são conectados ao App Builder são chamados de "fonte de dados".

Navegue até o App Builder Centro de Controle
Clique no link Conexões no menu Conectar
Clique para selecionar a entrada do servidor NetSuite no painel Data Servers e, em seguida, clique em Add a New Data Source > Create New Database no painel Data Sources. Algumas fontes de dados são importadas automaticamente para a página de armazenamento de dados do App Builder. Se a fonte de dados já tiver sido adicionada, clique no botão Details associado para abrir a página de detalhes.
Clique no botão Editar
Preencha as seguintes credenciais para a fonte de dados:
1. Servidor de fonte de dados: O nome do servidor de onde está sendo extraído
2. Nome da fonte de dados: Dê à fonte de dados um nome de exibição exclusivo
3. Import Pattern: Isso permite que os usuários importem apenas certas tabelas listando-as na caixa. Prefixos também podem ser usados para importar apenas um subconjunto de tabelas (por exemplo, MyApp_* importará apenas tabelas que começam com "MyApp_"). Se o espaço for deixado em branco, ele importará todas as tabelas.
Clique em Salvar para atualizar as configurações da fonte de dados.
Assim que a página for atualizada, clique no botão Importar que aparece abaixo das credenciais da fonte. Quando solicitado, clique em Prosseguir. A importação será agendada para ser executada em segundo plano.
Após a conclusão da importação, clique em Tabelas para visualizar as tabelas criadas atualmente

NetSuite SuiteQL vs. Serviços Web SuiteTalk

Conforme observado na seção Sobre deste guia, há diferenças importantes sobre como você trabalhará com o NetSuite SuiteQL em comparação com o SuiteTalk Web Services no App Builder, bem como quais informações podem ser recuperadas após a conexão ter sido estabelecida.

SuiteQL é uma linguagem de consultar baseada na linguagem de consultar SQL. Ela suporta recursos avançados de consultar que você pode aproveitar para visualizar registros e dados do NetSuite. Nossa recomendação é usar SuiteQL para Leitura e Construção de Objetos. Dentro do próprio App Builder, SuiteQL permitirá que você exiba Objetos como Visualizações.

anexo

SuiteTalk Web Services é um serviço web baseado em SOAP usado para integração com sistemas externos, neste caso App Builder. Por design, o SuiteTalk suportará apenas algumas junções e predicados.

Depois de configurado corretamente no App Builder, o SuiteTalk fornecerá Endpoints de tabela com base nos Endpoints SOAP no NetSuite.

anexo

Limitações

O NetSuite limita a simultaneidade de consultas executadas nele por conexão e licenças por pool de conexão, o que afetará o desempenho de leitura
O NetSuite tem algumas regras personalizadas sobre filtros que você precisará manipular seu formato de dados para poder filtrar corretamente
O NetSuite não suporta o uso de parênteses em nomes de objetos