Les modèles vous permettent de réutiliser la structure des projets existants pour lancer de nouvelles initiatives avec le même cadre déjà en place.


Aperçu des Modèles

Blue prend en charge deux types de modèles :

  • Modèles d'Entreprise : Créés par votre organisation pour un usage interne
  • Modèles Officiels : Créés par Blue pour tous les utilisateurs (modèles conformes aux normes de l'industrie)

Les modèles préservent l'ensemble de la structure du projet, y compris les tâches, les listes, les champs personnalisés, les automatisations, et plus encore.

Modèles de Liste

Utilisation de la requête templates

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Utilisation de projectList avec le filtre Template

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Créer un Projet à partir d'un Modèle

Pour créer un nouveau projet à partir d'un modèle existant :

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}
La création à partir d'un modèle est un processus asynchrone. Le projet est créé immédiatement, mais le contenu est copié en arrière-plan. Utilisez la requête `copyProjectStatus` pour suivre les progrès.

Convertir un Projet en Modèle

Transformez un projet existant en un modèle réutilisable :

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Supprimer le Statut de Modèle

Convertir un modèle en projet régulier :

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Obtenir un Modèle Unique

Récupérer des détails sur un modèle spécifique :

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Paramètres de Requête

Requête templates

Paramètre Type Requis Description
companyId String Non Filtrer les modèles par entreprise. Omettre pour voir les modèles officiels.
isOfficialTemplate Boolean Non Afficher uniquement les modèles officiels de Blue
category ProjectCategory Non Filtrer par catégorie de projet

Input convertProjectToTemplate

Paramètre Type Requis Description
projectId String! ✅ Oui Le projet à convertir en modèle
isOfficialTemplate Boolean! ✅ Oui Marquer comme modèle officiel (uniquement pour les employés de Blue)

Catégories de Modèles

Valeur Description
CRM Gestion de la Relation Client
CROSS_FUNCTIONAL Projets d'équipe inter-fonctionnels
CUSTOMER_SUCCESS Initiatives de réussite client
DESIGN Projets de design et créatifs
ENGINEERING Ingénierie et développement
GENERAL Projets généraux (par défaut)
HR Ressources Humaines
IT Technologies de l'Information
MARKETING Campagnes marketing
OPERATIONS Opérations et logistique
PRODUCT Gestion de produit
SALES Ventes et développement commercial

Ce qui est Copié des Modèles

Lors de la création d'un projet à partir d'un modèle, les éléments suivants sont copiés :

  • Structure : Toutes les listes de tâches et les tâches avec leurs positions
  • Contenu : Descriptions, commentaires et pièces jointes
  • Organisation : Étiquettes, labels et champs personnalisés
  • Automatisation : Toutes les règles d'automatisation et les flux de travail
  • Formulaires : Formulaires de projet et leurs configurations
  • Documents : Pages wiki et documentation
  • Paramètres : Configurations de couverture et préférences d'affichage
  • Rôles : Définitions de rôles d'utilisateur (mais pas les attributions d'utilisateur)

Non copié :

  • ❌ Attributions d'utilisateur (sauf le créateur)
  • ❌ Historique des activités
  • ❌ Données de suivi du temps
  • ❌ Statut complété des tâches

Permissions Requises

Création de Modèles

Action Rôle Requis
Convert project to template Project OWNER or ADMIN
Create official template Blue employee only
Remove template status Project OWNER or ADMIN

Utilisation des Modèles

Type de Modèle Qui Peut Utiliser
Company templates Users in the same company
Official templates All Blue users

Réponses d'Erreur

Modèle Non Trouvé

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Trop de Tâches

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Notes Importantes

  • Limite de Taille : Les projets avec plus de 250 000 tâches ne peuvent pas être utilisés comme modèles
  • Copie Asynchrone : Le contenu du modèle est copié en arrière-plan via une file d'attente de tâches
  • Statut d'Archivage : La conversion en modèle désarchive automatiquement le projet
  • Suppression de Dossier : Les modèles sont supprimés des dossiers lors de la conversion
  • Contrôle d'Accès : Les modèles officiels sont visibles par tous, les modèles d'entreprise uniquement par les membres
  • Mises à Jour en Temps Réel : Abonnez-vous aux changements de modèle en utilisant la souscription subscribeToProject

Assistant IA

Les réponses sont générées par l'IA et peuvent contenir des erreurs.

Comment puis-je vous aider ?

Posez-moi toutes vos questions sur Blue ou cette documentation.

Entrez pour envoyer • Maj+Entrée pour une nouvelle ligne • ⌘I pour ouvrir