Résolution de problèmes

Vue d'ensemble

Dans cette section, vous trouverez des instructions pour résoudre étape par étape les problèmes les plus fréquemment rencontrés en utilisant Production Scheduler.

Prérequis

Avant de tenter de résoudre les problèmes rencontrés avec Production Scheduler, assurez-vous d'avoir installé les versions adéquates de Sage X3, de Production Scheduler et les données de mapping associées.

Le tableau ci-dessous énumère les éléments requis pour chaque niveau de patch.

Livraison Sage X3/Production Scheduler : Liste des éléments nécessaires pour Sage X3 selon la version Sage X3

Niveau de patch Sage X3 Version de Production Scheduler Version des données de mapping de transformation

Attribut unique du mapping
(Code mapping - alias X3)

V11.0.1

6.0.1651

Tous enregistrements

V11.0.2

6.0.1651

Tous enregistrements

V11.0.3

6.0.1651

Tous enregistrements

V11.0.4

6.0.1705

POPSENVDET - MATFIXDAT

V11.0.5

6.0.1723

POPSENVDET - CUSVAL

V11.0.6

6.0.1739

POPSENVDET - PRVWOID

POPSENVUPDEDIT - STROPEDT

V11.0.10 / V12.0.3

6.0.1829

POPSENVUPDEDIT - STROPEDT

V11.0.11 / V12.0.15

6.0.1842

POPSENVUPDEDIT - STROPEDT

Un contrôle du mapping est effectué lorsque vous ouvrez la fonction Production Scheduler (FUNPSSCH). Cette fonctionnalité est disponible à partir des versions V11 patch 12 et V12 patch 16.

Résolution de problèmes - Exemple 1 : Site non initialisé

Plusieurs raisons peuvent empêcher l'initialisation d'un site dans Production Scheduler. Les raisons les plus fréquemment rencontrées sont listées ci-dessous.

Veuillez contacter l'assistance si malgré ces informations, votre problème persiste.

Identification du problème

  1. Vérifiez l'onglet Summary dans le Production Scheduler Manager.
  2. Si un site n’est pas initialisé dans Production Scheduler, il peut s’agir d’une erreur ou d’un avertissement relatif à Production Scheduler ERP Adapter.

Informations de configuration invalides

  1. Pour détecter une erreur de connexion, vérifiez d'abord l'onglet Configuration Manager .
  2. Une icône d’avertissement (rouge) indique que Production Scheduler ne parvient pas à établir la connexion avec Sage X3, ce qui signifie que les informations fournies sont erronées.
    • Votre nom d'utilisateur et/ou votre mot de passe Windows (ou Sage X3) sont-ils valides ?
    • Le nom du serveur est-il correct ?
    • Les champs REST services port (numéro du port Sage X3) et Instance (nom du dossier Sage X3) sont-ils corrects ?

Aucun accès à Sage X3 (processus de démarrage)

Ce problème est similaire au problème précédent (Informations de configuration invalides). Cependant, la cause du problème est différente.

  1. Pour commencer, ouvrez l’onglet Configuration Manager (gestionnaire de configuration) pour savoir s'il s'agit d'une erreur de connexion.
    1. Une icône d'avertissement (rouge) indique que Production Scheduler ne parvient pas à établir la connexion avec Sage X3.
    2. Une icône d'information (orange) indique que Production Scheduler ne peut pas vérifier la connexion au serveur.

      Il est possible que Sage X3 soit indisponible car il est encore en cours de démarrage.

    Corrigez la séquence de démarrage des serveurs afin que le serveur Production Scheduler soit le dernier à démarrer.
Il peut être nécessaire de redémarrer le service pour appliquer vos changements.

Connexion à Sage X3 sans initialisation

Après vérification des informations de connexion, Production Scheduler peut communiquer avec Sage X3. Cependant, les sites ne sont toujours pas initialisés.

  1. Pour comprendre ce problème, ouvrez l'onglet Logging (Trace) dans Production Scheduler.
  2. Une fois le service de Production Scheduler lancé, vous pouvez choisir la trace (log) à afficher.
  3. Il est préférable de sélectionner PlannerOneApplication.log puisqu’il s’agit de la trace la plus récente. Cette trace ne contient pas seulement les erreurs, mais aussi toutes les informations.

  4. Cliquez sur Open/Refresh log (Ouvrir/Actualiser trace).

  5. La trace est à présent ouverte. Cependant, seules les anciennes informations sont listées.
    1. Pour afficher les données les plus récentes, sélectionnez la case Follow tail (Afficher la fin de liste).
    2. Pour afficher les données les plus à jour, sélectionnez la case Auto refresh (Actualisation auto.). La trace est ainsi automatiquement mise à jour avec les nouvelles données.

    Avertissement : Il est impossible de naviguer dans la trace lorsque Auto refresh est activé.

  6. Les informations de la trace ne révèlent pas d’erreurs, seulement des informations générales.
  7. Pour un aperçu rapide des erreurs, ouvrez l'onglet Error list (Liste des erreurs). Cet onglet vous propose une brève description des erreurs.
  8. Cliquez sur l'erreur pour plus d'informations.
  9. Cliquez sur le double chevron (>>) pour obtenir des détails plus précis.

Ces informations devraient être suffisantes pour déterminer la source du problème.

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

Problème avec les données de mapping

Une fois que vous avez identifié un problème au niveau des données du mapping, la correction à appliquer est simple.

Intégrer la version de patch appropriée pour la version de Sage X3.
Le tableau dans Résolution des problèmes > Prérequis vous indique la version des données de mapping à patcher en fonction de la version de Sage X3.

 

Votre système devrait fonctionner normalement une fois la version correcte du mapping installée.

Problème dans le code

Un problème au niveau du code peut parfois être à l'origine de la non-initialisation d'un site dans Production Scheduler. Ce type de problème est rare, car la plupart des problèmes de code ont déjà été rencontrés et corrigés.

Certains problèmes de ce type n’ayant pas encore été détectés peuvent, toutefois, encore exister.

  1. Les problèmes de code peuvent paraître similaires aux problèmes de mapping, car ils génèrent le même avertissement : sev/mess unexpected property in the log file. L'identification du problème est la même.

    Vous pouvez utiliser l’annexe Comment utiliser l'application Postman pour identifier les problèmes.

  2. Le message d’erreur généré n'est pas toujours suffisamment détaillé.

    Vous pouvez utiliser Postman pour générer directement une requête interne à Sage X3 pour obtenir plus de détails.

Vous obtenez ainsi l'erreur exacte, ainsi que le script et la ligne où l'erreur se produit.

Résolution de problèmes - Exemple 2 : Accès à Production Scheduler impossible depuis Sage X3

Vous pouvez habituellement accéder à Production Scheduler via une fonction de Sage X3, par exemple Production Scheduler (FUNPSSCH) (Production > Production Scheduler > Production Scheduler).

Si cet accès ne fonctionne pas, il faut étudier le problème et chercher à le comprendre.

Cette section vous montre comment détecter et résoudre les causes probables d’une connexion impossible à Production Scheduler.

Service de publication World Wide Web non exécuté

Afin de vérifier si le service de publication World Wide Web est en cours d'exécution, ouvrez le programme Services.

Vérifiez l’état du service de publication World Wide Web. Il devrait afficher En cours d’exécution.

S’il n'est pas en cours d'exécution, ce qui est courant sur les machines virtuelles modèles (telles que celles utilisées par les partenaires), démarrez le service de publication World Wide Web.

Site web Production Scheduler arrêté

Si vous obtenez le message d’erreur Cannot get or validate token, le site web de l'instance n’est probablement pas en cours d'exécution.

Vérifiez le Gestionnaire des services IIS pour le site web de l'instance.

Si le site web n'est pas en cours d'exécution, démarrez le.

Service Production Scheduler arrêté

Si vous obtenez à nouveau l'erreur Cannot get or validate token, le service Production Scheduler n’est probablement pas en cours d’exécution.

  1. Vérifiez l'onglet Summary dans le Production Scheduler Manager.
  2. Si le Service Windows affiche l'état Sur erreur (rouge), vérifiez l’onglet Service Windows pour voir s'il y a un problème, ou si le service est en cours d'exécution.
  3. Sélectionnez le service adéquat pour cette instance et cliquez sur Select.
  4. Si le statut indique que le service est arrêté, démarrez le service.

Paramètre PSCLIENTID non configuré

Si le Message d'information suivant s’affiche : Unable to obtain authentication token, Sage X3 ne peut pas créer le jeton d'authentification à envoyer à Production Scheduler.

Cela signifie que l’ID client n’est pas renseigné ou qu’il est invalide.

  1. Vérifiez le paramètre PSCLIENTID - ID client Production Scheduler (chapitre EXAPP, groupe MIS).
  2. Assurez-vous que dans la Liste des applications connectées dans la fonction Applications connectées (Administration > Administration > Paramétrages > Authentification > Applications connectées) l'ID client correspond à celui de l’instance.

Données d'application connectée incorrectes

Si vous obtenez à présent l'erreur suivante : Production Scheduler took too long to respond.

Vérifiez que l’URL est correcte dans la Liste des applications connectées de la fonction Applications connectées (Administration > Administration > Paramétrages > Authentification > Applications connectées).

 

Production Scheduler devrait à présent fonctionner correctement.

Résolution de problèmes - Exemple 3 : Flux de données de Sage X3 vers Production Scheduler

Une fois que tout est correctement configuré, les données peuvent être envoyées de Sage X3 vers Production Scheduler. Cependant, il se peut que certains ordres de fabrication n'apparaissent pas dans Production Scheduler.

Cette section a pour but de vous expliquer comment détecter ces types de problèmes et les résoudre.

Des numéros séquentiels vous permettent d'effectuer le suivi des ordres de fabrication manquants.

Consignes générales en cas d’ordres de fabrication manquants

S'il manque des ordres de fabrication dans Production Scheduler et qu'il est difficile de déterminer ceux qui sont à l'origine du problème :

Supprimez tous les ordres de fabrication de Production Scheduler puis ajoutez-les à nouveau un par un.

S'il y a trop d'ordres de fabrication, ajoutez-les sous la forme de petits lots pour réduire le nombre d'ordres de fabrication pouvant poser problème.

Données non valides dans Sage X3

S'il manque des ordres de fabrication dans Production Scheduler, certaines données dans Sage X3 peuvent être incorrectes.

  1. Vérifiez l'onglet Summary dans le Production Scheduler Manager.
    1. Production Scheduler Manager signale que tous les éléments sont au statut Ready (vert).
    2. Il est normal que l'élément Resource Planner ERP Adapter reste au statut Unknown (point d'interrogation).

    3. Ces erreurs de service Windows sont répertoriées.
    4. Elles doivent être examinées.

  2. Afin de comprendre ces erreurs de service Windows, consultez l’onglet Error list.

  3. Consultez les détails de l'erreur.
  4. Le détail précise qu'il manque une ressource : Resource does not exist.

    La partie R_ est ajoutée par Production Scheduler.

  5. Vérifiez si les ordres de fabrication utilisent la ressource manquante (poste de charge).
  6. Vérifiez si le poste de charge manquant est un poste de charge valide.

C'est pourquoi une erreur survient dans Production Scheduler.

  1. Vous devez alors vérifier tous les autres ordres de fabrication qui utilisent le poste de charge manquant.
  2. Si les autres ordres de travail manquants n’utilisent pas ce poste de charge, vous devez examiner l’erreur plus en détail.
  3. Vérifiez tous les postes de charge utilisés par l'ordre de fabrication.
  4. Le poste de charge manquant est-il défini comme un poste de charge de remplacement ?


Identifiez parmi tous les ordres de fabrication manquants ceux qui présentent le même problème et changez les postes de charge.

 

Tous les ordres de fabrication devraient à présent s’afficher dans Production Scheduler.

Autres problèmes de données

Certaines erreurs de données peuvent être à l’origine de problèmes lors de l’initialisation du site. Cela peut provoquer des erreurs qui ne sont pas visibles depuis la trace.

  1. Consultez la trace dans Production Scheduler Manager.
  2. Vous pouvez utiliser l’annexe Comment utiliser l'application Postman pour identifier les problèmes.
  3. Pour trouver l'ordre de fabrication à l'origine du problème, appliquez les instructions suivantes : supprimez tous les ordres de fabrication et ajoutez les à nouveau, un par un.

Vous devrez probablement supprimer l'ordre de fabrication posant problème de Production Scheduler.

Vous pouvez aussi clôturer l’ordre de fabrication.

Ce problème a été résolu en V11 patch 7.
  1. Consultez à nouveau la trace dans Production Scheduler Manager.
  2. Vous pouvez utiliser Postman pour obtenir plus d’informations.
  3. Pour trouver l'ordre de fabrication à l'origine du problème, appliquez les instructions suivantes : supprimez tous les ordres de fabrication et ajoutez les à nouveau, un par un.
  4. Cliquez sur l'action Jalonnement pour consulter les données du jalonnement.
  5. Cliquez sur Graphique pour afficher le graphique.
  6. Cliquez maintenant sur l'action Afficher la liste pour consulter la liste des opérations.
  7. Vérifier l'heure à laquelle l’opération est censée se terminer.
  8. Cette erreur est causée par une différence entre la capacité du poste de charge et la capacité par défaut du site.


Cette solution permet de s'assurer que le schéma horaire associé au schéma hebdomadaire est en cohérence avec la capacité.

Ce problème a été résolu en V11 patch 8.

 

Tous les ordres de fabrication devraient à présent s’afficher dans Production Scheduler.

Problèmes de mapping

Les problèmes de mapping n'empêchent pas nécessairement l'envoi d'un ordre de fabrication vers Production Scheduler. En revanche, ils peuvent empêcher le transfert de données.

  1. Contrôlez les données envoyées à Production Scheduler. Postman est utilisé pour visualiser les données de Sage X3.
Vous pouvez convertir la date et l’heure en horodatage sur le site web suivant : OnlineConversion.
  1. Utilisez à nouveau Postman, mais cette fois avec api1 au lieu du bundle.
  2. Vérifiez les données de mapping associées au code de mapping POPSENVDET.


Rajoutez les données de mapping.

  1. Soumettez à nouveau l'ordre de fabrication.

Production Scheduler reçoit à présent la date fixe.

Aucun problème de données de mapping incorrectes n'a été rencontré. Ces informations permettent de déterminer quels problèmes risquent de survenir.

Fuseau horaire non paramétré/incorrect

En comparant les détails avec le problème précédent (Problèmes de mapping), vous pourriez rencontrer un problème de fuseau horaire.

  1. Le fuseau horaire est déterminé par le paramètre PSTIMEZONE - Fuseau horaire du serveur (chapitre EXAPP, groupe MIS) depuis une liste de sélection.
  2. Le fuseau horaire paramétré dans PSTIMEZONE - Fuseau horaire du serveur doit être le fuseau horaire du serveur.

Changez le fuseau horaire à celui dans lequel se trouve le serveur, puis soumettez à nouveau l'ordre de fabrication.
L'heure correspond à présent à l'ordre de fabrication.

Il existe un problème connu lié à l'affichage des opérations et aux fuseaux horaires.

Dans cet exemple, l'heure de début de l'opération est correctement paramétrée sur 08:00:00, toutefois, l'opération semble démarrer à 07:00:00 dans le diagramme de Gantt. En effet, le diagramme est affiché dans le navigateur et utilise le fuseau horaire du navigateur au lieu de celui du serveur.

Ce problème est apparu avec 3DS, mais il est traité dans ce guide pour éviter les appels au support.

Problèmes dans le code

En comparant les détails avec les Problème de mapping mentionnés précédemment, il se peut que vous ayez un problème avec le fuseau horaire.

  1. Comme pour la date fixe vue précédemment, vous devez déterminer pourquoi la durée d’attente n'est pas envoyée à Production Scheduler.
  2. Appliquez la même méthode et utilisez Postman pour déterminer d'où vient l'erreur.
  3. Pour limiter les données renvoyées utilisez un horodatage.
    1. Afin de déterminer quel devrait être l'horodatage, vous pouvez utiliser la fonction En colonnes (GSTDCOL, Développement > Utilitaires > Maintenances > En colonnes) pour vérifier la date/heure de mises à jour sur l'ordre de fabrication.
    2. Paramétrez la colonne UPDDATIM sur Afficher et appliquez le champ Sélection à l'ordre de fabrication.

    3. Pour retourner des données de date et d’heure, sélectionnez OK.
  4. Convertissez la date et heure de la demande de bundle en horodatage.

    Vous pouvez utiliser un site web pour convertir la date et heure.

  5. Vous disposez à présent de l’horodatage qui fait partie de la clé pour la demande de bundle dans Postman.
  6. Vérifier les résultats de Sage X3.


Corrigez le code, puis soumettez à nouveau l'ordre de fabrication.

Vous constatez que la durée d'attente (Transit time after) est mise à jour correctement.

Résolution de problèmes - Exemple 4 : Flux de données depuis Production Scheduler vers Sage X3

Les erreurs les plus complexes sont celles liées aux transferts de données entre Production Scheduler et Sage X3. En effet, elles sont difficiles à reproduire puisque les informations envoyées par Production Scheduler ne peuvent habituellement pas être visualisées. De plus, les données de trace de Production Scheduler apportent peu d'informations, et retournent une simple erreur http de type 500.

Une erreur http de type 500 n’apporte aucune indication sur la nature de l’erreur, vous devez donc utiliser la trace de l’application Sage X3, et dans certains cas Wireshark, pour déterminer la cause du problème. Les raisons les plus fréquemment rencontrées sont listées ci-dessous.

Données de l'ordre de fabrication inexistantes

Les données publiées dans Production Scheduler sont parfois désynchronisées avec Sage X3. Par conséquent, la publication tente de mettre à jour des informations qui n'existent pas.

  1. Si la trace est autorisée sur le site, en positionnant le paramètre PSLOGTRACE - Trace Production Scheduler sur Oui (chapitre EXAPP, groupe MIS), vous pouvez vérifier la présence d'erreurs lors de la mise à jour.
  2. A l'aide de la fonction Lecture traces (LECTRACE) (Impressions > Impression > Lectures traces), vous pouvez consulter les traces générées lors d'une mise à jour :
  1. Ouvrez le dernier fichier et vérifiez les dernières entrées.
  2. Le nom des fichiers trace de mise à jour commencent par le préfixe POPSUPD, suivi du code du site, puis de l’heure.

    Effacez les ordres de fabrication indiqués, puis essayez de publier à nouveau.

Ordre de fabrication verrouillé (en cours d'utilisation)

Ce problème est particulièrement difficile à reproduire car il est impossible de modifier un ordre de fabrication lorsqu'il est dans Production Scheduler. Cependant, lors du suivi de fabrication, l'ordre de fabrication est mis à jour : il est donc possible qu'il soit verrouillé au moment où la mise à jour de Production Scheduler tente d'y accéder.

Il s'agit donc d'un problème temporaire. La prochaine tentative de publication devrait être effectuée avec succès.

Mapping invalide

Si Sage X3 ne reçoit pas les données après la publication dans Production Scheduler, il faut comparer le mapping et les résultats obtenus dans Production Scheduler.

  1. Utilisez Wireshark pour récupérer les données publiées par Production Scheduler.
  2. Utilisez la fonction Mapping transformation JSON-X3 pour comparer les valeurs du fichier JSON au code de mapping POPSENVUPDEDIT.
  3. Vous devez aligner la propriété invalide du fichier de sortie de Production Scheduler à la valeur du mapping.

Corrigez la propriété invalide.

 

Nous devrions ainsi obtenir les commentaires dans Sage X3, et ensuite dans Production Scheduler.

Problème dans le code

Bien que tous les problèmes liés à la publication aient été résolus, un problème dans le code peut toujours survenir.

Pour identifier ces problèmes, il faut consulter la trace de l'application.

  1. Autorisez la trace de l'application en positionnant le paramètre PSLOGTRACE - Trace Production Scheduler sur Oui (chapitre EXAPP, groupe MIS).

Consultez la dernière trace en commençant par POPSENVUPD pour voir si des erreurs se sont produites pendant le processus de mise à jour.

Nos développeurs ont besoin des informations contenues dans la trace des applications pour résoudre un problème.

Fuseau horaire non paramétré/incorrect

Si les heures de début et de fin des ordres de fabrication publiés depuis Production Scheduler vers Sage X3 sont différentes de celles de Production Scheduler, il se peut que le paramètre de fuseau horaire ne soit pas, ou mal, configuré.

Suivez la procédure pour Sage X3 à Production Scheduler : fuseau horaire non paramétré/incorrect pour corriger l'erreur.