AppSource-Auflistungsoptionen für Ihr ereignisbasiertes Outlook-Add-In
Add-Ins müssen von den Administratoren einer Organisation bereitgestellt werden, damit Endbenutzer auf die ereignisbasierte Aktivierungsfunktion zugreifen können. Die ereignisbasierte Aktivierung ist eingeschränkt, wenn der Endbenutzer das Add-In direkt aus AppSource erworben hat. Wenn das Contoso-Add-In beispielsweise eine ereignisbasierte Funktion enthält, erfolgt der automatische Aufruf des Add-Ins nur, wenn das Add-In vom Administrator ihrer Organisation für den Endbenutzer installiert wurde. Andernfalls wird der automatische Aufruf des Add-Ins blockiert.
Ein Endbenutzer oder Administrator kann Add-Ins über AppSource oder den In-App-Store von Microsoft 365 und Copilot erwerben. Wenn das primäre Szenario oder der Workflow Ihres Add-Ins eine ereignisbasierte Aktivierung erfordert, sollten Sie Ihr Add-In auf die Administratorbereitstellung beschränken. Um diese Einschränkung zu aktivieren, können wir Flight-Code-URLs für Add-Ins in AppSource bereitstellen. Dank der Flugcodes können nur Endbenutzer mit diesen speziellen URLs auf das Listing zugreifen. Es folgt eine Beispiel-URL.
https://appsource.microsoft.com/product/office/WA200002862?flightCodes=EventBasedTest1
Benutzer und Administratoren können in AppSource oder im In-App-Microsoft 365- und Copilot-Store nicht explizit nach einem Add-In nach seinem Namen suchen, wenn dafür ein Flight-Code aktiviert ist. Als Ersteller des Add-Ins können Sie diese Flight-Codes privat für Organisationsadministratoren für die Add-In-Bereitstellung freigeben.
Hinweis
Endbenutzer können das Add-In zwar mithilfe eines Flight-Codes installieren, das Add-In enthält jedoch keine ereignisbasierte Aktivierung.
Wichtig
Add-Ins, die das Feature "Intelligente Warnungen" verwenden, können nur in AppSource veröffentlicht werden, wenn die Sendemoduseigenschaft des Manifests auf die Option benutzereingabeaufforderung oder soft block festgelegt ist. Wenn die Eigenschaft "Sendemodus" eines Add-Ins auf "Blockieren" festgelegt ist, kann es nur vom Administrator einer Organisation bereitgestellt werden, da die AppSource-Überprüfung fehlschlägt.
Angeben eines Flight-Codes
Um den Flight-Code für Ihr Add-In anzugeben, geben Sie den Code in den Notizen zur Zertifizierung frei, wenn Sie Ihr Add-In veröffentlichen. Wichtig: Bei Flight-Codes wird die Groß-/Kleinschreibung beachtet.
Bereitstellen eines Add-Ins mit Flight-Code
Nachdem die Flugcodes festgelegt wurden, erhalten Sie die URL vom App-Zertifizierungsteam. Sie können die URL dann privat für Administratoren freigeben.
Um das Add-In bereitzustellen, kann der Administrator die folgenden Schritte ausführen.
- Melden Sie sich mit Ihrem Microsoft 365-Administratorkonto bei admin.microsoft.com oder AppSource.com an. Wenn das einmalige Anmelden (Single Sign-On, SSO) für das Add-In aktiviert ist, werden globale Administratoranmeldeinformationen benötigt.
- Öffnen Sie die Flight-Code-URL in einem Webbrowser.
- Wählen Sie auf der Add-In-Eintragsseite Jetzt herunterladen aus. Sie sollten zum integrierten App-Portal umgeleitet werden.
Uneingeschränkte AppSource-Auflistung
Wenn Ihr Add-In die ereignisbasierte Aktivierung für kritische Szenarien nicht verwendet (d. h. Ihr Add-In funktioniert ohne automatischen Aufruf gut), sollten Sie erwägen, Ihr Add-In in AppSource ohne spezielle Flight-Codes aufzulisten. Wenn ein Endbenutzer Ihr Add-In aus AppSource erhält, erfolgt keine automatische Aktivierung für den Benutzer. Sie können jedoch andere Komponenten Ihres Add-Ins verwenden, z. B. einen Aufgabenbereich oder einen Funktionsbefehl.
Wichtig
Dies ist eine vorübergehende Einschränkung. In Zukunft planen wir, die ereignisbasierte Add-In-Aktivierung für Endbenutzer zu ermöglichen, die Ihr Add-In direkt erwerben.
Aktualisieren vorhandener Add-Ins, um die ereignisbasierte Aktivierung einzubeziehen
Sie können Ihr vorhandenes Add-In aktualisieren, um die ereignisbasierte Aktivierung einzubeziehen, es dann zur Überprüfung erneut übermitteln und entscheiden, ob Sie eine eingeschränkte oder uneingeschränkte AppSource-Auflistung wünschen.
Nachdem das aktualisierte Add-In genehmigt wurde, erhalten Organisationsadministratoren, die das Add-In zuvor bereitgestellt haben, im Admin Center im Abschnitt Integrierte Apps eine Updatenachricht. Die Meldung informiert den Administrator über die ereignisbasierten Aktivierungsänderungen. Nachdem der Administrator die Änderungen akzeptiert hat, wird das Update für Endbenutzer bereitgestellt. Weitere Informationen zum Prozess der Administratoreinwilligung finden Sie unter Administratoreinwilligung für die Installation ereignisbasierter Add-Ins.
Für Endbenutzer, die das Add-In selbst installiert haben, funktioniert das ereignisbasierte Aktivierungsfeature auch nach der Aktualisierung des Add-Ins nicht.
Administratoreinwilligung für die Installation ereignisbasierter Add-Ins
Wenn ein ereignisbasiertes Add-In über den Bildschirm Integrierte Apps bereitgestellt wird, erhält der Administrator Details zu den ereignisbasierten Aktivierungsfunktionen des Add-Ins im Bereitstellungs-Assistenten. Die Details werden im Abschnitt App-Berechtigungen und -Funktionen angezeigt. Dem Administrator sollten alle Ereignisse angezeigt werden, bei denen das Add-In automatisch aktiviert werden kann.
Wenn ein vorhandenes Add-In auf ereignisbasierte Funktionen aktualisiert wird, wird dem Administrator der Status "Update steht ausstehend" für das Add-In angezeigt. Das aktualisierte Add-In wird nur bereitgestellt, wenn der Administrator den Änderungen im Abschnitt App-Berechtigungen und -Funktionen zustimmt, einschließlich der Ereignisgruppe, in der das Add-In automatisch aktiviert werden kann.
Jedes Mal, wenn Sie Ihrem Add-In eine neue ereignisbasierte Aktivierungsfunktion hinzufügen, sehen Administratoren den Updateflow im Verwaltungsportal und müssen die Zustimmung für zusätzliche Ereignisse erteilen. Weitere Informationen zum Update- und Zustimmungsprozess finden Sie unter Verwalten von Apps im Portal für integrierte Apps.
Siehe auch
Office Add-ins