Zum Hauptinhalt springen

Asana

Verfügbar

Diese Integration ist aktiv und in Frihet einsatzbereit.

Verbinde deinen Asana-Workspace mit Frihet. Rufe Projekte und Aufgaben direkt aus deinem ERP ab, um beim Rechnungsstellen volle Transparenz über die geleistete Arbeit zu haben.

Wozu dient es?​

Mit integriertem Asana:

  • Projekte anzeigen — Rufe alle deine Asana-Projekte aus Frihet ab
  • Aufgaben anzeigen — Navigiere durch die Aufgaben jedes Projekts mit ihrem Status
  • Kontext beim Rechnungsstellen — Überprüfe abgeschlossene Aufgaben, bevor du Rechnungen erstellst
  • Automatische Workspace-Erkennung — Frihet erkennt deinen Haupt-Workspace automatisch

Voraussetzungen​

  • Aktiver Asana-Account — asana.com
  • Personal Access Token — Wird in den Asana-Einstellungen generiert
  • Frihet Pro oder höher

Asana mit Frihet verbinden​

Schritt 1: Deinen Personal Access Token erhalten​

  1. Gehe zu app.asana.com/0/developer-console
  2. Melde dich mit deinem Asana-Konto an
  3. Klicke im Abschnitt Personal access tokens auf Create new token
  4. Gib ihm einen Namen (z.B. "Frihet ERP")
  5. Akzeptiere die API-Bedingungen
  6. Kopiere den generierten Token
Token speichern

Der Personal Access Token wird nur einmal angezeigt. Kopiere ihn, bevor du das Fenster schließt.

Schritt 2: In Frihet konfigurieren​

  1. Gehe zu Einstellungen → Integrationen
  2. Suche nach Asana
  3. Klicke auf Verbinden
  4. Füge deinen Personal Access Token ein
  5. Klicke auf Verbindung prüfen
  6. Frihet erkennt deinen ersten Workspace automatisch

Schritt 3: Verbindung überprüfen​

Wenn die Verbindung erfolgreich ist, zeigt Frihet an:

  • Name deines Asana-Workspaces
  • Anzahl der zugänglichen Projekte
  • Dein Benutzername in Asana

Funktionsweise​

Frihet verwendet die Asana REST API v1 mit Bearer-Authentifizierung:

  1. Du stellst deinen Personal Access Token bereit
  2. Frihet sendet den Token im Header Authorization: Bearer <token>
  3. Beim Verbinden fragt Frihet deine Workspaces ab und wählt den ersten automatisch aus
  4. Projekte und Aufgaben werden bei Bedarf abgerufen
  5. Der Token wird verschlüsselt (AES-256-GCM) in Frihet gespeichert

Synchronisierte Daten​

DatumRichtungFrequenz
ProjekteAsana → FrihetBei Bedarf
AufgabenAsana → FrihetBei Bedarf
AufgabenstatusAsana → FrihetMit jeder Abfrage
ZugewieseneAsana → FrihetMit jeder Abfrage

Anwendungsfälle​

Berater, der projektbasiert Rechnungen stellt​

Du verwaltest die Leistungen jedes Kunden in Asana. Bevor du Rechnungen stellst, rufst du aus Frihet die abgeschlossenen Aufgaben des Projekts ab, um die korrekte Aufschlüsselung in die Rechnung aufzunehmen.

Kreativagentur mit Sprints​

Dein Team arbeitet in Sprints, die in Asana-Projekten organisiert sind. Am Ende jedes Sprints rufst du die abgeschlossenen Aufgaben aus Frihet ab und erstellst die entsprechenden Rechnungen.

Umfang vor Rechnungsstellung überprüfen​

Du hast ein Projekt mit definiertem Umfang in Asana. Bevor du die endgültige Rechnung ausstellst, überprüfst du in Frihet, dass alle Aufgaben des Umfangs als abgeschlossen markiert sind.

Funktionen​

Projekte anzeigen​

  1. Greife von Frihet aus auf den Asana-Abschnitt zu
  2. Du siehst alle Projekte deines Workspaces
  3. Jedes Projekt zeigt Name, Status und Anzahl der Aufgaben

Aufgaben eines Projekts anzeigen​

  1. Wähle ein Projekt aus
  2. Frihet zeigt die Aufgaben mit:
    • Name der Aufgabe
    • Status (abgeschlossen / ausstehend)
    • Zugewiesene Person
    • Fälligkeitsdatum
  3. Filter nach Status, um nur die abgeschlossenen anzuzeigen

Automatische Workspace-Erkennung​

Beim Verbinden erkennt Frihet deinen ersten Workspace automatisch. Wenn du mehrere Workspaces in Asana hast, wird der Haupt-Workspace verwendet. Du musst nichts Zusätzliches konfigurieren.

Fehlerbehandlung​

Alle Aufrufe an die Asana API haben ein Timeout von 30 Sekunden. Schlägt eine Anfrage fehl, protokolliert Frihet den Fehler automatisch zur Diagnose. Überprüfe deine Internetverbindung, wenn Abfragen wiederholt fehlschlagen.

Fehlerbehebung​

"Authentifizierungsfehler"​

  • Überprüfe, ob der Personal Access Token korrekt ist
  • Überprüfe, ob er in der Asana-Entwicklerkonsole nicht widerrufen wurde
  • Wenn du den Token neu generiert hast, aktualisiere ihn in Frihet

"Ich sehe meine Projekte nicht"​

  • Frihet verwendet den ersten Workspace deines Kontos. Wenn du mehrere hast, könnte der gewünschte in einem anderen sein
  • Überprüfe, ob du von deinem Asana-Konto aus Zugriff auf die Projekte hast
  • Private Projekte anderer Benutzer werden nicht sichtbar sein

"Die Aufgaben werden nicht aktualisiert"​

  • Die Abfragen erfolgen in Echtzeit (bei Bedarf)
  • Lade die Ansicht in Frihet neu, um die neuesten Änderungen zu sehen
  • Überprüfe, ob die Aufgaben dem richtigen Projekt in Asana zugewiesen sind

"Ich möchte einen anderen Workspace verwenden"​

  • Derzeit erkennt Frihet den ersten Workspace automatisch
  • Wenn du wechseln musst, trenne die Integration und verbinde sie erneut
  • Der ausgewählte Workspace hängt von der Reihenfolge ab, die von der Asana API zurückgegeben wird

"Ich möchte die Verbindung trennen"​

  1. Gehe zu Einstellungen → Integrationen → Asana
  2. Klicke auf Trennen
  3. Optional, widerrufe den Token unter app.asana.com/0/developer-console

Nächste Schritte​