You can create a pipeline that writes back data from an Anaplan Data Orchestrator dataset to Azure Blob Storage.
Prerequisites
You need a connection to Azure Blob Storage to create a pipeline. Make sure you meet the prerequisites in these sections before you create a connection to Azure and a writeback pipeline.
Connectivity prerequisites
Writeback pipeline prerequisites
Create a connection to Azure Blob Storage
You will need your Azure Blob Storage credentials to connect the Azure Blob Storage data with Data Orchestrator. View the Azure Blob Storage documentation for more information about your credentials.
To create a connection:
- Select Data Orchestrator from the top-left navigation menu.
- Choose a dataspace from the list.
- Select Connections from the left-side panel.
- Select Create connection.
- Select the Azure Blob Storage connector and then select Next.
If you can't find the connector, enter a search term in the Find... field. - Enter these details on the Connection details screen, and then select Next:
- Name: Create a name for your connection. The name can contain alphanumeric characters and underscores.
- Description: Enter a description about your connection.
- Enter your Azure Blob Storage credentials on the Connection credentials screen, and then select Next.
For information about the fields on this page, see Authentication options for Azure Blob Storage connections. - After the connection test is complete, select Done.
Create a writeback pipeline
When you set up the writeback pipeline, you'll use your connection to export either a source dataset or a transformation view dataset (derived dataset) from Data Orchestrator to Azure Blob Storage.
Note that the write option for Azure Blob Storage is automatically full replace.
To create a writeback pipeline:
- Select Data Orchestrator from the top-left navigation menu.
- Choose a dataspace from the list.
- Select Pipelines from the left-side panel.
- Select Create pipeline.
- Enter a Name for your pipeline and then select Create.
You are taken to the pipeline designer view. - Select the Source icon, and then complete these steps in the right-side panel:
- Select Anaplan from the Connection type dropdown.
- Select Datasets from the Choose connection dropdown.
- Enter a new Label if you want to change the source display name in the designer view.
By default, the name of the dataset you selected displays as the label name. - Select Source location to choose a Data Orchestrator dataset, then select Confirm.
The dataset is used as the source for your pipeline. - Select Columns if you want to exclude columns in the writeback.
By default, all columns are included. You can also select a Cursor column for your source.
- Optionally, select the add icon that appears between the Source and Sink nodes.
You can add steps to your pipeline to process data. - Select the Sink icon, and then complete these steps in the right-side panel:
- Select Azure Blob from the Connection type dropdown.
- Select the Azure connection you created from the Choose connection dropdown.
- Enter the file name followed by the
.csvextension in the File path field.
We recommend you include the date in the file name in this format YYMMDD (Y for year, M for month, and D for date). For example:Azurefilename_260901.csv - Select the Overwrite file checkbox if you want to overwrite an existing file in Azure, or leave it blank to create a new file:
- Create new file: Leave the Overwrite file checkbox blank, and enter the new file name in the File path field.
Note: If the file already exists, the pipeline fails and displays a message with this reason. - Overwrite existing file: Select the Overwrite file checkbox to overwrite an existing file in Azure. Enter the name of the existing file in the File path field.
- Create new file: Leave the Overwrite file checkbox blank, and enter the new file name in the File path field.
- Select a Column Separator from the dropdown:
- Comma
- Tab
- Pipe
- Semicolon
- Select a Text delimiter from the dropdown:
- Double quote (")
- Single quote (')
- None
- Enter a new Label to change the sink name that displays in the designer view.
- Select Publish, and then select Run to execute the data transfer.
Verify the writeback in Azure Blob Storage
Once the pipeline is successfully completed, you can log in to the Microsoft Azure platform to verify the writeback. Navigate to Azure Blob Storage and verify the CSV file is written back to your container.