Laden des DOM und der Laufzeitumgebung

  • Artikel

Vor dem Ausführen einer eigenen benutzerdefinierten Logik muss ein Add-In sicherstellen, dass sowohl das DOM als auch die Office-Add-Ins-Laufzeitumgebung geladen werden.

Starten eines Inhalts- oder Aufgabenbereich-Add-ins

In der folgenden Abbildung wird der Ereignisablauf beim Starten eines Inhalts- oder Aufgabenbereich-Add-Ins in Excel, PowerPoint, Project oder Word gezeigt.

Ablauf von Ereignissen beim Starten eines Inhalts- oder Aufgabenbereich-Add-Ins.

Die folgenden Ereignisse treten auf, wenn ein Inhalts- oder Aufgabenbereich-Add-In gestartet wird.

  1. Der Benutzer öffnet ein Dokument, das bereits ein Add-In enthält, oder fügt ein Add-In in das Dokument ein.

  2. Die Office-Clientanwendung liest das XML-Manifest des Add-Ins aus AppSource, einem App-Katalog in SharePoint oder dem Freigegebenen Ordnerkatalog, aus dem es stammt.

  3. Die Office-Clientanwendung öffnet die HTML-Seite des Add-Ins in einem Webview-Steuerelement.

    Die nächsten beiden Schritte, 4 und 5, werden asynchron und parallel ausgeführt. Daher muss der Code des Add-ins sicherstellen, dass sowohl das Dokumentobjektmodell (DOM) als auch die Laufzeitumgebung geladen wurden, bevor fortgefahren werden kann.

  4. Das Webview-Steuerelement lädt den DOM- und HTML-Text und ruft den Ereignishandler für das window.onload Ereignis auf.

  5. Die Office-Clientanwendung lädt die Laufzeitumgebung, in der die Office JavaScript-API-Bibliotheksdateien vom CDN-Server (Content Distribution Network) heruntergeladen und zwischengespeichert werden, und ruft dann den Ereignishandler des Add-Ins für das Initialisierungsereignis des Office-Objekts auf, wenn ihm ein Handler zugewiesen wurde. Zu diesem Zeitpunkt wird auch überprüft, ob Rückrufe (oder verkettete then() Methoden) an den Office.onReady Handler übergeben (oder verkettet) wurden. Weitere Informationen zur Unterscheidung zwischen Office.initialize und Office.onReadyfinden Sie unter Initialisieren Des Add-Ins.

  6. Wenn DOM und der HTML-Textkörper vollständig geladen wurden und das Add-in initialisiert ist, kann die Hauptfunktion des Add-ins fortgesetzt werden.

Starten eines Outlook-Add-Ins

In der folgenden Abbildung wird der Ereignisablauf beim Starten eines Outlook-Add-Ins auf dem Desktop, Tablet oder Smartphone gezeigt.

Ablauf von Ereignissen beim Starten des Outlook-Add-Ins.

Die folgenden Ereignisse treten auf, wenn ein Outlook-Add-In gestartet wird.

  1. Beim Starten von Outlook werden die XML-Manifeste für Outlook-Add-Ins gelesen, die für das E-Mail-Konto des Benutzers installiert wurden.

  2. Der Benutzer wählt ein Element in Outlook aus.

  3. Falls das ausgewählte Element die Aktivierungsbedingungen eines Outlook-Add-Ins erfüllt, aktiviert Outlook das Add-In und zeigt die Schaltfläche in der Benutzeroberfläche an.

  4. Wenn der Benutzer auf die Schaltfläche klickt, um das Outlook-Add-In zu starten, öffnet Outlook die HTML-Seite in einem Webview-Steuerelement. Die nächsten beiden Schritte, also Schritt 5 und 6, werden parallel ausgeführt.

  5. Das Webview-Steuerelement lädt den DOM- und HTML-Text und ruft den Ereignishandler für das onload Ereignis auf.

  6. Outlook lädt die Laufzeitumgebung, welche wiederum die JavaScript-API für JavaScript-Bibliotheksdateien vom CDN-Server (Content Distribution Network) herunterlädt und zwischenspeichert und anschließend den Ereignishandler des Add-ins für das initialize-Ereignis des Office-Objekts aufruft, wenn ihm ein Handler zugewiesen wurde. Zu diesem Zeitpunkt wird auch überprüft, ob Rückrufe (oder verkettete then() Methoden) an den Office.onReady Handler übergeben (oder verkettet) wurden. Weitere Informationen zur Unterscheidung zwischen Office.initialize und Office.onReadyfinden Sie unter Initialisieren Des Add-Ins.

  7. Wenn DOM und der HTML-Textkörper vollständig geladen wurden und das Add-in initialisiert ist, kann die Hauptfunktion des Add-ins fortgesetzt werden.

Siehe auch