Content Workflow's integration with Sitecore enables content editors to easily import and update content from Content Workflow in Sitecore. Editors can define mappings to specify which templates and fields should be imported using Template Mappings. This integration also allows editors to update the workflow status in Content Workflow for all successfully imported items. Brimit developed and maintains the integration in collaboration with Content Workflow.
Versions Supported
The module supports Sitecore 8.1, 8.2, 9.0 and 10.3
How to Install Sitecore
The Content Workflow connector is a Sitecore module delivered as a Sitecore package. To install the module, follow these steps.
- Download the package for your version of Sitecore here.
- Navigate to the Sitecore Menu > Development Tools > Installation Wizard.
- Select Upload Package and search for the package you downloaded. Upload the Content Workflow package and select Next.
- Verify the package information and click Install.
How to Configure Sitecore
A Content Workflow account module is created during the installation. The module stores user credentials that connect the Content Workflow account via the API and plugin settings. You have to set all of these parameters to start.
- Navigate to Content Workflow.
- Open the Content Editor and navigate to /sitecore/system/Modules/ContentWorkflowByBynder item.
- You can scroll down the page to the Credentials section and add your credentials.
-
Enter your Content Workflow User Email Address, API Key, and Platform URL > Save.
- Your email address is case-sensitive.
- You can find instructions on generating your API Key in our API Documentation.
(Optional) Update your Settings
You can customize the following settings once you've set up your credentials.
Settings |
Notes |
Set templates Root folder |
This is where you can specify a templates folder that will be used as root to select templates from on the Mapping Template dialog. If this is not set, /sitecore/templates/ will be used. |
Set output date format
|
All dates in the plugin will be displayed in the specified format. If this is not set, the format dd/MM/yyyy hh: mm tt will be used. |
Set DateTime field Format | The DateTime field format will map a date in text format from a Content Workflow field to a Sitecore Date or DateTime field. |
Set Drop Tree Home Node | This node will be the parent for all node pickers across the module. |
- Select the Test Connection
- After setting your credentials, you can test the connection to the Content Workflow platform by going to System> ModusystemontentWorkflowByBynder >Test Connection.
Introduction to Template Mappings
To bring content from Content Workflow, the content editor must establish connections between the Templates in Content Workflow templates in Sitecore and their respective fields. Follow these instructions to create these mappings.
How to Set up Template Mapping
- Select Mappings located on the Content Workflow ribbon. This will take you to the Manage template mappings section.
- Select Add Mapping. This will bring up the Field Mappings dialog, which lets you specify which templates and fields should be mapped.
-
Add the mapping details.
- Specify a name for the mapping. The mapping name will distinguish mappings on import dialogs. Set the default location (optional).
- This helps specify the default location (node) in Sitecore where imported Items will be stored. The field is also used in the multi-location import dialog to pre-fill the location pickers.
- Select the Content Workflow Project and Template and the corresponding Sitecore template.
- Specify the Content Workflow project and template you want to map and choose the corresponding Sitecore template (only templates stored under the Templates Root Folder will be visible there).
- Map the Content Workflow fields to Sitecore fields.
- All tabs and fields will be dynamically populated once you've added the mapping details (as above). You can now choose which Content Workflow fields (on the left-hand side) map to which Sitecore fields (on the right-hand side).
- Select Save Mappings Configuration.
- Once complete, you're ready to migrate over your content.
Important Notes
- The drop-downs display only fields that can be mapped. For example, it is not possible to map a text field from Content Workflow to an image field in Sitecore.
- The right-side dropdown displays all fields from the selected Sitecore template and fields from all base templates, which the current template inherits.
- The plugin supports many-to-one field mappings for text and guidelines field types. This means that it is possible to map, for example, two Content Workflow fields into one Sitecore field. The content of such fields will be concatenated and placed in the Sitecore field.
How to Map Radio and Select Fields
While text and attachment fields map directly into fields within Sitecore Radio, select fields that can include different options require an additional layer of mapping.
As seen below, there are two extra fields for a radio or checkbox field:
The first (1) is the list of drop-downs for each field of a certain type from the Content Workflow; you must select an element representing a pointer to a folder containing a list of options for a specific field.
For the second (2), you must select an element representing a pointer to a template of a specific option type. This is necessary so that when a certain option is in the Content Workflow but not in Sitecore, it will be imported and created based on the selected template. This is the same template type as the items in the folder selected in step 1.
Supported Field Types
Content Workflow Field |
Sitecore Field |
Note |
Text field (rich and plain text) |
Single-Line Text Multi-Line Text Rich Text Date DateTime |
Field content will be copied as is |
Guidelines field |
Single-Line Text Multi-Line Text Rich Text Date DateTime |
Field content will be copied as is |
Checkbox field |
Checklist Multilist Multilist with search Treelist TreelistEx |
The system will systemlected items in Content Workflow to items specified in the Sitecore field DataSourc.e |
Radio field |
Checklist Multilist Multilist with search Treelist TreelistEx |
The system will select items in Content Workflow to items specified in the Sitecore field DataSource. |
Attachment field |
Image File Droptree Multilist Multilist with search Treelist TreelistEx |
The attachment will be placed in the following Texting node structure: Sitecore media library/ContentWorkflowByBynder. If a field has a data source set, all imported fields will be uploaded to the location specified in the data source. If an Attachment field is mapped to a Sitecore Image or File or a Droptree field, only the first/file will be downloaded. The content workflow will be selected in Sitecore. If an Attachment field is mapped to a Sitecore field allowing multiple selections (Multilist, Multilist with search, Treelist, TreelistEx), all attachment files will be downloaded and selected in the corresponding field. |
How to Import Content into Sitecore
- Choose the Sitecore item from the list and click Import in the top bar.
- After all the mapping criteria are set, close the dialog and navigate to the content tree.
- Choose the Sitecore item under which you want to add items and click the Import on the Content Workflow ribbon.
- Select the Content Workflow project to import your content from.
- An import content dialog will appear, showing an empty grid.
- At this stage, you can select any Content Workflow project with a mapped template.
- You can also filter items by content workflow status and template.
- Select the Items you want to migrate.
- Select the items you want to import using the checkboxes, then click Next. This will launch the confirmation screen.
- Specify the language and destination and select the Item's status.
- On the confirmation screen, you can go over the selected Items.
- Then, specify the language and destination for the Items being imported.
- If a template for an item has more than one mapping defined, the system will drop down with possible mappings next to each item.
- You can also select the status that will be assigned to the Items in Content Workflow after a successful import.
- Select Import to begin the import process.
- The process can take some time, depending on the number of imported items.
- View the import results. After the import is finished, the import result screen will appear, where all imported and unimported Items are shown with their respective descriptions.
- It's now possible to open an Item in Sitecore or Content Workflow.
- The import results page will list all successful and failed imports.
- There are two reasons why an import may have failed. The error messages will show as Template fields mismatch and template not found.
How to Update Content in Sitecore with Changes Made in Content Workflow
You can update Sitecore items imported from Content Workflow.
- Navigate and select the update option in the top bar.
- Select the node under which you want to update items and click Update.
- Select the items to update.
- The pop-up dialog will show all items under the selected node previously imported from Content Workflow.
- You can select the items to update and click Next.
- View the results screen. The update process is similar to the import process. It ends with a results screen where you can view how many items were updated and if there are any errors.
Updated