MS SharePoint-Aktivität 'Listen abrufen' verwenden

Mit der Aktivität 'Listen abrufen' können Sie Listeneigenschaften aus MS SharePoint abrufen.

Informationen zu diesem Vorgang

Verwenden Sie diese Task, um Listeneigenschaften aus der MS SharePoint-Instanz abzurufen. 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 Listen abrufen aus. Die Aktivität Listen abrufen wird der Orchestrierung hinzugefügt. Klicken Sie doppelt auf die Aktivität. Die Prüfliste der MS SharePoint-Aktivität 'Listen abrufen' 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:
    • retrieveType (Gültige Werte: ALL und SPECIFIC)
    • retrieveListBy (Gültige Werte: LIST_ID und LIST_TITLE)
    • listId (Erforderlich, wenn retrieveType = SPECIFIC und retrieveListBy = LIST_ID)
    • listTitle (Erforderlich, wenn retrieveType = SPECIFIC und retrieveListBy = LIST_TITLE)

    Beispiel für eine Eingabeanforderung

    <?xml version="1.0" encoding="UTF-8"?>
    <RetrieveList xmlns="http://www.IBM.com/xmlns/prod/websphere/j2ca/Sharepoint/retrievelist">
    <!--1.	retrieveType = ALL -->
    
    <RetrieveListRequestDetails xmlns="">
    <retrieveType>ALL</retrieveType>
    </RetrieveListRequestDetails>
    
    
    <!--2.	retrieveType = SPECIFIC und retrieveListBy = LIST_TITLE -->
         <RetrieveListRequestDetails xmlns="">
            <retrieveType>SPECIFIC</retrieveType>
            <retrieveListBy>LIST_TITLE</retrieveListBy>
            <listTitle>List103</listTitle>
         </RetrieveListRequestDetails>
    
    
    <!--3.	retrieveType = SPECIFIC und retrieveListBy = LIST_ID -->
         <RetrieveListRequestDetails xmlns="">
            <retrieveType>SPECIFIC</retrieveType>
            <retrieveListBy>LIST_ID</retrieveListBy>
            <listId>efb347bd-2b4f-4859-b67c-80c7e60ed8fa</listId>
         </RetrieveListRequestDetails>
      </RetrieveList>
    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 verfügbar ist, wird 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 'Listen abrufen' konfiguriert.
Anmerkung:

Mit dieser Aktivität können Sie Eigenschaften mehrerer Listen in einem Aufruf abrufen, da die Eingabevariable unbegrenzt ist.

Einschränkung:

Die Option 'ExpandChildren' in der Aktivität 'Listen abrufen' funktioniert nicht für SharePoint am Standort. Dies ist das bekannte API-Verhalten für SharePoint am Standort.