Enterprise-UX & Governance

Wie Ihr IT-Team steuert, welche Add-in-Version Nutzer verwenden, wann sie geändert wird und wer sie erhält.

Die Blockbrain-Add-ins für Word und Outlook sind so konzipiert, dass sie von Ihrem IT-Team ausgerollt und verwaltet werden. Sie entscheiden, welche Version Ihre Nutzer ausführen, wann sie auf eine neuere wechseln und wer das Add-in überhaupt erhält. Diese Seite erklärt, wie die Versionierung funktioniert, welchen Manifest-Link Sie verwenden sollen und wie Sie prüfen können, was Ihre Nutzer gerade verwenden.

Kurz gesagt: installieren Sie über den Release-Linie Link, zum Beispiel https://ms-word-addin.theblockbrain.ai/v/2.0.0/manifest.xml. Das Add-in, das Ihre Nutzer ausführen, ändert sich dann nur, wenn ein Administrator erneut ein Manifest hochlädt.

So funktioniert die Versionierung

Jedes Release eines Add-ins hat seine eigene Installationsseite und sein eigenes Manifest. Ein versioniertes Manifest verweist auf einen festen Build, und spätere Blockbrain-Releases überschreiben diesen Build nie.

• Jedes Release hat seine eigene Seite und sein eigenes Manifest. Word und Outlook veröffentlichen jeweils eine Installationsseite pro Release-Linie.

• Ihre Nutzer bleiben auf dem Build, den Sie installiert haben. Er ändert sich nur, wenn ein Administrator erneut ein Manifest hochlädt.

• Eine Release-Linie springt nie auf eine neuere Version. Ihr Link liefert immer den neuesten Fix dieser Linie und nichts aus späteren Linien.

• Jeder exakte Build bleibt aufgeführt. Die Installationsseite listet jeden Build der Linie auf, falls Ihr Änderungsprozess einen exakten Build benötigt.

Eine Versionsnummer lesen

Eine Version hat vier Zahlen, zum Beispiel 2.0.0.1.

Teil	Beispiel	Was es bedeutet
Release-Linie	2.0.0	Die ersten drei Zahlen. Ein Release mit seinem Satz an Funktionen.
Fix	die letzte 1 in 2.0.0.1	Ein Fix in dieser Release-Linie. Er enthält alles aus der Linie plus den Fix und nichts aus einer neueren Linie.

Also 2.0.0.0 ist der erste Build der 2.0.0-Linie und 2.0.0.1 ist der erste Fix darauf. Eine neuere Linie wie 2.1.0 erreicht Ihre Nutzer nur, wenn Sie ihr Manifest hochladen.

Wählen Sie Ihren Manifest-Link

Jedes Add-in bietet drei Arten von Manifest-Link an. Sie unterscheiden sich darin, ob Updates Ihre Nutzer von selbst erreichen.

Link-Typ	Beispiel (Word)	Was Ihre Nutzer erhalten	Am besten geeignet für
Release-Linie (empfohlen)	https://ms-word-addin.theblockbrain.ai/v/2.0.0/manifest.xml	Den neuesten Fix der 2.0.0-Linie. Nie eine neuere Linie.	Produktiv-Rollouts
Exakter Build	https://ms-word-addin.theblockbrain.ai/v/2.0.0.0/manifest.xml	Genau Build 2.0.0.0 und nichts anderes	Änderungsprozesse, die einen bestimmten Build freigeben
Immer aktuellste	https://ms-word-addin.theblockbrain.ai/manifest.xml	Der aktuelle Blockbrain-Release. Neue Funktionen und Fehlerbehebungen erreichen Ihre Nutzer beim nächsten Öffnen des Bereichs, ohne dass ein Upload nötig ist.	Testgruppen, die immer die neueste Version wollen

Was ein versionierter Link fixiert. Ein Link zu einer Release-Linie oder einem exakten Build fixiert den Add-in-Code, der in Word oder Outlook ausgeführt wird. Die Blockbrain-Plattform dahinter, etwa Agents, Modelle und Ihre Wissensdatenbanken, erhält weiterhin die regulären Blockbrain-Plattform-Updates.

Aktuelle Releases

Add-in	Release-Linie	Installationsseite	Manifest-Link
Word	2.0.0	ms-word-addin.theblockbrain.ai/v/2.0.0	https://ms-word-addin.theblockbrain.ai/v/2.0.0/manifest.xml
Outlook	2.4.0	ms-outlook-addin.theblockbrain.ai/v/2.4.0	https://ms-outlook-addin.theblockbrain.ai/v/2.4.0/manifest.xml

Jede Installationsseite zeigt den zu kopierenden Manifest-Link, die genaue Manifest-Version und den Build dahinter sowie alle Builds der Linie an.

Word-Installationsseite 2.0.0

Outlook-Installationsseite 2.4.0

Eine Version installieren oder wechseln

1

Öffnen Sie die Installationsseite

Öffnen Sie die Installationsseite des gewünschten Releases, das oben unter Aktuelle Releases aufgeführt ist.

2

Kopieren Sie den Manifest-Link

Wählen Sie Link kopieren um die Release-Linie zu verwenden. Um stattdessen einen exakten Build beizubehalten, nehmen Sie dessen Manifest aus der Versionsliste auf derselben Seite.

3

Fügen Sie es im Microsoft 365 Admin Center hinzu

Gehen Sie zu Einstellungen → Integrierte Apps → Benutzerdefinierte Apps hochladen, wählen Sie Office-Add-in und geben Sie den Manifest-Link an. Die vollständige Schritt-für-Schritt-Anleitung finden Sie in den Word und Outlook Einrichtungsleitfäden.

4

Benutzer zuweisen und Zeit für den Rollout einplanen

Weisen Sie die gesamte Organisation, eine Gruppe oder einzelne Nutzer zu. Microsoft zeigt das Add-in in der Regel innerhalb einer Stunde nach dem Upload an, bei großen Tenants manchmal auch später.

Um später auf ein neueres Release zu wechseln, geben Sie Microsoft 365 den Manifest-Link der neuen Release-Linie. Bis ein Administrator dies tut, behalten Ihre Nutzer den Build, den sie haben.

Prüfen, welche Version Ihre Nutzer ausführen

Es gibt zwei Nummern. Teilen Sie beide mit, wenn Sie den Blockbrain-Support kontaktieren.

Nummer	Wo sie zu finden ist	Was sie Ihnen sagt
Manifest-Version, z. B. 2.0.0.0	Microsoft 365 Admin Center unter Integrierte Apps, und auf der Installationsseite	Welches Manifest Ihre Organisation installiert hat
Build, z. B. 7f87f1f	Auf der Installationsseite, neben der Manifest-Version. In Word sehen Nutzer ihn außerdem im Add-in unter Einstellungen.	Welchen Code der Aufgabenbereich ausführt

Der Build eines Nutzers entspricht der Installationsseite, sobald er den Bereich erneut öffnet.

Weitere Steuerungsmöglichkeiten für unternehmensweite Rollouts

Steuerung	So funktioniert es
Zentrale Bereitstellung	Bereitgestellt und zugewiesen über das Microsoft 365 Admin Center. Keine lokale Installation und keine Downloads auf den Geräten der Nutzer.
Ein Manifest für jede Organisation	Dasselbe Manifest funktioniert für jeden Blockbrain-Kunden. Blockbrain ermittelt beim Anmelden, zu welcher Organisation ein Nutzer gehört.
Anmeldung und Datenregion	Nutzer melden sich mit ihrer geschäftlichen E-Mail an und wählen die Blockbrain-Region, die ihre Organisation verwendet: Global oder EU Sovereign.
Nutzer behalten die Kontrolle	Outlook fragt den Nutzer, bevor etwas gesendet wird. In Word können Änderungen als nachverfolgte Änderungen überprüft werden, die der Nutzer annimmt oder ablehnt.
Aktivierung für Ihre Organisation	Blockbrain aktiviert die Add-ins für Ihre Organisation vor dem Rollout. Wenden Sie sich vor der Bereitstellung des Manifests an Ihren Key Account Manager.

Häufig gestellte Fragen

Kann ein Blockbrain-Release das Add-in ändern, das unsere Nutzer ausführen?

Nicht, wenn Sie über eine Release-Linie oder einen Link zu einem exakten Build installieren. Das Manifest verweist auf einen festen Build, den spätere Releases nie überschreiben, sodass Ihre Nutzer nur dann auf eine neue Version wechseln, wenn ein Administrator erneut ein Manifest hochlädt. Der Link „immer aktuellste“ ist die Ausnahme: Er existiert, damit neue Releases von selbst ankommen.

Wir haben das Add-in installiert, bevor es Versionierung gab. Auf welcher Version sind wir?

Wenn Ihre Organisation https://ms-word-addin.theblockbrain.ai/manifest.xml oder https://ms-outlook-addin.theblockbrain.ai/manifest.xmlinstalliert hat, verwenden Sie den Link „immer aktuellste“. Um eine Version festzuhalten, fügen Sie den Release-Linien-Link des aktuellen Releases im Microsoft 365 Admin Center hinzu.

Welches Release sollten wir wählen?

Die neueste Release-Linie, die unter Aktuelle Releases aufgeführt ist, sofern Ihr Key Account Manager mit Ihnen keine andere vereinbart hat.