Transmettre aux partenaires
Transmettre aux partenaires envoie les métadonnées ONIX de vos titres, et éventuellement leurs images de couverture, directement sur le serveur FTP, FTPS ou SFTP d'un partenaire commercial. Vous définissez chaque partenaire une fois par catalogue (adresse, identifiants, chemins, nommage du fichier), testez la connexion, puis transmettez la sélection ou les résultats de recherche courants en un clic. Le transfert s'exécute comme tâche en arrière-plan : vous pouvez continuer à travailler pendant que le fichier est généré et téléversé.
Où la trouver
- Dans la liste des titres, ouvrez la liste déroulante Actions et choisissez Transmettre aux partenaires. La boîte de dialogue est offerte sur les catalogues ONIX 2.1 comme ONIX 3.0, à tout utilisateur qui peut ouvrir la liste.
- Les partenaires appartiennent au catalogue courant : un partenaire défini sur un catalogue n'est pas listé sur un autre.
- Le résultat de chaque transmission apparaît dans le menu Notifications de la barre supérieure (voir L'espace de travail).
Vue d'ensemble de l'écran
La boîte de dialogue liste vos partenaires dans deux tableaux. Le tableau Actions FTP (Nom, adresse FTP, une case à cocher par ligne) contient les partenaires FTP, FTPS et SFTP : Nouveau partenaire ouvre le formulaire de partenaire, et Modifier et Supprimer sont affichés sur les partenaires créés dans ONIXEDIT Cloud. Le tableau Actions POST (URL, Libellé EN, Libellé FR) contient les points d'accès HTTP décrits plus bas, avec Nouvelle Action POST, Modifier et Supprimer. Le bouton Transmettre [[NUMBER]] titre(s) aux partenaires sélectionnés reste désactivé tant qu'au moins une ligne de l'un des deux tableaux n'est pas cochée; le nombre est la taille de votre sélection, ou le nombre de titres de la liste lorsque rien n'est sélectionné.
Comment définir un partenaire
Dans la boîte de dialogue, cliquez sur Nouveau partenaire (ou sur Modifier sur une ligne existante).
Remplissez la connexion :
Champ Quoi saisir Nom du destinataire Un nom pour le partenaire; obligatoire. Type de connexion FTP/FTPS ou SFTP. Adresse Le nom d'hôte ou l'adresse IP, avec un port facultatif après un deux-points ( ftp.example.com:2121). Une valeur invalide affiche Adresse de serveur invalide.Nom d'utilisateur / Mot de passe Les identifiants fournis par votre partenaire. FTP explicite sur TLS Cochez lorsque le partenaire exige FTPS avec TLS explicite. Transfert passif Cochez lorsque le partenaire exige le mode passif (habituel derrière un pare-feu). Chemin distant pour le fichier ONIX Le dossier du serveur où va le fichier ONIX, par exemple /Path/To/ONIX.Version ONIX 3 Catalogues ONIX 3.0 seulement : ONIX 3.0 ou ONIX 3.1 pour le fichier envoyé à ce partenaire. Dans la carte Nom de fichier, choisissez comment le fichier est nommé (voir plus bas).
Dans la carte Images de couverture, cochez Copier les images de couverture si le partenaire veut les images sous forme de fichiers. La carte active alors Chemin distant pour les images (prérempli avec le chemin ONIX), Masque de nom d'image (prérempli avec
[ISBN13]) et Gardez seulement le lien vers l'image de couverture dans le fichier ONIX.Cliquez sur Test de la connexion. Un message vert La connexion a réussi ! ou rouge La connexion a échoué ! apparaît; Annuler interrompt un test qui ne répond pas.
Cliquez sur OK pour enregistrer le partenaire.
Comment nommer le fichier ONIX
La carte Nom de fichier offre trois options :
- Masque de nom de fichier — un nom fixe composé de caractères valides et de jetons, sans l'extension, par exemple
Prefix_[yyyyMMdd]_Suffix. Cliquez sur Jetons pour insérer un jeton de date ([yyyyMMdd],[ddMMyyyy],[yyyy-M-d],[yyyy]…), de date et heure ([yyyyMMddHHmm]…) ou de date, heure et secondes ([yyyyMMddHHmmss]…), dans l'ordre jour, mois, année de votre choix. - Demander le nom du fichier — le masque est désactivé et ONIXEDIT Cloud vous demande un nom à chaque transmission (voir plus bas).
- Utiliser la convention de nom et extension de fichier de TitlePage (.XOT et .COT) — le fichier est téléversé avec l'extension
.XOTet renommé en.COTune fois le transfert terminé, comme l'exige TitlePage. Cette option requiert un horodatage complet : un jeton de date seule dans le masque est remplacé par[ddMMyyyyHHmmss], et ce jeton est ajouté lorsque le masque n'en contient aucun. Elle désactive aussi Demander le nom du fichier.
Le bouton Jetons du Masque de nom d'image offre [ISBN10], [ISBN13], [EAN], [REF] (référence d'enregistrement) et [Original-Filename].
Comment transmettre des titres
- Sélectionnez les titres dans la liste, ou lancez une recherche; sans l'un ni l'autre, tout le catalogue est envoyé.
- Ouvrez Actions et choisissez Transmettre aux partenaires.
- Cochez les partenaires destinataires et cliquez sur Transmettre [[NUMBER]] titre(s) aux partenaires sélectionnés.
- Pour chaque partenaire réglé sur Demander le nom du fichier, la boîte de dialogue Entrez un nom de fichier pour s'ouvre avec le nom du partenaire : tapez le Nom de fichier (sans extension), insérez des Jetons si vous le souhaitez, puis cliquez sur Envoyer au partenaire.
- La boîte de dialogue se ferme et une tâche Transmission aux partenaires est mise en file d'attente. Suivez-la dans le menu Notifications; un transfert échoué affiche Plus de Détails avec la raison.
Un fichier ONIX est généré par partenaire, dans le format du catalogue (ONIX 2.1, ou la Version ONIX 3 choisie pour le partenaire sur un catalogue ONIX 3.0), et téléversé dans le Chemin distant pour le fichier ONIX du partenaire. Lorsque Copier les images de couverture est activé, les images des titres transmis sont téléversées dans le Chemin distant pour les images sous leur Masque de nom d'image.
Actions POST
Une action POST est un partenaire joint par HTTP plutôt que par FTP : ONIXEDIT Cloud publie un champ de chaque titre (sa référence d'enregistrement, son ISBN13, son EAN, ONIX_NOSEQ, un champ personnalisé ou une autre balise ONIX) vers l'URL que vous saisissez — comme une boutique en ligne ou l'API d'un distributeur reçoit les commandes de nouveaux titres. Les actions POST se définissent dans le tableau Actions POST de la boîte de dialogue Transmettre aux partenaires et peuvent être lancées de là, cochées comme un partenaire FTP, ou depuis la liste déroulante Actions de la liste des titres.
Comment définir une action POST
Dans la boîte de dialogue, cliquez sur Nouvelle Action POST (ou sur Modifier sur une ligne existante).
Remplissez le formulaire Action POST :
Champ Quoi saisir Libellé EN / Libellé FR Le nom de l'action tel qu'il apparaît dans la liste déroulante Actions, en anglais et en français; la langue de l'interface détermine celui qui est affiché. HTTP POST L'URL qui reçoit la requête. Champ La valeur publiée pour chaque titre : Record Reference, ISBN13, EAN, ONIX_NOSEQ, Champ Personnalisé ONIXEDIT ou Autre Tag ONIX. Body Le nom du champ personnalisé ou le Tag ONIX à publier, lorsque Champ est l'une des deux dernières valeurs. Sélection de titres Les titres que le partenaire accepte : Titres Sélectionnés Seul (l'action exige une sélection), Titres Sélectionnés ou Tous (sélection, recherche ou tout le catalogue), ou Aucun Titre Requis (la requête est envoyée sans titres). Cliquez sur OK. Supprimer sur une ligne demande Voulez-vous vraiment supprimer cette action POST de la liste? avant de la retirer.
Comment publier des titres
- Depuis la boîte de dialogue : cochez l'action POST (et tout partenaire FTP) et cliquez sur Transmettre, comme pour une transmission FTP.
- Depuis la liste des titres : lorsque le catalogue a au moins une action POST, la liste déroulante Actions se termine par Publier les produits sélectionnés à suivi du libellé de chaque action. Choisissez-en une et confirmez; la confirmation nomme la portée — la sélection courante avec son nombre, la recherche courante, ou tout le catalogue jusqu'à la limite de la tâche (voir Actions sur les titres).
Dans les deux cas, une tâche Transmission aux partenaires est mise en file d'attente et suivie dans le menu Notifications.
Conseils
Amazon et les images de couverture
Lorsque l'adresse contient « amazon » et que Copier les images de couverture est activé, ONIXEDIT Cloud propose de cocher Gardez seulement le lien vers l'image de couverture dans le fichier ONIX, car Amazon traite mal les vignettes de couverture copiées.
Testez avant de transmettre
Un chemin ou un mot de passe erroné ne se manifeste que par une tâche échouée, quelques minutes plus tard. Utilisez Test de la connexion chaque fois que vous changez l'adresse, les identifiants ou le type de connexion.
Questions fréquentes
Quels titres sont transmis?
Les titres que vous avez cochés dans la liste. Sans sélection, les résultats de la recherche courante sont envoyés, et sans recherche non plus, tout le catalogue. Le bouton Transmettre affiche le nombre avant que vous confirmiez.
Dois-je d'abord créer un fichier ONIX?
Non. La transmission est une tâche en arrière-plan qui génère le fichier ONIX pour chaque partenaire sélectionné et le téléverse, avec les images de couverture si le partenaire les demande.
Puis-je envoyer de l'ONIX 3.1 à un partenaire et de l'ONIX 3.0 à un autre?
Oui. Sur un catalogue ONIX 3.0, chaque partenaire a son propre réglage de version ONIX 3. Sur un catalogue ONIX 2.1, le fichier est toujours en ONIX 2.1.
Pourquoi ne puis-je pas modifier ou supprimer un partenaire?
Les partenaires FTP configurés en dehors d'ONIXEDIT Cloud ne sont listés que pour la transmission. Modifier et Supprimer sont offerts sur les partenaires et les actions POST créés ici.
Comment savoir si la transmission a fonctionné?
Ouvrez le menu Notifications de la barre supérieure. La tâche Transmission aux partenaires affiche sa progression, son résultat et, en cas d'échec, les détails de l'erreur.