SharePoint storage connector

When to use this connector

Use this Connector to create Flows that work with files in Microsoft SharePoint.

Etlworks includes a SharePoint (premium) connector, which we recommend using if you need to access Lists, Groups, Attachments, and Users stored in SharePoint. 

Create a Connection

Step 1. In the Connections window, click +, and type in sharepoint. Select Sharepoint Storage.

Step 2. Select Sharepoint.

Step 3. Enter Connection parameters.

Connection Parameters

• SharePoint URL: the base SharePoint URL, for example, https://etlworks.sharepoint.com
• Sharepoint Site: the optional SharePoint site name.

Sharepoint Site can be in a format Site or sites/Site depending on the configuration of the SharePoint instance.

• Directory: the actual directory with files. The default is Shared Documents.
• Files: the actual file name or a wildcard file name, for example, *.csv.

Authentication with username and password

Authentication with username and password works for all versions of SharePoint, including SharePoint Online, Office 365, and SharePoint hosted locally. 

Select Username and password in Authentication Method. Note that this is a default Authentication Method. 

Enter: 

• User: username.
• Password: password.

Authentication with OAuth

Authentication with OAuth works only for SharePoint Online and Office 365.

Authentication with OAuth is the only option to connect to SharePoint Online and Office 365 if 2FA or SSO is enabled for the Office 365 account. 

Select OAuthin Authentication Method.

Click Sign in with Microsoft and follow on-screen instructions to continue authentication. Optionally change Permissions.

Other parameters

• Add Suffix When Creating Files in Transformation: you can select one of the predefined suffixes for the files created using this Connection. For example, if you select uuid as a suffix and the original file name is dest.csv, Etlworks will create files with the name dest_uuid.csv, where uuid is a globally unique identifier such as 21EC2020-3AEA-4069-A2DD-08002B30309D.

This parameter works only when the file is created using source-to-destination-transformation. Read how to add a suffix to the files created when copying, moving, renaming, and zipping files.

• File Processing Order: Specifies the order in which source files are processed when using wildcard patterns in ETL and file-based flows (e.g., copy, move, delete). The default setting is Oldest, meaning files are processed starting with the oldest by creation or modification time. Choose from various criteria such as file age, size, or name to determine the processing sequence:
  • Disabled: wildcard processing is disabled,
  • Oldest/Newest: Process files based on their creation or modification time, Ascending/Descending: Process files in alphabetical order, Largest/Smallest: Process files based on their size. 

Decryption

When SharePoint Connection is used as a source (FROM) in the source-to-destination transformation, it is possible to configure the automatic decryption of the encrypted source files using the PGP algorithm and private key uploaded to the secure key storage.

If the private key is available, all source files processed by the transformation will be automatically decrypted using the PGP algorithm and given key.  Note that the private key requires a password. 

Read how to generate a pair of public/private keys.