​

Prérequis

Cette version de Sage 100 est disponible sur un environnement Microsoft Azure avec administration possible, full SaaS-PaaS-IaaS. Elle est exclusivement commercialisée par les revendeurs Sage 100 appelés intégrateurs avec :

• Un accès natif au moteur Microsoft SQL Server Azure.
• Un accès aux objets métiers spécifiques à Sage 100 SPC.

⚠ Il est fortement recommandé de contacter votre partenaire informatique ou votre intégrateur Sage pour établir la connexion de votre logiciel comptable. ATTENTION : Cette version de Sage 100 NE NÉCESSITE PAS l’installation de la librairie Objets Métiers de Sage 100 On Premise. Une version dédiée est installée par défaut par Sage. Si vous rencontrez des problèmes après l’installation du connecteur, veuillez vérifier que la librairie Objets Métiers de Sage 100 On Premise n’a pas été installée durant le processus d’installation. Si la librairie Objets Métiers de Sage 100 On Premise a été installée par erreur, veuillez suivre ces étapes pour restaurer la version correcte de la librairie Objets Métiers de Sage 100 SPC :

1. Désinstallez la librairie Objets Métiers de Sage 100 On Premise
2. Mettez à jour la machine virtuelle vers la version actuellement installée. Cela forcera l’installation de la version correcte de la librairie Objets Métiers de Sage 100 SPC

​

🛠 PRÉPARATION (informations nécessaires avant la connexion)

Afin d’établir la connexion avec Sage 100 « On Premise », vous devrez récupérer un certain nombre d’informations sur votre instance Sage 100 et auprès du partenaire intégrateur qui a installé votre instance Sage 100.

1. Trouver le code de votre dossier / société
2. Récupérer le numéro de la zone / du plan analytique
3. Récupérer le nom de votre instance Azure SQL et de votre base de données
4. Récupérer vos identifiants SQL

Les étapes 3 et 4 nécessiteront très probablement de contacter votre intégrateur, car il s’agit d’informations techniques auxquelles vous n’avez peut-être pas accès.

​

1. Trouver le code de votre dossier / société

Cette information est visible depuis votre instance Sage 100 tout en haut de votre page dans une barre de menu. Au centre de ce bandeau « menu », vous verrez le code de votre dossier (société) indiqué.

​

2. Récupérer le numéro de la zone/du plan analytique

Pour identifier le numéro de la zone/du plan analytique, vous devez suivre ces étapes depuis votre instance Sage 100.

• Menu → Structure → Plan analytique

Vous devez choisir le plan analytique à connecter. Dans l’exemple de compte ci-dessous, nous avons 4 plans analytiques possibles

• Activité = 1 (renseignez le numéro 1 pour sélectionner la première option de plan analytique)
• Produits et services = 2 (renseignez le numéro 2 pour sélectionner la deuxième option de plan analytique)
• Affaire = 3 (renseignez le numéro 3 pour sélectionner la troisième option de plan analytique)
• et ainsi de suite…

​

3. Récupérer le nom de votre instance Azure SQL et de votre base de données

Afin d’installer l’extension sur le cloud, vous devrez :

• Contacter votre intégrateur Sage 100.
  • Lui demander de vous fournir les informations suivantes :
    • Le nom de votre instance (serveur) SQL Azure (ressemble à un code comme « xiyxu8z271 »)
    • Le nom de la base de données SQL Azure (ressemble à un code comme « xim9mokrk4q_AS274AY1ZH »)

​

4. Récupérer votre nom d’utilisateur et mot de passe Azure SQL

Vous devez contacter votre intégrateur Sage 100 et lui demander de vous fournir les informations suivantes :

• Nom d’utilisateur SQL Server Sage 100
• Mot de passe SQL Server Sage 100

​

Connexion

Étape 1 : Choisissez un nom pour votre connexion (peut varier selon les outils auxquels vous vous connectez). Ce nom est purement informatif, nous recommandons donc d’utiliser le nom du dossier comptable qui va être connecté. Étape 2 : Cliquez sur « Connecter » pour finaliser la connexion et télécharger l’agent local

​

Téléchargement et installation de l’agent local

​

Étape 1 : Télécharger le fichier Zip

Après l’étape de connexion, vous aurez deux options pour télécharger et installer l’agent local sur le même serveur/ordinateur que votre instance Sage 100 :

• Si vous avez un accès administrateur au serveur/ordinateur où Sage 100 est installé, vous pouvez directement télécharger le programme en cliquant sur Télécharger. Sinon, un lien pour télécharger le même fichier Zip sera envoyé par email à l’adresse que vous fournirez.
• Un dossier zip s’ouvrira et vous proposera plusieurs fichiers.
  • Lancez l’installation du dossier « local agent » portant le numéro correspondant au numéro de version de votre Sage.
  • Pendant l’installation, vous devrez sélectionner le fichier « settings.json » pour terminer les étapes d’installation.
• Si Sage 100 est installé sur un serveur/ordinateur auquel vous n’avez pas d’accès administrateur, vous avez la possibilité d’envoyer le programme par email à la personne ou à l’entreprise qui possède l’accès administrateur au serveur/ordinateur où Sage 100 est installé

​

Étape 2 : Installer le Cockpit (s’il n’a pas déjà été installé)

Pour installer le cockpit, veuillez suivre les étapes documentées dans l’article suivant : 📄 Local Agent Cockpit — Guide utilisateur Si le Cockpit a déjà été installé sur votre serveur, vous pouvez le démarrer en tant qu’administrateur et aller directement dans la section Sage 100 FR GC du cockpit.

​

Étape 3 : Connecter votre dossier via le Cockpit

Téléchargement et installation de l’agent local

​

Étape 1 : Télécharger le fichier Zip

Après l’étape de connexion, vous aurez deux options pour télécharger et installer l’agent local sur le même serveur/ordinateur que votre instance Sage 100 :

• Si vous avez un accès administrateur au serveur/ordinateur où Sage 100 est installé, vous pouvez directement télécharger le programme en cliquant sur Télécharger. Sinon, un lien pour télécharger le même fichier Zip sera envoyé par email à l’adresse que vous fournirez.
• Un dossier zip s’ouvrira et vous proposera plusieurs fichiers.
  • Lancez l’installation du dossier « local agent » portant le numéro correspondant au numéro de version de votre Sage.
  • Pendant l’installation, vous devrez sélectionner le fichier « settings.json » pour terminer les étapes d’installation.
• Si Sage 100 est installé sur un serveur/ordinateur auquel vous n’avez pas d’accès administrateur, vous avez la possibilité d’envoyer le programme par email à la personne ou à l’entreprise qui possède l’accès administrateur au serveur/ordinateur où Sage 100 est installé

​

Étape 2 : Installer le Cockpit (s’il n’a pas déjà été installé)

Pour installer le cockpit, veuillez suivre les étapes documentées dans l’article suivant : 📄 Local Agent Cockpit — Guide utilisateur Si le Cockpit a déjà été installé sur votre serveur, vous pouvez le démarrer en tant qu’administrateur et aller directement dans la section Sage 100 FR GC du cockpit.

​

Étape 3 : Connecter votre dossier via le Cockpit

Pour créer la connexion avec votre dossier GCM, veuillez cliquer sur le bouton Add connection en haut de l’écran. Cela ouvrira un nouvel onglet qui vous demandera de sélectionner un fichier settings.json. Ce fichier est le fichier contenant toutes les informations techniques permettant au cockpit de créer la bonne connexion avec votre dossier. Chaque dossier que vous souhaitez connecter via le cockpit nécessitera un settings.json distinct qui devra être téléchargé séparément. Une fois le fichier settings.json ouvert, une connexion supplémentaire devrait apparaître dans le Cockpit. Cette connexion n’a pas encore été configurée. Pour démarrer la configuration de cette connexion, cliquez sur la connexion pour ouvrir le menu de configuration. Remplissez le formulaire avec les différentes valeurs que vous avez récupérées lors de l’étape Préparation de la documentation.

• Company Code : c’est le code de votre Société dans Sage, issu de la première étape de la section Préparation.
  • exemple : BIJOU
• Sage 100 username : c’est l’email de l’utilisateur utilisé pour se connecter à Sageonline. Cet utilisateur doit avoir accès au dossier que vous connectez.
• Azure SQL Server name : c’est le nom de votre serveur SQL (devrait se terminer par .windows.database.net). Vous pouvez supprimer la partie finale pour ne fournir que la version courte, mais les deux versions devraient être gérées par le connecteur. Vous devriez avoir demandé cette information à votre intégrateur lors de la Préparation - étape 3.
• Azure SQL database name : c’est le nom de votre base de données SQL. Vous devriez avoir demandé cette information à votre intégrateur lors de la Préparation - étape 3.
• Azure SQL Username : c’est le nom d’utilisateur d’un utilisateur SQL qui a accès à la base de données du dossier que vous connectez. Vous devriez avoir demandé cette information à votre intégrateur lors de la Préparation - étape 4.
• Azure SQL Password : c’est le mot de passe de l’utilisateur SQL que vous venez de fournir. Vous devriez avoir demandé cette information à votre intégrateur lors de la Préparation - étape 4.

Vous pouvez laisser tous les autres champs vides, ceux-ci ne sont pas utilisés par la version SPC du connecteur. Une fois tous les champs remplis, vous devriez avoir quelque chose de similaire à ceci : Vous pouvez ensuite cliquer sur le bouton Save pour enregistrer toutes les valeurs fournies. Une fois les modifications enregistrées, une nouvelle fenêtre apparaîtra pour vous demander si vous souhaitez redémarrer le service : Toutes les modifications ne sont appliquées qu’au démarrage du service. Donc si vous voulez que ces modifications soient appliquées, vous devez cliquer sur oui. Si vous souhaitez ajouter d’autres connexions avant de démarrer le service, vous pouvez cliquer sur non et ajouter la connexion concernée avant de démarrer le service. Une fois le service redémarré, vous pouvez tester vos connexions grâce au module Health. Pour lancer le test, il vous suffit de cliquer sur le bouton « Check health ». Le service effectuera quelques tests pour s’assurer que tout a été configuré correctement. Si vous avez une erreur dans la configuration, certains tests échoueront avec des messages d’erreur qui devraient indiquer l’élément à l’origine du problème (mot de passe invalide, pas d’accès aux dossiers, etc.). Si tout a été configuré correctement, vous devriez voir tous les tests apparaître en vert. Votre connexion devrait donc être pleinement fonctionnelle.