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

AutomationFilterInput

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

AutomationPagination

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

Asystent AI

Odpowiedzi są generowane przy użyciu sztucznej inteligencji i mogą zawierać błędy.

Jak mogę Ci pomóc?

Zapytaj mnie o cokolwiek dotyczącego Blue lub tej dokumentacji.

Wciśnij Enter, aby wysłać • Shift+Enter, aby dodać nową linię • ⌘I, aby otworzyć