Workflow Actions

Get Resource Property Action

7min

Introduction

The "Get Resource Property" action in CloudFiles retrieves the external URL and various metadata related to a file or folder stored in your cloud library. This is useful when you need to add the URL of a specific file or folder to a HubSpot custom object. To make sure this action works with your Cloud Storage, you need to understand What is an 'Automation User' and how does it work?ο»Ώ

Document image
ο»Ώ

Input Parameters

The "Get Resource Property" action takes in various parameters to specify the source & destination of the file.

  1. Library: The location where the file or folder URL needs to be extracted, such as SharePoint, Google Drive, or other storage platforms.
  2. Path to Resource: The exact path to the file/folder. There may be more than one parameters required to specify this path based on library selection.
  3. Property to get: The API name of property to be get.

- List of Property Names:

  • name - gives the name of the resource
  • description - gives the description of the resource
  • id - gives the ID of the resource
  • driveId - gives the drive ID of the resource
  • library - gives the library that the resource is in
  • externalUrl - gives the cloud drive (Sharepoint, Google Drive, etc.) URL of the resource
  • path - gives the path of the resource in the cloud drive
  • type - gives the type of resource (file/folder)
  • size - gives the size of the resource
  • createdAt - gives the date of creation of the resource (not present in dropbox
  • updatedAt - gives the date when the resource was last updated
  • extension - gives the extension of the resource

4. Return Values: Various values returned by this action after execution.

Document image
ο»Ώ

These parameters have been detailed in the section below:

1 - Library

Choose the cloud storage platform from which you want to extract the file or folder URL. You can choose from CloudFiles, OneDrive, SharePoint, Box, or Dropbox. Depending on your selection, additional parameters will appear in the action, which are explained in the sections below.

Document image
ο»Ώ

2 - Path to Resource:

This defines the source from which the file or folder URL needs to be extracted. You can specify the full path using a simple '/' separated string with the file name at the end.

The path to the folder can be copied from the metadata on the CloudFiles dashboard and then personalized using the record tokens. Follow the simple steps below -

1. Find the CloudFiles widget from any HubSpot record, and click on CloudFiles. It will redirect you toΒ app.cloudfiles.ioο»Ώ

2. Under the libraries tab, navigate to the file or folder that you are trying to add.

3. Copy the parameter from the meta data on the right side of the screen. This meta data example is shown below -

Document image
ο»Ώ

3 - Property to get

In this parameter, specify β€œexternalUrl” to retrieve the URL of the file or folder stored in Google Drive, SharePoint, or other storage platforms.

ο»Ώ

Document image
ο»Ώ

Return Values

The Move Resource action returns the following values. These can be used in later actions to chain together actions and create complex automation.

1. Action StatusΒ - This is a success or failure message based on whether the action is executed correctly.

2. Value (Boolean) - If the user prefers the output in a boolean format (yes/no), it will return the value accordingly.

3. Value (Date and Time) - If the user wants the output in date and time format, it will return the value accordingly.

4. Value (Date)- If the user requests the output in a date format, it will be returned accordingly.

5. Value (Number) - If the user requests the output as a number, it will be returned in that format.

6. Value (String) - If the user wants the output as a string in the form of an internal URL, the function will return the value accordingly.

ο»Ώ

ο»Ώ

Document image
ο»Ώ

ο»Ώ