---

Översikt

Anpassade fält gör att du kan utöka Blues standardpoststruktur med ytterligare datafält som är specifika för dina affärsbehov. De erbjuder ett kraftfullt sätt att fånga strukturerad data utöver de inbyggda fälten som titel, beskrivning och förfallodatum.

Anpassade fält definieras på projekt nivå och kan användas över alla poster (att-göra) inom det projektet. Varje fält har en specifik typ som bestämmer dess valideringsregler, inmatningsformat och visningsbeteende.

Tillgängliga operationer

Kärnfältshantering

Operation	Beskrivning	Länk
List Custom Fields	Fråga och filtrera anpassade fält	View Details →
Create Custom Field	Lägg till nya anpassade fält till projekt	View Details →
Delete Custom Field	Ta bort anpassade fält med korrekt städning	View Details →

Fältvärden

Operation	Beskrivning	Länk
Set Field Values	Ställ in och uppdatera anpassade fältvärden på poster	View Details →

Typer av anpassade fält

Textfält

Typ	Beskrivning	Användningsfall	Länk
TEXT_SINGLE	En rad textinmatning	Names, titles, short descriptions	View Details →
TEXT_MULTI	Flera rader textområde	Långa beskrivningar, anteckningar, kommentarer	View Details →

Urvalsfält

Typ	Beskrivning	Användningsfall	Länk
SELECT_SINGLE	Enkel urval rullgardinsmeny	Status, priority, category	View Details →
SELECT_MULTI	Flera urval rullgardinsmeny	Tags, skills, categories	View Details →
CHECKBOX	Boolesk kryssfält	Flags, approvals, confirmations	View Details →

Numeriska fält

Typ	Beskrivning	Användningsfall	Länk
NUMBER	Numerisk inmatning	Quantities, scores, measurements	View Details →
CURRENCY	Valuta belopp	Budgets, costs, pricing	View Details →
PERCENT	Procentvärde	Completion rates, discounts	View Details →
RATING	Stjärnbetyg med anpassad skala	Performance ratings, satisfaction	View Details →
FORMULA	Beräknat fält baserat på andra fält	Totals, computations, aggregations	View Details →

Kontaktfält

Typ	Beskrivning	Användningsfall	Länk
EMAIL	E-postadress med validering	Kontaktinformation, meddelanden	View Details →
PHONE	Telefonnummer med internationell formatering	Contact details, emergency contacts	View Details →
URL	Webb-URL med validering	Links, references, resources	View Details →

Datum- och tidsfält

Typ	Beskrivning	Användningsfall	Länk
DATE	Datumväljare	Deadlines, milestones, events	View Details →
TIME_DURATION	Tidsregistreringsfält	Work hours, duration estimates	View Details →

Plats och geografi

Typ	Beskrivning	Användningsfall	Länk
LOCATION	Geografisk plats (lat/lng)	Addresses, venues, service areas	View Details →
COUNTRY	Landväljare	Regional assignments, localization	View Details →

Fil och media

Typ	Beskrivning	Användningsfall	Länk
FILE	Filbilaga	Documents, images, resources	View Details →

Systemfält

Typ	Beskrivning	Användningsfall	Länk
UNIQUE_ID	Automatgenererat unikt identifierare	Ticket numbers, order IDs	View Details →
REFERENCE	Länk till poster i ett annat projekt	Cross-project relationships	View Details →
LOOKUP	Hämta data från refererade poster	Aggregate data from related records	View Details →

Interaktiva fält

Typ	Beskrivning	Användningsfall	Länk
BUTTON	Handlingsbar knappfält	Triggers, actions, workflows	View Details →
CURRENCY_CONVERSION	Valutaomvandlingsfält	Multi-currency calculations	View Details →

Nyckelkoncept

Fältdefinition

• Anpassade fält definieras på projekt nivå
• Varje fält har ett unikt namn och typ
• Fält kan inkludera valideringsregler och begränsningar
• Konfigurationsalternativ varierar beroende på fälttyp

Fältvärden

• Värden lagras på individuella poster (att-göra)
• Varje post kan ha olika värden för samma fält
• Tomma/nullvärden är tillåtna för valfria fält
• Värden valideras enligt reglerna för fälttyp

Behörighetsmodell

Anpassade fält respekterar projekt nivå behörigheter:

Roll	Skapa fält	Redigera fält*	Ställ in värden	Visa värden
OWNER	✅ Ja	✅ Ja	✅ Ja	✅ Ja
ADMIN	✅ Ja	✅ Ja	✅ Ja	✅ Ja
MEMBER	❌ Nej	❌ Nej	✅ Ja	✅ Ja
CLIENT	❌ Nej	❌ Nej	✅ Begränsad	✅ Begränsad

*Redigera fält hänvisar till att ändra fältinställningar (namn, typ, alternativ, valideringsregler) - inte att ställa in fältvärden på poster

Anpassade rollbehörigheter

• Projekt kan ha anpassade roller med fält-specifika behörigheter
• Fält kan märkas som redigerbara/icke-redigerbara per roll
• Anpassade roller kan begränsa åtkomst till specifika fält

Vanliga mönster

Skapa ett grundläggande anpassat fält

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

Ställa in fältvärden på poster

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

Fråga poster med anpassade fält

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

Skapa poster med anpassade fältvärden

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

Bästa praxis

Fältdesign

1. Använd beskrivande namn - Gör fältens syften tydliga
2. Välj lämpliga typer - Matcha fälttyp till datakrav
3. Ställ in valideringsregler - Använd min/max värden, obligatoriska fält
4. Organisera logiskt - Gruppera relaterade fält tillsammans

Prestandaöverväganden

1. Begränsa antal fält - För många fält kan påverka prestanda
2. Använd paginering - Vid frågning av stora datamängder
3. Indexera nyckelfält - För fält som används i filtrering/sortering
4. Undvik djup nästning - Håll fältrelationer enkla

Datakvalitet

1. Validera inmatning - Använd lämpliga fälttyper med validering
2. Ge standardvärden - Ställ in rimliga standardvärden där det är lämpligt
3. Använd konsekventa format - Standardisera datainmatningsmönster
4. Regelbunden städning - Ta bort oanvända fält och alternativ

Användarupplevelse

1. Tydliga beskrivningar - Ge hjälpsamma fältbeskrivningar
2. Logisk ordning - Placera fält i naturlig arbetsflödesordning
3. Visuell hierarki - Använd färger och formatering effektivt
4. Progressiv avslöjande - Visa fält när det är relevant

Felhantering

Vanliga fel när man arbetar med anpassade fält:

Felkod	Beskrivning	Lösning
CUSTOM_FIELD_NOT_FOUND	Fältet finns inte	Verify field ID and project access
VALIDATION_ERROR	Värdet matchar inte fälttyp	Check format and validation rules
UNAUTHORIZED	Otillräckliga behörigheter	Ensure proper role level
CUSTOM_FIELD_VALUE_PARSE_ERROR	Ogiltigt värdeformat	Review field type requirements

Relaterade resurser

• Poster API - Arbeta med poster som innehåller anpassade fält
• Projekt API - Hantera projekt som innehåller anpassade fält
• Automatiseringar API - Automatisera arbetsflöden med anpassade fältsutlösare
• Användarhantering API - Hantera behörigheter för anpassade fält