Get File/Folder

UiPath.MicrosoftOffice365.Activities.Files.GetItem

Beschreibung

Verwendet die Microsoft Graph Get item- API, 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).

After locating the item, the activity returns its metadata in a new DriveItem object (Item) that you can use in subsequent activities.

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, navigieren Sie zum Ordner oder zur Datei, und wählen Sie ihn aus.
• ID eingeben – Um die ID abzurufen, geben Sie eine Ausgabe- DriveItem -Variable aus einer Aktivitätsabhängigkeit ein (z. B. Dateien und Ordner suchen, Datei/Ordner kopieren, Ordner erstellen). Rufen Sie bei Eingabe der Variablen 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

• Drive-Name - Der Name des Drive innerhalb der OneDrive- oder SharePoint-Instanz, die nach den angegebenen Dateien oder Ordnern durchsucht wurde. Wenn dieses Drive innerhalb von SharePoint vorhanden ist, muss SiteUrl angegeben werden. Wenn leer gelassen, wird die Suche im Standardlaufwerk (typischerweise „Dokumente“) der SharePoint-Site ausgeführt, die im Feld Site-URL angegeben ist. Diese Eigenschaft unterstützt String -Variablen und stringformatierte Werte.
• Site-URL - Die URL der SharePoint-Website, die nach den angegebenen Dateien oder Ordnern durchsucht 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 “ und Ihr Drive-Name „Documents“ lauten. Diese Eigenschaft unterstützt String -Variablen und String-formatierte 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. Add the Get Item Info activity inside the Microsoft Office 365 Scope activity.
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.