Get File/Folder

UiPath.MicrosoftOffice365.Activities.Files.GetItem

Beschreibung

Verwendet die Get Item -API von Microsoft Graph, um die Metadaten eines angegebenen Elements mit einer bekannten ID (ItemID) abzurufen. Um die ID des Elements abzurufen, können Sie eine Aktivität verwenden, die ein DriveItem -Objekt ausgibt (z. B. Find Files And Folders).

Nachdem das Element gefunden wurde, gibt die Aktivität ihre Metadaten in einem neuen DriveItem -Objekt (Item) zurück, das Sie in nachfolgenden Aktivitäten verwenden können.

Scopes

Diese Aktivität erfordert die folgenden Scopes:

• Sites.Read.All

ODER

• Sites.ReadWrite.All

Projektkompatibilität

Windows – Legacy | Windows

Konfiguration

Im Textkörper der Aktivität

• Datei oder Ordner – Die Zieldatei oder der Zielordner. Klicken Sie auf Durchsuchen neben dem Feld, und navigieren Sie dann zum Ordner oder zur Datei, und wählen Sie ihn aus. 
• Enter Id – Um die ID abzurufen, geben Sie eine DriveItem -Ausgabevariable von einer Aktivitätsabhängigkeit ein (z. B. Find Files And Folders, Copy File/Folder, Create Folder). Rufen Sie bei der Eingabe der Variable DriveItem die ID des Objekts ab, indem Sie „.Id“ an das Ende der Variablen anhängen (z. B. firstFolderFound.Id). Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• URL eingeben – Die DriveItem-URL der Datei oder des Ordners von Interesse. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eigenschaften-Panel

Allgemein

• Anzeigename – Der Name der Aktivität im Designerbereich. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Eingabe

• Element-ID – Die DriveItem-ID der gewünschten Datei oder des gewünschten Ordners. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.
• Element-URL – Die DriveItem-URL der gewünschten Datei oder des gewünschten Ordners. Diese Eigenschaft unterstützt String-Variablen und stringformatierte Werte.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert. Dieses Feld unterstützt nur boolesche Werte.

Optionen

• Konto – Die ID oder der Benutzerprinzipalname für den Benutzer, der die OneDrive-Instanz besitzt. Dieser Parameter muss für die Authentifizierungstypen ApplicationIdAndSecret und ApplicationIdAndCertificate festgelegt werden.

Ausgabe

• Element - Die Datei oder der Ordner von Interesse als DriveElement.

SharePoint

• Laufwerksname – Der Name des Laufwerks in OneDrive oder SharePoint, in dem nach den angegebenen Dateien oder Ordnern gesucht wurde. Wenn dieses Laufwerk in SharePoint vorhanden ist, muss die Site-URL angegeben werden. Wenn leer gelassen, wird die Suche im Standardlaufwerk (normalerweise „Dokumente“) der SharePoint-Site ausgeführt, die im Feld Site-URL angegeben ist. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.
• Site- URL – Die URL der SharePoint-Site, durch die nach den angegebenen Dateien oder Ordnern gesucht wurde. Nur bei der Suche in SharePoint erforderlich. Wenn Sie beispielsweise in den Dokumenten Ihrer SharePoint-Website suchen möchten, könnte Ihre Website-URL „https://uipath.sharepoint.com/sites/Quickstart“ lauten. und Ihr Drive-Name wäre „Documents“. Diese Eigenschaft unterstützt String -Variablen und zeichenfolgenformatierte Werte.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Führen Sie die Schritte aus.
2. Fügen Sie die Aktivität Microsoft Office 365 Scope zu Ihrem Projekt hinzu.
3. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der ein DriveItem-Objekt ausgibt (z. B. Find Files And Folders, Create Workbook, Copy File/Folder).
4. Fügen Sie die Aktivität Get Item Info innerhalb der Aktivität Microsoft Office 365 Scope hinzu.
5. Geben Sie Werte für die Eingabeeigenschaften ein.
6. Erstellen Sie eine DriveItem -Variable für Ihre Output-Eigenschaft, und geben Sie sie ein.

7. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die GetItem- API gesendet.
   • Die API gibt den Wert DriveItem an Ihre Ausgabeeigenschaftsvariable zurück.