Étapes : configurer des sources de données NetSuite
Vous pouvez utiliser l’intégration pour extraire des données de votre instance NetSuite.
Adaptive Planning
les utilisateurs peuvent accéder aux données d’une instance NetSuite au moyen de l’adaptation NetSuite.Pour définir une source de données NetSuite, procédez comme suit :
- Accédez àIntégration > Concevoir des intégrations.
- Développez le dossierSources de donnéesdans laBibliothèque de composants.La source de données NetSuite dispose d’une licence séparée. Si vous ne voyez pas cet adaptateur dans la liste des sources de données, ouvrez un cas dans Workday Customer Center.
- Cliquez sur lasource de données NetSuite.La zone centrale de l’écran affiche les paramètres de votre nouvelle source de données, ainsi que d’autres informations.
- Entrez l’information de la source de données :
- Activer l’authentification par jeton :coché par défaut lorsque vous effectuez une mise à jour avec la dernière version de NetSuite. Vous devez sélectionner un identifiant NetSuite qui contientune clé du consommateur, une clé secrète du consommateur, un identifiant du jetonet uneclé secrète du jetongénérés par un administrateur NetSuite dans l’interface utilisateur NetSuite.
- Identifiant :sélectionnez l’identifiant NetSuite qui contientune clé du consommateur, une clé secrète du consommateur, un identifiant du jetonet uneclé secrète du jetongénérés par un administrateur NetSuite dans l’interface utilisateur NetSuite. Pour savoir comment définir une données d'identification NetSuite, cliquez ici.
- Fuseau horaire du compte: dans la liste déroulante, sélectionnez le fuseau horaire associé au compte. (Le fuseau horaire que vous sélectionnez ici doit être le même que celui indiqué dans l’interface utilisateur NetSuite pour ce compte utilisateur. Dans NetSuite, accédez àHome > Set Preferences > Localization.)
- Durée du lot de remblayage: sélectionnez la durée du lot de remblayage. La valeur par défaut est une semaine (168 heures). Cette valeur correspond au nombre d’heures de données extraites lors d’une mise à jour unique sur une table NetSuite importée différentiellement. Cela vous permet de faire des regroupements pour permettre au planificateur de maintenir un équilibre entre les tâches par lots de grande et de petite taille. Entrez une valeur inférieure si vous disposez de très grandes quantités de données NetSuite. Plus la valeur est petite, plus des boucles de remblayage sont requises pour une période civile donnée.La valeur précise que vous entrez est étroitement liée à plusieurs variables propres au site, telles que la taille des tâches, le ratio des petites tâches et des grandes tâches, le temps de traitement et les ressources système.
- Niveau de journalisation :sélectionnez un niveau de journalisation dans la liste déroulante afin de préciser les détails de journalisation pour cette source de données. Vos options sont les suivantes :
- Erreur: consigne uniquement les erreurs graves.
- Informations: consigne toutes les informations de base. Par exemple, la date de mise à jour de la source de données.
- Mode détaillé :fournit des informations très détaillées sur toutes les phases et les actions. (Ce niveau est principalement utilisé pour le débogage ou l’audit, car il génère souvent trop d’informations pour une utilisation normale.)
- Cliquez surEnregistrerdans le menu Actions.
Vous pouvez tester les informations de connexion dans le nouvel agent en cliquant sur
Tester la connexion
dans le menu Actions. Le système tente de se connecter à NetSuite en utilisant les informations disponibles dans les champs de la source de données. Si le système peut se connecter à NetSuite, cliquez sur OK
. En cas de problème de connexion, ouvrez un cas dans Workday Customer Center.Dès que vous pouvez vous connecter à NetSuite, vous pouvez importer la structure de données. Les tables et les colonnes sont alors affichées dans NetSuite.
Importer la structure à partir des sources de données NetSuite
- Cliquez surImporter la structuredans le menuActions. Les tables et les colonnes sont affichées dans le menuComposants de données.
Les données sont synchronisées dans un compte utilisateur NetSuite comme suit :
- Intégration choisit la meilleure méthode de synchronisation.
- Intégration essaie initialement d’obtenir des données de manière incrémentielle.
- Si la source de données sous-jacente ne prend pas en charge cette méthode, Intégration procède à une actualisation complète des données dans la zone intermédiaire.
Importer la structure et la table du récapitulatif des transactions d’inscription Adaptive pour NetSuite
Intégration fournit une table de démarrage pour NetSuite nommée
AdaptivePostingTransactionSummary
.La table
AdaptivePostingTransactionSummary
et ses tables associées sont affichées par défaut pendant l’importation de la structure
. Cette table révèle les éléments de données les plus fréquemment demandés dans un système source NetSuite. Cette table crée automatiquement des jointures entre la table PostingTransactionSummary
et ses tables associées. Ainsi, des noms conviviaux sont exposés pour les catégories NetSuite les plus fréquemment demandées :
- Compte
- Classification
- Éléments
- Service
- Emplacement
- Filiale
- Client
Pour chaque table, la colonne Nom est incluse. La colonne
Type de compte
est automatiquement activée dans l’onglet Comptes
. Les tables de catégorie sont importées automatiquement dès que Importer la structure
est exécuté.Vous devrez peut-être filtrer les types de compte qui ne sont pas nécessaires en utilisant un filtre SQL dans le chargeur Planning, comme expliqué dans la section Création d’un filtre SQL.
Vous pouvez également choisir de supprimer une ou plusieurs dimensions par défaut disponibles dans la table de jointure. Veillez à n’inclure que les catégories dont vous avez besoin pour votre modèle. Toutes les autres catégories doivent être supprimées de la jointure, et la colonne sous-jacente doit être exclue de l’importation dans la table PostingTransactionsSummary.
Ajouter des tables à une source de données NetSuite
Après avoir importé la structure des données, vous pouvez préciser les informations que vous souhaitez importer. Un ensemble standard de tables NetSuite a déjà été activé. Pour que des tables supplémentaires soient ajoutées, utilisez la section Tables à importer disponibles à l’écran pour configurer des données NetSuite importées.
Pour indiquer les tables à importer du compte utilisateur, procédez comme suit :
- Développez l’entrée de la source de données dans le menuComposants de données.Chaque table est affichée comme un élément distinct.
- Glissez-déposez les tables que vous voulez importer dans la section Tables à importer au centre de l’écran.Lorsque vous faites glisser chaque table vers la section Tables à importer, un onglet s’affiche pour la table et les informations apparaissent dans la section Tables à importer, ce qui vous permet de voir le type d’information que vous avez ajouté. Chaque onglet de la table dispose également d’un menu déroulant, auquel vous pouvez accéder en cliquant sur la flèche située à côté de son nom.
Gérer les colonnes
Si une table sur laquelle vous travaillez comporte un grand nombre de colonnes, vous pouvez utiliser Gérer les colonnes pour modifier rapidement les colonnes à importer. La boîte de dialogue Gérer les colonnes affiche les colonnes disponibles dans une table afin que vous puissiez cocher ou décocher les colonnes à importer.
Pour gérer les colonnes à importer, procédez comme suit :
- Cliquez sur la flèche de l’onglet situé à droite du nom de la table.
- Cliquez sur Gérer les colonnes dans le menu flottant.
- Cochez la case située à côté d’une colonne pour l’importer.Lorsque vous cochez une colonne, celle-ci s’affiche également dans la fenêtre d’aperçu une fois que le contenu contextuel est enregistré. Si vous décochez une colonne, la colonne sera retirée de la fenêtre d’aperçu.Vous ne pouvez pas modifier le statut d’importation des champs générés par le système, comme isDeleted.Vous pouvez également modifier le statut d’importation de colonnes individuelles en procédant comme suit :
- Sélectionnez les propriétés de colonne et définissez la propriété.
- Glissez-déposez les colonnes dans le concepteur.
Personnaliser les tables
Pour chaque table, vous pouvez personnaliser le mode d’importation des données.
Pour personnaliser les paramètres d’une table, procédez comme suit :
- Cliquez sur la flèche de l’onglet situé à droite du nom de la table.
- Cliquez surParamètres de tabledans le menu flottant.
- Entrez les paramètres de table :
- Mode d’importation des données :il n’existe qu’une seule option dans la liste déroulante :
- Source de données pour la sélection automatique de la meilleure approche de synchronisation :il s’agit de la valeur par défaut. La source de données examine NetSuite et choisit automatiquement la meilleure façon de synchroniser les données de la zone intermédiaire avec les informations de NetSuite. (Certaines tables sont intégralement lues chaque fois, tandis que d’autres utilisent la mise à jour différentielle.)
- Filtre d’importation des données :utilisez cette option pour entrer une expression SQL qui filtre ou formate l’information en cours d’importation. Le filtre SQL est appliqué avant que les données ne soient extraites de NetSuite afin de réduire la quantité de données à importer, ce qui vous donne un niveau de contrôle supplémentaire sur les données à introduire dans la zone intermédiaire. Cliquez sur le champ pour afficher la boîte de dialogue Modifier l’expression SQL (le filtre que vous entrez ici est appliqué aux données réelles de NetSuite et non aux données d’aperçu de la zone intermédiaire). Certains types de source de données ne prennent pas en charge le même niveau de fonctionnalité de filtrage SQL.
- Paramètre de période :tables NetSuitePostingTransactionBalanceEtPostingTransactionSummaryImportation par défaut et configuration d’un paramètre de période avant l’importation. Si vous choisissez d’importerConsolidatedExchangeRateouBudgetExchangeRateLes tables, elles nécessitent également la configuration d’un paramètre de période. Si aucun paramètre de période n’est configuré pour ces tables, l’importation échouera et le message suivant s’affichera :Required parameter is not configuredNetSuite dispose d’une fonctionnalité de filtrage non SQL très limitée. Seules les expressions très simples sont prises en charge.
- Cliquez surAppliquerpour appliquer les paramètres.
- Répétez les étapes 1 à 3 pour chaque table.
- Cliquez surEnregistrerpour enregistrer les paramètres dans la source de données.
Paramétrer les options de colonne
Lorsque vous utilisez la section Tables à importer, vous pouvez voir un aperçu des données qui existent dans la source de données ou dans la zone intermédiaire après leur importation. Vous pouvez modifier les options de chaque colonne en passant la souris sur son en-tête, puis en cliquant sur le menu déroulant à côté de son nom :
- Trier par ordre croissant :triez l’ensemble de la table en fonction de cette colonne dans l’ordre croissant.
- Trier par ordre décroissant: triez l’ensemble de la table en fonction de cette colonne dans l’ordre décroissant.
- Paramètres de colonne :cette boîte de dialogue permet de modifier les propriétés de la colonne dans la table intermédiaire.
- Nom :nom de la colonne, tel qu’il est affiché dans l’en-tête.
- Type de colonne :type de données utilisées dans la colonne.
- Convertir le type de colonne :sélectionnez le nouveau type dans ce menu déroulant.
- Exclure la colonne de l’importation: sélectionnez cette option pour retirer cette colonne des données importées.
- Supprimer une colonne personnalisée: sélectionnez cette option pour supprimer la colonne. (Disponible uniquement pour les colonnes personnalisées.)
Créer des colonnes Sous-interrogation
Les colonnes Sous-interrogation vous permettent de filtrer des lignes NetSuite en fonction des conditions avec une autre table associée. Par exemple, vous pouvez filtrer des enregistrements de possibilité NetSuite selon l’existence d’un ou de plusieurs enregistrements de devis.
Vous pouvez utiliser des colonnes Sous-interrogation pour :
- Choisir la table/colonne principale et la table/colonne associée.
- Rechercher certaines conditions dans des tables associées.
- Insérer les valeurs appropriées dans la table de pilotage en fonction des résultats de ces vérifications.
Pour chaque table, vous pouvez personnaliser la méthode d’importation des données.
Pour créer une colonne Sous-interrogation, procédez comme suit :
- Dans le menu Composants de données, développez le dossier Colonne personnalisée de la source de données.
- Glissez-déposez le composant Colonne Sous-interrogation jusqu’à la section Tables à importer au centre de l’écran.
- Entrez les paramètres de la colonne :
- Nom :entrez le nom de la colonne Sous-interrogation.
- Type de colonne :ce champ en mode affichage seulement sert de colonne booléenne.
- Table associée :sélectionnez une table associée à utiliser aux fins de comparaison.
- Expression de jointure :cliquez sur ce champ pour entrer une condition de jointure. La boîte de dialogue Modifier l’expression de jointure SQL s’affiche. (Pour plus d’informations sur la création de jointures SQL, voir Étapes : ajouter des tables et des colonnes de jointure SQL.)
- Règle de valeur de jointure :sélectionnez l’une des options de valeur de jointure SQL dans la liste déroulante : Existe, N’existe pas, Somme, Nombre, Min ou Max.
- Cliquez surAppliquerpour appliquer les paramètres.
- Cliquez surEnregistrerpour enregistrer les paramètres dans la source de données.
Télécharger des données depuis une table intermédiaire
Vous pouvez télécharger des données à partir d’une seule table intermédiaire.
Pour télécharger des données à partir d’une seule table intermédiaire, procédez comme suit :
- Cliquez sur la flèche vers le bas située dans un en-tête de table de la section Tables à importer.
- Cliquez surTélécharger les données.
- Lorsque l’on vous y invite, cliquez surEnvoyer.Cette opération envoie un courriel contenant une adresse URL pour télécharger les données.Intégration envoie un courriel contenant une adresse URL au compte de messagerie associé au concepteur de données.
- Ouvrez le courriel et cliquez sur l’URL. Les données sont téléchargées au format .csv.
Utiliser le filtre avancé
Sous le menu déroulant Source, vous pouvez cliquer sur Filtre avancé afin d’afficher des options permettant de filtrer les données dans la zone d’aperçu Tables à importer. Le filtre avancé fournit des outils pour afficher et parcourir un sous-ensemble de données dans une table intermédiaire ou directement depuis la source distante (si vous avez sélectionné NetSuite dans le menu déroulant Source).
La zone d’aperçu est conçue pour prévisualiser une petite partie des données de la zone intermédiaire (ou de NetSuite). Vous pouvez explorer les données disponibles dans le compte du tableur et vérifier que vous obtenez les données prévues en examinant la zone intermédiaire. Vous pouvez également vous en servir pour affiner le filtre d’importation des données que vous souhaitez utiliser. (Les filtres définis dans la fonction d’aperçu n’ont aucune incidence sur les données réelles de la zone intermédiaire.)
Les options de filtre avancé sont les suivantes :
- Lignes distinctes :cochez cette case pour masquer les lignes en double.
- Nombre maximum de lignes :limitez le nombre de lignes affichées dans la zone d’aperçu en entrant un nombre dans la zone de texte.
- Colonnes :sélectionnez ou désélectionnez les colonnes dans ce menu déroulant pour afficher ou masquer les colonnes affichées.
Même si vous retirez une colonne de cette liste, la colonne ne sera pas retirée de la liste de l’importation.
- Filtre SQL: cliquez sur la grande zone de texte pour afficher la boîte de dialogue Modifier l’expression SQL dans laquelle vous pouvez entrer un filtre SQL pour limiter le nombre de lignes prévisualisées. Cliquez sur Appliquer pour vérifier automatiquement la syntaxe SQL du filtre. (S’il y a des erreurs, celles-ci sont indiquées dans l’expression.) L’expression que vous avez entrée s’affiche dans le champ Filtre d’importation des données. Pour obtenir une aide détaillée sur la syntaxe SQL, vous pouvez cliquer ici dans la section Remarques. NetSuite dispose d’une fonctionnalité de filtrage non SQL très limitée. Seules les expressions très simples sont prises en charge.
Cliquez sur
Supprimer le filtre
(à côté du menu déroulant Source) pour effacer les paramètres dans la fenêtre d’aperçu. NetSuite désigne certaines colonnes comme colonnes clés. Ces informations sont présentées dans les tables intermédiaires. Ces informations ne doivent pas être modifiées.
Importer des données à partir de NetSuite
Dès que vous configurez et enregistrez votre source de données NetSuite, vous pouvez importer des données.
Pour importer des données à partir NetSuite, procédez comme suit :
- Cliquez surImporter des donnéesdans le menu Actions. Les données sélectionnées sont filtrées par des expressions SQL et chargées dans la zone intermédiaire. Vous pouvez afficher un aperçu des données dans la zone intermédiaire.
Les informations restent dans la zone intermédiaire jusqu’à ce que vous les effaciez.
Pour effacer les données de la zone intermédiaire, procédez comme suit :
- Cliquez surEffacer les tables intermédiairesdans le menu Actions. La zone intermédiaire est effacée pour toutes les tables dans la source de données.
Bonne pratique :
lorsque vous importez des types de transactions NetSuite, assurez-vous que vous utilisez uniquement les types de transactions NetSuitequi sont pris en charge.Importation des recherches enregistrées NetSuite
L'importation à partir des recherches enregistrées NetSuite est uniquement disponible si vous avez configuré votre intégration NetSuite avant le 12 août 2024.
Les recherches enregistrées ne peuvent être importées qu’à partir des adaptateurs NetSuite. L’authentification SSO pour cette source de données doit également être configurée.
L’importation de recherches enregistrées nécessite la configuration d’une recherche enregistrée NetSuite dans le concepteur de données, puis l’importation de sa structure. Les recherches enregistrées dans l’intégration prennent en charge les enregistrements personnalisés, les champs personnalisés et les segments personnalisés NetSuite.
Configurer une recherche enregistrée dans le concepteur de données
- Cliquez surGérer les recherches enregistréesdans le menu Actions.
- Dans la boîte de dialogueGérer les recherches enregistrées, cliquez sur le bouton Actions sous l’arborescence de navigation et sélectionnez Ajouter la recherche enregistrée, ou cliquez avec le bouton droit de la souris sur le dossier des recherches enregistrées et sélectionnez Ajouter la recherche enregistrée. Entrez un nom pour la recherche enregistrée.
- Sélectionnez letype d’enregistrement NetSuite.
- Sélectionnez larecherche enregistrée NetSuite.
- Cliquez surAppliquer.
Importer la structure d’une recherche enregistrée
- Dans la boîte de dialogue Recherches enregistrées gérées, cliquez sur une recherche enregistrée que vous avez créée précédemment pour la sélectionner.
- Cliquez sur le bouton Actions sous l’arborescence de navigation et sélectionnezImporter la structuredans le menu Actions, ou cliquez avec le bouton droit de la souris sur la recherche enregistrée et sélectionnezImporter la structure.
- Après avoir importé la structure de la recherche enregistrée, fermez la boîte de dialogue Recherches enregistrées gérées.
- La zone intermédiaire affiche un onglet pour chaque structure de recherches enregistrées que vous avez importée.
Sachez que toutes les recherches enregistrées dans le panneau Composants de données seront importées si vous cliquez sur Importer la structure dans le panneau Actions.
Bonne pratique :
assurez-vous que les résultats de l’importation de la structure de recherches enregistrées ne contiennent pas de colonnes des résultats récapitulatifs NetSuite. Il s’agit d’une restriction d’API de services Web NetSuite. Le nombre maximum de recherches enregistrées NetSuite pouvant être importé est de 1 000.
Sélectionner un mode d’importation pour les données de recherches enregistrées de NetSuite
- Dans la zone intermédiaire, cliquez sur l’icône en forme de flèche dans l’onglet pour afficher une table contenant vos recherches enregistrées NetSuite.
- Sélectionnez lesparamètres de la tabledans la liste déroulante.Deux options sont disponibles :
- Tous les enregistrements sont remplacés à chaque exécution d’une importation de données :il s’agit du paramètre par défaut. Toutes les données sont remplacées lorsque l’importation est exécutée.
- Tous les enregistrements qui se situent dans la période sont transmis :cette option vous permet de sélectionner une plage de périodes à l’aide d’un paramètre, puis de choisir une colonne Date et heure dans la table Recherches enregistrées à laquelle s’applique le paramètre. Vous pouvez cliquer surModifier les paramètresdans cette boîte de dialogue pour créer un paramètre de plage de périodes à utiliser. Si vous choisissez d’importer une plage de périodes, vous devrez définir un paramètre de période ou l’importation échouera.
- Cliquez surAppliquer.
- Cliquez surEnregistrerdans le panneau Actions.
Importer des données à partir d’une recherche enregistrée
- Dans le panneau Actions, cliquez surImporter des données.
- Les données de recherches enregistrées NetSuite sont importées dans la zone intermédiaire.
Supprimer des recherches enregistrées NetSuite
- Cliquez surRecherches enregistrées géréesdans le panneau Actions.
- Cliquez avec le bouton droit de la souris sur la recherche enregistrée dans les recherches enregistrées gérées, puis sélectionnezSupprimer. La recherche enregistrée est retirée de la liste de la boîte de dialogue Gérer les recherches enregistrées, mais sa structure reste dans le panneau Composants de données et dans la zone intermédiaire jusqu’à ce que l’action Importer la structure soit à nouveau exécutée.
Si une recherche enregistrée NetSuite est supprimée dans NetSuite, un message indique qu’elle n’est plus disponible lors de l’exécution de l’action Importer la structure. Si une recherche enregistrée qui est déjà utilisée dans l’intégration pour l’importation de données est modifiée dans NetSuite, la réussite des importations de données futures n’est pas garantie.
Bonne pratique :
dans NetSuite, créez vos recherches enregistrées pour qu’elles soient utilisées dans Intégration et nommez-les pour qu’elles ne soient pas modifiées ou supprimées par d’autres utilisateurs NetSuite.Bonne pratique :
assurez-vous que vous disposez des autorisations appropriées dans NetSuite pour afficher le contenu renvoyé par le résultat d’une recherche enregistrée. Si vous ne détenez pas l’autorisation d’accéder au contenu, votre recherche renverra zéro enregistrement sans aucun message d’erreur. Il s’agit d’une limite de NetSuite indiquée dans son aide en ligne : If you reference a saved search for which you do not have the permission, the exception is ignored and fields have no value (are not in the SOAP response at all).
Sélectionner les fichiers de classeurs NetSuite à importer
Vous pouvez gérer et sélectionner des fichiers CSV à partir de classeurs NetSuite pour les importer en tant que tables intermédiaires.
Extraction à partir de Adaptive Planning Retour à NetSuite
Adaptive Planning
Retour à NetSuite L’exploration NetSuite est disponible uniquement si vous avez configuré votre intégration NetSuite avant le 12 août 2024.
Vous pouvez activer l’exploration des données importées à partir de NetSuite. Les liens d’exploration seront disponibles dans les feuilles Planning et les rapports pour les montants réels importés de NetSuite. Afin de configurer l’exploration pour NetSuite, vous devez vous assurer que vos identifiants internes sont utilisés pour le mappage des colonnes dans le chargeur Planning. Vous devrez configurer un système externe NetSuite et le joindre à un profil utilisé par le chargeur Planning.
Si vous configurez plusieurs colonnes dans NetSuite pour procéder à des mappages vers une seule dimension Planning, ces colonnes doivent être combinées dans la source de données à l’aide d’une colonne SQL tuple.
Pour obtenir plus de détails, voir la section Présentation du mappage de profils dans Créer des chargeurs de données Planning.
- Principales étapes pour activer l’exploration transversale de Planning à NetSuite
- Avant de commencer, vérifiez que la case Exploration par lot améliorée est cochée dans le menuIntegration > NetSuite Setupde Planning.Configurez un système NetSuiteExternalqui définit le mappage de dimensions.Effectuez les ajustements requis au niveau de la source de données pour les mappages dimensionnels définis.
- Si vous disposez de plusieurs catégories NetSuite mappées dans une même dimension Planning, révisez la source de données pour ajouter une colonne SQL tuple dans un mappage de colonnes plusieurs à un.
- Cliquez sur la tableRécapitulatif des transactions d’inscription Adaptivedans Tables à importer.
- SélectionnezGérer les colonnesdans le menu déroulant deRécapitulatif des transactions d’inscription Adaptive.
- ActiverAccountInternalId.
- ActivezInternalIdspour les autres dimensions selon lesquelles vous prévoyez une exploration.
- Enregistrez la source de données.
Effectuez les ajustements requis au niveau du chargeur en utilisant les ajustements de source de données pour le mappage dimensionnel.- Une fois que les paramètres de source de données NetSuite ci-dessus sont définis, configurez un chargeur de données Planning pour importer des données de chiffres réels NetSuite.
- Liez un profil au système externe que vous avez configuré à l’étape de configuration d’un système externe NetSuite.
- Joignez ce profil au chargeur Planning.
- Cliquez sur l’ongletMappage de colonnes.
- Pour la ligne Compte :
- Dans la colonneIdentifiant source,sélectionnezaccountInternalIdcolonne à partir de votre table source.
- Dans la colonneNom d’affichage de la source, sélectionnez le nom d’affichage.
- Répétez l’étape ci-dessus pour chacune des autres dimensions standard que vous souhaitez explorer.
- Enregistrez le chargeur.
Après avoir suivi toutes ces étapes, vous devriez maintenant pouvoir explorer des données.