Connecter OpenText Trading Grid : documents EDI entrants et sortants

Créez la connexion dans Integration, sous Connexions EDI, saisissez le mode de transport, l’hôte, l’identifiant et le mot de passe ou la clé privée exactement comme les donne votre dossier d’ouverture OpenText, vérifiez la forme des identifiants, mappez chaque partenaire commercial, puis activez.

OpenText Trading Grid est une plateforme EDI : vous échangez par elle des documents EDI avec vos partenaires commerciaux — les documents de commande des partenaires entrent, et les documents d’expédition et de facture repartent. Cette connexion ne se crée pas dans un assistant de canal. Elle se crée dans Integration, sous Connexions EDI, et chaque détail demandé — hôte, identifiant et le reste — vient du dossier d’ouverture qu’OpenText vous remet à l’ouverture de votre compte. Il n’y a aucun autre endroit où consulter ces détails.

Prérequis#

• Un compte OpenText Trading Grid, ouvert ou en cours d’ouverture auprès d’OpenText. Les détails de la connexion sont émis dans le cadre de cette ouverture de compte — ce n’est pas quelque chose que vous créez ou consultez par vous-même.
• Le dossier d’ouverture d’OpenText pour votre compte. Il contient l’hôte, l’identifiant et chaque autre détail de connexion que ce guide vous demande de saisir. Gardez-le sous la main pendant toute la configuration — si un détail n’y figure pas, il est manquant, et la solution est de le demander à votre contact d’ouverture OpenText, pas de le deviner.
• Un mode de transport, tel qu’indiqué dans le dossier d’ouverture : SFTP avec mot de passe, SFTP avec clé privée, ou dépôt de fichiers (file drop). Le dossier décide lequel votre compte utilise — les trois modes demandent des champs différents aux étapes suivantes, donc sachez lequel est le vôtre avant de commencer à remplir.
• Au moins un partenaire commercial — un distributeur ou un autre partenaire — avec lequel vous échangerez des documents EDI via OpenText. Chaque partenaire est mappé séparément plus loin dans ce guide, avec les identifiants de partenaire et de distributeur convenus pour ce partenaire.

Obtenir les identifiants#

1. Suivez l’ouverture de compte avec OpenText. Vos identifiants ne se créent pas dans un portail en libre-service et ne se consultent nulle part ailleurs — ils vous sont émis dans le cadre de cette ouverture.
2. Recevez le dossier d’ouverture de votre compte et repérez-y l’hôte SFTP et l’identifiant SFTP. Copiez les deux exactement comme ils sont écrits — ces valeurs viennent uniquement d’OpenText, et un hôte ou un identifiant venu d’ailleurs n’appartiendra pas à votre compte.
3. Repérez le secret qui correspond à votre mode de transport. Si votre dossier indique SFTP avec mot de passe, il vous donne le mot de passe SFTP. S’il indique SFTP avec clé privée, il vous donne la clé privée SFTP. S’il indique dépôt de fichiers (file drop), il n’y a ni mot de passe ni clé privée à recueillir pour cette connexion.
4. Conservez le dossier et le secret ensemble, et traitez le mot de passe ou la clé privée comme un secret dès sa réception : conservez-le en lieu sûr, ne l’envoyez pas en clair dans des messages, et préparez-vous à le coller une fois, à la section suivante. S’il manque quelque chose que le dossier devrait contenir, demandez à votre contact d’ouverture OpenText de le compléter — ne comblez pas le manque avec une valeur d’un autre compte ou d’un autre système.

Remplir dans Integration#

1. Ouvrez Integration → Connexions EDI → Nouvelle connexion, et choisissez OpenText Trading Grid. OpenText n’a pas d’assistant de canal : si vous le cherchez dans une liste de canaux ou de marketplace, vous n’êtes pas au bon endroit — la connexion se trouve avec les autres connexions EDI.
2. Mode de transport (transport_method) : choisissez celui qu’indique votre dossier d’ouverture — sftp_password pour SFTP avec mot de passe, sftp_key pour SFTP avec clé privée, ou file_drop pour le dépôt de fichiers. Ce choix décide lesquels des champs ci-dessous sont nécessaires, donc il doit correspondre au dossier, pas au mode qui semble le plus simple.
3. Hôte SFTP (sftp_host) : collez l’hôte exactement comme il apparaît dans votre dossier d’ouverture. Il n’y a pas d’hôte standard à taper de mémoire — le dossier est la seule source de cette valeur, donc copiez-la au lieu de la taper, et si le dossier n’indique aucun hôte, arrêtez-vous et demandez à votre contact d’ouverture OpenText au lieu d’en deviner un.
4. Identifiant SFTP (sftp_username) : collez l’identifiant du même dossier d’ouverture. Il va de pair avec l’hôte ci-dessus — un identifiant d’un autre compte ou d’un autre système ne s’appariera pas avec lui.
5. Mot de passe SFTP (sftp_password) : ne remplissez ce champ que si votre mode de transport est sftp_password. Collez le mot de passe du dossier d’ouverture. Il est stocké chiffré et n’est jamais réaffiché après l’enregistrement — si vous devez le changer plus tard, vous le remplacez par une nouvelle valeur au lieu d’afficher l’ancienne. Pour les deux autres modes, laissez ce champ vide.
6. Clé privée SFTP (sftp_private_key) : ne remplissez ce champ que si votre mode de transport est sftp_key. Collez la clé privée entière du dossier d’ouverture, complète et sans modification — une clé raccourcie ou reformatée est une autre clé. Elle est stockée chiffrée et n’est jamais réaffichée après l’enregistrement. Pour les deux autres modes, laissez ce champ vide. Si votre mode est file_drop, aucun des deux champs de secret ne s’applique : ce qui compte, c’est que le mode de transport lui-même corresponde au dossier.
7. Enregistrez la connexion, mais ne considérez pas l’enregistrement comme la ligne d’arrivée. Testez-la ensuite, puis faites le mapping des partenaires commerciaux — une connexion avec des identifiants complets mais sans mapping de partenaire ne peut toujours placer les documents d’aucun partenaire.

Tester la connexion#

Cliquez sur Tester la connexion, et lisez le résultat pour ce qu’il couvre réellement. À ce stade, la vérification ne regarde que la forme de ce que vous avez saisi : pour le mode que vous avez choisi, tout ce dont ce mode a besoin est-il présent — le mode de transport lui-même, l’hôte et l’identifiant, le mot de passe pour le mode par mot de passe, ou la clé privée pour le mode par clé ? S’il manque quelque chose dont ce mode a besoin, la vérification échoue et nomme la pièce manquante. Si vous avez choisi file_drop, la vérification signalera que le point de terminaison reste à configurer — avec ce mode, il n’y a aucun point de terminaison serveur que la vérification puisse atteindre, donc ce résultat est attendu et ne signifie pas que vous avez mal rempli quoi que ce soit. Et quel que soit le résultat, soyez clair sur sa portée : une forme d’identifiants complète ne prouve pas que les fichiers peuvent déjà circuler. L’envoi et la réception réels de fichiers sont activés en même temps que l’achèvement de votre raccordement d’ouverture OpenText, donc ne jugez cette étape que comme un contrôle de complétude du formulaire, et servez-vous de la FAQ ci-dessous quand un résultat vous surprend.

Mapping / choisir un modèle#

Sur OpenText, le mapping se fait par partenaire commercial, pas en un seul réglage pour toute la connexion. Pour chaque partenaire, enregistrez les identifiants sous lesquels ce partenaire est connu — l’identifiant de partenaire et l’identifiant de distributeur convenus pour ce partenaire lors de l’ouverture et de la configuration du partenaire — et choisissez le modèle de ce partenaire, pour que ses documents de commande entrants soient reconnus comme les siens et mappés dans la commande standard, et que vos données d’expédition et de facture soient mappées en retour dans les documents attendus par ce partenaire. Les identifiants sont le point clé : un document qui arrive avec des identifiants ne correspondant à aucun mapping ne peut pas être rangé chez le bon partenaire, aussi complets que soient les identifiants de la connexion. Traitez vos partenaires un par un et utilisez les identifiants exactement comme convenus pour chacun — ne réutilisez pas les identifiants d’un partenaire pour un autre.

Activer#

Activez la connexion une fois le formulaire complet et chaque partenaire commercial avec lequel vous comptez commencer mappé. L’activation met la connexion, avec son mode de transport et ses mappings de partenaires, en service du côté d’Integration. Gardez sa portée à l’esprit : l’envoi et la réception réels de fichiers via OpenText sont activés en même temps que l’achèvement de votre raccordement d’ouverture OpenText, donc si l’ouverture n’est pas encore achevée de ce côté-là, une connexion activée ne transportera pas encore de fichiers — c’est l’ouverture qui se termine, pas une faute dans ce que vous avez rempli. Une fois l’échange de fichiers actif, surveillez les premiers documents de chaque partenaire dans Runs / Logs, partenaire par partenaire, avant de laisser l’échange sans surveillance.

FAQ#

Le test signale que le point de terminaison reste à configurer (file drop)

C’est le résultat attendu pour le mode dépôt de fichiers (file drop), pas le signe que vous avez mal rempli quelque chose. Avec file drop, il n’y a aucun point de terminaison serveur que la vérification puisse atteindre, et les détails de point de terminaison qui viendraient de l’ouverture ne sont pas configurés comme quelque chose que la vérification puisse sonder — la vérification le dit donc tel quel, au lieu de vous laisser passer.

Ne changez pas de mode de transport et n’inventez pas un hôte juste pour que le test paraisse vert. Gardez le mode indiqué par le dossier d’ouverture, terminez le mapping des partenaires commerciaux et confirmez auprès de votre contact d’ouverture OpenText où en est l’ouverture du compte — l’envoi et la réception de fichiers sont activés en même temps que l’achèvement de ce raccordement d’ouverture, et les premiers documents réels sont ceux que vous vérifiez dans Runs / Logs.

Le test échoue : il manque quelque chose dont le mode choisi a besoin

Les champs du formulaire ne forment pas encore un ensemble complet pour le mode de transport que vous avez choisi. Les cas habituels sont de simples manques : pas d’hôte, pas d’identifiant, le mode par mot de passe choisi mais le champ de mot de passe laissé vide, ou le mode par clé choisi mais le champ de clé privée laissé vide. Un décalage compte aussi — par exemple, une clé privée collée alors que le mode est toujours réglé sur le mode par mot de passe, donc la pièce que la vérification cherche n’est pas là.

Comparez le formulaire au dossier d’ouverture, champ par champ : d’abord le mode de transport, puis l’hôte, puis l’identifiant, et enfin le seul secret qu’utilise votre mode — le mot de passe pour sftp_password, la clé privée pour sftp_key, collée en entier. Ne complétez que la pièce manquante ou mal placée, enregistrez et testez à nouveau. Si une valeur manque dans le dossier lui-même, demandez-la à votre contact d’ouverture OpenText plutôt que d’en emprunter une d’un autre compte.

La forme des identifiants semble complète, mais aucun fichier ne circule encore

Il n’y a pas nécessairement quoi que ce soit de faux dans le formulaire. Le test de connexion vérifie seulement que la forme des identifiants est complète pour le mode que vous avez choisi — il n’établit pas à lui seul le transfert de fichiers. L’envoi et la réception réels de fichiers sont activés en même temps que l’achèvement de votre raccordement d’ouverture OpenText, donc un formulaire qui passe entièrement peut encore se trouver avant cet interrupteur : la connexion est prête de ce côté, et l’échange de fichiers n’est pas encore allumé.

Confirmez auprès de votre contact d’ouverture OpenText si le raccordement d’ouverture de votre compte est achevé — c’est cet achèvement qui allume l’échange de fichiers. En attendant, terminez le mapping des partenaires commerciaux, pour que rien ne manque de ce côté quand il s’allumera. Une fois le raccordement achevé, vérifiez les premiers documents de chaque partenaire dans Runs / Logs ; si les fichiers ne circulent toujours pas après confirmation de l’achèvement, recroisez les détails de la connexion et les identifiants de partenaire avec le dossier d’ouverture.

Les documents d’un partenaire n’atterrissent pas, ou atterrissent chez le mauvais partenaire

La connexion peut être complète alors que le mapping d’un partenaire ne l’est pas. Le mapping se fait par partenaire, et les documents sont rangés selon les identifiants qu’ils portent — l’identifiant de partenaire et l’identifiant de distributeur convenus pour ce partenaire. Si les identifiants enregistrés dans le mapping de ce partenaire ne correspondent pas à ceux que portent ses documents, les documents n’ont pas de bon domicile : soit ils n’atterrissent pas du tout, soit ils sont lus comme ceux d’un autre partenaire dont les identifiants correspondent par hasard.

Ouvrez le mapping de ce partenaire et comparez ses identifiants de partenaire et de distributeur enregistrés, caractère par caractère, avec les identifiants convenus pour ce partenaire lors de l’ouverture et de la configuration du partenaire. Corrigez ce mapping — jamais ceux des autres partenaires — enregistrez-le et vérifiez le document suivant de ce partenaire dans Runs / Logs. Un partenaire ajouté plus tard a besoin du même traitement avant son premier document : ses propres identifiants, son propre modèle, vérifiés séparément.