SharePoint on-premises - Get item attachment by name
The SharePoint on-premises - Get item attachment by name action A tool for building the processes, logic, and direction within workflows. retrieves a specified attachment from a collection variable containing all attachment names for a given list item.
For more information about the SharePoint on-premises connector, go to SharePoint on-premises.
Configure the SharePoint on-premises - Get item attachment by name action
Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.
- Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.
- In the Configuration section, select a SharePoint on-premises Connection. If you do not have a connection, see Add a connection.
- Type a SharePoint site URL and click Retrieve lists.
Example:https://domain.sharepoint.com/sites/hr
- Select the List name that contains the item with the attachment that you want to retrieve.
- For Item ID, specify the ID of the list item that you want to retrieve the attachment from.
For more information about Item ID, see SharePoint on-premises - Get item attachment by name.
Retrieve attachments from a list item
The following actions can be used along with SharePoint on-premises- Get item attachment by name to retrieve attachments from a list item:
You can retrieve attachments from a list item using SharePoint on-premises - Retrieve an item action as described in the steps below:
-
Store attachment file names to a collection variable using the SharePoint on-premises - Retrieve an item action.
-
Loop through the collection variable to retrieve each attachment:
- Add the Loop for each action to the workflow after the SharePoint on-premises - Retrieve an item action.
- Click the Loop for each action to open the configuration panel.
- To select the Target Collection:
- Click Insert.
- In the variable panel, select SharePoint Online > attachmentnames > Attachment name(s) and click Insert.
-
Get each attachment using the SharePoint Online - Get item attachment by name action:
- Drag the SharePoint Online - Get item attachment by name action to the drop zone () in the loop construct.
- Click the SharePoint Online - Get item attachment by name action to open the configuration panel.
-
Access the list that contains the list item you want for the operation:
-
Select a SharePoint Online Connection.
-
Type a SharePoint site URL.
Example:https://domain.sharepoint.com/sites/hr
- Click Retrieve lists. Existing lists in the site are retrieved and displayed in the List name drop-down.
-
Select the List name that you want.
-
- For Item ID, specify the ID of the list item that you want to retrieve attachments from. You can insert a variable or type the value.
- For Attachment name:
- Click Insert.
- In the Loop for each variable section, select Loop for each > Current item and click Insert.
-
For Result:
- Click Add variable > Create variable.
- For Name, type attachmentOutput and click Create & insert.
You can retrieve attachments from a list item using SharePoint on-premises - Query a list action as described in the steps below:
In the Designer page:
-
Store attachment file names to a collection variable using the SharePoint on-premises - Query a list action.
-
Loop through the collection variable to retrieve each attachment:
- Add the Loop for each action to the workflow after the SharePoint on-premises - Query a list action.
- Click the Loop for each action to open the configuration panel.
- To select the Target Collection:
- Click Insert.
- In the variable panel, select SharePoint Online > attachmentnames > Attachment name(s) and click Insert.
- Loop through each attachment:
- Add another Loop for each action to iterate through the attachments associated with that item.
Get each attachment using the SharePoint on-premises- Get item attachment by name action within this loop:
- Drag the SharePoint on-premises- Get item attachment by name action to the drop zone () in the loop construct.
- Click the SharePoint on-premises- Get item attachment by name action to open the configuration panel.
Access the list that contains the list item you want for the operation:
Select a SharePoint on-premises Connection.
Type a SharePoint site URL.
Example:https://domain.sharepoint.com/sites/hr
- Click Retrieve lists. Existing lists in the site are retrieved and displayed in the List name drop-down.
Select the List name that you want.
- For Item ID, specify the ID of the list item that you want to retrieve attachments from. You can insert a variable or type the value.
- For Attachment name:
- Click Insert.
- In the Loop for each variable section, select Loop for each > Current item and click Insert.
For Result:
- Click Add variable > Create variable.
- For Name, type attachmentOutput and click Create & insert.
SharePoint on-premises- Get item attachment by name action fields and settings
Important: Before inserting variables in the action configuration, you must manually type or select the values and populate other dependent fields in order to retrieve the output data. Once configured, you can insert variables to the required fields.
Section | Field | Description | Variable types | |
---|---|---|---|---|
(unlabeled) |
SharePoint on-premises connection for the list containing the item with attachments that you want to retrieve. To refresh the available connections, click . |
(n/a) | ||
Source attachment |
SharePoint site URL |
The URL of the SharePoint on-premises site containing the list you want to use. To retrieve the lists from the SharePoint on-premises site, type the SharePoint site URL and click Retrieve lists. Example:https://domain.sharepoint.com/sites/hr |
Boolean, Collection, DateTime, Decimal, Integer, Text |
|
List name |
The name of the list containing the list item with the attachments you want to retrieve. Accepts a selection from the drop-down list. The drop-down list is limited to lists within the site specified in the SharePoint site URL. |
Boolean, Collection, DateTime, Decimal, Integer, Text |
||
Item ID |
The ID of the list item from which you want to retrieve the attachments. How do I find the item ID in the SharePoint on-premises list?
The ID column is added to the list. |
Integer |
||
Attachment name |
The name of the attachment. Accepts any combination of typed text and inserted variables. |
Boolean, Collection, DateTime, Decimal, Integer, Text |
||
Output |
Result |
File variable to store the output from the action. |
File |