---

Een Aangepast Veld Verwijderen

Verwijdert permanent een aangepast veld uit een project samen met alle bijbehorende gegevens, waarden en configuraties. Deze bewerking kan niet ongedaan gemaakt worden en zal invloed hebben op alle records die dit veld gebruiken.

Basisvoorbeeld

mutation DeleteCustomField {
  deleteCustomField(id: "field_abc123")
}

Geavanceerd Voorbeeld

mutation DeleteCustomFieldWithResponse {
  deleteCustomField(id: "field_abc123")
}

Invoervelden

Parameter	Type	Vereist	Beschrijving
id	String!	✅ Ja	De unieke identificatie van het aan te passen veld dat verwijderd moet worden

Antwoordvelden

Veld	Type	Beschrijving
deleteCustomField	Boolean!	Geeft altijd true terug wanneer de verwijdering succesvol is

Vereiste Machtigingen

Alleen projecteigenaars en beheerders kunnen aangepaste velden verwijderen.

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

Cascade-effecten

Wanneer een aangepast veld wordt verwijderd, worden de volgende opruimoperaties automatisch uitgevoerd:

Gegevensopruiming

• Waarden van aangepaste velden - Alle waarden voor dit veld worden verwijderd uit alle records
• Veldopties - Alle dropdownopties en configuraties worden verwijderd
• Activiteitsgeschiedenis - Alle activiteitsrecords die verband houden met dit veld worden verwijderd
• Lookup-configuraties - Alle verwijzingen naar lookup-velden worden opgeruimd

Speciale Behandeling voor Knopvelden

Als het verwijderde veld van het type BUTTON is, vindt er aanvullende opruiming plaats:

• Automatiseringen - Alle automatiseringen die door deze knop worden geactiveerd, worden verwijderd
• Automatiseringsgeschiedenis - Gerelateerde automatiseringsactiviteit wordt verwijderd

Real-time Updates

• Grafieken - Projectgrafieken worden gemarkeerd voor update om de wijzigingen weer te geven
• Formules - Alle formulevelden in het project worden opnieuw berekend
• Tijdregistratie - Tijdduur berekeningen worden bijgewerkt
• Abonnementen - Real-time meldingen worden verzonden naar verbonden cliënten
• Webhooks - Integratie-webhooks worden geactiveerd met verwijderingsgebeurtenissen

Foutantwoorden

Aangepast Veld Niet Gevonden

{
  "errors": [{
    "message": "Custom field was not found.",
    "extensions": {
      "code": "CUSTOM_FIELD_NOT_FOUND"
    }
  }]
}

Onvoldoende Machtigingen

{
  "errors": [{
    "message": "You don't have permission to perform this action",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}

Belangrijke Notities

Permanente Verwijdering

• Geen ongedaan maken - Verwijderde aangepaste velden kunnen niet worden hersteld
• Gegevensverlies - Alle veldwaarden in alle records worden permanent verwijderd
• Directe effect - Wijzigingen worden onmiddellijk van kracht voor alle projectgebruikers

Prestatieoverwegingen

• Grote projecten - Verwijdering kan langer duren in projecten met veel records
• Herberekening van formules - Projecten met complexe formules kunnen korte verwerkingsvertragingen ervaren
• Grafiekupdates - Dashboardgrafieken worden vernieuwd om de wijzigingen weer te geven

Best Practices

1. Back-up gegevens - Exporteer belangrijke veldwaarden voordat u verwijdert
2. Communiceer wijzigingen - Informeer teamleden voordat u velden verwijdert
3. Controleer afhankelijkheden - Controleer of er geen automatiseringen of formules afhankelijk zijn van het veld
4. Herzie rapporten - Werk eventuele rapporten bij die naar het verwijderde veld verwijzen

Gerelateerde Operaties

• Gebruik Lijst Aangepaste Velden om veld-ID's te vinden
• Overweeg Maak Aangepast Veld om soortgelijke velden opnieuw te maken
• Bekijk Aangepaste Veldwaarden om de impact op gegevens te begrijpen

Veelvoorkomende Gebruiksscenario's

Verwijderen van Ongebruikte Velden

# First, list fields to identify unused ones
query ListCustomFields {
  customFields(projectId: "project_123") {
    id
    name
    type
    createdAt
    # Check usage in records
  }
}

# Then delete the unused field
mutation DeleteUnusedField {
  deleteCustomField(id: "field_to_remove")
}

Opruimen van Testvelden

# Remove fields created during testing
mutation CleanupTestFields {
  field1: deleteCustomField(id: "test_field_1")
  field2: deleteCustomField(id: "test_field_2")
  field3: deleteCustomField(id: "test_field_3")
}

Herstructureren van Projectvelden

# When reorganizing field structure
mutation RestructureFields {
  # Delete old fields
  deleteOldPriorityField: deleteCustomField(id: "old_priority_field")
  deleteOldStatusField: deleteCustomField(id: "old_status_field")
  
  # Note: Create new fields in separate mutations
}

Webhook-gebeurtenissen

Wanneer een aangepast veld wordt verwijderd, wordt de volgende webhook-gebeurtenis geactiveerd:

{
  "event": "CUSTOM_FIELD_DELETED",
  "projectId": "project_123",
  "timestamp": "2024-01-15T10:30:00Z",
  "previousValue": {
    "id": "field_abc123",
    "name": "Priority Level",
    "type": "SELECT_SINGLE",
    "projectId": "project_123"
  },
  "currentValue": null
}