Haal een paginated lijst van aangepaste velden voor een project of over meerdere projecten met filter- en sorteermogelijkheden
Lijst alle Aangepaste Velden
Aangepaste velden stellen je in staat om de standaard recordstructuur van Blue uit te breiden met extra datavelden die specifiek zijn voor jouw zakelijke behoeften. Dit eindpunt haalt aangepaste velden op die beschikbaar zijn in jouw projecten, met filtering op veldtype en ondersteuning voor paginering.
Basisvoorbeeld
query ListCustomFields {
customFields(
filter: { projectId: "project_123" }
sort: position_ASC
take: 20
) {
items {
id
uid
name
type
position
}
pageInfo {
totalItems
hasNextPage
}
}
}
Geavanceerd Voorbeeld
query ListCustomFieldsAdvanced {
customFields(
filter: {
projectId: "project_123"
types: [TEXT_SINGLE, NUMBER, SELECT_SINGLE]
}
sort: name_ASC
skip: 20
take: 50
) {
items {
id
uid
name
type
position
description
# Type-specific fields
min # For NUMBER, RATING, PERCENT
max # For NUMBER, RATING, PERCENT
currency # For CURRENCY type
prefix # For UNIQUE_ID type
isDueDate # For DATE type
formula # For FORMULA type
# Validation settings
editable
metadata
# For SELECT types
customFieldOptions {
id
title
color
position
}
}
pageInfo {
totalItems
hasNextPage
hasPreviousPage
}
}
}
Invoervelden
| Parameter |
Type |
Vereist |
Beschrijving |
projectId |
String |
Nee |
Filter op specifieke project-ID |
types |
[CustomFieldType!] |
Nee |
Filter op aangepaste veldtypes |
CustomFieldSort Waarden
| Waarde |
Beschrijving |
name_ASC |
Sorteer op naam oplopend (A-Z) |
name_DESC |
Sorteer op naam aflopend (Z-A) |
createdAt_ASC |
Sorteer op aanmaakdatum (oudste eerst) |
createdAt_DESC |
Sorteer op aanmaakdatum (nieuwste eerst) |
position_ASC |
Sorteer op positie (standaard) |
position_DESC |
Sorteer op positie aflopend |
CustomFieldType Waarden
| Waarde |
Beschrijving |
TEXT_SINGLE |
Enkele regel tekstinvoer |
TEXT_MULTI |
Meerregelige tekstgebied |
SELECT_SINGLE |
Enkele selectie dropdown |
SELECT_MULTI |
Meerdere selectie dropdown |
CHECKBOX |
Boolean checkbox veld |
RATING |
Sterrenbeoordeling (1-5 of aangepaste range) |
PHONE |
Telefoonnummer met validatie |
NUMBER |
Numerieke invoer |
CURRENCY |
Valuta bedrag |
PERCENT |
Percentage waarde |
EMAIL |
E-mailadres met validatie |
URL |
Web-URL met validatie |
UNIQUE_ID |
Automatisch gegenereerde unieke identificatie |
LOCATION |
Geografische locatie (lat/lng) |
FILE |
Bestandsbijlage |
DATE |
Datumkiezer |
COUNTRY |
Landselector |
FORMULA |
Berekend veld op basis van andere velden |
REFERENCE |
Link naar records in een ander project |
LOOKUP |
Gegevens ophalen uit verwijzende records |
TIME_DURATION |
Tijdregistratie veld |
BUTTON |
Actieknop veld |
CURRENCY_CONVERSION |
Valuta conversie veld |
Paginering Parameters
| Parameter |
Type |
Vereist |
Beschrijving |
skip |
Int |
Nee |
Aantal items om over te slaan (standaard: 0) |
take |
Int |
Nee |
Aantal items om terug te geven (standaard: 20, max: 500) |
Antwoordvelden
CustomField
| Veld |
Type |
Beschrijving |
id |
String! |
Unieke identificatie |
uid |
String! |
Unieke gebruiksvriendelijke ID |
name |
String! |
Weergavenaam van het veld |
type |
CustomFieldType! |
Type van het aangepaste veld |
position |
Float! |
Sorteervolgorde positie |
description |
String |
Optionele veldbeschrijving |
min |
Float |
Minimumwaarde (NUMMER, BEOORDELING, PERCENTAGE) |
max |
Float |
Maximumwaarde (NUMMER, BEOORDELING, PERCENTAGE) |
currency |
String |
Valutacode (VALUTA type) |
prefix |
String |
Voorvoegsel voor UNIQUE_ID generatie |
isDueDate |
Boolean |
Of het DATUM veld een vervaldatum vertegenwoordigt |
formula |
JSON |
Formuleconfiguratie (FORMULE type) |
editable |
Boolean |
Of de huidige gebruiker dit veld kan bewerken |
metadata |
JSON |
Extra veldconfiguratie |
customFieldOptions |
[CustomFieldOption!] |
Beschikbare opties voor SELECT types |
CustomFieldOption
| Veld |
Type |
Beschrijving |
id |
String! |
Unieke identificatie |
title |
String! |
Weergavetekst voor de optie |
color |
String! |
Hex kleurcode |
position |
Float! |
Sorteervolgorde positie |
PageInfo
| Veld |
Type |
Beschrijving |
totalItems |
Int |
Totaal aantal aangepaste velden |
hasNextPage |
Boolean! |
Of er meer pagina's bestaan |
hasPreviousPage |
Boolean! |
Of eerdere pagina's bestaan |
endCursor |
String |
Cursor voor paginering (verouderd - gebruik offset-gebaseerde paginering) |
Vereiste Machtigingen
Aangepaste velden zijn toegankelijk op basis van jouw projectrol. Als je een aangepaste rol hebt met beperkte toegang tot velden, worden alleen velden die als bewerkbaar zijn gemarkeerd voor jouw rol geretourneerd.
| Rol |
Kan Aangepaste Velden Lijsten |
OWNER |
✅ Ja (alle velden) |
ADMIN |
✅ Ja (alle velden) |
MEMBER |
✅ Ja (op basis van rolmachtigingen) |
CLIENT |
✅ Ja (op basis van rolmachtigingen) |
Foutantwoorden
Project Niet Gevonden
{
"errors": [{
"message": "Project not found.",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Ongeldig Veldtype
{
"errors": [{
"message": "Variable \"$filter\" got invalid value \"INVALID_TYPE\" at \"filter.types[0]\"; Value \"INVALID_TYPE\" does not exist in \"CustomFieldType\" enum.",
"extensions": {
"code": "GRAPHQL_VALIDATION_FAILED"
}
}]
}
Belangrijke Notities
- Aangepaste velden zijn beperkt tot projecten - je moet een
projectId in de filter specificeren
- De
take parameter is beperkt tot 500 items per verzoek voor prestaties
- Velden worden geretourneerd op basis van gebruikersmachtigingen - aangepaste rollen kunnen beperkte toegang hebben
- De standaard sorteervolgorde is op
position oplopend, wat de volgorde weerspiegelt die in de UI wordt weergegeven
- Deze query ondersteunt filtering op enkele projecten - voor multi-project queries, gebruik de geneste CustomFieldQueries interface
- Sommige veldtypes (zoals FORMULE en REFERENTIE) kunnen extra geneste datastructuren bevatten
- Het
editable veld geeft aan of de huidige gebruiker waarden voor dit aangepaste veld kan wijzigen
Gerelateerde Eindpunten