Hämta en paginerad lista över automatiseringar för ett projekt med filtreringsalternativ


Lista alla Automatiseringar

Automatiseringar i Blue gör att du kan skapa kraftfulla arbetsflöden som utlöser åtgärder baserat på specifika händelser. Denna slutpunkt hämtar alla automatiseringar som är konfigurerade för ditt projekt, inklusive deras utlösare, åtgärder och nuvarande status.

Grundläggande Exempel

query ListAutomations {
  automationList {
    items {
      id
      isActive
      trigger {
        type
        color
      }
      actions {
        type
        color
      }
      createdAt
    }
    pageInfo {
      totalItems
      hasNextPage
    }
  }
}

Avancerat Exempel

query ListAutomationsAdvanced {
  automationList(
    filter: {
      customFieldIds: ["field_123", "field_456"]
    }
    skip: 0
    take: 50
  ) {
    items {
      id
      isActive
      createdAt
      updatedAt
      
      # Trigger details
      trigger {
        id
        type
        color
        metadata {
          ... on AutomationTriggerMetadataTodoOverdue {
            incompleteOnly
          }
        }
        customField {
          id
          name
          type
        }
        customFieldOptions {
          id
          title
          color
        }
        todoList {
          id
          title
        }
        tags {
          id
          title
          color
        }
        assignees {
          id
          name
          email
        }
      }
      
      # Action details
      actions {
        id
        type
        color
        duedIn
        assigneeTriggerer
        
        # Action-specific fields
        customField {
          id
          name
        }
        customFieldOptions {
          id
          title
        }
        todoList {
          id
          title
        }
        tags {
          id
          title
        }
        assignees {
          id
          name
        }
        
        # Email action metadata
        metadata {
          ... on AutomationActionMetadataSendEmail {
            email {
              subject
              to
              from
              content
            }
          }
          ... on AutomationActionMetadataCreateChecklist {
            checklists {
              title
              checklistItems {
                title
                duedIn
              }
            }
          }
        }
      }
      
      # Creator info
      createdBy {
        id
        name
        email
      }
    }
    
    pageInfo {
      totalItems
      totalPages
      hasNextPage
      hasPreviousPage
    }
    
    totalCount
  }
}

Indata Parametrar

AutomationFilterInput

Parameter Typ Obligatorisk Beskrivning
customFieldIds [String] Nej Filtrera automatiseringar relaterade till specifika anpassade fält

Paginering Parametrar

Parameter Typ Obligatorisk Beskrivning
skip Int Nej Antal objekt att hoppa över (standard: 0)
take Int Nej Antal objekt att returnera (standard: 20)

Svarsfält

AutomationPagination

Fält Typ Beskrivning
items [Automation!]! Lista över automatiseringsobjekt
pageInfo PageInfo! Paginering information
totalCount Int! Totalt antal automatiseringar

Automation

Fält Typ Beskrivning
id ID! Unik identifierare
trigger AutomationTrigger! Händelsen som utlöser denna automatisering
actions [AutomationAction!]! Åtgärder som utförs när den utlöses
isActive Boolean! Om automatiseringen för närvarande är aktiv
createdBy User! Användare som skapade automatiseringen
project Project! Projekt som denna automatisering tillhör
createdAt DateTime! Skapelsestämpel
updatedAt DateTime! Senaste uppdateringsstämpel

AutomationTrigger

Fält Typ Beskrivning
id ID! Unik identifierare
type AutomationTriggerType! Typ av utlösande händelse
color String Relaterad färg (hex-format)
metadata AutomationTriggerMetadata Utlösarspecifik konfiguration
customField CustomField Relaterat anpassat fält (om tillämpligt)
customFieldOptions [CustomFieldOption!] Valda alternativ för urvalsfält
todos [CustomFieldReferenceTodo!] Refererade att-göra-punkter
todoList TodoList Relaterad att-göra-lista
tags [Tag!] Relaterade taggar
assignees [User!] Relaterade tilldelningar

AutomationAction

Fält Typ Beskrivning
id ID! Unik identifierare
type AutomationActionType! Typ av åtgärd att utföra
color String Relaterad färg (hex-format)
duedIn Int Dagar att lägga till för förfallodatumsåtgärder
assigneeTriggerer String Speciell tilldelningsidentifierare
metadata AutomationActionMetadata Åtgärdsspecifik konfiguration
customField CustomField Mål anpassat fält
customFieldOptions [CustomFieldOption!] Alternativ för urvalsfält
todoList TodoList Mål att-göra-lista
tags [Tag!] Taggar att lägga till/ta bort
assignees [User!] Tilldelningar att lägga till/ta bort
httpOption AutomationActionHttpOption HTTP begärningskonfiguration

Utlösartyper

Typ Beskrivning
TODO_CREATED När en ny post skapas
TODO_LIST_CHANGED När en post flyttas mellan listor
TODO_MARKED_AS_COMPLETE När en post slutförs
TODO_MARKED_AS_INCOMPLETE När en post görs ofullständig
ASSIGNEE_ADDED När en tilldelning läggs till
ASSIGNEE_REMOVED När en tilldelning tas bort
DUE_DATE_CHANGED När förfallodatumet ändras
DUE_DATE_REMOVED När förfallodatumet rensas
DUE_DATE_EXPIRED När förfallodatumet passerar
TAG_ADDED När en tagg läggs till
TAG_REMOVED När en tagg tas bort
CHECKLIST_ITEM_MARKED_AS_DONE När en checklista-punkt slutförs
CHECKLIST_ITEM_MARKED_AS_UNDONE När en checklista-punkt görs ofullständig
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT När posten importeras
CUSTOM_FIELD_ADDED När värdet för det anpassade fältet sätts
CUSTOM_FIELD_REMOVED När värdet för det anpassade fältet rensas
CUSTOM_FIELD_BUTTON_CLICKED När knappläget klickas
COLOR_ADDED När färg tillämpas
COLOR_REMOVED När färg tas bort

Åtgärdstyper

Typ Beskrivning
CHANGE_TODO_LIST Flytta posten till en annan lista
MARK_AS_COMPLETE Slutför posten
MARK_AS_INCOMPLETE Gör posten ofullständig
ADD_ASSIGNEE Lägg till tilldelning(ar)
REMOVE_ASSIGNEE Ta bort tilldelning(ar)
ADD_ASSIGNEE_TRIGGERER Lägg till användare som utlöste automatiseringen
CHANGE_DUE_DATE Sätt eller uppdatera förfallodatum
REMOVE_DUE_DATE Rensa förfallodatum
ADD_TAG Tillämpa tagg(ar)
REMOVE_TAG Ta bort tagg(ar)
ADD_COLOR Tillämpa färg
REMOVE_COLOR Ta bort färg
ADD_CUSTOM_FIELD Sätt värde för anpassat fält
REMOVE_CUSTOM_FIELD Rensa värde för anpassat fält
CREATE_CHECKLIST Skapa ny checklista
MARK_CHECKLIST_ITEM_AS_DONE Slutför checklistapunkter
MARK_CHECKLIST_ITEM_AS_UNDONE Gör checklistapunkter ofullständiga
COPY_TODO Duplicera posten
SEND_EMAIL Skicka e-postmeddelande
GENERATE_PDF Generera PDF-dokument
MAKE_HTTP_REQUEST Anropa extern API

Obligatoriska Behörigheter

Att lista automatiseringar kräver autentisering och projektåtkomst:

Roll Kan Lista Automatiseringar
OWNER ✅ Ja
ADMIN ✅ Ja
MEMBER ✅ Ja
CLIENT ✅ Ja

Alla autentiserade användare med projektåtkomst kan se automatiseringar.

Fel Svar

Autentisering Krävs

{
  "errors": [{
    "message": "You must be logged in",
    "extensions": {
      "code": "UNAUTHENTICATED"
    }
  }]
}

Projekt Inte Hittat

{
  "errors": [{
    "message": "Project not found",
    "extensions": {
      "code": "PROJECT_NOT_FOUND"
    }
  }]
}

Viktiga Anteckningar

  • Ordning: Automatiseringar returneras alltid nyast först (efter skapelsedatum)
  • Projektomfång: Automatiseringar är begränsade till den aktuella projektkontexten
  • Aktiv Status: Kontrollera isActive för att avgöra om en automatisering för närvarande körs
  • Metadata: Vissa utlösare och åtgärder har ytterligare metadata för konfiguration
  • Prestanda: Använd paginering för projekt med många automatiseringar
  • Filtrering: Stöder för närvarande endast filtrering efter anpassade fält-ID:n

AI-assistent

Svar genereras med hjälp av AI och kan innehålla misstag.

Hur kan jag hjälpa dig?

Fråga mig vad som helst om Blue eller denna dokumentation.

Tryck Enter för att skicka • Shift+Enter för ny rad • ⌘I för att öppna