Sage X3 – Comment ouvrir un objet X3 (ex : commande d’achat) en programmation

Sage X3 – Comment ouvrir un objet X3 (ex : commande d’achat) en programmation

Dans Sage X3, il arrive fréquemment de devoir accéder à un objet (tel qu’une commande d’achat) depuis du code, par exemple dans une extension, une routine personnalisée ou un tunnel. Voici une méthode simple et efficace pour y parvenir.

Objectif

Vous voulez ouvrir un objet X3 (par exemple une commande d’achat) à partir de votre code, en utilisant sa clé. Cette approche est utile pour automatiser des traitements, créer des liens directs, ou intégrer Sage X3 à d’autres solutions.

Exemple : ouvrir une commande d’achat

Supposons que vous disposez du numéro de document de la commande d’achat et que vous souhaitez appeler ce document programme‑tiquement.

Local Char W_CLE1 : W_CLE1 = "PO0000001"  # numéro d'une commande d'achat
Local Char W_CLE2 : W_CLE2 = ""

Call OBJET_CHAR(W_CLE1,"POH",W_CLE2) From GOBJET

Explications

• W_CLE1
  Représente la clé de l’objet que vous voulez ouvrir. Dans cet exemple : "PO0000001" (la commande d’achat).
• "POH"
  C’est le code interne de l’objet commande d’achat dans Sage X3. Chaque objet X3 possède un code unique utilisé par les API et fonctions internes.
• W_CLE2
  Variable de sortie où l’on stocke le résultat retourné par l’appel.

Quand utiliser cette méthode ?

• Création de boutons personnalisés qui ouvrent des écrans spécifiques.
• Développement de tunnels pour relier Sage X3 à d’autres systèmes.
• Traitements automatisés où il faut ouvrir puis modifier un objet.
• Extensions à la logique standard sans modifier les écrans natifs.

Bonnes pratiques

• Toujours vérifier que la clé passée existe avant d’appeler l’objet.
• Traiter proprement les erreurs retournées par la fonction.
• Tester dans un environnement de dev avant de déployer en production.

Résumé

Élément	Utilisation
OBJET_CHAR	Fonction Sage X3 pour ouvrir un objet depuis une clé
W_CLE1	Clé de l’objet (ex : numéro de commande)
"POH"	Code de l’objet X3 (ici, Purchase Order Header)
W_CLE2	Résultat retourné

Publié sur AgrouDev – Votre source d’astuces Sage X3.