Dokumentenservices Framework für Microsoft OneDrive

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 7 Minuten Lesedauer
  • Integrieren Sie das Dokumentenservices Framework mit Microsoft OneDrive.

    Apps im Store anfordern

    Besuchen Sie die ServiceNow Store-Website, um alle verfügbaren Apps anzuzeigen und Informationen zum Senden von Anforderungen an den Store zu erhalten. Kumulative Informationen zum Release für alle veröffentlichten Apps finden Sie in den Release-Hinweisen zum ServiceNow Store-Versionsverlauf.

    IntegrationHub-Abonnement

    Diese Spoke erfordert ein Integration Hub-Abonnement. Weitere Informationen finden Sie unter Gesetzliche Zeitpläne − IntegrationHub − Übersicht.

    Spoke-Version

    Microsoft OneDrive-Spoke für Dokumentenservices-Framework-Spoke v 1.2.2 ist die aktuelle Version.

    Unterstützte Versionen

    Diese Spoke wurde für Microsoft OneDrive Spoke for Dokumentenservices Framework V1.1 erstellt, ist jedoch möglicherweise mit späteren Versionen kompatibel.

    Schlüsselfunktionen

    Microsoft OneDrive Mit der Spoke for Dokumentenservices Framework kann ein Flow Designer:
    • Laden Sie Dokumente in hoch Microsoft OneDrive
    • Collaborate
    • Verwalten Sie Versionen
    • Laden Sie Dokumente herunter

    Spoke-Abhängigkeiten

    Wenn Sie Probleme beim Installieren der App haben, stellen Sie sicher, dass die folgenden abhängigen Plugins installiert sind:
    • Komplexes Objekt (com.glide.cobject)
    • IHUB Spoke Util Pack (com.snc.ihub_spoke_util_pack)
    • Multi-Provider-Framework Dokumentenservices (com.snc.multiprovider_documents)
    • Remote-Verzeichnissynchronisierung (com.snc.remote_directory_sync)
    • ServiceNow Flow Designer – Dynamische Eingaben (com.glide.hub.dynamic_inputs)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    Hinweis:
    Einige dieser Plugins sind lizenzierbare Funktionen und erfordern entsprechende Lizenzen, wenn sie außerhalb der Spoke-Implementierung verwendet werden.

    Spoke-Unterabläufe

    Die Microsoft OneDrive -Spoke für das Dokumentenservices -Framework bietet Beispiel-Subflows, um die Automatisierung von Dokumentenservices -Aufgaben zu demonstrieren. Um einen Beispiel-Unterablauf anzupassen, kopieren Sie ihn in einen neuen Anwendungsbereich. In den folgenden Tabellen sind die verfügbaren Beispiel-Subflows für V1 und V2 aufgeführt.
    Hinweis:
    Nur V2-Subflows unterstützen die Site Microsoft SharePoint.
    Tabelle : 1. V1-Subflows
    Subflow Beschreibung
    Mitarbeitenden zu Gruppe hinzufügen Fügt die angegebene CollaboratorID als durch den Typ angegebenes Mitglied oder Besitzer hinzu.
    Zusammenarbeitsdokument Ordnet ein Dokument einer Gruppe oder einem Anwender unter Microsoft OneDrivezu.
    Zusammenarbeitsdokument mit Empfängertyp Ordnet ein Dokument einem angegebenen Empfängertyp zu
    Verbinden Sie das Dokument über den Pfad auf OneDrive Verbindet das Dokument Microsoft OneDrive.
    Kopieren Sie die OneDrive-Dokumentversion Kopiert das Dokument mit der angegebenen Version aus Microsoft OneDrive in einen Anhang in der Instanz ServiceNow.
    Dokument erstellen Kopiert das Dokument nach Microsoft OneDrive, erstellt einen Datensatz in der Tabelle „Multi-Provider-Dokument“ [mp_document] und fügt eine Version in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] hinzu.
    Gruppe erstellen Erstellt eine Gruppe wie in Microsoft OneDrive angegeben und aktualisiert die Tabelle „Konfiguration der Mehrfachanbieter-Berechtigung“ [mp_permission_configuration].
    Dokument löschen Löscht das Dokument in Microsoft OneDrive und entfernt die entsprechenden Datensätze in den Tabellen der Multi-Provider-Dokumentversion [mp_document_version].
    Dokumentversion löschen Löscht die angegebene Version des Dokuments in Microsoft OneDrive und der Instanz ServiceNow und löscht einen Datensatz in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version].
    Ruft die gesamte Dokumentversion ab Ruft alle Dokumentversionen von Microsoft OneDrive ab und erstellt und aktualisiert Datensätze in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version].
    Ruft das Dokument aus OneDrive ab Kopiert das Dokument aus Microsoft OneDrive in den angegebenen Dokumentnamen. Außerdem wird ein Datensatz in der Tabelle „Multi-Provider-Dokument“ [mp_document] und in allen Dokumentversionen in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] erstellt.
    Dokumentversion wiederherstellen Stellen Sie das Dokument auf die Version in Microsoft OneDrivewieder her.
    Synchronisieren Sie Mitarbeitende Synchronisiert alle Microsoft Azure Anwender mit der Tabelle „Mitarbeitende bei mehreren Anbietern“ [mp_collaborators].

    Wenn der Anwender gelöscht oder aktualisiert wird, wird der Datensatz des Anwenders in der Tabelle „Mitarbeitende bei mehreren Anbietern“ [mp_collaborators] überprüft. Wenn er vorhanden ist, wird der Datensatz gelöscht oder aktualisiert.

    Wenn der Benutzer neu hinzugefügt wird, wird ein Eintrag in der Tabelle „Mitarbeitende bei mehreren Anbietern“ [mp_collaborators] unter „Dokumente bei mehreren Anbietern“ erstellt.

    Hinweis:
    Die geplante Aufgabe mit dem Namen „ Mitarbeitende synchronisieren“ löst den Subflow für „Mitarbeitende synchronisieren“ aus. Sie können aus den verfügbaren Optionen zum Ausführen eines Skripts auswählen. Die Standardoption ist Bei Bedarf. Die Aufgabe wird basierend auf dem festgelegten Zeitplan ausgeführt, und die Mitarbeitenden werden entsprechend synchronisiert. Weitere Informationen finden Sie unter Automatically run a script of your choosing.
    Mitarbeiterdatensatz löschen Löscht den angegebenen Mitarbeiterdatensatz aus der Tabelle „Mitarbeiter bei mehreren Anbietern“ [mp_collaborators].
    Dokumentinhalt aktualisieren Aktualisiert das angegebene Dokument mit dem angegebenen Anhang in Microsoft OneDrive, der der Dokument-ID entspricht. Der Anhangname muss mit dem Namen des Dokuments in Microsoft OneDriveübereinstimmen.
    Große Datei hochladen Lädt einen Anhang in Microsoft OneDrivehoch. Die maximale Größe der Datei darf 60 MB nicht überschreiten.
    Ruft die aktuelle URL ab Ruft die neueste URL zu einem Dokument im Microsoft OneDriveab.
    Verbinden Sie das Dokument erneut mit dem Microsoft OneDrive Stellt die Verbindung zu einem Dokument in Microsoft OneDrivewieder her.
    Hinweis:
    Stellen Sie vor der Verwendung des Subflows sicher, dass die entsprechenden Microsoft OneDrive -Verbindungs- und -Anmeldeinformationen erstellt wurden und das Autorisierungstoken Microsoft OneDrive verfügbar ist.
    Tabelle : 2. V2-Subflows
    Subflow Beschreibung
    Aktuelle Dokument-URL abrufen V2 Ruft die neueste URL von Microsoft OneDrive für die referenzierte Dokument-ID ab.
    Dokumentinhalt aktualisieren V2 Aktualisiert das angegebene Dokument mit dem bereitgestellten Anhanginhalt in Microsoft OneDrive, der der Dokument-ID aus der Tabelle „sys_id des Multi-Provider-Dokuments“ entspricht. Der Anhangsname muss mit dem Namen des Dokuments in Microsoft OneDriveübereinstimmen.
    Zusammenarbeitsdokument V2 Ordnet ein Dokument einem angegebenen Empfängertyp zu.
    Dokument aus OneDrive über Pfad verbinden V2 Verbindet das Dokument Microsoft OneDrive, das auch unter Multi-Provider-Dokumente nachverfolgt werden kann.
    Kopieren Sie das OneDrive-Dokument Version V2 Kopiert das Dokument mit der angegebenen Version aus Microsoft OneDrive in einen Anhang in der Instanz ServiceNow.
    Dokument erstellen V2 Kopiert das Dokument nach Microsoft OneDrive und erstellt einen Datensatz in der Tabelle „Multi-Provider-Dokument“ [mp_document] und in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] für Multi-Provider-Dokumente.
    Dokument löschen V2 Löscht das Dokument in Microsoft OneDrive und entfernt die entsprechenden Datensätze in den Tabellen „Multi-Provider-Dokument“ [mp_document] und „Multi-Provider-Dokumentversion“ [mp_document_version].
    Löschen Sie die Dokumentversion V2 Löscht die jeweilige Version des Dokuments inMicrosoft OneDrive und löscht einen Datensatz in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] unter „Multi-Provider-Dokumente“.
    Alle Dokumentversionen abrufen V2 Ruft alle Dokumentversionen von Microsoft OneDrive ab und erstellt oder aktualisiert Datensätze in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] unter „Multi-Provider-Dokumente“. Dieser Subflow unterstützt Dokumente aus verschiedenen Quellen, die von Microsoft OneDriveunterstützt werden.
    Dokument aus OneDrive V2 abrufen Kopiert das Dokument aus Microsoft OneDrive in den angegebenen Dokumentnamen. Außerdem erstellt es einen Datensatz in der Tabelle „Multi-Provider-Dokument“ [mp_document] und alle zugehörigen Versionen in der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version] unter „Multi-Provider-Dokumente“.
    Dokument von Microsoft OneDrive V2 erneut verbinden Stellt die Verbindung zu einem Dokument im Microsoft OneDrivewieder her.
    Hinweis:
    Stellen Sie vor der Verwendung des Subflows sicher, dass die entsprechenden Microsoft OneDrive -Verbindungs- und -Anmeldeinformationen erstellt wurden und das Autorisierungstoken Microsoft OneDrive verfügbar ist.
    Stellen Sie die Dokumentversion V2 wieder her Setzt das Dokument auf die in Microsoft OneDriveangegebene Version zurück.
    Mitarbeitende synchronisieren V2 Synchronisiert alle Microsoft Azure Anwender mit der Tabelle „Mitarbeitende“ [mp_collaborators] unter „Multi-Provider-Dokumente“.
    Große Datei hochladen V2 Lädt einen Anhang in Microsoft OneDrivehoch. Die maximale Größe der Datei darf 60 MB nicht überschreiten.
    Dokumentzusammenarbeit entfernen Entfernt die Zusammenarbeit an einem Dokument Microsoft OneDrive.
    Dokumentzusammenarbeit aktualisieren Aktualisiert die Zusammenarbeit an einem Microsoft OneDrive -Dokument.
    Hinweis:
    Die V2-Subflows funktionieren nur für Dokumente, die mit den Subflows „Dokument erstellen“ V2 oder „Dokument verbinden V2“ an die Plattform angehängt sind.
    an.

    Spoke-Aktionen

    Die Microsoft OneDrive -Spoke für das Dokumentenservices -Framework bietet Beispielaktionen zum Automatisieren von Dokumentenservices -Aufgaben, wenn Ereignisse in ServiceNoweintreten. In der folgenden Tabelle sind die verfügbaren Beispielaktionen aufgeführt.

    Aktion Beschreibung
    Mitarbeiterdatensatz löschen Löscht den angegebenen Mitarbeiterdatensatz aus der Tabelle „Mitarbeiter bei mehreren Anbietern“ [mp_collaborators].
    Dokument löschen Löscht den Dokumentdatensatz aus der Tabelle „Multi-Provider-Dokument“ [mp_document].
    Dokument und Versionen löschen Löscht das angegebene Dokument und alle zugehörigen Versionen aus der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version].
    Dokumentversion löschen Löscht die angegebenen Versionen eines Dokuments aus der Tabelle „Multi-Provider-Dokumentversion“ [mp_document_version].
    Versionen des Dokuments löschen Löscht alle Versionen eines angegebenen Dokuments.
    Sucht nach der Existenz des Zieldatensatzes Überprüft das Vorhandensein eines Zieldatensatzes in der angegebenen Zieltabelle.
    Dateien und Ordner suchen Ruft die Liste der Dateien und Ordner unter der angegebenen Ordner-ID für die ausgewählte Quelle und Quell-ID ab. Wenn keine Quelle ausgewählt ist, wird standardmäßig der Inhalt des Stammordners aufgelistet.
    Nach Websites basierend auf Abfragezeichenfolge-Stream suchen Listet alle Websites auf, die die angegebene Abfragezeichenfolge erfüllen.
    Delta-Token aktualisieren Aktualisiert die Systemeigenschaft deltaToken mit dem angegebenen Delta-Token.

    Alias-Anforderungen für Verbindungen und Anmeldeinformationen

    IntegrationHub verwendet Aliasse, um Verbindungs- und Anmeldeinformationen zu verwalten. Wenn Sie ein Alias verwenden, müssen Sie nicht mehrere Anmeldeinformations- und Verbindungsinformationsprofile konfigurieren, wenn Sie mehrere Umgebungen verwenden. Wenn sich die Verbindungs- oder Anmeldeinformationen ändern, müssen Sie die Aktionen, die die Verbindung verwenden, nicht aktualisieren. Weitere Informationen finden Sie unter Connections and Credentials.

    Informationen zum Einrichten der Spoke finden Sie unter Set up Microsoft OneDrive spoke.