Annexes

Annexe 1 : Comment déterminer la version de Production Scheduler

Il existe plusieurs manières de déterminer la version de Production Scheduler.

1. Sur l'écran de démarrage du Production Scheduler (PlannerOne) Manager.

2. Dans l’onglet Summary (Récapitulatif) du Production Scheduler Manager.



Cliquez sur Show version info (Afficher les informations de version).

3. Dans la section + de la fonction Production Scheduler (FUNPSSCH) (Production > Production Scheduler > Production Scheduler).

Annexe 2 : Comment vérifier la version actuelle du mapping

1. Pour vérifier la version actuelle du mapping, effectuez d'abord une recherche pour JSNX3 et sélectionnez la fonction Mapping transformation JSON-X3.



2. Affichez le code de mapping spécifié dans le tableau, par exemple POPSENVDET.



3. Cherchez l’alias X3 mentionné dans le tableau, par exemple MATFIXDAT.

Annexe 3 : Comment modifier le niveau d'accès du Production Scheduler Manager

Par défaut, le niveau d'accès de Production Scheduler est INFO. Même si cela fournit beaucoup d'informations, ce n'est parfois pas suffisant.

Modifier le niveau d’accès signifie émettre certaines commandes PowerShell.

1. Tout d'abord, lancez une fenêtre PowerShell.



Il est recommandé de lancer PowerShell en tant qu’Administrateur pour éviter les problèmes d'autorisation.



2. Changez de répertoire et sélectionnez le répertoire Production Scheduler PowerShell. Ce répertoire se situe à l'emplacement d'installation de Production Scheduler (habituellement C:\Sage\Planner_one_for_Sage_X3\SAGE.6.0.xxxx\module, où "xxxx' représente le numéro de version).



3. Lancez le script init.ps1.



Toutes les commandes disponibles sont affichées.



4. Vérifiez le niveau d'accès actuel.

Modifiez le niveau d'accès. Le plus haut niveau est DEBUG.

Annexe 4 : Comment utiliser l'application Postman pour identifier les problèmes

Postman est une application autonome permettant l'accès aux bundles et aux web services, sans devoir créer un programme. La dernière version peut être téléchargée ici : https://www.getpostman.com/.

1. Afin d’utiliser Postman pour identifier des problèmes, paramétrez le Type d’autorisation (Authorization Type) sur Autorisation de base (Basic Auth).
2. Ajoutez le nom d'utilisateur (Username) et le mot de passe (Password) Sage X3.



3. Saisissez l'URL pour la requête de données. Le format de l'URL de requête est spécifique, en fonction de l'action. Les requêtes externes et internes sont disponibles. Les données des requêtes internes viennent directement de Sage X3, sans utiliser le bundle.
4. La requête est envoyée à Sage X3 et les données sont renvoyées.



Les éléments mess et sev ne sont pas reconnus par Production Scheduler.

Cependant, dans cet exemple, le message d'erreur est en réalité une erreur de transformation. Les erreurs de transformation suggèrent un problème de mapping.

D'autres erreurs sont possibles, notamment au niveau du code ou des permissions utilisateur.

Parties variables de l’URL

Les parties variables utilisées dans l'URL pour une requête de données sont actuellement les suivantes :

Variable	Partie
{protocol}	http
{host}	Serveur hôte Sage X3
{port}	Numéro de port (si utilisé)
{app}	Dossier Sage X3
{class}	Classe Sage X3
{site}	Code du site (appelé Environment dans PlannerOne)
{timestamp}	Horodatage, au format POSIX Seules les données mises à jour après ce temps seront envoyées.
Variable externe	Partie
{representation}	Représentation Sage X3
nnnnn	Numéro de suivi unique généré par le système d'appel
Variable interne	Partie
{maxrec}	Nombre maximum d'entités par tranche (détaillé dans JSNX3TRAN ou 0 partout)
{endtimstp}	Horodatage maximum utilisé pour consulter les fiches et basé sur la durée d'exécution de la première requête
{curtab}	Table où le nombre d'entités maximum est dépassé
{curkey}	Clé où le nombre d'entités maximum est dépassé

Requêtes de type externe

Requête en masse - récupérer tous les sites

{protocol}://{host}:{port}/bundles/ortems/X3/erp/{app}/{class}?representation={representation}.$bulk&trackingId=nnnnn

Requête détaillée - récupérer toutes les informations d'un site

{protocol}://{host}:{port}/bundles/ortems/X3/erp/{app}/{class}('{site}')?representation={representation}.$details&trackingId=nnnnn

Requête détaillée - récupérer toutes les informations d'un site modifié depuis l’horodatage

{protocol}://{host}:{port}/bundles/ortems/X3/erp/{app}/{class}('{site}~{timestamp}')?representation={representation}.$details&trackingId=nnnnn

Modifier la publication - envoyer les informations pour mise à jour dans Sage X3

{protocol}://{host}:{port}/bundles/ortems/X3/erp/{app}/{class}('{site}')?representation={representation}.$edit&trackingId=nnnnn

Exemples

Requêtes de type interne

Requête détaillée - récupérer toutes les informations d'un site, dont la taille maximum de la tranche de données

{protocol}://{host}:{port}/api1/X3/erp/{app}/{class}('{site}~~{maxrec}')?representation={representation}.$details

Requête détaillée - récupérer toutes les informations d'un site modifié depuis l'horodatage et la taille maximum de la tranche de données

{protocol}://{host}:{port}/api1/X3/erp/{app}/{class}('{site}~{timestamp}~{maxrec}')?representation={representation}.$details

Requête détaillée - récupérer toutes les informations d'un site modifié depuis l'horodatage avec suivi des informations

{protocol}://{host}:{port}/api1/X3/erp/{app}/{class}('{site}~{timestamp}~{maxrec}~{endtimstp}~{curtab}~{curkey}')?representation={representation}.$details{site}- Code du site (appelé Environment dans PlannerOne)

Exemples

Annexe 5 : Comment utiliser Wireshark pour récupérer les données de publication

Wireshark est une application qui surveille le trafic du réseau. Il permet de visualiser les données envoyées et reçues par Production Scheduler. La dernière version peut être téléchargée ici : https://www.wireshark.org/.

1. Pour ajouter un filtre d'enregistrement, cliquez sur l'icône de gestion des filtres dans Wireshark.



Un nouveau filtre peut être saisi.



2. Saisissez le numéro de port Sage X3 et nommez-le.



3. Sélectionnez ce filtre depuis la liste.



4. Cliquez sur le lien du réseau (ici Ethernet 2) pour visualiser le trafic.



La plupart des données du trafic ne seront pas utiles, mais les requêtes POST en particulier seront à privilégier pour les publications.

5. A l'aide de l'option Find Packet, recherchez les requêtes POST.



6. Recherchez POST, en précisant CHAÎNE (STRING) comme type de Filtre d'affichage (Display filter).



La première requête POST est celle qui vous intéresse.



7. Effectuez un clic droit sur le Type de support (Media type). Sélectionnez Copy pour copier les données contenues dans la requête, puis sélectionnez As printable text (Texte imprimable).



8. Une fois que vous avez copié les données, vous devez les afficher. Utilisez Notepad++.
   1. Le résultat que vous obtenez avec Notepad++ n'est pas toujours lisible.

   

   2. Enregistrez le fichier au format JSON, puis pour obtenir une version plus lisible, formatez-le à l'aide d'un plug-in pour la visualisation JSON.