Aller au contenu
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Craft CMS

Intégrez votre workflow avec Craft CMS

L'étape d'intégration Craft CMS vous permet de connecter vos workflows AirOps à votre instance Craft CMS. Cette intégration native offre des capacités complètes de gestion des entrées et des assets directement depuis vos workflows.

Aperçu

Craft CMS est un système de gestion de contenu flexible et convivial conçu pour créer des expériences numériques personnalisées. En connectant Craft CMS à AirOps, vous pouvez automatiser la création de contenu, la publication et la gestion des assets dans vos projets Craft.

Authentification

Avant d'utiliser l'intégration Craft CMS dans vos workflows, vous devez d'abord connecter votre compte Craft CMS dans les paramètres AirOps :

  1. Accédez à Paramètres > Intégrations

  2. Trouvez la section Craft CMS et cliquez sur "Configurer"

  3. Saisissez votre Jeton GraphQL — un jeton avec des permissions d'écriture généré dans le panneau de contrôle de votre Craft CMS sous GraphQL > Jetons

  4. Saisissez votre URL du site — l'URL de base de votre instance Craft CMS (par ex. https://example.com)

  5. Saisissez éventuellement un ID d'auteur par défaut — l'ID numérique de l'utilisateur Craft CMS à attribuer par défaut comme auteur des entrées. Les actions individuelles peuvent remplacer cette valeur

Votre jeton GraphQL doit disposer des permissions de lecture et d'écriture pour les entrées et les assets dans les sections que vous prévoyez d'utiliser.

Actions disponibles

Gestion des entrées

  • Créer une entrée -- ajouter une nouvelle entrée à une section Craft CMS

  • Mettre à jour une entrée -- modifier les champs, le statut ou les métadonnées d'une entrée existante

  • Obtenir une entrée -- récupérer une seule entrée par ID ou slug

  • Lister les entrées -- récupérer plusieurs entrées d'une section avec des filtres facultatifs

  • Supprimer une entrée -- supprimer définitivement une entrée

Gestion des assets

  • Obtenir un asset -- récupérer un seul asset par ID

  • Lister les assets -- récupérer des assets d'un volume avec des filtres facultatifs

  • Attacher un asset à une entrée -- associer des assets existants à un champ d'assets d'une entrée

  • Supprimer un asset -- supprimer définitivement un asset d'un volume

Craft CMS Integration step with the Action dropdown listing Create Entry, Update Entry, Get Entry, List Entries, Delete Entry, Get Asset, List Assets, Attach Asset to Entry, Delete Asset
Choisissez une action Craft CMS.

Paramètres de l'action

Créer une entrée

  1. Section (obligatoire) -- le handle de section auquel appartient l'entrée (par ex. blog, news)

  2. Type d'entrée -- le handle du type d'entrée (par ex. défaut, article). Valeur par défaut défaut

  3. Titre -- le titre de l'entrée

  4. Slug -- le slug URL de l'entrée

  5. Statut -- statut de l'entrée : en ligne ou désactivé

  6. Date de publication -- la date à laquelle l'entrée doit être publiée (format ISO 8601)

  7. Date d'expiration -- la date à laquelle l'entrée doit expirer (format ISO 8601)

  8. Champs personnalisés -- un objet JSON des valeurs des champs personnalisés, indexé par handle de champ

  9. ID de l'auteur -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

Craft CMS Create Entry action with section, entry type, title, slug, status, and custom fields
Créez une entrée Craft CMS à partir des sorties du workflow.

Mettre à jour une entrée

  1. ID de l'entrée (obligatoire) -- l'ID numérique de l'entrée à mettre à jour

  2. Section -- le handle de section auquel appartient l'entrée

  3. Type d'entrée -- le handle du type d'entrée

  4. Titre -- le titre de l'entrée

  5. Slug -- le slug URL de l'entrée

  6. Statut -- statut de l'entrée : en ligne ou désactivé

  7. Date de publication -- la date à laquelle l'entrée doit être publiée

  8. Date d'expiration -- la date à laquelle l'entrée doit expirer

  9. Champs personnalisés -- un objet JSON des valeurs des champs personnalisés, indexé par handle de champ

  10. ID de l'auteur -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

Obtenir une entrée

  1. Rechercher par (obligatoire) -- comment identifier l'entrée : id ou slug

  2. Valeur de recherche (obligatoire) -- la valeur d'ID ou de slug à rechercher

  3. Type d'entrée -- le handle du type d'entrée, utilisé pour construire des fragments de champs personnalisés

  4. Champs -- liste séparée par des virgules des handles de champs personnalisés à inclure dans la réponse (par ex. heroImage,body)

Lister les entrées

  1. Section -- le handle de section à filtrer

  2. Type d'entrée -- le handle du type d'entrée, utilisé pour construire des fragments de champs personnalisés

  3. Champs -- liste séparée par des virgules des handles de champs personnalisés à inclure dans la réponse

  4. Recherche -- une chaîne de requête de recherche pour filtrer les entrées

  5. Limite -- le nombre maximal d'entrées à retourner

  6. Décalage -- le nombre d'entrées à ignorer (pour la pagination)

Supprimer une entrée

  1. ID de l'entrée (obligatoire) -- l'ID numérique de l'entrée à supprimer

Obtenir un asset

  1. ID de l'asset (obligatoire) -- l'ID numérique de l'asset à récupérer

Lister les assets

  1. Volume -- le handle du volume par lequel filtrer les assets (par ex. images, documents)

  2. Recherche -- une chaîne de requête de recherche pour filtrer les assets

  3. Limite -- le nombre maximal d'assets à retourner

Attacher un asset à une entrée

  1. ID de l'entrée (obligatoire) -- l'ID numérique de l'entrée à laquelle attacher des assets

  2. Section (obligatoire) -- le handle de section auquel appartient l'entrée

  3. Type d'entrée -- le handle du type d'entrée

  4. Handle du champ (obligatoire) -- le handle du champ Assets sur l'entrée (par ex. heroImage, images)

  5. ID des assets (obligatoire) -- liste séparée par des virgules des ID d'assets à attacher (par ex. 123,456). Remplace tous les assets existants dans le champ

  6. ID de l'auteur -- l'ID numérique de l'auteur de l'entrée. Remplace l'ID d'auteur par défaut défini dans les identifiants

Supprimer un asset

  1. ID de l'asset (obligatoire) -- l'ID numérique de l'asset à supprimer

Cas d'utilisation courants

  • Créer et publier automatiquement des entrées de blog à partir de contenu généré par l'IA

  • Mettre à jour en masse les statuts des entrées selon les conditions du workflow

  • Attacher des images générées ou importées aux entrées comme assets principaux

  • Récupérer des entrées par slug pour enrichir ou réécrire du contenu existant

  • Construire des pipelines de contenu qui créent des entrées en brouillon et les publient après révision

  • Nettoyer automatiquement les entrées et assets expirés ou obsolètes

Remarque : l'intégration Craft CMS nécessite un jeton GraphQL avec les permissions appropriées. Assurez-vous que votre jeton accorde l'accès aux sections et volumes que vous prévoyez d'utiliser.

Mis à jour

Ce contenu vous a-t-il été utile ?