---

Przegląd Szablonów

Blue obsługuje dwa rodzaje szablonów:

• Szablony Firmowe: Tworzone przez Twoją organizację do użytku wewnętrznego
• Oficjalne Szablony: Tworzone przez Blue dla wszystkich użytkowników (szablony standardów branżowych)

Szablony zachowują całą strukturę projektu, w tym zadania do zrobienia, listy, pola niestandardowe, automatyzacje i inne.

Szablony List

Używanie zapytania szablonów

query GetTemplates {
  templates(
    companyId: "company-123"
    isOfficialTemplate: false
    category: MARKETING
  ) {
    id
    name
    description
    category
    isOfficialTemplate
    icon
    color
    image {
      thumbnail
      small
    }
  }
}

Używanie projectList z filtrem szablonów

query ListTemplates {
  projectList(
    filter: {
      companyIds: ["company-id"]
      isTemplate: true
    }
    sort: [updatedAt_DESC]
    take: 20
    skip: 0
  ) {
    items {
      id
      slug
      name
      description
      category
      isTemplate
      isOfficialTemplate
      color
      icon
      createdAt
      updatedAt
    }
    pageInfo {
      hasNextPage
      totalItems
    }
    totalCount
  }
}

Utwórz projekt z szablonu

Aby utworzyć nowy projekt z istniejącego szablonu:

mutation CreateFromTemplate {
  createProject(
    input: {
      templateId: "template-id-or-slug"
      name: "Q1 Marketing Campaign"
      companyId: "company-id"
      description: "Marketing initiatives for Q1"
      color: "#10B981"
    }
  ) {
    id
    name
    slug
  }
}

Konwertuj projekt na szablon

Przekształć istniejący projekt w szablon do ponownego użycia:

mutation ConvertToTemplate {
  convertProjectToTemplate(
    input: {
      projectId: "project-123"
      isOfficialTemplate: false
    }
  ) {
    id
    name
    isTemplate
    isOfficialTemplate
  }
}

Usuń status szablonu

Przekształć szablon z powrotem w zwykły projekt:

mutation RemoveTemplateStatus {
  removeProjectFromTemplates(projectId: "template-123") {
    id
    name
    isTemplate
  }
}

Pobierz pojedynczy szablon

Pobierz szczegóły dotyczące konkretnego szablonu:

query GetTemplate {
  template(templateId: "template-123") {
    id
    name
    description
    category
    isOfficialTemplate
    todoLists {
      name
      todos {
        title
      }
    }
  }
}

Parametry zapytania

zapytanie szablonów

Parametr	Typ	Wymagany	Opis
companyId	String	Nie	Filtruj szablony według firmy. Pomiń, aby zobaczyć oficjalne szablony.
isOfficialTemplate	Boolean	Nie	Pokaż tylko oficjalne szablony Blue
category	ProjectCategory	Nie	Filtruj według kategorii projektu

convertProjectToTemplate Input

Parametr	Typ	Wymagany	Opis
projectId	String!	✅ Tak	Projekt do przekształcenia w szablon
isOfficialTemplate	Boolean!	✅ Tak	Oznacz jako oficjalny szablon (tylko dla pracowników Blue)

Kategorie szablonów

Wartość	Opis
CRM	Zarządzanie relacjami z klientami
CROSS_FUNCTIONAL	Projekty zespołów międzyfunkcyjnych
CUSTOMER_SUCCESS	Inicjatywy dotyczące sukcesu klienta
DESIGN	Projekty projektowe i kreatywne
ENGINEERING	Inżynieria i rozwój
GENERAL	Projekty ogólne (domyślnie)
HR	Zasoby ludzkie
IT	Technologia informacyjna
MARKETING	Kampanie marketingowe
OPERATIONS	Operacje i logistyka
PRODUCT	Zarządzanie produktem
SALES	Sprzedaż i rozwój biznesu

Co jest kopiowane z szablonów

Podczas tworzenia projektu z szablonu kopiowane są następujące elementy:

• ✅ Struktura: Wszystkie listy zadań i zadania z ich pozycjami
• ✅ Zawartość: Opisy, komentarze i załączniki
• ✅ Organizacja: Tagowanie, etykiety i pola niestandardowe
• ✅ Automatyzacja: Wszystkie zasady automatyzacji i przepływy pracy
• ✅ Formularze: Formularze projektowe i ich konfiguracje
• ✅ Dokumenty: Strony wiki i dokumentacja
• ✅ Ustawienia: Konfiguracje okładek i preferencje wyświetlania
• ✅ Role: Definicje ról użytkowników (ale nie przypisania użytkowników)

Nie kopiowane:

• ❌ Przypisania użytkowników (z wyjątkiem twórcy)
• ❌ Historia aktywności
• ❌ Dane śledzenia czasu
• ❌ Status ukończenia zadań

Wymagane uprawnienia

Tworzenie szablonów

Akcja	Wymagana rola
Convert project to template	Project OWNER or ADMIN
Create official template	Blue employee only
Remove template status	Project OWNER or ADMIN

Używanie szablonów

Typ szablonu	Kto może używać
Company templates	Users in the same company
Official templates	All Blue users

Odpowiedzi błędów

Szablon nie znaleziony

{
  "errors": [{
    "message": "Template not found",
    "extensions": {
      "code": "TEMPLATE_NOT_FOUND"
    }
  }]
}

Zbyt wiele zadań

{
  "errors": [{
    "message": "This project has more than 250,000 todos and cannot be used as a template",
    "extensions": {
      "code": "TOO_MANY_TODOS"
    }
  }]
}

Ważne uwagi

• Limit rozmiaru: Projekty z więcej niż 250 000 zadaniami nie mogą być używane jako szablony
• Asynchroniczne kopiowanie: Zawartość szablonu jest kopiowana w tle za pomocą kolejki zadań
• Status archiwum: Konwersja na szablon automatycznie archiwizuje projekt
• Usunięcie folderu: Szablony są usuwane z folderów podczas konwersji
• Kontrola dostępu: Oficjalne szablony są widoczne dla wszystkich, szablony firmowe tylko dla członków
• Aktualizacje w czasie rzeczywistym: Subskrybuj zmiany szablonów, używając subskrypcji subscribeToProject