Aller au contenu principal

Créer un éditeur

Objectif​

Créer un éditeur afin que son préfixe serve d’espace de noms aux composants que vous construisez, pour éviter qu’ils n’entrent en conflit avec les composants d’autres éditeurs.

Prérequis​

  • Vous êtes connecté au Centre de contrôle d’administration en tant qu’administrateur de la plateforme.

Étapes​

  1. Ouvrez la page Éditeurs depuis la navigation supérieure.
  2. Saisissez un nom d’éditeur.
  3. Saisissez un préfixe — un jeton court en minuscules (2 à 8 lettres ou chiffres, commençant par une lettre), par exemple par.
  4. Sélectionnez Ajouter l’éditeur.
  5. L’éditeur apparaît dans le tableau, avec son préfixe affiché sous la forme par_.

Renommer un éditeur​

Sélectionnez l’éditeur (ou cliquez sur sa ligne) et choisissez Modifier. Seul le nom d’affichage peut changer — et uniquement pour un éditeur que vous avez créé.

  • Le préfixe ne peut pas changer. Il fait partie du nom logique de chaque composant que cet éditeur a jamais créé (par_invoice), et ce sont ces noms auxquels se réfèrent les formulaires, les vues, les filtres, les étapes de plug-in et les couches de solution. Le modifier ne renommerait rien et laisserait tout orphelin.
  • La base des valeurs d’option ne peut pas changer non plus. Les options déjà numérotées à partir d’elle sont stockées sous forme de nombres dans de vrais enregistrements : déplacer la plage laisserait ces nombres en dehors.

Les deux sont affichés dans le panneau Modifier, grisés, avec cette raison à côté.

Deux éditeurs ne peuvent pas être renommés du tout, et ne proposent pas Modifier :

  • L’éditeur par défaut de votre locataire, celui qui possède la solution par défaut. Son nom est une convention de la plateforme, et la plateforme le retrouve par son préfixe — un renommage laisserait le code fonctionner pendant que l’écran dirait autre chose.
  • Un éditeur créé par l’importation d’une solution. Celui-ci représente l’organisation dont la solution gérée est arrivée ; le renommer ici ferait apparaître le même fournisseur différemment dans chaque environnement, et la prochaine importation contredirait l’écran.

Ce qui se passe en coulisses​

Le préfixe est réservé au sein de votre locataire. Chaque composant que vous ajoutez ensuite à une solution appartenant à cet éditeur doit avoir un nom logique commençant par ce préfixe (par exemple par_invoice) : c’est ainsi que les composants de différents éditeurs restent distincts lorsqu’ils sont réunis dans un même environnement.

Dépannage​

  • « This publisher belongs to the platform … so its name cannot be changed here. » — il s’agit de l’éditeur par défaut de votre locataire ou d’un éditeur créé par l’importation d’une solution. Voir Renommer un éditeur ci-dessus pour comprendre pourquoi ni l’un ni l’autre ne vous appartient.
  • « Prefix … must be 2–8 lower-case letters/digits starting with a letter. » — corrigez le préfixe pour qu’il respecte cette forme (pas de majuscules, pas de traits de soulignement, ni trop court ni trop long).
  • « A publisher with prefix … already exists. » — ce préfixe est déjà pris dans votre locataire. Choisissez-en un autre.

Scénarios associés​

  • Créer une solution.
  • Ajouter un composant à une solution.