Sage Intacct

Introduction

L'installation des Modèles vous fournit un ensemble de Vues, de Tableaux de Bord et de Rapports prêts à l'emploi.

L'installation (en supposant que le Central Point soit fraîchement installé et vide), se fera en deux étapes :

  • Configuration des Sources de Données pour les bases de données ERP et Entrepôt de Données (facultatif).
  • Importation des modèles dans le point central.

Il peut y avoir d'autres étapes, y compris la construction et le chargement des Cubes OLAP.

SEI DataSync

Les données de Sage Intacct ne sont accessibles qu'à partir d'une plateforme Cloud, elles doivent donc être utilisées en conjonction avec DataSync.

Prérequis

  • Un environnement de production Sage Intacct
  • Un environnement de destination (Cloud ou Sur Site)
  • Une version valide du DataSync (voir Installer DataSync pour plus d'informations)

Paramétrer les Connexions

Important

Vous aurez besoin de deux Connexions Source :

  • Une avec le Type de Suivi défini sur Date
  • Une avec le Type de Suivi défini sur Aucun
Important
  • Le Fuseau horaire du serveur DataSync doit être réglé sur GMT lors de la sélection d'un Type de Suivi par Date.

Configuration dans Sage Intacct

Important

Pour établir la connexion entre Sage Intacct et DataSync, vous devez disposer d'un compte avec les Droits Administrateur (User role permissions) pour Sage Intacct.

Cette section vous aide à configurer l'intégration de Sage Intacct avec DataSync afin qu'ils puissent communiquer entre eux.

  1. Dans la barre supérieure, cliquez sur la catégorie Company et sélectionnez Subscriptions situé sous l'onglet Admin.
  2. Dans la liste, trouvez Web Services et faites glisser le curseur pour l'activer. Ne tenez pas compte de l'avertissement concernant les frais supplémentaires.
  3. Dans la barre supérieure, cliquez sur Overview situé dans l'onglet Company.

  4. Dans la page Company, sous la section Setup , cliquez sur Company Information.
  5. Allez dans l'onglet Security et cliquez sur Edit.
  6. Sous le menu déroulant Sign-in settings, dans la section Password, cliquez sur le crayon situé sous le champ IP Filter.
  7. Dans le champ Username, entrez le Company ID fourni par Sage (celui que vous avez utilisé pour vous connectez).
  8. Dans la fenêtre IP Address Filter Information, cliquez sur Add.
  9. Dans la fenêtre suivante, dans le champ Username, sélectionnez le User ID que vous avez utilisé pour vous connecter.
  10. Dans les champs Start IP Address et End IP Address, entrez l'adresse IP fournie par l'équipe Nectari et cliquez sur Save.
  11. Une fois que votre Nom d'Utilisateur figure dans la liste, vous pouvez fermer la fenêtre IP Address Filter Information.
  12. De retour dans la fenêtre Company Information, faites défiler la page jusqu'au menu déroulant Web Services authorizations et cliquez sur Add.
  13. Dans le champ Sender ID, entrez NectariMPP et cliquez sur Save.
Créer un Rôle pour l'Utilisateur

Avant de créer un Utilisateur, vous devez d'abord créer un Rôle afin que l'Utilisateur puisse envoyer des requêtes API dans DataSync.

  1. Dans la barre supérieure, cliquez sur Roles situé dans l'onglet Company .
  2. Dans la page Roles, cliquez sur Add.
  3. Dans le champ Name, entrez Nectari et cliquez sur Save.
  4. Dans la page Roles Subscription, cochez la case Application / Module et cliquez sur l'hyperlien Permissions.
  5. Dans la fenêtre Permissions, cliquez sur Read-Only, puis sur Save.

Important

Les Permissions doivent être définies sur Read-Only pour tous les modules/applications figurant sur cette page, afin de permettre / autoriser DataSync à récupérer des données de Sage Intacct.

  1. Une fois que vous avez terminé, cliquez sur Save.
Créer un Utilisateur

Après avoir créé le Rôle, vous pouvez maintenant créer l'Utilisateur qui sera utilisé pour authentifier la connexion entre DataSync et Sage Intacct.

  1. Dans la barre supérieure, cliquez sur Web Services users, situé dans l'onglet Company.

  2. Dans la page Web Services Users, cliquez sur Add.
  3. Remplissez les champs User ID, Last Name, First Name et Email.
  4. Sous la section User Type, sélectionnez Business.
  5. Sous la section Admin Privileges, sélectionnez Full.
Note

Sage Intacct utilisera le courriel que vous entrez ici pour vous envoyer le mot de passe associé à l'User ID que vous avez défini.

Cet User ID sera utilisé pour la configuration de la connexion dans DataSync.

Exemple

Nous avons défini iciNectari comme étant l'User ID.

  1. Une fois que cela est fait, cliquez sur l'onglet Role Information.
  2. Cliquez sur une des lignes et sélectionnez Nectari dans la liste déroulante Role Name.
  3. Cliquez sur Save et sur OK dans la fenêtre contextuelle.
  4. Dans la fenêtre Password, entrez le mot de passe que vous avez utilisé pour vous connecter à votre compte Sage Account et cliquez sur Done.
Note

Une fois l'Utilisateur créé, il apparaîtra dans la liste comme présenté ci-dessous :

Vous recevrez également un e-mail de Sage Intacct contenant les informations d'identification relatives à cet Utilisateur.

La configuration de Sage Intacct est maintenant terminée, vous pouvez donc maintenant procéder au paramétrage de la connexion dans DataSync.

Paramétrage dans DataSync
  1. Dans DataSync, créer une nouvelle Connexion Source.
  2. Dans la liste, sélectionnez Sage Intacct.
  3. Dans la fenêtre Propriétés de Connexion :
    1. Dans le champ Description, entrez un nom pour cette connexion.
    2. Collez cette adresse URL https://api.intacct.com/ia/xml/xmlgw.phtml dans le champ URL.
    3. Pour les champs User ID, Mot de Passe et Company ID, entrez les informations d'identification que vous avez reçues dans le courriel de Sage Intacct.
    4. Une fois ces champs remplis, modifiez les autres paramètres (Type de suivi etc.) en fonction de vos préférences.
    5. Cliquez sur Enregistrer pour terminer.
Exemple

Si nous nous basons sur le User ID que nous avons créé dans l'exemple (Nectari), avec des informations réelles, cela devrait ressembler à ceci :

Importer les Extractions

Cette fonction vous permet d'importer un modèle prédéfini ou de restaurer une sauvegarde que vous avez effectuée vous-même avec la fonction Exporter (voir Exporter une Extraction pour plus de détails).

Certains modèles prédéfinis sont déjà disponibles ; si vous n'y avez pas accès, veuillez contacter votre partenaire. Un exemple de modèle prédéfini que vous pourriez utiliser est celui qui définit la liste des tables et des champs à synchroniser pour envoyer des données Sage 300, X3, Acumatica, Salesforce vers le Cloud.

  1. Cliquez sur l'une des extractions de la liste puis sur l'icône Importer une extraction située dans le coin supérieur droit.
  2. Dans la fenêtre Importer une Extraction, cliquez sur l'hyperlien Choisissez un fichier zip pour naviguer jusqu'à l'emplacement où vous avez enregistré le fichier d'exportation.zip ou faites-le glisser directement dans cette fenêtre et cliquez sur Suivant.
Note

Pour Sage Intacct, deux fichiers zip seront fournis.

  • Utilisez le fichier DS_EXTR_[Version-Logiciel]_[Version-Extraction]_Sage Intacct with refresh DS-SYNC.zip pour la connexion Source avec le suivi par Date et le fichier DS_EXTR_[Version-Logiciel]_[Version-Extraction]_Sage Intacct w_o refresh DS-SYNC.zip pour celle qui n'en a pas.
  1. Dans le volet de gauche, sélectionnez le type d'extraction que vous souhaitez effectuer et cliquez sur Suivant.
Important

Pour Sage Intacct, il est nécessaire d'utiliser CPYID pour le Nom de Colonne.

  1. Référez-vous à Configurer le Panneau Extraction pour définir l'extraction et cliquez sur Importer pour terminer le processus.
  1. Vous devriez obtenir un résultat similaire à celui-ci :

Note

Si vous avez déjà créé des Custom Fields dans Sage Intacct, ces Champs ne sont pas encore synchronisés. Vous devrez vous rendre dans chacune de leurs tables et cocher la case Sync. Vous devrez également faire apparaître ces Champs dans les Modèles de Données correspondants via le Concepteur de Modèles de Données, en double-cliquant sur le Champ dans la Table correspondante afin de les analyser.

Note

La fenêtre Extractions passera automatiquement à la fenêtre Tables.

Référez-vous Ajouter une Requête SQL si vous souhaitez ajouter des instructions SQL à certaines tables et Configurer les Champs pour personnaliser les champs (ajouter un calcul, changer le nom de la destination, etc.)

 

Valider et Construire les Extractions

Une fois que votre extraction (source, connexion de destination et leurs tables associées) est configurée, l'étape suivante consiste à valider le paramétrage d'une extraction, avant de pouvoir l'exécuter.

La fonction :

  • S'assurera que toutes les tables/champs existent bien dans les connexions sources,
  • Validera toutes les requêtes SQL ou les champs calculés,
  • S'Assurera que l'intégrité des données dans la connexion de destination n'est pas affectée (ex : modification de la structure de la table).

Pour ce faire :

  1. Sélectionnez l'extraction que vous souhaitez valider et construire dans la liste et cliquez sur l'icône Valider et Construire.
  2. Dans la nouvelle fenêtre, choisissez l'action qui correspond le mieux à vos besoins et cliquez sur Construire (Valider pour les extractions de type Migration et Exportation).
Note

Le choix sera différent en fonction du type d'extraction que vous sélectionnez.

Exemple

Pour les extractions de type Synchronisation / Consolidation :

Pour les extractions de type Migration et Exportation :

  1. Attendez que le processus soit terminé.
Note

Une fenêtre Rapport de Validation apparaîtra pour vous donner un bref aperçu du processus une fois qu'il sera terminé. Les résultats sont affichés dans la colonne Statut et s'il y a une erreur, vous obtiendrez plus de détails en cliquant sur l'hyperlien dans la colonne Erreur qui mène à Page des Journaux.

Lancer les Extractions

Une fois vos données validées (voir Valider et Construire une Extraction pour plus de détails), vous pouvez lancer manuellement l'extraction si vous voulez un résultat immédiat au lieu de la planifier.

  1. Sélectionnez l'extraction que vous souhaitez exécuter dans la liste et cliquez sur l'icône Lancer l'Extraction Maintenant.
  2. Dans le coin supérieur droit, choisissez l'action que vous voulez exécuter et le(s) table(s) puis cliquez sur Exécuter.
Exemple


Note

Charger (uniquement pour une extraction de type Migration) : Charge toutes les données de votre destination à partir de votre source.

Tronquer et Charger : Remplace toutes les données de votre destination par les données actuelles de votre source.

Charge Incrémentale : Récupère uniquement les enregistrements qui ont changé depuis votre dernière Charge Incrémentale et remplacez les enregistrements correspondants dans votre destination par ceux qui ont été mis à jour.

Traitement des Enregistrements Supprimés : Nombre maximal de jours pendant lesquels le processus de validation vérifie si des enregistrements ont été supprimés en fonction de la date de la dernière modification. c.-à-d. Si la valeur est définie à 30 jours, le système vérifiera toutes les transactions qui ont été créées ou mises à jour au cours des 30 derniers jours et validera ensuite si elles existent toujours dans la source. Si elles n'existent plus dans la source, elles seront alors supprimées de la destination.

  1. Attendez que le processus soit terminé.
Note

Lorsque le processus est terminé, les résultats sont affichés dans la colonne Statut. En cas d'erreur, vous pouvez obtenir plus de détails en cliquant sur l'hyperlien dans la colonne Erreur, qui mène à Page des Journaux.

Configuration de la Sources de Données

Environnements et sources de données

Astuce

La description donnée à une Source de Données créée pour la première fois est utilisée dans tous les environnements pour décrire cette Source de Données.

Donnez une description générique pour la première fois (par exemple, Source de Données ERP, Source de Données Cube) et, si nécessaire, renommez-la après la création du premier environnement.

Les informations suivantes sont nécessaires pour configurer les Sources de Données :

  • Identifiants du serveur de base de données :Nom du serveur, Instance, Stratégie d'authentification.
  • Principales informations de la base de données ERP :Nom de la base de données et du schéma.

Source des données ERP

  1. Dans le coin supérieur droit, cliquez sur le bouton pour accéder à la section Administration.
  2. Dans le volet de gauche, sélectionnez Env. & Sources de Données.
  3. Par défaut, il existe déjà un environnement appelé Production, que vous pouvez renommer en double-cliquant dans la zone de texte. Une fois la modification effectuée, appuyez sur la touche Entrée.
  4. Dans la section Sources de données, cliquez sur Ajouter pour créer la première source de données.
  5. Terminer la configuration de la source de données ERP. Voir les instructions pour MS SQL Server ci-dessous.

Description de la source de données :
Type :
SQLSERVER
Serveur :
Serveur de base de données de base de données de Sage Intacct
Nom de la base de données :
Nom de la Sage Intacctbase de données de synchronisation (attention à la casse)
Nom du schéma de base de données :
SEIschéma :
Saisissez le schéma SEIpersonnalisé choisi pour l'environnement actuel.
Stratégie d'authentification :
UseSpecific
Nom d'utilisateur :
Utilisateur SQL accédant à laSage Intacct base de données de synchronisation. Par exemple, sa.
Mot de passe :
Le mot de passe de l'utilisateur.
  1. Cliquez sur Valider puis sur Enregistrer pour terminer la configuration de la Source de Données.

Importer des Modèles

Pour chaque environnement, les informations suivantes, précédemment configurées, seront requises :

  • Nom de la base de données ERP
  • SEI Schéma personnalisé
  • Schéma ERP

Téléchargez le fichier du Modèle : TPL_9.5.XXX_SageIntacct.zip.

Le X représente le numéro de construction du modèle (utilisez le plus haut disponible).

Démarrer l'Importation d'un Modèle

  1. Dans le coin supérieur droit, cliquez sur pour accéder à la section Administration.
  2. Dans la section Administration, cliquez sur le menu déroulant Modèles dans le volet de gauche.
  3. Sélectionnez Importer un modèle.
  4. Choisissez l'emplacement spécifique où les nouveaux modèles seront installés et cliquez sur Suivant.
    Note

    Habituellement, le dossier Racine est utilisé.

  1. Dans la fenêtre Importer un Modèle, cliquez sur Sélectionner les fichiers...
  2. Trouvez le dossier où vous avez enregistré le fichier Template.zip afin de le sélectionner puis cliquez sur Ouvrir.
  3. Dans l'écran Mappage des Sources de Données, associez les Sources de Données (ERP) listées dans la colonne Description des Sources de Données Reçues (celles du modèle) aux Sources de Données que vous avez définies précédemment dans le Central Point (listées dans la colonne Description des Sources de Données Actuelles).
    • Dans la colonne Description des Sources de Données Reçues, assurez-vous que seules les cases Sources de Données que vous souhaitez utiliser à partir du modèle sont cochées.
    • Dans la colonne Description des sources de données actuelles, cliquez sur Lier une source de données pour accéder à la liste déroulante contenant les sources de données existantes et cliquez sur Suivant.

Dans l'écran suivant, l'intégralité du contenu des Modèles est affichée, par rapport à ce que le Central Point utilise déjà.

Par défaut, lors de la première installation, tout sera défini sur Ajouter (laisser tel quel).

  • Dans le cas d'une première installation, les quatre premières colonnes afficheront Aucune et Jamais installé, les trois suivantes détailleront le contenu du modèle, et les trois dernières vous donneront le choix d' Ajouter, Mettre à jour ou Sauter pendant l'installation.
    Note

    Dans le cas d'une mise à jour, vous pouvez vous référer à Mettre à jour un Modèle pour plus de détails.

  1. Cliquez sur Suivant (cela peut prendre du temps).
  1. Une fois cette opération terminée, une fenêtre vous demandera d'entrer les paramètres nécessaires à la création des objets personnalisés.
  2. Si plus d'un Environnement a été créé, vous verrez une colonne par Environnement. Vous pouvez décocher une case Environnement, auquel cas les Scripts Globaux ne s'exécuteront pas.


  1. Complétez les paramètres, voir les exemples ci-dessous, et cliquez sur Suivant.
  1. Après l'importation, un Rapport d'Exécution sera produit, comme indiqué ci-dessous.
    Note

    La première section concerne la Source de Données ERP et la suivante la Source de Données Cube.

    Vous pouvez cliquer sur le bouton pour voir les détails de chaque script individuellement. Si aucune panne n'est signalée, fermez la fenêtre.

  1. Si l'un des scripts ne s'exécute pas, une icône d'échec s'affiche. Cliquez sur le symbole d'échec pour afficher la fenêtre Aperçu du Rapport, qui affiche le script SQL correspondant.
  • Copiez ce script, déboguez, et exécutez le séparément si nécessaire. Les utilisateurs qui maîtrisent SQL peuvent le déboguer directement dans la fenêtre Aperçu du Rapport et l'exécuter en cliquant sur le bouton Essayer de le ré-exécuter.

Mettre à jour un Modèle

Important

Quelques considérations dont vous devez tenir compte avant de commencer :

  • Faire de nouvelles sauvegardes de la base de données SEI et du Central Point est fortement recommandé avant de faire la mise à jour du modèle.
  • Vérifier les Modèles de Données de SEI et les Objets SQL Personnalisés de SEI qui peuvent avoir été livrés avec la version initiale du modèle, car vous pourriez perdre ces personnalisations lors de la mise à jour.
  • Vous devez disposer d'une version de modèle correspondant à la version du logiciel installée. Si vous utilisez SEI dans sa version 9, le modèle doit également être à la version 9.

Lors d'une mise à jour du logiciel SEI, seule la version du logiciel est mise à jour, et non le modèle. En d'autres termes, les Modèles de Données et les Vues SEI existants ne seront pas affectés.

Note

Après une mise à jour du logiciel, il n'est pas obligatoire d'effectuer systématiquement une mise à jour du modèle. Une mise à jour du modèle est utile si vous avez rencontré des problèmes avec des Modèles de Données SEI spécifiques ou des objets SQL personnalisés SEI car elle inclut des correctifs.

Pour mettre à jour un modèle :

  1. Après avoir mappé les Sources de données, cochez les cases des objets que vous souhaitez mettre à jour et cliquez sur Suivant.
    Note

    Par défaut, aucune case à cocher dans la colonne Mise à jour ne sera cochée. S'il y a un nouveau Modèle de Données ou une nouvelle Vue, la case Ajouter sera cochée. Sélectionnez Sauter si vous voulez l'ignorer.

    Important

    Si vous cochez la case Mettre à jour, il écrasera les objets SEI existants associés à ce modèle de données ou connectés aux autres (dépendances). Veuillez noter que si des personnalisations ont été faites, elles seront perdues.

  1. Sélectionnez l'environnement dans lequel les scripts seront exécutés et cliquez sur Suivant.
  2. Complétez les paramètres et cliquez sur Suivant.
  3. Dans la fenêtre Rapport d'exécution, si l'un des scripts ne s'exécute pas, une icône d'échec s'affiche. Cliquez sur le symbole d'échec pour afficher la fenêtreAperçu du Rapport, qui affiche le script SQL correspondant.
  4. Copiez ce script, déboguez, et exécutez le séparément si nécessaire. Les utilisateurs qui maîtrisent SQL peuvent le déboguer directement dans la fenêtre Aperçu du Rapport et l'exécuter en cliquant sur le bouton Essayer de le ré-exécuter.
Important

Les Navigateurs Web ont mis à jour leur politique concernant les Cookies et ces changements doivent être appliqués à votre Client Web si vous souhaitez intégrer SEI à votre site ERP, ou utiliser l'Authentification Unique (SSO). Reportez-vous à Gestion des Cookies pour plus de détails.