Maak een Aangepast Veld

Voeg nieuwe aangepaste velden toe om de datastructuur van uw project uit te breiden met type-specifieke configuraties

Maak een Aangepast Veld

Aangepaste velden stellen u in staat om Blue aan te passen aan uw specifieke zakelijke behoeften door gestructureerde datavelden aan uw records toe te voegen. Dit eindpunt maakt een nieuw aangepast veld met configuraties die specifiek zijn voor elk veldtype.

Basisvoorbeeld

mutation CreateTextField {
  createCustomField(input: {
    name: "Customer Name"
    type: TEXT_SINGLE
    description: "Primary customer contact name"
  }) {
    id
    uid
    name
    type
    position
  }
}

Geavanceerd Voorbeeld

mutation CreateAdvancedField {
  createCustomField(input: {
    name: "Project Budget"
    type: CURRENCY
    description: "Total allocated budget for this project"
    currency: "USD"
    min: 0
    max: 1000000
  }) {
    id
    uid
    name
    type
    currency
    min
    max
    position
    createdAt
  }
}

Invoervelden

CreateCustomFieldInput

Parameter	Type	Vereist	Beschrijving
`name`	String!	✅ Ja	De weergavenaam van het aangepaste veld
`type`	CustomFieldType!	✅ Ja	Het veldtype (zie types hieronder)
`description`	String	Nee	Optionele beschrijving die het doel van het veld uitlegt
`min`	Float	Nee	Minimale waarde voor NUMBER, RATING, PERCENT velden
`max`	Float	Nee	Maximale waarde voor NUMBER, RATING, PERCENT velden
`currency`	String	Nee	ISO-valutacode voor CURRENCY velden
`prefix`	String	Nee	Tekstprefix voor UNIQUE_ID velden
`isDueDate`	Boolean	Nee	Of het DATE veld een vervaldatum vertegenwoordigt
`formula`	JSON	Nee	Formuleconfiguratie voor FORMULA velden
`referenceProjectId`	String	Nee	Doelproject-ID voor REFERENCE velden
`referenceMultiple`	Boolean	Nee	Meerdere selecties toestaan in REFERENCE velden
`referenceFilter`	TodoFilterInput	Nee	Filteropties voor REFERENCE velden
`lookupOption`	CustomFieldLookupOptionInput	Nee	Configuratie voor LOOKUP velden
`timeDurationDisplay`	CustomFieldTimeDurationDisplayType	Nee	Weergaveformaat voor TIME_DURATION
`timeDurationTargetTime`	Float	Nee	Doeltijd in seconden voor TIME_DURATION
`timeDurationStartInput`	CustomFieldTimeDurationInput	Nee	Starttrigger voor TIME_DURATION
`timeDurationEndInput`	CustomFieldTimeDurationInput	Nee	Eindtrigger voor TIME_DURATION
`buttonType`	String	Nee	Actietype voor BUTTON velden
`buttonConfirmText`	String	Nee	Bevestigingsprompt voor BUTTON velden
`useSequenceUniqueId`	Boolean	Nee	Gebruik sequentiële nummering voor UNIQUE_ID
`sequenceDigits`	Int	Nee	Aantal cijfers in de sequentie (bijv. 5 → 00001)
`sequenceStartingNumber`	Int	Nee	Startnummer voor de sequentie
`currencyFieldId`	String	Nee	Referentievaluta voor CURRENCY_CONVERSION
`conversionDate`	String	Nee	Conversiedatum voor CURRENCY_CONVERSION
`conversionDateType`	String	Nee	Type conversiedatum voor CURRENCY_CONVERSION
`metadata`	JSON	Nee	Extra metadata voor het aangepaste veld

Waarden voor CustomFieldType

Waarde	Beschrijving	Vereiste Parameters
`TEXT_SINGLE`	Enkele regel tekstinvoer	Geen
`TEXT_MULTI`	Multi-line tekstgebied	Geen
`SELECT_SINGLE`	Enkele selectie dropdown	Create options separately
`SELECT_MULTI`	Meerdere selectie dropdown	Create options separately
`CHECKBOX`	Boolean checkbox	Geen
`RATING`	Sterrenbeoordelingsveld	Optional: `max` (default: 5)
`PHONE`	Telefoonnummer met validatie	Geen
`NUMBER`	Numerieke invoer	Optional: `min`, `max`
`CURRENCY`	Valuta bedrag	Optional: `currency`, `min`, `max`
`PERCENT`	Percentage (0-100)	Optional: `min`, `max`
`EMAIL`	E-mail met validatie	Geen
`URL`	Web-URL met validatie	Geen
`UNIQUE_ID`	Automatisch gegenereerde identificatie	Optional: `prefix`, `useSequenceUniqueId`
`LOCATION`	Geografische coördinaten	Geen
`FILE`	Bestandsbijlage	Geen
`DATE`	Datumkiezer	Optional: `isDueDate`
`COUNTRY`	Landselector	Geen
`FORMULA`	Berekend veld	Required: `formula`
`REFERENCE`	Link naar andere records	Required: `referenceProjectId`
`LOOKUP`	Gegevens ophalen uit referenties	Required: `lookupOption`
`TIME_DURATION`	Tijdregistratie	Required: duration inputs (see below)
`BUTTON`	Actieknop	Optional: `buttonType`, `buttonConfirmText`
`CURRENCY_CONVERSION`	Valutaconverter	Special configuration

Voorbeelden van Veldtypeconfiguraties

Nummer Veld met Beperkingen

mutation CreateQuantityField {
  createCustomField(input: {
    name: "Quantity"
    type: NUMBER
    description: "Number of items"
    min: 1
    max: 999
  }) {
    id
    name
    min
    max
  }
}

Valuta Veld

mutation CreateBudgetField {
  createCustomField(input: {
    name: "Budget"
    type: CURRENCY
    currency: "EUR"
    min: 0
  }) {
    id
    name
    currency
    min
  }
}

Datum Veld met Vervaldatum Vlag

mutation CreateDeadlineField {
  createCustomField(input: {
    name: "Project Deadline"
    type: DATE
    isDueDate: true
    description: "When this project must be completed"
  }) {
    id
    name
    isDueDate
  }
}

Referentie Veld

mutation CreateRelatedTasksField {
  createCustomField(input: {
    name: "Dependencies"
    type: REFERENCE
    referenceProjectId: "proj_abc123"
    referenceMultiple: true
    referenceFilter: {
      statusIds: ["status_open", "status_inprogress"]
    }
  }) {
    id
    name
    referenceProjectId
    referenceMultiple
  }
}

Lookup Veld

mutation CreateLookupField {
  createCustomField(input: {
    name: "Customer Email"
    type: LOOKUP
    lookupOption: {
      referenceId: "field_customer_ref"
      lookupId: "field_email"
      lookupType: TODO_CUSTOM_FIELD
    }
  }) {
    id
    name
    customFieldLookupOption {
      referenceId
      lookupId
      lookupType
    }
  }
}

Unieke ID met Sequentie

mutation CreateOrderNumberField {
  createCustomField(input: {
    name: "Order Number"
    type: UNIQUE_ID
    prefix: "ORD-"
    useSequenceUniqueId: true
    sequenceDigits: 6
    sequenceStartingNumber: 1000
  }) {
    id
    name
    prefix
  }
}

Tijd Duur Veld

mutation CreateTimeTrackingField {
  createCustomField(input: {
    name: "Time to Resolution"
    type: TIME_DURATION
    timeDurationDisplay: FULL_DATE_STRING
    timeDurationStartInput: {
      type: TODO_CREATED_AT
      condition: FIRST
    }
    timeDurationEndInput: {
      type: TODO_MARKED_AS_COMPLETE
      condition: FIRST
    }
  }) {
    id
    name
  }
}

Geldige Tijd Duur Types

TODO_CREATED_AT - Wanneer het record is aangemaakt
TODO_CUSTOM_FIELD - Wanneer een aangepast veld verandert
TODO_DUE_DATE - Wanneer de vervaldatum is ingesteld/wijzigd
TODO_MARKED_AS_COMPLETE - Wanneer het record als voltooid is gemarkeerd
TODO_MOVED - Wanneer het record naar een andere lijst wordt verplaatst
TODO_TAG_ADDED - Wanneer een tag wordt toegevoegd
TODO_ASSIGNEE_ADDED - Wanneer een toegewezen persoon wordt toegevoegd

Selectieopties Maken

Na het maken van een SELECT_SINGLE of SELECT_MULTI veld, voeg opties toe:

mutation CreateSelectOptions {
  createCustomFieldOptions(input: {
    customFieldId: "field_xyz789"
    customFieldOptions: [
      { title: "High", color: "#FF0000", position: 1 }
      { title: "Medium", color: "#FFA500", position: 2 }
      { title: "Low", color: "#00FF00", position: 3 }
    ]
  }) {
    id
    title
    color
    position
  }
}

Antwoordvelden

CustomField

Veld	Type	Beschrijving
`id`	String!	Unieke identificatie
`uid`	String!	Gebruiksvriendelijke unieke ID
`name`	String!	Weergavenaam
`type`	CustomFieldType!	Veldtype
`description`	String	Veldbeschrijving
`position`	Float!	Weergavevolgorde positie
`createdAt`	DateTime!	Aanmaak tijdstempel
`updatedAt`	DateTime!	Laatste update tijdstempel
`min`	Float	Minimale waarde (indien van toepassing)
`max`	Float	Maximale waarde (indien van toepassing)
`currency`	String	Valutacode (CURRENCY type)
`prefix`	String	ID-prefix (UNIQUE_ID type)
`isDueDate`	Boolean	Vervaldatum vlag (DATE type)
`formula`	JSON	Formuleconfiguratie (FORMULA type)
`referenceProjectId`	String	Verwezen project (REFERENCE type)
`customFieldLookupOption`	CustomFieldLookupOption	Lookup configuratie (LOOKUP type)

Vereiste Machtigingen

Het maken van aangepaste velden vereist projecttoegang:

Rol	Kan Aangepaste Velden Maken
`OWNER`	✅ Ja
`ADMIN`	✅ Ja
`MEMBER`	✅ Ja
`CLIENT`	❌ Nee

Opmerking: Aangepaste rollen kunnen aanvullende beperkingen hebben op het beheer van velden.

Foutreacties

Ongeldig Veldtype

{
  "errors": [{
    "message": "Variable \"$input\" got invalid value \"INVALID\" at \"input.type\"; Value \"INVALID\" does not exist in \"CustomFieldType\" enum.",
    "extensions": {
      "code": "GRAPHQL_VALIDATION_FAILED"
    }
  }]
}

Referentieproject Niet Gevonden

{
  "errors": [{
    "message": "Reference project not found or access denied",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Ontbrekende Vereiste Configuratie

{
  "errors": [{
    "message": "REFERENCE fields require referenceProjectId",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

Belangrijke Notities

Veldpositie: Automatisch berekend om aan het einde van bestaande velden te verschijnen
Veldlimieten: Projecten kunnen limieten hebben voor het aantal aangepaste velden
Directe Beschikbaarheid: Gemaakte velden zijn onmiddellijk beschikbaar voor gebruik
Bijwerkingen: Het maken van een veld activeert:
- Activiteit logboekvermelding
- Real-time updates voor verbonden gebruikers
- Webhookmeldingen
- Achtergrondtaken voor FORMULA, LOOKUP en UNIQUE_ID velden
Speciale Overwegingen:
- REFERENCE velden vereisen toegang tot het doelproject
- LOOKUP velden zijn afhankelijk van bestaande REFERENCE velden
- FORMULA velden kunnen zichzelf niet verwijzen
- UNIQUE_ID sequenties worden asynchroon verwerkt
- SELECT velden moeten opties apart worden gemaakt
Naamgeving: Veldnamen moeten duidelijk en beschrijvend zijn zoals ze in de UI verschijnen

Gerelateerde Eindpunten

Lijst Aangepaste Velden - Bekijk bestaande aangepaste velden
Update Aangepast Veld - Wijzig veld eigenschappen
Verwijder Aangepast Veld - Verwijder een aangepast veld
Maak Veldopties - Voeg opties toe aan select velden
Stel Aangepaste Veldwaarden In - Stel waarden in op records