A Chains tem três conectores diferentes do NetSuite, cada um funcionando de uma maneira diferente. Elas não são tão simples ou flexíveis quanto outras plataformas, portanto, é muito importante conhecer as diferenças para tomar a decisão certa para sua empresa e solução.
Pré-requisitos e requisitos
Antes de configurar qualquer integração com o NetSuite, verifique se você tem os seguintes componentes prontos. A falta desses itens é a causa mais comum de falhas de conexão.
- SuiteAnalytics Connect: Se estiver usando os conectores JDBC ou Analytics, esse recurso deve estar ativado em sua conta do NetSuite. Observe que esse módulo geralmente é um complemento pago; verifique seu contrato do NetSuite.
- Serviços da Web SuiteTalk REST: Necessário para o conector moderno do NetSuite Analytics e as operações do SuiteQL.
- Usuário de integração dedicado: A Workiva recomenda enfaticamente a criação de uma "Função de integração" e um "Usuário de integração" específicos no NetSuite, em vez de usar um login pessoal. Isso ajuda a evitar a quebra da cadeia se o acesso de um funcionário for alterado.
NetSuite® Analytics (recomendado)
Esta abordagem recomendada usa SuiteAnalytics (especificamente a fonte de dados `NetSuite2.com`) e SuiteQL. Esse é o método moderno e permite uma solução mais sustentável e de melhor desempenho. Você precisará organizar seus dados para uso no SuiteAnalytics, o que pode valer o investimento para evitar os problemas de desempenho observados com os conectores legados.
Uso típico de exportação
Use o comando Execute SuiteQL Query para executar sua consulta SuiteQL e recuperar registros do NetSuite.
Outros usos
Você também pode listar e executar conjuntos de dados usando esse conector.
NetSuite® Token Authentication (Legado)
Atualmente, o conector de autenticação de token usa a versão mais recente dos serviços da Web SOAP da NetSuite. Embora isso garanta a estabilidade atual, o SOAP está sendo eliminado pela NetSuite em favor de protocolos mais novos.
Atualização do roteiro: A Workiva está planejando migrar esse conector para usar a versão REST API em 2026 para se alinhar com o cronograma de depreciação do NetSuite. Até lá, o conector continua sendo totalmente compatível com a versão mais recente do SOAP, embora geralmente seja recomendável usar o conector NetSuite Analytics para novos projetos, sempre que possível.
Uso típico de exportação
- Método do armário de arquivos: No NetSuite, automatize a transferência de seus arquivos para o armário de arquivos e, em seguida, nas cadeias, use o comando Get file para recuperá-los.
- Método de pesquisa salva: Crie as pesquisas salvas necessárias no NetSuite e, em seguida, em Chains, use o comando List saved searches para obter uma lista de todas as pesquisas disponíveis, seguido pelo comando Get saved search data para extrair os dados.
Observação: A API do NetSuite não suporta a obtenção de dados de uma pesquisa salva que contenha resultados resumidos (agrupamento).
Outros usos
Também é possível pesquisar registros por tipo ou ID, e recuperar dados JSON para um registro padrão.
NetSuite® JDBC
Esse conector requer o SuiteAnalytics Connect no NetSuite e suporta conectividade JDBC, permitindo que você consulte o banco de dados usando SQL padrão. O conector mais recente do NetSuite Analytics (que usa o SuiteQL) é geralmente recomendado, pois o gerenciamento de drivers JDBC e cadeias de conexão pode ser mais complexo.
Comparação de conectores
| Conector | Tecnologia subjacente | Melhor caso de uso |
|---|---|---|
| Análise do NetSuite | SuiteQL / REST | A maioria dos cenários. O padrão moderno para consulta de grandes conjuntos de dados de forma limpa. |
| Autenticação por token | SOAP (legado) | Somente suporte legado. Use se você tiver pesquisas salvas existentes que ainda não podem ser migradas para o SuiteQL. |
| NetSuite JDBC | Conectividade de banco de dados Java | Se a sua equipe preferir escrever consultas SQL brutas em vez de interações de API padrão. Requer o módulo "Connect". |