Outils du Connector
Vous trouvez chaque outil avec ses effets, ses limites et ses paramètres.
Sur cette page
Trouvez l’outil adapté et ses paramètres. Chaque outil d’hébergement travaille dans exactement un Space.
À savoir
L’application est reliée à votre compte TEISENDA, et la connexion n’est pas terminée ; consultez les guides Claude et ChatGPT.
Pour un outil d’hébergement, la connexion inclut le Space indiqué dans l’appel. Vous en êtes membre, et il n’est pas bloqué.
Votre rôle dans le Space autorise l’outil.
L’argument space détermine le Space
Chaque outil d’hébergement exige l’argument space : la Space-ID à dix chiffres. whoami ne prend aucun argument.
Les instructions du Connector demandent à l’application de choisir le Space à partir de whoami ou de votre indication, et vous demander en cas de plusieurs Spaces possibles.
TEISENDA vérifie lui-même à chaque appel si le Space fait partie de la connexion et si vous en êtes membre. L’outil ne fonctionne que dans ce Space.
Quelle valeur accepte space ?
Un entier à dix chiffres ou un texte composé d’exactement dix chiffres. TEISENDA répond à toute autre valeur comme à un Space manquant, par exemple à un nombre ayant moins ou plus de chiffres. Si les dix chiffres ne correspondent à aucun Space de la connexion, TEISENDA indique que le Space ne fait pas partie de la connexion. Les deux messages figurent dans le outil pour les Spaces.
Le résultat d’un outil d’hébergement indique d’abord le Space
Le résultat commence par la Space-ID et le nom d’affichage. Vérifiez ces informations ; si le Space est incorrect, les instructions demandent à l’application de s’arrêter.
En cas de Enregistré, mais pas encore transféré au nœud d'hébergement :, la modification est enregistrée mais pas encore transmise. Vérifiez l’état plus tard avec hosting_project_status.
Quand un résultat n’est-il pas une erreur alors qu’une action reste en attente ?
Certains résultats ne sont pas marqués comme erreurs : l’outil a fait ce qu’il pouvait et indique ce qui manque. C’est le cas si la version indiquée est déjà publiée, si le DNS d’un domaine n’est pas encore correct, si un projet est supprimé mais que le nœud d’hébergement ne l’a pas encore confirmé, et pour la réponse d’un outil en deux étapes demandant la phrase de confirmation.
Que modifie un outil dans TEISENDA, et où le voir ?
Chaque outil appelle les mêmes services que l’interface de l’app, avec les mêmes droits et limites. Une modification effectuée par un outil est appliquée dans TEISENDA comme si vous l’aviez effectuée dans l’interface.
Le journal du projet consigne les modifications avec le canal Application connectée lorsque l’opération crée une entrée. Les outils de lecture n’y créent pas d’entrée. Lors de l’écriture ou de la suppression de fichiers, il indique seulement qu’un nouveau brouillon est ouvert.
Votre rôle autorise l’outil
Propriétaire, Administrateur et Utilisateur peuvent appeler tous les outils d’hébergement. Lecture seule ne peuvent utiliser que cinq outils d’hébergement de lecture ; la liste figure dans les autorisations.
La liste affiche aussi les outils interdits à votre rôle. Le droit est vérifié lors de l’appel.
Aucun outil d’hébergement ne fonctionne dans un Space bloqué
whoami continue à lister un Space bloqué et le signale comme tel, mais aucun outil d’hébergement n’y fonctionne. Une connexion dont tous les Spaces sont bloqués ne propose à l’application que whoami. Les solutions figurent dans le outil pour les Spaces ; les blocages sont expliqués dans Comprendre les Spaces.
Les indicateurs distinguent lecture et modification
Les indicateurs figurent sur l’outil et dans la liste ci-dessous.
| Indicateur | Signification |
|---|---|
| « lecture seule » | L’outil ne modifie rien, ne crée aucune entrée de journal visible dans l’app et peut être répété sans effet. Cela concerne sept outils d’hébergement et whoami. |
| « modifie des données » | L’outil effectue une modification. Cela concerne les 16 autres outils d’hébergement. |
| « supprime, remplace ou modifie le contenu visible » | L’outil supprime, remplace ou modifie ce que les visiteurs d’un site voient. Cet indicateur ne signifie pas nécessairement que l’outil supprime ; son action est décrite dans sa section. |
| « deux étapes » | L’outil exige une phrase de confirmation. |
Trois outils exigent une phrase de confirmation
hosting_delete_project, hosting_remove_domain et le passage à public avec hosting_set_visibility fonctionnent en deux étapes : sans confirm, la réponse indique la conséquence et la phrase ; seul un appel avec cette phrase exécute l’action.
Les instructions du Connector demandent à l’application d’obtenir d’abord votre accord. Vérifiez le projet et le Space ; les autorisations expliquent la procédure.
Attention
Tous les autres outils agissent dès le premier appel, y compris pour supprimer, remplacer ou modifier le site. Une demande de confirmation par l’application n’est pas garantie.
Les outils utilisent parfois un autre vocabulaire
Les descriptions des outils sont en anglais. Leurs réponses allemandes utilisent parfois d’autres termes que cette documentation.
| Dans les réponses allemandes | Dans cette documentation |
|---|---|
« Stand », « Deployment » ; paramètre deploy | Version. Les outils emploient aussi ce terme pour le brouillon. |
« Deployment », pour le décompte de l’offre ; champ deployments | Publication : publier une version pour la première fois en utilise une. Republier une version déjà publiée n’en utilise aucune. |
| « offener Stand » | Brouillon : ses fichiers peuvent encore être modifiés, et il n’est pas publié. Un projet en a au maximum un. |
| « abgeschlossen » | Version finalisée : toute version vérifiée qui ne peut plus être modifiée, qu’elle soit publiée ou non. |
| « fertig, aber nicht veröffentlicht » | Version prête : une version finalisée qui n’a encore jamais été publiée. |
| « automatic address » dans les descriptions des outils | Adresse TEISENDA : l’adresse que TEISENDA attribue elle-même au projet. |
Chaque outil a une section sur une sous-page
Le nom mène à la section de l’outil avec ses paramètres. Les titres sont en anglais.
| Outil | Titre | Propriétés |
|---|---|---|
whoami | Show user and spaces | lecture seule |
hosting_list_projects | List projects | lecture seule |
hosting_create_project | Create project | modifie des données |
hosting_project_status | Project status | lecture seule |
hosting_rename_project | Rename project | modifie des données |
hosting_set_offline | Take project offline or online | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_delete_project | Delete project | modifie des donnéessupprime, remplace ou modifie des éléments visiblesdeux étapes |
hosting_put_files | Write files | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_delete_files | Delete files | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_list_files | List files | lecture seule |
hosting_read_file | Read file | lecture seule |
hosting_create_upload | Create upload link | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_deploy | Publish deployment | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_deploy_status | Deployment status | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_list_deploys | List deployments | lecture seule |
hosting_rollback | Roll back deployment | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_add_domain | Add domain | modifie des données |
hosting_check_domain | Check domain | modifie des données |
hosting_set_primary_domain | Set primary domain | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
hosting_remove_domain | Remove domain | modifie des donnéessupprime, remplace ou modifie des éléments visiblesdeux étapes |
hosting_get_visibility | Get visibility | lecture seule |
hosting_set_visibility | Set visibility | modifie des donnéessupprime, remplace ou modifie des éléments visiblesdeux étapes |
hosting_list_redirects | List redirects | lecture seule |
hosting_set_redirects | Set redirects | modifie des donnéessupprime, remplace ou modifie des éléments visibles |
Certaines limites et certains messages concernent tous les appels
Un appel dure au maximum deux minutes ; une requête ne dépasse pas 8 Mo. Les autres limites et l’aide en cas d’erreur concernent tous les outils.
Les limites de l’offre du Space sont décrites dans les outils pour les projets, les domaines, les fichiers et la publication ; les offres figurent dans Offres Free et Max.