Ein neues Projekt erstellen

Um ein neues Projekt zu erstellen, können Sie die folgende Mutation verwenden:

mutation {
  createProject(
    input: {
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
      description: "Project description"
      color: "#3B82F6"
      icon: "briefcase"
      category: GENERAL
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}

Antwortbeispiel

Bei Erfolg gibt die Mutation die Details des neu erstellten Projekts zurück:

{
  "data": {
    "createProject": {
      "id": "newly-created-project-id",
      "name": "YOUR PROJECT NEW NAME",
      "slug": "your-project-new-name",
      "description": "Project description",
      "color": "#3B82F6",
      "icon": "briefcase",
      "category": "GENERAL"
    }
  }
}

Aus einer Vorlage erstellen

Um ein Projekt aus einer vorhandenen Vorlage zu erstellen, können Sie eine optionale templateId zur Mutation hinzufügen.

mutation {
  createProject(
    input: {
      templateId: "YOUR TEMPLATE ID OR SLUG"
      name: "YOUR PROJECT NEW NAME"
      companyId: "YOUR COMPANY ID OR SLUG"
    }
  ) {
    id
  }
}

Fortgeschrittenes Beispiel mit Vorlage

Hier ist ein vollständiges Beispiel, das alle verfügbaren Optionen beim Erstellen aus einer Vorlage zeigt:

mutation {
  createProject(
    input: {
      templateId: "marketing-template"
      name: "Q1 Marketing Campaign"
      companyId: "acme-corp"
      description: "Marketing initiatives for Q1 2024"
      color: "#10B981"
      icon: "megaphone"
      category: MARKETING
      coverConfig: {
        enabled: true
        fit: COVER
        imageSelectionType: FIRST
        source: DESCRIPTION
      }
    }
  ) {
    id
    name
    slug
    description
    color
    icon
    category
  }
}

Status der Erstellung überprüfen

Um den Status Ihrer Projektcreation in der Warteschlange zu überprüfen, können Sie die folgende Abfrage verwenden:

query {
  copyProjectStatus {
    newProjectName
    isTemplate
    isActive
    queuePosition
    totalQueues
  }
}

Diese Abfrage gibt den Status Ihrer Projektcreation in der Warteschlange zurück.

Eingabeparameter

CreateProjectInput

Projektkategorie-Werte

TodoCoverConfigInput

Wenn Sie konfigurieren möchten, wie Todo-Coverbilder in Ihrem Projekt funktionieren, können Sie den coverConfig Parameter angeben:

Werte für ImageFit: COVER, CONTAIN, FILL, SCALE_DOWN

Werte für ImageSelectionType: FIRST (erstes Bild), LAST (letztes Bild)

Werte für ImageSource: DESCRIPTION (aus der Todo-Beschreibung), COMMENTS (aus Kommentaren), CUSTOM_FIELD (aus einem benutzerdefinierten Feld)

Antwortfelder

Die createProject-Mutation gibt ein Projektobjekt mit den folgenden verfügbaren Feldern zurück:

Hinweis: Sie können jede Kombination dieser Felder in Ihrer Antwort anfordern.

Wichtige Hinweise

• Sie müssen OWNER, ADMIN oder MEMBER Zugriff auf Unternehmensebene haben, um Projekte zu erstellen
• Beim Erstellen aus einer Vorlage darf die Vorlage nicht mehr als 250.000 Todos enthalten
• Der erstellende Benutzer wird automatisch als Projekt OWNER zugewiesen
• Projektnamen werden automatisch von Leerzeichen befreit
• Der coverConfig Parameter ist derzeit nur beim Erstellen aus einer Vorlage funktionsfähig

Fehlermeldungen

Unternehmen nicht gefunden

{
  "errors": [{
    "message": "Company not found",
    "extensions": {
      "code": "NOT_FOUND"
    }
  }]
}

Vorlage nicht gefunden

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

Vorlage zu groß

{
  "errors": [{
    "message": "Template cannot have more than 250000 todos",
    "extensions": {
      "code": "VALIDATION_ERROR"
    }
  }]
}

Berechtigung verweigert

{
  "errors": [{
    "message": "You do not have permission to create projects in this company",
    "extensions": {
      "code": "FORBIDDEN"
    }
  }]
}