---

Overzicht

Aangepaste velden stellen u in staat om de standaard recordstructuur van Blue uit te breiden met extra gegevensvelden die specifiek zijn voor uw zakelijke behoeften. Ze bieden een krachtige manier om gestructureerde gegevens vast te leggen die verder gaan dan de ingebouwde velden zoals titel, beschrijving en vervaldatum.

Aangepaste velden worden gedefinieerd op projectniveau en kunnen worden gebruikt in alle records (to-do's) binnen dat project. Elk veld heeft een specifiek type dat de validatieregels, invoerformaat en weergavegedrag bepaalt.

Beschikbare Operaties

Beheer van Kernvelden

Operatie	Beschrijving	Link
List Custom Fields	Vraag en filter aangepaste velden	View Details →
Create Custom Field	Voeg nieuwe aangepaste velden toe aan projecten	View Details →
Delete Custom Field	Verwijder aangepaste velden met de juiste opruiming	View Details →

Veldwaarden

Operatie	Beschrijving	Link
Set Field Values	Stel en werk aangepaste veldwaarden bij op records	View Details →

Typen Aangepaste Velden

Tekstvelden

Type	Beschrijving	Toepassingen	Link
TEXT_SINGLE	Enkele regel tekstinvoer	Names, titles, short descriptions	View Details →
TEXT_MULTI	Meerregelige tekstgebied	Lange beschrijvingen, notities, opmerkingen	View Details →

Selectievelden

Type	Beschrijving	Toepassingen	Link
SELECT_SINGLE	Enkele selectie dropdown	Status, priority, category	View Details →
SELECT_MULTI	Meervoudige selectie dropdown	Tags, skills, categories	View Details →
CHECKBOX	Boolean checkbox veld	Flags, approvals, confirmations	View Details →

Numerieke Velden

Type	Beschrijving	Toepassingen	Link
NUMBER	Numerieke invoer	Quantities, scores, measurements	View Details →
CURRENCY	Bedrag in valuta	Budgets, costs, pricing	View Details →
PERCENT	Percentage waarde	Completion rates, discounts	View Details →
RATING	Sterrenbeoordeling met aangepaste schaal	Performance ratings, satisfaction	View Details →
FORMULA	Gecalculeerd veld op basis van andere velden	Totals, computations, aggregations	View Details →

Contactvelden

Type	Beschrijving	Toepassingen	Link
EMAIL	E-mailadres met validatie	Contactinformatie, meldingen	View Details →
PHONE	Telefoonnummer met internationale opmaak	Contact details, emergency contacts	View Details →
URL	Web-URL met validatie	Links, references, resources	View Details →

Datum- en Tijdvelden

Type	Beschrijving	Toepassingen	Link
DATE	Datumkiezer	Deadlines, milestones, events	View Details →
TIME_DURATION	Tijdregistratieveld	Work hours, duration estimates	View Details →

Locatie en Geografie

Type	Beschrijving	Toepassingen	Link
LOCATION	Geografische locatie (lat/lng)	Addresses, venues, service areas	View Details →
COUNTRY	Landselector	Regional assignments, localization	View Details →

Bestanden en Media

Type	Beschrijving	Toepassingen	Link
FILE	Bestandsbijlage	Documents, images, resources	View Details →

Systeemvelden

Type	Beschrijving	Toepassingen	Link
UNIQUE_ID	Automatisch gegenereerde unieke identificatie	Ticket numbers, order IDs	View Details →
REFERENCE	Link naar records in een ander project	Cross-project relationships	View Details →
LOOKUP	Gegevens ophalen uit verwijzende records	Aggregate data from related records	View Details →

Interactieve Velden

Type	Beschrijving	Toepassingen	Link
BUTTON	Actieknopveld	Triggers, actions, workflows	View Details →
CURRENCY_CONVERSION	Valuta conversieveld	Multi-currency calculations	View Details →

Sleutelconcepten

Velddefinitie

• Aangepaste velden worden gedefinieerd op projectniveau
• Elk veld heeft een unieke naam en type
• Velden kunnen validatieregels en beperkingen bevatten
• Configuratieopties variëren per veldtype

Veldwaarden

• Waarden worden opgeslagen op individuele records (to-do's)
• Elk record kan verschillende waarden voor hetzelfde veld hebben
• Lege/null waarden zijn toegestaan voor optionele velden
• Waarden worden gevalideerd volgens de regels van het veldtype

Toegangsmodel

Aangepaste velden respecteren de projectniveau-toegangsrechten:

Rol	Velden Aanmaken	Velden Bewerken*	Waarden Instellen	Waarden Bekijken
OWNER	✅ Ja	✅ Ja	✅ Ja	✅ Ja
ADMIN	✅ Ja	✅ Ja	✅ Ja	✅ Ja
MEMBER	❌ Nee	❌ Nee	✅ Ja	✅ Ja
CLIENT	❌ Nee	❌ Nee	✅ Beperkt	✅ Beperkt

*Velden Bewerken verwijst naar het wijzigen van veldinstellingen (naam, type, opties, validatieregels) - niet het instellen van veldwaarden op records

Aangepaste Roltoegangen

• Projecten kunnen aangepaste rollen hebben met veldspecifieke toegangen
• Velden kunnen per rol als bewerkbaar/niet-bewerkbaar worden gemarkeerd
• Aangepaste rollen kunnen de toegang tot specifieke velden beperken

Veelvoorkomende Patronen

Een Basis Aangepast Veld Aanmaken

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
    }
  }
}

Veldwaarden Instellen op Records

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

Records Opvragen met Aangepaste Velden

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
    }
  }
}

Records Aanmaken met Aangepaste Veldwaarden

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
    }
  }
}

Beste Praktijken

Veldontwerp

1. Gebruik beschrijvende namen - Maak de doeleinden van velden duidelijk
2. Kies geschikte types - Stem het veldtype af op de gegevensvereisten
3. Stel validatieregels in - Gebruik min/max waarden, verplichte velden
4. Organiseer logisch - Groepeer gerelateerde velden samen

Prestatieoverwegingen

1. Beperk het aantal velden - Te veel velden kunnen de prestaties beïnvloeden
2. Gebruik paginering - Bij het opvragen van grote datasets
3. Indexeer sleutelvelden - Voor velden die worden gebruikt bij filtering/sorteren
4. Vermijd diepe nesting - Houd veldrelaties eenvoudig

Gegevenskwaliteit

1. Valideer invoer - Gebruik geschikte veldtypes met validatie
2. Bied standaardwaarden - Stel zinvolle standaardwaarden in waar nodig
3. Gebruik consistente formaten - Standaardiseer gegevensinvoerpaden
4. Regelmatige opruiming - Verwijder ongebruikte velden en opties

Gebruikerservaring

1. Duidelijke beschrijvingen - Bied nuttige veldbeschrijvingen
2. Logische ordening - Plaats velden in de natuurlijke workflowvolgorde
3. Visuele hiërarchie - Gebruik kleuren en opmaak effectief
4. Progressieve onthulling - Toon velden wanneer relevant

Foutafhandeling

Veelvoorkomende fouten bij het werken met aangepaste velden:

Foutcode	Beschrijving	Oplossing
CUSTOM_FIELD_NOT_FOUND	Veld bestaat niet	Verify field ID and project access
VALIDATION_ERROR	Waarde komt niet overeen met veldtype	Check format and validation rules
UNAUTHORIZED	Onvoldoende rechten	Ensure proper role level
CUSTOM_FIELD_VALUE_PARSE_ERROR	Ongeldig waardeformaat	Review field type requirements

Gerelateerde Bronnen

• Records API - Werken met records die aangepaste velden bevatten
• Projecten API - Beheren van projecten die aangepaste velden bevatten
• Automatiseringen API - Automatiseren van workflows met aangepaste veldtriggers
• Gebruikersbeheer API - Beheren van toegangen tot aangepaste velden