Expositions
Une décision prise une fois pour toutes : un écran peut quitter l’entreprise – quelles colonnes, quelles lignes, et si des modifications peuvent y être apportées. Rien n’est accessible de l’extérieur tant que ce n’est pas publié ici, et il n’existe pas de politique de « tout publier ».
Où le trouver
- Module: Plate-forme
- Groupe: Connectivité
- Section: API publiée
- Écran: Expositions
Adresse dans la console: /platform/api-exposures
Liste · 11 colonnes · 16 champs sur son formulaire · 4 d'entre eux requis
Ce que la liste affiche
Voici les colonnes de la liste, dans l'ordre où elles apparaissent. Chacune d'elles peut être triée, filtrée, masquée ou exportée.
| Colonne | Gentil | Nom du champ |
|---|---|---|
| Publié sous le titre | Code | code |
| Nom | Texte | name |
| Module | Statut | module_key |
| Écran | Code | resource_key |
| Accéder | Statut | access_summary |
| Colonnes | Texte | column_summary |
| Nombre maximal de lignes | Nombre | max_rows |
| Clés | Nombre | granted_to |
| Appels (30j) | Nombre | calls_30d |
| Dernières nouvelles | Date et heure | last_called_at |
| Statut | Statut | status |
Le formulaire
Voici les informations demandées lors de la création d'un enregistrement. Les champs obligatoires sont indiqués ; un choix issu d'une liste de configuration est un choix qu'un administrateur peut compléter sans nouvelle version.
| Champ | Taper | Choix | Notes |
|---|---|---|---|
| Publié sous le titre requis | Texte | C'est ainsi que les utilisateurs extérieurs nomment cela. Il s'agit de l'URL et du nom de l'outil MCP, volontairement distincts du nom d'écran, afin que le fait de renommer un écran ici ne perturbe jamais l'intégration d'un utilisateur. | |
| Nom requis | Texte | ||
| Qu'est-ce que c'est | Texte long | Lu par un développeur dans la documentation OpenAPI et par un modèle dans la liste des outils MCP. À noter : c’est le seul endroit où il est précisé que « commandes » désigne ici les bons de commande. | |
| Module requis | Texte | Sélectionnez les éléments dans le sélecteur d'API Studio plutôt que de les saisir au clavier ; la liste est lue directement par le produit. | |
| Écran requis | Texte | ||
| Peut être lu | Oui ou non | ||
| Peut être créé | Oui ou non | Une création effectuée via l'API suit les mêmes règles de validation, de numérotation et de publication qu'une création saisie à l'écran. | |
| Peut être modifié | Oui ou non | ||
| Peut être supprimé | Oui ou non | ||
| Colonnes | Choix | listé, tous, tout sauf | listé — seul ce qui est nommé ci-dessous, et rien d’autre n’est envoyé. tout — toutes les colonnes. tout_sauf — tout sauf ce qui est nommé ci-dessous. |
| Noms de colonnes | Texte | Séparés par des virgules. Une faute d'orthographe dans un nom est sans effet ; utilisez donc le sélecteur d'API Studio pour voir le contenu réel de l'écran. | |
| Rangées susceptibles de voyager | Texte | Le même filtre est utilisé sur chaque écran de liste : {"col":"status","op":"eq","value":"posted"}. Il est appliqué côté serveur à chaque appel, et un filtre envoyé par l'appelant est combiné par un ET logique en dessous ; aucun autre filtre envoyé ne peut l'élargir. | |
| La plupart des lignes par appel | Nombre | ||
| Offre en tant qu'outil MCP | Oui ou non | ||
| Que dire à un mannequin | Texte long | Uniquement lorsqu'un modèle nécessite des informations qu'un développeur n'aurait pas à fournir. Si ce champ est laissé vide, la description ci-dessus est utilisée. | |
| Statut | Choix | brouillon, actif, suspendu, à la retraite | Seule une exposition active est accessible. Un brouillon est une décision en cours de rédaction. |
Les règles qui s'appliquent ici
Tout ce qui s'affiche à l'écran obéit aux règles de la plateforme et non à des règles propres. Voici celles qu'il est important de connaître avant de l'utiliser :
- Réduire une liste — Recherche, conditions, tri, totaux, exportation et vues enregistrées.
- Ce qui peut être changé — les cinq motifs pour lesquels un enregistrement ne peut être modifié.
- Entreprises et unités commerciales — ce que le commutateur situé au-dessus de cette liste lui fait.
- Création d'un enregistrement — champs obligatoires, provenance des choix et mode d'attribution des numéros.
- Importer une feuille de calcul — Cet écran en accepte un, et il suit les mêmes règles que la saisie au clavier.