---

Aperçu

Les champs personnalisés vous permettent d'étendre la structure d'enregistrement standard de Blue avec des champs de données supplémentaires spécifiques à vos besoins commerciaux. Ils fournissent un moyen puissant de capturer des données structurées au-delà des champs intégrés tels que le titre, la description et la date d'échéance.

Les champs personnalisés sont définis au niveau du projet et peuvent être utilisés dans tous les enregistrements (tâches) au sein de ce projet. Chaque champ a un type spécifique qui détermine ses règles de validation, son format d'entrée et son comportement d'affichage.

Opérations Disponibles

Gestion des Champs de Base

Opération	Description	Lien
List Custom Fields	Interroger et filtrer les champs personnalisés	View Details →
Create Custom Field	Ajouter de nouveaux champs personnalisés aux projets	View Details →
Delete Custom Field	Supprimer les champs personnalisés avec nettoyage approprié	View Details →

Valeurs des Champs

Opération	Description	Lien
Set Field Values	Définir et mettre à jour les valeurs des champs personnalisés sur les enregistrements	View Details →

Types de Champs Personnalisés

Champs de Texte

Type	Description	Cas d'Utilisation	Lien
TEXT_SINGLE	Saisie de texte sur une seule ligne	Names, titles, short descriptions	View Details →
TEXT_MULTI	Zone de texte multi-lignes	Longues descriptions, notes, commentaires	View Details →

Champs de Sélection

Type	Description	Cas d'Utilisation	Lien
SELECT_SINGLE	Menu déroulant à sélection unique	Status, priority, category	View Details →
SELECT_MULTI	Menu déroulant à sélection multiple	Tags, skills, categories	View Details →
CHECKBOX	Champ case à cocher booléenne	Flags, approvals, confirmations	View Details →

Champs Numériques

Type	Description	Cas d'Utilisation	Lien
NUMBER	Saisie numérique	Quantities, scores, measurements	View Details →
CURRENCY	Montant en devise	Budgets, costs, pricing	View Details →
PERCENT	Valeur en pourcentage	Completion rates, discounts	View Details →
RATING	Évaluation par étoiles avec échelle personnalisée	Performance ratings, satisfaction	View Details →
FORMULA	Champ calculé basé sur d'autres champs	Totals, computations, aggregations	View Details →

Champs de Contact

Type	Description	Cas d'Utilisation	Lien
EMAIL	Adresse e-mail avec validation	Informations de contact, notifications	View Details →
PHONE	Numéro de téléphone avec format international	Contact details, emergency contacts	View Details →
URL	URL Web avec validation	Links, references, resources	View Details →

Champs de Date et Heure

Type	Description	Cas d'Utilisation	Lien
DATE	Sélecteur de date	Deadlines, milestones, events	View Details →
TIME_DURATION	Champ de suivi du temps	Work hours, duration estimates	View Details →

Localisation et Géographie

Type	Description	Cas d'Utilisation	Lien
LOCATION	Localisation géographique (lat/lng)	Addresses, venues, service areas	View Details →
COUNTRY	Sélecteur de pays	Regional assignments, localization	View Details →

Fichiers et Médias

Type	Description	Cas d'Utilisation	Lien
FILE	Pièce jointe	Documents, images, resources	View Details →

Champs Système

Type	Description	Cas d'Utilisation	Lien
UNIQUE_ID	Identifiant unique généré automatiquement	Ticket numbers, order IDs	View Details →
REFERENCE	Lien vers des enregistrements dans un autre projet	Cross-project relationships	View Details →
LOOKUP	Extraire des données d'enregistrements référencés	Aggregate data from related records	View Details →

Champs Interactifs

Type	Description	Cas d'Utilisation	Lien
BUTTON	Champ de bouton actionnable	Triggers, actions, workflows	View Details →
CURRENCY_CONVERSION	Champ de conversion de devise	Multi-currency calculations	View Details →

Concepts Clés

Définition des Champs

• Les champs personnalisés sont définis au niveau du projet
• Chaque champ a un nom et un type uniques
• Les champs peuvent inclure des règles de validation et des contraintes
• Les options de configuration varient selon le type de champ

Valeurs des Champs

• Les valeurs sont stockées sur des enregistrements individuels (tâches)
• Chaque enregistrement peut avoir des valeurs différentes pour le même champ
• Les valeurs vides/nulles sont autorisées pour les champs optionnels
• Les valeurs sont validées selon les règles de type de champ

Modèle de Permissions

Les champs personnalisés respectent les permissions au niveau du projet :

Rôle	Créer des Champs	Modifier des Champs*	Définir des Valeurs	Voir des Valeurs
OWNER	✅ Oui	✅ Oui	✅ Oui	✅ Oui
ADMIN	✅ Oui	✅ Oui	✅ Oui	✅ Oui
MEMBER	❌ Non	❌ Non	✅ Oui	✅ Oui
CLIENT	❌ Non	❌ Non	✅ Limité	✅ Limité

*Modifier des Champs fait référence à la modification des paramètres des champs (nom, type, options, règles de validation) - pas à la définition des valeurs des champs sur les enregistrements

Permissions de Rôle Personnalisé

• Les projets peuvent avoir des rôles personnalisés avec des permissions spécifiques aux champs
• Les champs peuvent être marqués comme modifiables/non modifiables par rôle
• Les rôles personnalisés peuvent restreindre l'accès à des champs spécifiques

Modèles Courants

Création d'un Champ Personnalisé de Base

mutation CreateCustomField {
  createCustomField(input: {
    name: "Priority Level"
    type: SELECT_SINGLE
    description: "Task priority level"
    customFieldOptions: [
      { title: "Low", color: "#28a745" }
      { title: "Medium", color: "#ffc107" }
      { title: "High", color: "#fd7e14" }
      { title: "Critical", color: "#dc3545" }
    ]
  }) {
    id
    name
    type
    customFieldOptions {
      id
      title
      color
    }
  }
}

Définition des Valeurs des Champs sur les Enregistrements

mutation SetFieldValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    customFieldOptionId: "option_789"  # For SELECT_SINGLE
  })
}

Interrogation des Enregistrements avec des Champs Personnalisés

query GetTodosWithCustomFields {
  todos(projectId: "project_123") {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      # Type-specific value fields
      text           # TEXT_SINGLE, TEXT_MULTI, EMAIL, etc.
      number         # NUMBER, CURRENCY, PERCENT, RATING
      selectedOption # SELECT_SINGLE
      selectedOptions # SELECT_MULTI
      checked        # CHECKBOX
      date           # DATE
    }
  }
}

Création d'Enregistrements avec des Valeurs de Champs Personnalisés

mutation CreateTodoWithCustomFields {
  createTodo(input: {
    title: "New task"
    todoListId: "list_123"
    customFields: [
      { customFieldId: "priority_field", value: "high_priority_option" }
      { customFieldId: "budget_field", value: "5000" }
      { customFieldId: "notes_field", value: "Additional context here" }
    ]
  }) {
    id
    title
    customFields {
      customField { name }
      value
    }
  }
}

Meilleures Pratiques

Conception des Champs

1. Utilisez des noms descriptifs - Rendez les objectifs des champs clairs
2. Choisissez des types appropriés - Associez le type de champ aux exigences de données
3. Définissez des règles de validation - Utilisez des valeurs min/max, des champs obligatoires
4. Organisez logiquement - Regroupez les champs connexes ensemble

Considérations de Performance

1. Limitez le nombre de champs - Trop de champs peuvent affecter la performance
2. Utilisez la pagination - Lors de l'interrogation de grands ensembles de données
3. Indexez les champs clés - Pour les champs utilisés dans le filtrage/le tri
4. Évitez les imbrications profondes - Gardez les relations entre champs simples

Qualité des Données

1. Validez les entrées - Utilisez des types de champs appropriés avec validation
2. Fournissez des valeurs par défaut - Définissez des valeurs par défaut sensées lorsque cela est approprié
3. Utilisez des formats cohérents - Standardisez les modèles de saisie de données
4. Nettoyage régulier - Supprimez les champs et options inutilisés

Expérience Utilisateur

1. Descriptions claires - Fournissez des descriptions utiles des champs
2. Ordre logique - Positionnez les champs dans l'ordre naturel du flux de travail
3. Hiérarchie visuelle - Utilisez les couleurs et le formatage de manière efficace
4. Divulgation progressive - Affichez les champs lorsque cela est pertinent

Gestion des Erreurs

Erreurs courantes lors de l'utilisation des champs personnalisés :

Code d'Erreur	Description	Solution
CUSTOM_FIELD_NOT_FOUND	Le champ n'existe pas	Verify field ID and project access
VALIDATION_ERROR	La valeur ne correspond pas au type de champ	Check format and validation rules
UNAUTHORIZED	Permissions insuffisantes	Ensure proper role level
CUSTOM_FIELD_VALUE_PARSE_ERROR	Format de valeur invalide	Review field type requirements

Ressources Associées

• API des Enregistrements - Travailler avec des enregistrements contenant des champs personnalisés
• API des Projets - Gestion des projets contenant des champs personnalisés
• API des Automatisations - Automatiser les flux de travail avec des déclencheurs de champs personnalisés
• API de Gestion des Utilisateurs - Gestion des permissions des champs personnalisés