DocsMarshal /ActivityLibrary /MicrosoftGraph /OneDrive_ItemGet

OneDrive_ItemGet

Description

This activity allows to get the properties of an item stored in OneDrive given its id or its path.

Note:

For the activity to work, the reference application in the Azure Portal must have the following API permissions. This activity allows only APPLICATION type permissions (it cannot work with "DELEGATE" ones).
Required permissions:
Files: Files.Read.All, Files.ReadWrite.All
Sites: Sites.Read.All
Check this page for more information on Azure app API permissions.

Auth

AuthString InArgument<String> REQUIRED

The authorization string to authenticate in MicrosoftGraph service.

It is possible to obtain it using the activity MsGraph_Login. Look at its dedicated page for more details.

Creation

CreatedById OutArgument<String>

The id of the Identity of the user, device, and application which created the item.

CreatedByName OutArgument<String>

The display name of the Identity of the user, device, and application which created the item.

CreatedDateTime OutArgument<DateTime>

Date and time of item creation.

Deleted

DeletedState OutArgument<String>

Represents the state of the deleted item.

Drive

DriveId InArgument<String>

The Id of the drive on which the activity has to work on.

File Props

Crc32Hash OutArgument<String>

(Hex string). The CRC32 value of the file in little endian (if available).

MimeType OutArgument<String>

The MIME type for the file.

QuickXorHash OutArgument<String>

(Base64 string). A proprietary hash of the file that can be used to determine if the contents of the file have changed (if available).

Sha1Hash OutArgument<String>

(Hex string). SHA1 hash for the contents of the file (if available).

Folder Props

ChildrenCount OutArgument<Int32>

The number of children contained immediately within this item. It must be a folder.

Item

ItemId InArgument<String>

The Id of the item.

It is possible to obtain it by the activity OneDrive_ItemGet which allow to get the id of an item given its path.

ItemPath InArgument<String>

The path of the Item (File, Folder, ecc...). It must be '' (empty string) to work on the root of the drive. To work on any other folder the path must follow this pattern: 'folder1/folder2/folder3/.../file1.txt' (it is not necessary to specify the file if the item is a folder).

ResultItem OutArgument<OdItem>

An object representing the obtained OdeDrive item.

Last Modify

LastAccessedDateTime OutArgument<DateTime>

Date and time of item was last accessed.

LastModifiedDateTime OutArgument<DateTime>

Date and time of item was last modified.

LastModifiedId OutArgument<String>

The id of the Identity of the user, device, and application which last modified the item.

LastModifiedName OutArgument<String>

The display name of the Identity of the user, device, and application which last modified the item.

Props

FileType OutArgument<EFileType>

Indicates the type of the item if it is a file. If it's not a file or its type is not handled the "Generic" value will be returned.

Have a look to the page dedicated to the EFileType enumeration for more informations.

ItemIdOut OutArgument<String>

The unique identifier within the Drive of the obtained element.

ItemName OutArgument<String>

The name of the item (filename and extension).

ItemType OutArgument<EItemType>

Indicates whether the the item is a file or a folder.

Have a look to the page dedicated to the EItemType enumeration for more informations.

Size OutArgument<Int64>

Size of the item in bytes.

WebUrl OutArgument<String>

URL that displays the resource in the browser.

Settings

Timeout InArgument<TimeSpan>

The maximum time the activity might take to be executed. If it takes longer, an exception will be thrown.

Tags

CTag OutArgument<String>

An eTag for the content of the item. This eTag is not changed if only the metadata is changed. Note: this property is not returned if the item is a folder.

ETag OutArgument<String>

The eTag for the entire item (metadata + content). An ETag is an opaque identifier assigned by OneDrive to a specific version of an item found inside it. ETags are similar to fingerprints and can quickly be compared to determine whether two representations of a resource are the same.

User

UserId InArgument<String>

The id of the Microsoft Account of the owner of the Drive.

It can be found in the result fields of certain activities such as, for example, the owner of a file returned by the OneDrive_ItemGet activity.

UserName InArgument<String>

The email of the Microsoft Account of the owner of the Drive. Example: "mario.rossi@outlook.it".