Use an Azure Blob Endpoint to connect CIC to a container in Azure Blob Storage. Once configured, you can send files to the container and receive files from it in Data Flows, or link it as a folder in a Partner Mailbox.
Before you begin, make sure you have an Azure Storage account and a container. You also need either the storage account’s access key or an Azure Key Vault secret that contains it.
Azure Blob Endpoint Settings
The following sections describe the settings and information for an Azure Blob Endpoint. The General settings are required to create the Endpoint. The Advanced settings are optional. Linked Folders is a read-only list that shows where the Endpoint is in use.
General
The General settings identify the storage account and container CIC connects to, and how CIC authenticates. Select an Authentication method to display the fields for that method.
General field descriptions
| Attribute | Description | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Storage Account | The Azure Storage account name. | ||||||||||||||
| Authentication |
Two methods of authentication are available - Access Key and Azure Key Vault. Choose a method from the drop down menu to reveal fields appropriate for your choice.
|
||||||||||||||
| Container |
The Azure Storage container name. Valid pattern: Example: |
||||||||||||||
| Blob Type | The type of blob CIC creates in the container. Choose Block Blob or Append Blob. |
Advanced
These settings control how CIC connects to Azure Blob Storage and handles directory listings, retries, and concurrent transfers. They also let you set up email notifications for successful sends and receives, and turn on debug logging for troubleshooting. The default values work for most configurations.
Connection & Transfer
| Attribute | Description | ||||||
|---|---|---|---|---|---|---|---|
| Endpoint Suffix | The Azure Storage endpoint suffix. Default is "core.windows.net" Specify the endpoint suffix to use in the connection string. | ||||||
| Headers | An editable list of optional additional HTTP headers. See Editing Headers. | ||||||
| Retrieve Directory Sort |
Specify the sorting order for files being transferred and processed. Choose from the following:
|
||||||
| Maximum Directory Entries Returned |
Specify the maximum number of directory entries to return and display. Note: Use this property with caution when this Endpoint is being used as a linked folder for a Partner Mailbox.
Minimum value: 0 (no limit) |
||||||
| Automatic Retries |
The number of retries that should be made during an attempt. An attempt consists of the number of transfer retries you specify. For example, if you specify 5 retries and 30 seconds, an attempt would consist of 5 retries occurring in the span of 30 seconds. This setting applies to both sends and receives. The minimum number of retries is 0 and the maximum is 5. The time between retries can range from 0 to 120 seconds. |
||||||
| Extended Outbound Retries |
The period of time during which outbound retries are attempted after a failed send attempt and subsequent failed automatic retry. Retries will not be attempted after the end of the period specified. This period starts when the first retry is attempted and ends after the value you specify elapses. Minimum value is 15 minutes. Maximum value is 3 days. |
||||||
| Concurrent Outbound Transfers |
Specify the maximum number of connections that can be transferring to this Endpoint at the same time. Default value is 5. Minimum value is 1 and maximum is 10. |
||||||
| Events |
CIC can send notification email to one or more recipients when files are successfully sent to or received from this Endpoint. Use the fields below to specify who receives the notifications.
Recipients can be CIC users or external recipients. When you enter a CIC user, a type-ahead dropdown helps you find the name. External recipients require a full email address. CIC users also receive more detailed notification emails than external recipients, who receive a simpler email. For all recipients, the notification email includes a link where the recipient can opt out of notifications from this Endpoint or all Endpoints. If a recipient opts out of these notifications, their email address no longer appears in the list of recipients you specified. |
Logging
| Attribute | Description |
|---|---|
| Enable Debug |
Select to enable debug-level logging for this endpoint.
|
Linked Folders
A Partner Mailbox can use an Azure Blob Endpoint as a linked folder. If this Endpoint is linked in one or more Partner Mailboxes, this list displays the names of those Partner Mailboxes and folders. The list is read-only and is empty if the Endpoint isn’t linked anywhere.
Editing Headers
When you click the Headers > Edit button, the Headers dialog box displays.

To add a header, enter a header name and value, and then click Add.
To disable a header, clear the Enabled check box for that row.
AzureBlob Endpoint Commands
The following commands are available for AzureBlob Endpoints.
CLEAR
Clear a property string value. The cleared value only affects the commands that follow the CLEAR.
CLEAR property
| property | Property name with no embedded spaces. |
DIR
Get a directory listing of available files from the host
DIR "source"
| source | Remote source directory path. |
GET
Receive one or more files from the host
GET -REC -DEL "source" "destination"
| -REC |
Recursively retrieve nested subdirectories. If used in conjunction with -DEL, the retrieved files, but not subdirectories, are deleted on the server. Optional. |
| -DEL |
If the GET is successful, delete the remote file. Optional. |
| source |
Remote source path. You can specify a path ( If the path contains a macro variable, space, dash (-), comma (,), or equal sign (=), it must be enclosed with double quotes ("..."). |
| destination |
CIC destination path.
|
PUT
Send one or more files to the host.
PUT "source" "destination"
| source |
|
| destination | Remote destination filename. If the destination contains a macro variable, space, dash (-), comma (,), or equal sign (=), it must be enclosed with double quotes ("..."). The use of macro variables is supported. See Using Macro Variables in CIC (Destination context) for a list of the applicable macros. |
SET
Change a property value. The new value only affects the commands that follow the SET.
SET property=value
| property = value |
Property and new value
|
Valid properties for SET command are as follows:
| RetrieveDirectorySort |
Use this property to control the order in which files are downloaded from the server. Possible values include:
|
| TerminateOnFail |
Valid for all Endpoints configured as source in a Data Flow.
Default value is True. |
WAIT
Pause execution.
WAIT seconds
| seconds | Number of seconds to pause. |
Comments
0 comments
Please sign in to leave a comment.