Chains dispose de trois connecteurs NetSuite différents, chacun fonctionnant d'une manière différente. Elles ne sont pas aussi simples ou flexibles que d'autres plateformes, il est donc très important de connaître les différences afin de prendre la bonne décision pour votre entreprise et votre solution.
Conditions préalables et exigences
Avant de configurer l'intégration de NetSuite, assurez-vous que les composants suivants sont prêts. L'absence de ces éléments est la cause la plus fréquente des échecs de connexion.
- SuiteAnalytics Connect : Si vous utilisez les connecteurs JDBC ou Analytics, cette fonctionnalité doit être activée dans votre compte NetSuite. Notez qu'il s'agit souvent d'un module complémentaire payant ; vérifiez votre contrat NetSuite.
- Services Web REST de SuiteTalk : Nécessaire pour le connecteur moderne NetSuite Analytics et les opérations SuiteQL.
- Utilisateur d'intégration dédié : Workiva recommande fortement de créer un "rôle d'intégration" et un "utilisateur d'intégration" spécifiques dans NetSuite plutôt que d'utiliser un login personnel. Cela permet d'éviter que la chaîne ne se brise si l'accès d'un employé change.
NetSuite® Analytics (recommandé)
Cette approche recommandée utilise SuiteAnalytics (en particulier la source de données `NetSuite2.com`) et SuiteQL. Il s'agit de la méthode la plus moderne, qui permet d'obtenir une solution plus durable et plus performante. Vous devrez organiser vos données pour les utiliser dans SuiteAnalytics, ce qui peut valoir l'investissement pour éviter les problèmes de performance rencontrés avec les anciens connecteurs.
Utilisation typique pour l'exportation
Utilisez la commande Execute SuiteQL Query pour exécuter votre requête SuiteQL et récupérer les enregistrements de NetSuite.
Autres utilisations
Vous pouvez également lister et exécuter des ensembles de données à l'aide de ce connecteur.
NetSuite® Token Authentication (Legacy)
Le connecteur d'authentification par jeton utilise actuellement la dernière version des services Web SOAP de NetSuite . Bien que cela garantisse la stabilité actuelle, NetSuite abandonne progressivement SOAP au profit de protocoles plus récents.
Mise à jour de la feuille de route : Workiva prévoit de migrer ce connecteur pour utiliser la version de l'API REST en 2026 afin de s'aligner sur le calendrier d'obsolescence de NetSuite. D'ici là, le connecteur reste entièrement pris en charge sur la dernière version SOAP, bien qu'il soit généralement recommandé d'utiliser le connecteur NetSuite Analytics pour les nouveaux projets, dans la mesure du possible.
Utilisation typique pour l'exportation
- Méthode de l'armoire à dossiers : Dans NetSuite, automatisez le transfert de vos fichiers vers l'armoire, puis, dans les chaînes, utilisez la commande Get file pour les récupérer.
- Méthode de recherche sauvegardée : Créez toutes les recherches sauvegardées nécessaires dans NetSuite puis, dans les chaînes, utilisez la commande List saved searches pour obtenir une liste de toutes les recherches disponibles, suivie de la commande Get saved search data pour extraire les données.
Remarque : L'API NetSuite ne permet pas d'obtenir des données à partir d'une recherche enregistrée contenant des résultats récapitulatifs (regroupement).
Autres utilisations
Vous pouvez également rechercher des enregistrements par type ou ID, et récupérer des données JSON pour un enregistrement standard.
NetSuite® JDBC
Ce connecteur nécessite SuiteAnalytics Connect dans NetSuite et prend en charge la connectivité JDBC, ce qui vous permet d'interroger la base de données à l'aide de SQL standard. Le connecteur NetSuite Analytics le plus récent (qui utilise SuiteQL) est généralement recommandé, car la gestion des pilotes JDBC et des chaînes de connexion peut être plus complexe.
Comparaison des connecteurs
| Connecteur | Technologie sous-jacente | Meilleur cas d'utilisation |
|---|---|---|
| NetSuite Analytics | SuiteQL / REST | La plupart des scénarios. La norme moderne pour l'interrogation propre de grands ensembles de données. |
| Authentification par jeton | SOAP (ancien) | Prise en charge de l'héritage uniquement. A utiliser si vous avez des recherches sauvegardées existantes qui ne peuvent pas encore être migrées vers SuiteQL. |
| NetSuite JDBC | Connectivité des bases de données Java | Si votre équipe préfère écrire des requêtes SQL brutes plutôt que des interactions API standard. Nécessite le module "Connect". |