Eine paginierte Liste von Automatisierungen für ein Projekt mit Filteroptionen abrufen


Alle Automatisierungen auflisten

Automatisierungen in Blue ermöglichen es Ihnen, leistungsstarke Workflows zu erstellen, die Aktionen basierend auf bestimmten Ereignissen auslösen. Dieser Endpunkt ruft alle für Ihr Projekt konfigurierten Automatisierungen ab, einschließlich ihrer Auslöser, Aktionen und aktuellen Status.

Einfaches Beispiel

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

Fortgeschrittenes Beispiel

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

Eingabeparameter

AutomationFilterInput

Parameter Typ Erforderlich Beschreibung
customFieldIds [String] Nein Filtert Automatisierungen, die mit bestimmten benutzerdefinierten Feldern verbunden sind

Paginierungsparameter

Parameter Typ Erforderlich Beschreibung
skip Int Nein Anzahl der zu überspringenden Elemente (Standard: 0)
take Int Nein Anzahl der zurückzugebenden Elemente (Standard: 20)

Antwortfelder

AutomationPagination

Feld Typ Beschreibung
items [Automation!]! Liste von Automatisierungsobjekten
pageInfo PageInfo! Paginierungsinformationen
totalCount Int! Gesamtanzahl der Automatisierungen

Automation

Feld Typ Beschreibung
id ID! Eindeutige Kennung
trigger AutomationTrigger! Das Ereignis, das diese Automatisierung auslöst
actions [AutomationAction!]! Aktionen, die bei Auslösung durchgeführt werden
isActive Boolean! Ob die Automatisierung derzeit aktiv ist
createdBy User! Benutzer, der die Automatisierung erstellt hat
project Project! Projekt, zu dem diese Automatisierung gehört
createdAt DateTime! Erstellungszeitstempel
updatedAt DateTime! Letzter Aktualisierungszeitstempel

AutomationTrigger

Feld Typ Beschreibung
id ID! Eindeutige Kennung
type AutomationTriggerType! Art des Auslöserereignisses
color String Zugehörige Farbe (Hex-Format)
metadata AutomationTriggerMetadata Auslöserspezifische Konfiguration
customField CustomField Zugehöriges benutzerdefiniertes Feld (falls zutreffend)
customFieldOptions [CustomFieldOption!] Ausgewählte Optionen für Auswahlfelder
todos [CustomFieldReferenceTodo!] Referenzierte Todos
todoList TodoList Zugehörige To-do-Liste
tags [Tag!] Zugehörige Tags
assignees [User!] Zugehörige Zuweisungen

AutomationAction

Feld Typ Beschreibung
id ID! Eindeutige Kennung
type AutomationActionType! Art der auszuführenden Aktion
color String Zugehörige Farbe (Hex-Format)
duedIn Int Tage, die für Fälligkeitsdatum-Aktionen hinzugefügt werden sollen
assigneeTriggerer String Besondere Zuweisungskennung
metadata AutomationActionMetadata Aktionsspezifische Konfiguration
customField CustomField Zielbenutzerdefiniertes Feld
customFieldOptions [CustomFieldOption!] Optionen für Auswahlfelder
todoList TodoList Ziel-To-do-Liste
tags [Tag!] Tags hinzufügen/entfernen
assignees [User!] Zuweisungen hinzufügen/entfernen
httpOption AutomationActionHttpOption HTTP-Anforderungs-Konfiguration

Auslöserarten

Typ Beschreibung
TODO_CREATED Wenn ein neuer Datensatz erstellt wird
TODO_LIST_CHANGED Wenn ein Datensatz zwischen Listen verschoben wird
TODO_MARKED_AS_COMPLETE Wenn ein Datensatz abgeschlossen wird
TODO_MARKED_AS_INCOMPLETE Wenn ein Datensatz nicht abgeschlossen wird
ASSIGNEE_ADDED Wenn ein Zuweiser hinzugefügt wird
ASSIGNEE_REMOVED Wenn ein Zuweiser entfernt wird
DUE_DATE_CHANGED Wenn das Fälligkeitsdatum geändert wird
DUE_DATE_REMOVED Wenn das Fälligkeitsdatum gelöscht wird
DUE_DATE_EXPIRED Wenn das Fälligkeitsdatum überschritten wird
TAG_ADDED Wenn ein Tag hinzugefügt wird
TAG_REMOVED Wenn ein Tag entfernt wird
CHECKLIST_ITEM_MARKED_AS_DONE Wenn ein Checklistenpunkt abgeschlossen wird
CHECKLIST_ITEM_MARKED_AS_UNDONE Wenn ein Checklistenpunkt nicht abgeschlossen wird
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT Wenn ein Datensatz importiert wird
CUSTOM_FIELD_ADDED Wenn der Wert eines benutzerdefinierten Feldes festgelegt wird
CUSTOM_FIELD_REMOVED Wenn der Wert eines benutzerdefinierten Feldes gelöscht wird
CUSTOM_FIELD_BUTTON_CLICKED Wenn das Schaltflächenfeld angeklickt wird
COLOR_ADDED Wenn eine Farbe angewendet wird
COLOR_REMOVED Wenn eine Farbe entfernt wird

Aktionsarten

Typ Beschreibung
CHANGE_TODO_LIST Datensatz in eine andere Liste verschieben
MARK_AS_COMPLETE Den Datensatz abschließen
MARK_AS_INCOMPLETE Den Datensatz nicht abschließen
ADD_ASSIGNEE Zuweiser hinzufügen
REMOVE_ASSIGNEE Zuweiser entfernen
ADD_ASSIGNEE_TRIGGERER Benutzer hinzufügen, der die Automatisierung ausgelöst hat
CHANGE_DUE_DATE Fälligkeitsdatum festlegen oder aktualisieren
REMOVE_DUE_DATE Fälligkeitsdatum löschen
ADD_TAG Tag(s) anwenden
REMOVE_TAG Tag(s) entfernen
ADD_COLOR Farbe anwenden
REMOVE_COLOR Farbe entfernen
ADD_CUSTOM_FIELD Wert eines benutzerdefinierten Feldes festlegen
REMOVE_CUSTOM_FIELD Wert eines benutzerdefinierten Feldes löschen
CREATE_CHECKLIST Neue Checkliste erstellen
MARK_CHECKLIST_ITEM_AS_DONE Checklistenpunkte abschließen
MARK_CHECKLIST_ITEM_AS_UNDONE Checklistenpunkte nicht abschließen
COPY_TODO Den Datensatz duplizieren
SEND_EMAIL E-Mail-Benachrichtigung senden
GENERATE_PDF PDF-Dokument generieren
MAKE_HTTP_REQUEST Externe API aufrufen

Erforderliche Berechtigungen

Das Auflisten von Automatisierungen erfordert Authentifizierung und Projektzugriff:

Rolle Kann Automatisierungen auflisten
OWNER ✅ Ja
ADMIN ✅ Ja
MEMBER ✅ Ja
CLIENT ✅ Ja

Alle authentifizierten Benutzer mit Projektzugriff können Automatisierungen anzeigen.

Fehlerantworten

Authentifizierung erforderlich

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

Projekt nicht gefunden

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

Wichtige Hinweise

  • Reihenfolge: Automatisierungen werden immer neueste zuerst zurückgegeben (nach Erstellungsdatum)
  • Projektbereich: Automatisierungen sind auf den aktuellen Projektkontext beschränkt
  • Aktiver Status: Überprüfen Sie isActive, um festzustellen, ob eine Automatisierung derzeit läuft
  • Metadaten: Einige Auslöser und Aktionen haben zusätzliche Metadaten zur Konfiguration
  • Leistung: Verwenden Sie die Paginierung für Projekte mit vielen Automatisierungen
  • Filterung: Derzeit wird nur die Filterung nach benutzerdefinierten Feld-IDs unterstützt

KI-Assistent

Antworten werden mit KI generiert und können Fehler enthalten.

Wie kann ich Ihnen helfen?

Fragen Sie mich alles über Blue oder diese Dokumentation.

Eingabe zum Senden • Shift+Eingabe für neue Zeile • ⌘I zum Öffnen