Pobierz paginowaną listę automatyzacji dla projektu z opcjami filtrowania
Wyświetl wszystkie automatyzacje
Automatyzacje w Blue pozwalają na tworzenie potężnych przepływów pracy, które wyzwalają akcje na podstawie określonych zdarzeń. Ten punkt końcowy pobiera wszystkie automatyzacje skonfigurowane dla Twojego projektu, w tym ich wyzwalacze, akcje i aktualny status.
Podstawowy przykład
query ListAutomations {
automationList {
items {
id
isActive
trigger {
type
color
}
actions {
type
color
}
createdAt
}
pageInfo {
totalItems
hasNextPage
}
}
}
Zaawansowany przykład
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
}
}
Parametry wejściowe
Parametr |
Typ |
Wymagany |
Opis |
customFieldIds |
[String] |
Nie |
Filtrowanie automatyzacji związanych z określonymi polami niestandardowymi |
Parametry paginacji
Parametr |
Typ |
Wymagany |
Opis |
skip |
Int |
Nie |
Liczba elementów do pominięcia (domyślnie: 0) |
take |
Int |
Nie |
Liczba elementów do zwrócenia (domyślnie: 20) |
Pola odpowiedzi
Pole |
Typ |
Opis |
items |
[Automation!]! |
Lista obiektów automatyzacji |
pageInfo |
PageInfo! |
Informacje o paginacji |
totalCount |
Int! |
Całkowita liczba automatyzacji |
Automation
Pole |
Typ |
Opis |
id |
ID! |
Unikalny identyfikator |
trigger |
AutomationTrigger! |
Zdarzenie, które wyzwala tę automatyzację |
actions |
[AutomationAction!]! |
Akcje wykonywane po wyzwoleniu |
isActive |
Boolean! |
Czy automatyzacja jest obecnie aktywna |
createdBy |
User! |
Użytkownik, który utworzył automatyzację |
project |
Project! |
Projekt, do którego należy ta automatyzacja |
createdAt |
DateTime! |
Znacznik czasu utworzenia |
updatedAt |
DateTime! |
Znacznik czasu ostatniej aktualizacji |
AutomationTrigger
Pole |
Typ |
Opis |
id |
ID! |
Unikalny identyfikator |
type |
AutomationTriggerType! |
Typ zdarzenia wyzwalającego |
color |
String |
Powiązany kolor (format hex) |
metadata |
AutomationTriggerMetadata |
Konfiguracja specyficzna dla wyzwalacza |
customField |
CustomField |
Powiązane pole niestandardowe (jeśli dotyczy) |
customFieldOptions |
[CustomFieldOption!] |
Wybrane opcje dla pól wyboru |
todos |
[CustomFieldReferenceTodo!] |
Odwołane zadania |
todoList |
TodoList |
Powiązana lista zadań |
tags |
[Tag!] |
Powiązane tagi |
assignees |
[User!] |
Powiązani przypisani |
AutomationAction
Pole |
Typ |
Opis |
id |
ID! |
Unikalny identyfikator |
type |
AutomationActionType! |
Typ akcji do wykonania |
color |
String |
Powiązany kolor (format hex) |
duedIn |
Int |
Dni do dodania do akcji związanych z terminem |
assigneeTriggerer |
String |
Identyfikator specjalnego przypisanego |
metadata |
AutomationActionMetadata |
Konfiguracja specyficzna dla akcji |
customField |
CustomField |
Docelowe pole niestandardowe |
customFieldOptions |
[CustomFieldOption!] |
Opcje dla pól wyboru |
todoList |
TodoList |
Docelowa lista zadań |
tags |
[Tag!] |
Tagi do dodania/usunięcia |
assignees |
[User!] |
Przypisani do dodania/usunięcia |
httpOption |
AutomationActionHttpOption |
Konfiguracja żądania HTTP |
Typy wyzwalaczy
Typ |
Opis |
TODO_CREATED |
Gdy nowy rekord zostanie utworzony |
TODO_LIST_CHANGED |
Gdy rekord przemieszcza się między listami |
TODO_MARKED_AS_COMPLETE |
Gdy rekord zostanie ukończony |
TODO_MARKED_AS_INCOMPLETE |
Gdy rekord zostanie odznaczony |
ASSIGNEE_ADDED |
Gdy przypisany zostanie dodany |
ASSIGNEE_REMOVED |
Gdy przypisany zostanie usunięty |
DUE_DATE_CHANGED |
Gdy termin zostanie zmodyfikowany |
DUE_DATE_REMOVED |
Gdy termin zostanie usunięty |
DUE_DATE_EXPIRED |
Gdy termin minie |
TAG_ADDED |
Gdy tag zostanie dodany |
TAG_REMOVED |
Gdy tag zostanie usunięty |
CHECKLIST_ITEM_MARKED_AS_DONE |
Gdy element listy kontrolnej zostanie ukończony |
CHECKLIST_ITEM_MARKED_AS_UNDONE |
Gdy element listy kontrolnej zostanie odznaczony |
TODO_COPIED_OR_MOVED_FROM_OTHER_PROJECT |
Gdy rekord zostanie zaimportowany |
CUSTOM_FIELD_ADDED |
Gdy wartość pola niestandardowego zostanie ustawiona |
CUSTOM_FIELD_REMOVED |
Gdy wartość pola niestandardowego zostanie usunięta |
CUSTOM_FIELD_BUTTON_CLICKED |
Gdy pole przycisku zostanie kliknięte |
COLOR_ADDED |
Gdy kolor zostanie zastosowany |
COLOR_REMOVED |
Gdy kolor zostanie usunięty |
Typy akcji
Typ |
Opis |
CHANGE_TODO_LIST |
Przenieś rekord do innej listy |
MARK_AS_COMPLETE |
Ukończ rekord |
MARK_AS_INCOMPLETE |
Odznacz rekord |
ADD_ASSIGNEE |
Dodaj przypisane |
REMOVE_ASSIGNEE |
Usuń przypisane |
ADD_ASSIGNEE_TRIGGERER |
Dodaj użytkownika, który wyzwolił automatyzację |
CHANGE_DUE_DATE |
Ustaw lub zaktualizuj termin |
REMOVE_DUE_DATE |
Wyczyść termin |
ADD_TAG |
Zastosuj tagi |
REMOVE_TAG |
Usuń tagi |
ADD_COLOR |
Zastosuj kolor |
REMOVE_COLOR |
Usuń kolor |
ADD_CUSTOM_FIELD |
Ustaw wartość pola niestandardowego |
REMOVE_CUSTOM_FIELD |
Wyczyść wartość pola niestandardowego |
CREATE_CHECKLIST |
Utwórz nową listę kontrolną |
MARK_CHECKLIST_ITEM_AS_DONE |
Ukończ elementy listy kontrolnej |
MARK_CHECKLIST_ITEM_AS_UNDONE |
Odznacz elementy listy kontrolnej |
COPY_TODO |
Duplikuj rekord |
SEND_EMAIL |
Wyślij powiadomienie e-mail |
GENERATE_PDF |
Wygeneruj dokument PDF |
MAKE_HTTP_REQUEST |
Wywołaj zewnętrzne API |
Wymagane uprawnienia
Wyświetlanie automatyzacji wymaga autoryzacji i dostępu do projektu:
Rola |
Może wyświetlać automatyzacje |
OWNER |
✅ Tak |
ADMIN |
✅ Tak |
MEMBER |
✅ Tak |
CLIENT |
✅ Tak |
Wszyscy uwierzytelnieni użytkownicy z dostępem do projektu mogą przeglądać automatyzacje.
Odpowiedzi błędów
Wymagana autoryzacja
{
"errors": [{
"message": "You must be logged in",
"extensions": {
"code": "UNAUTHENTICATED"
}
}]
}
Projekt nie znaleziony
{
"errors": [{
"message": "Project not found",
"extensions": {
"code": "PROJECT_NOT_FOUND"
}
}]
}
Ważne uwagi
- Porządek: Automatyzacje są zawsze zwracane w kolejności od najnowszych (według daty utworzenia)
- Zakres projektu: Automatyzacje są ograniczone do bieżącego kontekstu projektu
- Status aktywny: Sprawdź
isActive
, aby ustalić, czy automatyzacja jest obecnie uruchomiona
- Metadane: Niektóre wyzwalacze i akcje mają dodatkowe metadane do konfiguracji
- Wydajność: Użyj paginacji dla projektów z wieloma automatyzacjami
- Filtrowanie: Obecnie obsługuje tylko filtrowanie według identyfikatorów pól niestandardowych