Ir para o conteúdo

Guia de Conexão NetSuite

Visão Geral

Este guia descreve os requisitos do sistema e as instruções para conectar App Builder para 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 começar o App Builder configuração para a conexão, você primeiro precisa 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 o App Builder configuração.

  • Faça login no NetSuite como administrador

    anexo

  • Navegue até Configuração > Integração > Gerenciar integração > Novo

    anexo

  • 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 configuração.

Adicionando um Servidor

  1. Navegue até o App Builder Centro de controle

  2. Clique no link Conexões no menu Conectar

    anexo

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

    anexo

  • Configurações avançadas: Inclui opções de configuração adicionais, incluindo a configuração Ping Timeout, que determina a quantidade de tempo (em segundos) que App Builder aguardará um ping de volta do servidor antes de declarar um tempo limite.

    • Avançado: Este campo deve ser preenchido corretamente para suportar a 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}

    Interface gráfica do usuário, descrição do aplicativo gerada automaticamente

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á an App Builder mensagem de "Sucesso" 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 a App Builder. Bancos de dados que estão conectados a App Builder são chamados de "fonte de dados".

  1. Navegue até o App Builder Centro de Controle

  2. Clique no link Conexões no menu Conectar

  3. 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 o App Builder página de armazenamento de dados. Se a fonte de dados já tiver sido adicionada, clique no botão Detalhes associado para abrir a página de detalhes.

  4. Clique no botão Editar

  5. Preencha as seguintes credenciais para a fonte de dados:

    1. Servidor da fonte de dados: O nome do servidor que está sendo extraído

    2. Nome da fonte de dados: Dê à fonte de dados um nome de exibição exclusivo

    3. Padrão de importação: Isso permite que os usuários importem apenas determinadas tabelas listando-as na caixa. Os 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.

    anexo

  6. Clique em Salvar para atualizar as configurações da fonte de dados.

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

    anexo

  8. 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 vs. SuiteTalk Web Services em 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 App Builder em si, o SuiteQL permitirá que você exiba Objetos como Views.

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.

Após configurado corretamente em App Builder o SuiteTalk fornecerá Endpoints de tabela com base em 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