Modèle Sage 100

Utilisez les liens suivants pour accéder à une section :

• Modèle Sage 100
• Introduction
• Data Sync de Nectari
• Importer les Extractions
• Ajouter une Requête SQL avec un Connecteur ODBC sans Sous-Requête
• Valider et Construire les Extractions
• Lancer les Extractions
• Configuration de la Sources de Données
• Importer des Modèles
• Mettre à jour un Modèle
• Construire et Charger les Cubes OLAP

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.

Data Sync de Nectari

Data Sync est nécessaire pour Sage 100 Premium 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.

Prérequis

• Une version de Sage 100 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 100 )
• Une version valide du Data Sync (voir Installer Data Sync pour plus d'informations)

Paramétrer les Connexions

Paramètres pour Sage 100 Premium

Si vous utilisez Sage 100 Premium, procédez comme suit. Si ce n'est pas le cas, reportez-vous à Paramètres pour Sage 100 Standard.

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

Paramètres pour Sage 100 Standard

1. Dans Data Sync, cliquez sur la tuile Connexions.
2. Dans le coin supérieur gauche, cliquez sur Nouveau pour créer une nouvelle connexion Source .
   
3. Dans la liste, sélectionnez ODBC.

Panneau Propriétés de la Connexion

1. Dans le champ Description, entrez un nom pour cette connexion.
2. Laissez les champs Expression Nulle sur leurs valeurs par défaut.
3. Entrez un guillemet simple dans les champs Délimiteur de la Chaîne Constante.
4. Dans la section ci-dessous, cochez toutes les cases à l'exception des cases Prise en charge des schémas et Prise en charge des sous-requêtes.

5. Lorsque vous cochez la case Prise en charge des Guillemets, ne cochez que les cases Alias et Colonnes.
6. Entrez un guillemet simple dans les champs Délimiteur Gauche et Délimiteur Droit.
7. Laissez les autres Champs sur leurs valeurs par défaut.
8. Dans la liste déroulante Chargement des Métadonnées, sélectionnez À partir de l'instruction SELECT.
   

Panneau Autres Propriétés de la Connexion

• Cliquez sur Ajouter une propriété pour ajouter les propriétés décrites dans le tableau ci-dessous :

Panneau Paramètres Avancés

1. Dans la liste déroulante Type de Suivi, sélectionnez Date.
2. Réglez le fuseau horaire sur l'heure du serveur d'application Sage 100.

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

3. Cliquez sur Enregistrer pour terminer.

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.

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

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

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

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

Ajouter une Requête SQL avec un Connecteur ODBC sans Sous-Requête

Lorsque les Sous-Requêtes sur votre connexion Source pour ODBC sont désactivées, Data Sync de Nectari n'analyse plus votre code avec les paramètres et exécute uniquement le code brut saisi dans la fenêtre Requête SQL. Notez que les ERPs tels que Sage 100 Standard utilisent un ancien Pilote ODBC, qui ne prend pas en charge les Sous-Requêtes, et peut limiter les capacités.

Lorsque vous ajoutez une Requête SQL (voir Configurer les Champs), il vous faudra tenir compte de plusieurs aspects :

1. Si les Délimiteurs sont absolument nécessaires avec votre Pilote ODBC, vous devrez les définir.
2. Pour faire une Jointure, vos Tables doivent être placées à l'intérieur de {oj [...]}.

SELECT Customer.*
FROM {oj Customer INNER JOIN SalesReps ON Customer.SALESREP = SalesReps.SALESREP}

3. Vous ne pouvez pas utiliser * (astérisque) sans Alias dans votre instruction SELECT si votre instruction SELECT joint plus d'une table. Bien que cela ne vous donne pas forcément une erreur, il y a un risque d'introduire des erreurs lorsque vous avez plusieurs Colonnes possédant le même nom dans différentes Tables .

Voici un exemple d'une instruction qui provoquerait des erreurs :

SELECT *
FROM {oj Customer INNER JOIN SalesReps ON Customer.SALESREP = SalesReps.SALESREP}

4. Vous ne pouvez pas utiliser plusieurs * (astérisque) avec un Alias dans votre instruction SELECT. Ce problème s'applique également aux multiples Colonnes portant le même nom, bien que cela se casse simplement lors de l'exécution de la tâche Traitement des Enregistrements Supprimés, car il ne sera pas possible de trouver de quelle Table provient le Champ.

Voici un exemple d'une instruction qui provoquerait des erreurs :

SELECT Customer.*, SalesReps.*
FROM {oj Customer INNER JOIN SalesReps ON Customer.SALESREP = SalesReps.SALESREP}

5. Évitez de créer des Champs Calculés dans l'instruction SELECT. Utilisez plutôt les options du menu de la section Champ (voir Configurer les Champs). Dans la plupart des cas, cela ne posera pas de problème. Toutefois, lors de la définition de ce Champ en tant que Clé primaire ou Clé de Suivi, vous risquez d'introduire une erreur lors de l'exécution des tâches Charge Incrémentale ou Traitement des Enregistrements Supprimés.

Ajouter une Table non incluse dans le fichier zip de l'Extraction

• Reportez-vous à Configurer les Champs pour utiliser le Champ Calculé suivant comme Clé de Suivi pour la tâche Charge Incrémentale si vous souhaitez ajouter une table :

{fn TIMESTAMPADD(SQL_TSI_SECOND,
{fn CONVERT( {fn FLOOR(  {fn CONVERT(TimeUpdated,SQL_FLOAT)} * 3600 ) } - {fn CONVERT( {fn FLOOR(  {fn CONVERT(TimeUpdated,SQL_FLOAT)} ) }, SQL_INTEGER) } *3600, SQL_INTEGER) },
{fn TIMESTAMPADD(SQL_TSI_HOUR, {fn CONVERT( {fn FLOOR(  {fn CONVERT(TimeUpdated,SQL_FLOAT)} ) }, SQL_INTEGER) } ,{fn CONVERT(DateUpdated,SQL_TIMESTAMP)} )}  )}

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

3. Attendez que le processus soit terminé.

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.

3. Attendez que le processus soit terminé.

Configuration de la Sources de Données

Environnements et sources de données

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 :

Si vous utilisez Data Sync :

Sage 100 DATASYNC

Si vous n'utilisez pas Data Sync :

Sage 100 VIEWS

Pour le modèle UDM :

Sage 100 TABLES

Type :

SQLSERVER

Serveur :

Serveur de base de données de base de données de Sage 100

Nom de la base de données :

Nom de la Sage 100base 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) :

Si vous utilisez Data Sync :

DatabaseName.SchémaDestinationDansDataSync

DatabaseName.NEC_CUSTOM_SCHEMA

Si vous n'utilisez pas Data Sync :

DatabaseName.NEC_CUSTOM_SCHEMA

DatabaseName.dbo

Pour le modèle UDM :

DatabaseName.dbo

DatabaseName.NEC_CUSTOM_SCHEMA

Note

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

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

• Commencez par NEC
• Utilisez des majuscules
• Séparez les mots par un trait de soulignement

Important

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

Nectarischéma :

Saisissez le schéma Nectaripersonnalisé choisi pour l'environnement actuel.

Stratégie d'authentification :

UtilisationSpécifique

Nom d'utilisateur :

Utilisateur SQL accédant à laSage 100 base de données de synchronisation. Par exemple, sa.

Mot de passe :

Le mot de passe de l'utilisateur.

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

Source de Données du Cube

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.

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 Nectari OLAP For SQL Server.

Nom de la base de données :

NectariCube.

Nom du schéma de base de données :

NectariCube.NEC_FOLDER (remplacer FOLDER par le nom du dossier).

Où NEC_FOLDER (remplacez FOLDER par le nom du dossier) est le schéma utilisé dans la Base de Données ERP du même environnement.

Nectarisché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 Nectari personnalisé que vous avez choisi.

Utilisez MARS pendant le chargement des cubes :

Non contrôlé

• Cliquez sur Valider puis sur Enregistrer.

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
• Nectari Schéma personnalisé
• Schéma ERP

Téléchargez le fichier du Modèle : TPL_9.X.XXX_Sage100Conso.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é.

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

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

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

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

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

Lors d'une mise à jour du logiciel Nectari, 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 Nectari existants ne seront pas affectés.

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

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

Construire et Charger les Cubes OLAP

Pour créer la structure de la base de données Cubes dans la base Nectaride données Cube précédemment installée, vous devez Construire le Cube.

1. Dans le coin supérieur droit, cliquez sur pour accéder à la section Administration.
   
2. Dans le volet de gauche, cliquez sur OLAP Manager.
3. Dans le volet de droite, cliquez sur Gérer.
   
4. Dans la section de gauche, sélectionnez tous les cubes à construire en cochant la case à côté de la colonne Description.
5. Dans la fenêtre Gérer, sélectionnez Construire dans la liste déroulante Action puis le(s) environnement(s) et cliquez sur Confirmer.
   
6. Dans la fenêtre Confirmation, cochez la case et cliquez sur Oui.
   
7. En cas d'erreur, reportez-vous à Logs pour activer la fonction d'enregistrement.

Maintenant que les cubes sont construits, vous pouvez les remplir.

1. Dans le volet de droite, cliquez sur Gérer.
2. Dans la section de gauche, sélectionnez tous les cubes à charger en cochant la case à côté de la colonne Description.
3. Dans la fenêtre Gérer, sélectionnez Charger tout dans la liste déroulante Action puis le(s) environnement(s) et cliquez sur Confirmer.
   
4. Dans la fenêtre Confirmation, cochez la case et cliquez sur Oui.
   

L'installation du modèle est maintenant terminée.

Il est maintenant possible de programmer des rafraîchissements de données réguliers pour les Cubes. Pour plus de détails sur la manière de procéder, voir Planificateur.

Remplir les Codes Postaux

Lors de l'importation, une table est créée dans le Schéma Nectari Personnalisé pour les codes postaux.

Bien que la Table ZIP ne soit pas nécessaire pour que le modèle Sage 100 fonctionne, il est recommandé de télécharger et de remplir la Table ZIP avec un transfert de données récent des codes postaux, y compris les détails (latitude, longitude).