Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Asana Microsoft 365 Copilot-Connector integriert Asana-Aufgaben in Microsoft 365, sodass Copilot, Copilot Search und Microsoft Search relevante Aufgabeninformationen direkt in Apps wie Microsoft Teams, Outlook und SharePoint anzeigen können. In diesem Artikel werden die Schritte zum Bereitstellen und Anpassen des Asana-Connectors beschrieben.
Voraussetzungen
Stellen Sie vor der Bereitstellung des Connectors sicher, dass die folgenden Voraussetzungen erfüllt sind:
- Sie müssen ein Microsoft 365-Administrator sein.
- Sie müssen Zugriff auf den Asana-Arbeitsbereich haben, den Sie herstellen möchten.
- Die Asana-Umgebung muss für den API-Zugriff konfiguriert werden.
- Die Identitätszuordnung muss konfiguriert werden, wenn sich asana-Benutzer-E-Mails von Microsoft Entra ID Benutzerprinzipalnamen (UPNs) unterscheiden.
Bereitstellen des Connectors
So fügen Sie den Asana-Connector für Ihre organization hinzu:
- Wählen Sie im Microsoft 365 Admin Center im linken Bereich Copilot-Connectors> aus.
- Wählen Sie die Registerkarte Katalog aus.
- Wählen Sie in der Liste der verfügbaren Connectors Asana aus.
Festlegen des Anzeigenamens
Der Anzeigename wird verwendet, um Verweise in Copilot-Antworten zu identifizieren, damit Benutzer die zugeordnete Datei oder das zugeordnete Element erkennen können. Der Anzeigename steht auch für vertrauenswürdigen Inhalt und wird als Inhaltsquellenfilter verwendet.
Sie können den Standardmäßigen Asana-Anzeigenamen übernehmen oder den Wert so anpassen, dass er einen Anzeigenamen verwendet, den Benutzer in Ihrem organization erkennen.
Weitere Informationen zu Anzeigenamen und Beschreibungen von Connectors finden Sie unter Verbessern der Copilot-Ermittlung von Connectorinhalten.
Festlegen instance URL
Geben Sie die URL des Asana-Arbeitsbereichs ein, den Sie verbinden möchten. Die typische Struktur ist:
https://app.asana.com/
Auswählen des Authentifizierungstyps
Der Asana-Connector unterstützt den folgenden Authentifizierungstyp:
- OAuth 2.0 (empfohlen): Sichere und skalierbare Authentifizierung mithilfe des OAuth-Flusses von Asana.
Um Asana OAuth für die Authentifizierung zu verwenden, muss ein Asana-Administrator eine App in der Asana-Entwicklerkonsole erstellen.
Verwenden Sie die Informationen in der folgenden Tabelle, um das OAuth-Clienterstellungsformular auszufüllen.
| Feld | Beschreibung | Empfohlener Wert |
|---|---|---|
| App-Name | Eindeutiger Wert, der die Anwendung angibt, für die Sie OAuth-Zugriff benötigen. | Microsoft Search |
| Was beschreibt am besten, was Ihre App tun wird? | Beschreiben sie den Zweck der App. | Abrufen von Daten aus Asana, um Berichte zu erstellen. |
| Umleitungs-URL | Eine erforderliche Rückruf-URL, an die der Autorisierungsserver umleitet. | Für Microsoft 365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callbackFür Microsoft 365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback |
| Berechtigungsbereiche | Bereiche definieren, auf welche Art von Anforderungen Ihre App zugreifen kann. | Wählen Sie aus Full permissions. |
| Verwalten der Verteilung | Wählen Sie arbeitsbereiche aus, die verteilt werden sollen. | Fügen Sie bestimmte Arbeitsbereiche hinzu, auf die der Connector zugreifen kann, oder wählen Sie Beliebige Arbeitsbereiche aus. |
Kopieren Sie die Client-ID und den geheimen Clientschlüssel von der Registerkarte OAuth in der Asana-App, und fügen Sie sie in die Felder Client-ID und Geheimer Clientschlüssel ein . Wählen Sie Autorisieren aus, und verwenden Sie die gleichen Anmeldeinformationen für das Asana-Administratorkonto, um die Berechtigung zum Durchforsten zu authentifizieren.
Hinweis
Sie müssen den Zugriff auf die Asana-App in einem Popupfenster autorisieren. Stellen Sie sicher, dass Ihr Browser Popupfenster zulässt oder Zugriff gewährt, wenn das Popupfenster blockiert ist.
Rollout
Um das Rollout für eine begrenzte Zielgruppe durchzuführen, wählen Sie die Umschaltfläche neben Rollout für eingeschränkte Zielgruppe aus, und geben Sie die Benutzer und Gruppen an, für die der Connector rollout ausgeführt werden soll.
Wählen Sie Erstellen aus, um die Verbindung bereitzustellen. Der Asana Copilot-Connector beginnt sofort mit der Indizierung von Inhalten.
In der folgenden Tabelle sind die Standardwerte aufgeführt, die festgelegt werden.
| Kategorie | Setting | Standardwert |
|---|---|---|
| Benutzer | Zugriffsberechtigungen | Nur Personen mit Zugriff auf den Inhalt in der Datenquelle. |
| Benutzer | Zuordnen von Identitäten | Datenquellenidentitäten, die mithilfe von Microsoft Entra-IDs zugeordnet werden. |
| Inhalt | Eigenschaften verwalten | Informationen zu den Standardeigenschaften und ihrem Schema finden Sie unter Anpassen von Inhaltseinstellungen. |
| Synchronisieren | Inkrementelle Durchforstung | Wird alle 15 Minuten ausgeführt. |
| Synchronisieren | Vollständige Durchforstung | Wird täglich ausgeführt. |
Um diese Werte anzupassen, wählen Sie Benutzerdefiniertes Setup aus. Weitere Informationen finden Sie unter Anpassen von Einstellungen.
Nachdem Sie Ihre Verbindung erstellt haben, können Sie die status im Abschnitt Connectors des Microsoft 365 Admin Center überprüfen.
Anpassen von Einstellungen (optional)
Sie können die Standardwerte für die Asana-Connectoreinstellungen anpassen. Wählen Sie zum Anpassen der Einstellungen auf der Connectorseite im Admin Center Die Option Benutzerdefiniertes Setup aus.
Anpassen von Benutzereinstellungen
Zugriffsberechtigungen
Der Asana-Connector unterstützt die folgenden Benutzerzugriffsberechtigungen:
- Jeder
- Nur Personen mit Zugriff auf diese Datenquelle (Standard)
Wenn Sie Alle auswählen, werden indizierte Daten in den Suchergebnissen für alle Benutzer angezeigt. Wenn Sie Nur Personen mit Zugriff auf diese Datenquelle auswählen, werden in den Suchergebnissen für Benutzer, die Zugriff darauf haben, indizierte Daten angezeigt.
In Atlassian Asana werden Sicherheitsberechtigungen über Projektberechtigungsschemas definiert, die Gruppen auf Websiteebene und Projektrollen enthalten. Die Sicherheit auf Aufgabenebene kann auch über Berechtigungsschemas auf Taskebene definiert werden.
Zuordnen von Identitäten
Die Standardmethode zum Zuordnen Ihrer Datenquellenidentitäten zu Microsoft Entra ID besteht darin, zu überprüfen, ob die E-Mail-ID von Asana-Benutzern mit dem Benutzerprinzipalnamen (UPN) der Benutzer in Microsoft Entra ID identisch ist. Wenn die Standardzuordnung für Ihre organization nicht funktioniert, können Sie eine benutzerdefinierte Zuordnungsformel bereitstellen. Weitere Informationen finden Sie unter Zuordnen Ihrer nicht Azure AD-Identitäten.
So ermitteln Sie, welche Option für Ihre organization am besten geeignet ist:
- Wählen Sie die Option Microsoft Entra ID aus, wenn die E-Mail-ID der Asana-Benutzer mit dem UPN in Microsoft Entra ID identisch ist.
- Wählen Sie die Option Nicht Microsoft Entra ID aus, wenn sich die E-Mail-ID der Asana-Benutzer von der UPN und E-Mail-Adresse der Benutzer in Microsoft Entra ID unterscheidet.
Anpassen von Inhaltseinstellungen
Um verfügbare Eigenschaften zu Ihrem Asana hinzuzufügen oder daraus zu entfernen, weisen Sie der Eigenschaft ein Schema zu (definieren Sie, ob eine Eigenschaft durchsuchbar, abfragbar, abrufbar oder verfeinernd ist), ändern Sie die semantische Bezeichnung, und fügen Sie der Eigenschaft einen Alias hinzu.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die standardmäßig indiziert sind.
| Standardeigenschaft | Label | Beschreibung |
|---|---|---|
| Assignee | assignedToPeople |
Die Personen, die diese Aufgabe ausführen sollten |
| Abgeschlossen | State |
Gibt an, ob die Aufgabe abgeschlossen ist. |
| CompletedAt | ClosedDate |
Datum und Uhrzeit, zu dem die Aufgabe abgeschlossen wurde |
| CompletedBy | closedBy |
Die Person, die die Aufgabe abgeschlossen hat |
| CreatedAt | createdDateTime |
Datum und Uhrzeit der Erstellung der Aufgabe |
| CreateBy | createdBy |
Die Person, die diese Aufgabe erstellt hat |
| DueOn | DueDate |
Wann diese Aufgabe abgeschlossen werden soll |
| Gid | SecondaryId |
Globale ID dieser Aufgabe |
| ModifiedAt | lastModifiedDateTime |
Datum und Uhrzeit der Änderung des Vorgangs |
| Name | Title |
Aufgabenname |
| Hinweise | NA |
Beschreibung der Aufgabe (Inhalt) |
| ProjectIds | NA |
Projekt-IDs |
| ProjectNames | NA |
Projektnamen |
| Tags | Tags |
Dieser Aufgabe zugewiesene Tags |
| TaskUrl | url |
Der Link des Vorgangs |
| WorkspaceName | containerName |
Arbeitsbereichsname |
| Priorität | Priority |
Priorität des Vorgangs |
| Severity | Severity |
Schweregrad der Aufgabe |
| Sections | NA |
Abschnitte, zu denen diese Aufgabe gehört |
| SectionIds | NA |
Abschnitts-IDs, zu denen diese Aufgabe gehört |
| "Gefällt mir" | NumReactions |
Anzahl der Likes für diese Aufgabe |
Anpassen von Synchronisierungsintervallen
Sie können die Häufigkeit von vollständigen und inkrementellen Durchforstungen konfigurieren:
- Vollständige Durchforstung: Empfohlen alle 24 Stunden, um eine vollständige Datenaktualisierung sicherzustellen.
- Inkrementelle Durchforstung: Empfohlen alle 15 Minuten, um aktuelle Änderungen zu erfassen.
Weitere Informationen finden Sie unter Richtlinien für Synchronisierungseinstellungen.