MS SharePoint-Aktivität 'Dateien freigeben' verwenden

Mit der Aktivität 'Dateien freigeben' können Sie eine vorhandene Datei in MS SharePoint zur gemeinsamen Nutzung freigeben.

Informationen zu diesem Vorgang

Verwenden Sie diese Task, um eine Datei für die gemeinsame Nutzung durch interne oder externe Benutzer in der MS SharePoint-Instanz freizugeben. Der Aufruf dieser Aktivität ist ein synchroner Aufruf, bei dem die Eingabedaten zur Verarbeitung an die Aktivität gesendet werden und die Antwort zurück an die Orchestrierung gesendet wird.

Vorgehensweise

  1. Klicken Sie mit der rechten Maustaste auf den Abschnitt 'Orchestrierungen' und wählen Sie 'Neue Orchestrierung' aus.
  2. Ziehen Sie den neu erstellten MS SharePoint-Endpunkt auf die Orchestrierung und wählen Sie die Aktivität Dateien freigeben aus. Die Aktivität Dateien freigeben wird der Orchestrierung hinzugefügt. Klicken Sie doppelt auf die Aktivität. Die Prüfliste der MS SharePoint-Aktivität 'Dateien freigeben' wird angezeigt.
  3. Klicken Sie in der Prüfliste auf Wiederholung. Überprüfen Sie die Standardeinstellungen und nehmen Sie die erforderlichen Änderungen vor.
    Anmerkung: Weitere Informationen finden Sie unter Optionen für 'Wiederholung' für MS SharePoint REST API-Aktivitäten angeben.
  4. Wählen Sie Eingaben zuordnen in der Prüfliste aus. Die XML-Schemas, die aus dieser Operation generiert wurden, werden als Knoten unter dem Anforderungseingabeparameter im Fenster An Aktivität angezeigt.
  5. Erstellen Sie eine Zuordnung zwischen den Orchestrierungsvariablen und dem Eingabeparameter der Aktivität.
    Pflichtfelder:
    • resourceAddress (Die vollständige URL zu dem Dokument, das freigegeben werden soll.)
    • additiveMode
    • UserRoleAssignments
      • Role (Die Eigenschaft 'Role' stellt die Berechtigung dar, die zugewiesen wird. 1 = Anzeigen, 2 = Bearbeiten, 3 = Eigner, 0 = Keine)
      • userId (Die Eigenschaft 'UserId' kann den Namen des Benutzers oder einer Rolle enthalten.)
    Anmerkung:

    AdditiveMode: Ein Flag, das angibt, ob die Berechtigungseinstellung den additiven oder den strikten Modus verwendet. Wenn der Wert "true" angegeben ist, verwendet die Berechtigungseinstellung den additiven Modus. Bei diesem Modus wird die angegebene Berechtigung der aktuellen Liste der Berechtigungen des Benutzers hinzugefügt, wenn sie nicht bereits vorhanden ist. Wenn der Wert "false" angegeben wird, verwendet die Berechtigungseinstellung den strikten Modus, bei dem die angegebene Berechtigung die aktuellen Berechtigungen des Benutzers ersetzt. Dieser Parameter ist nützlich, wenn die Freigabe eines Dokuments zur gemeinsamen Nutzung mit einer Person oder Gruppe beendet werden soll. In diesem Fall setzen Sie 'additiveMode' auf 'false' mit 'Role = 0'.

    Beispiel für eine Eingabeanforderung:

      <ShareFile xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/sharefile">
         <ShareFileRequestDetails xmlns="">
            <resourceAddress>/shared documents/file1.txt</resourceAddress>
            <UserRoleAssignments>
               <Role>1</Role>
               <UserId>khushbu_khatuja@persistent.com</UserId>
            </UserRoleAssignments>
            <validateExistingPermissions>true</validateExistingPermissions>
            <additiveMode>true</additiveMode>
            <sendServerManagedNotification>true</sendServerManagedNotification>
            <customMessage>hello</customMessage>
            <includeAnonymousLinksInNotification>true</includeAnonymousLinksInNotification>
         </ShareFileRequestDetails>
      </ShareFile>
    Anmerkung: Während der Ausführung müssen Werte für die obligatorischen Elemente der Eingabestruktur angegeben werden. Ein Wert kann angegeben werden, indem ein Standardwert für ein Element eingegeben wird oder indem das Element mit einem Eingabeknoten verknüpft wird. Wenn während der Ausführung kein Wert für ein obligatorisches Element angegeben wird, löst die Aktivität eine Ausnahmebedingung aus, die von der Web Management Console gemeldet wird. Wenn während der Ausführung kein Wert für einen optionalen Eingabeparameter angegeben wird, wird während der Ausführung keine Ausnahmebedingung ausgelöst.
  6. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Das XML-Schema, das zur Aufnahme der Antwort der Aktivität generiert wurde, wird als Knoten unter dem Antwortausgabeparameter im Fenster Von Aktivität angezeigt.
  7. Erstellen Sie eine Zuordnung zwischen den Ausgabeparametern und den Orchestrierungsvariablen.

Ergebnisse

Sie haben die MS SharePoint-Aktivität 'Dateien freigeben' konfiguriert.
Anmerkung:

Mit dieser Aktivität können Sie mehrere Dateien in einem Aufruf freigeben, da die Eingabevariable unbegrenzt ist.