Sage 300

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

DataSync est nécessaire pour Sage 300 uniquement si vous souhaitez consolider les données dans une base de données afin que les Rapports provenant de différentes Sociétés puissent être consultés dans la même base de données.

Important

Il est également recommandé de le faire si vous ne souhaitez pas interroger la base de données ERP qui utilise les Données de Production, et que vous préférez interroger la copie de cette base de données.

Prérequis

Une version de Sage 300 prise en charge par Sage
Une base de données de destination (de préférence, dans la même collation que votre base de données Sage 300 )
Une version valide du DataSync (voir Installer DataSync pour plus d'informations)

Paramétrer les Connexions

Important

Chaque base de données que vous souhaitez consolider nécessite sa propre connexion Source.

Important

Peu importe le nombre de Sources dont vous disposez, vous n'avez besoin que d'une seule connexion de Destination.
Le Fuseau Horaire doit être réglé sur GMT lors de la sélection d'un Type de Suivi par Date.

Suivez la procédure décrite dans Ajouter une Connexion Source et Destination pour créer une connexion Source et une connexion de Destination.

Exemple

Vous devriez obtenir un résultat similaire à ceci pour la connexion Source :

Exemple

Vous devriez obtenir un résultat similaire à ceci pour la connexion de Destination :

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.

Important

Une Extraction par connexion Source créée est nécessaire pour récupérer correctement les données.

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.
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 300, deux fichiers zip seront fournis.

Si vous effectuez une consolidation, importez le fichier DS_EXTR_[Version-Logiciel]_[Version-Extraction]_Sage 300 with refresh DS-CONSO.zip.
Si vous n'avez qu'une seule Compagnie et que vous souhaitez reproduire la base de données, importez le fichier DS_EXTR_[Version-Logiciel]_[Version-Extraction]_Sage 300 with refresh DS-SYNC.zip pour effectuer une synchronisation.

Dans le volet de gauche, sélectionnez le type d'extraction que vous souhaitez effectuer et cliquez sur Suivant.

Important

Si vous effectuez une consolidation, assurez-vous d'avoir le même Nom de Colonne pour le champ Identifiant Unique.

Bien qu'il n'y ait pas de restriction pour Sage 300, il est recommandé d'utiliser CPYID pour le Nom de Colonne et les codes de la Société pour le champ Unique Identifier.

Référez-vous à Configurer le Panneau Extraction pour définir l'extraction et cliquez sur Importer pour terminer le processus.

Vous devriez obtenir un résultat similaire à celui-ci :

Le diagramme ci-dessous illustre la manière dont DataSync traite les données.

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 :

Sélectionnez l'extraction que vous souhaitez valider et construire dans la liste et cliquez sur l'icône Valider et Construire.
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 :

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.

Sélectionnez l'extraction que vous souhaitez exécuter dans la liste et cliquez sur l'icône Lancer l'Extraction Maintenant.
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.

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

Dans le coin supérieur droit, cliquez sur le bouton pour accéder à la section Administration.
Dans le volet de gauche, sélectionnez Env. & Sources de Données.
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.
Dans la section Sources de données, cliquez sur Ajouter pour créer la première source de données.
Terminer la configuration de la source de données ERP. Voir les instructions pour MS SQL Server et Oracle ci-dessous.

Les instructions Oracle suivent

Description de la source de données :: Source de données Sage 300
Type :: SQLSERVER
Serveur :: Serveur de base de données de base de données de Sage 300
Nom de la base de données :: Nom de la Sage 300base de données de synchronisation (attention à la casse)
Nom du schéma de base de données :: Créez les deux entrées suivantes en cliquant sur l'icône (remplacez DatabaseName par la valeur appropriée) :; DatabaseName.dbo; DatabaseName.SEI_CUSTOM_SCHEMA
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 300 base de données de synchronisation. Par exemple, sa.
Mot de passe :: Le mot de passe de l'utilisateur.

Cliquez sur Valider puis sur Enregistrer pour terminer la configuration de la Source de Données.

Pour la Base de Données Oracle

Description de la source de données :: Source de données Sage 300
Type :: ORACLE
Serveur :: Nom du serveur Oracle
SID et Port :: SID et Port de l'instance de la Sage 300base de données
Nom du schéma de la base de données :: Créez 2 entrées en cliquant sur l'icône + :; dbo; SEI_CUSTOM_SCHEMA

Note

Cette seconde ligne contient le Schéma SEI Personnalisé.

Vous pouvez en utiliser un autre, mais nous vous recommandons fortement de suivre cette convention d'appellation :

Commencez par SEI
Utilisez des majuscules
Séparez les mots avec un trait de soulignement

Important

Choisissez un nom de Schéma Personnalisé unique pour chaque Environnement.

Schéma SEI :: Saisissez le schéma SEIpersonnalisé choisi pour l'environnement actuel.
Stratégie d'authentification :: UtilisationSpécifique
Nom d'utilisateur :: Par exemple : system
Mot de passe :: Mot de passe de l'utilisateur.

Cliquez sur Valider puis sur Enregistrer pour terminer la configuration de la Source de Données.

Source de Données du Cube

Important

Seulement si vous installez le modèle UDM par la suite.

Dans le même Environnement que la Source de Données ERP, créez une nouvelle Source de Données pour le Cube OLAP.

Complétez la définition de la source de données avec toutes les informations appropriées.

Les instructions Oracle suivent

La capture d'écran ci-dessous en donne un exemple.

Serveur :: Serveur de base de données sur lequel est installé le paquet d'installation SEI OLAP For SQL Server.
Nom de la base de données :: SEICube.
Nom du schéma de base de données :: SEICube.SEI_FOLDER (remplacer FOLDER par le nom du dossier).; Où SEI_FOLDER (remplacez FOLDER par le nom du dossier) est le schéma utilisé dans la Base de Données ERP du même environnement.
SEIschéma :: Saisissez le schéma personnalisé choisi pour l'environnement actuel.

Cliquez sur Valider puis sur Enregistrer.
Cliquez sur Définir comme entrepôt de données pour définir la source de données comme entrepôt de données, puis entrez les informations suivantes :

Schéma d'entrepôt de base de données :: Saisissez à nouveau le schéma SEI personnalisé que vous avez choisi.
Utilisez MARS pendant le chargement des cubes :: Non contrôlé

Cliquez sur Valider puis sur Enregistrer.

Astuce

Reportez-vous à Environments and Data Sources pour plus de détails sur l'option MARS.

Pour la Base de Données Oracle

Serveur :: Nom du serveur de base de données sur lequel le point central est installé
SID et Port :: Instance SID et Port de la base de données Oracle
Pooling :: L'activation de cette option améliore les performances (pour plus de détails, reportez-vous à Environments and Data Sources pour plus de détails).
Nom du schéma de la base de données :: SEI_CUSTOM_SCHEMA; Où _SEI est le schéma personnalisé utilisé dans la base de données ERP du même environnement CUSTOM_SCHEMA
SEIschéma :: Saisissez le schéma SEIpersonnalisé choisi pour l'environnement actuel.
Schéma d'entrepôt de base de données :: Après avoir sauvegardé la source de données et l'avoir définie comme entrepôt de données, saisissez le schéma SEIpersonnalisé choisi pour l'environnement actuel.

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

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

Dans la fenêtre Importer un Modèle, cliquez sur Sélectionner les fichiers...
Trouvez le dossier où vous avez enregistré le fichier Template.zip afin de le sélectionner puis cliquez sur Ouvrir.
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.

Cliquez sur Suivant (cela peut prendre du temps).

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

Complétez les paramètres, voir les exemples ci-dessous, et cliquez sur Suivant.

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.

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 :

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.

Sélectionnez l'environnement dans lequel les scripts seront exécutés et cliquez sur Suivant.
Complétez les paramètres et cliquez sur Suivant.
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.
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.

Configurer les Champs Optionnels

Les Champs Optionnels est une fonctionnalité issue de Sage 300qui a été importée dans SEI.

Pour Sage 300, il existe sept types de Champs Optionnelsconfigurables :

Variable Globale	Table Sage 300	Nombre de Variables
@@GLOPT	Account	5
@@ICITEMOPT	Item	9
@@ORDOPT	Order	5
@@CUSOPT	Customer	9
@@GLPOSTO	Posted Transaction	5
@@VENDOPT	Vendor	10

Pour accéder aux différents Champs Optionnels disponibles dans Sage 300, vous devez d'abord les configurer à l'aide des Variables Globales disponibles dans le modèle.

Modifier une Variable Globale

Pour modifier une Variable Globale :

Dans la section Administration , cliquez sur Variables Globales dans le volet de gauche.
Dans la liste, sélectionnez une des Variables Globales et cliquez sur le crayon situé à droite.
Modifiez la valeur dans le champ Scriptet cliquez sur Mettre à jour.

Exemple concret

Si nous prenons le rapport Transaction Détaillée comme exemple, nous pouvons voir que les Dimensions représentant les champs optionnels GL Opt Field 1 Code et GL Opt Field 2 Code renvoient une valeur nul.

Comme indiqué dans le tableau ci-dessus, ces Champs correspondent à la table Account et sont définis dans la variable globale @@GLOPT.

Dans cet exemple, nous avons modifié les variables globales @@GLOPT1 et @@GLOPT2 en suivant la procédure décrite dans Modifier une Variable Globale.

Note

Ces Champs Optionnels se trouvent dans la table GLAMFO.

Nous utiliserons les valeurs ACCTCLASS et CASHFLOWTYPE pour les valeurs de Script.

Si nous actualisons le Rapport maintenant, nous pouvons voir que les données de ces Champs Optionnels sont maintenant disponibles.