Adding story-connect target selection component
Configuration
If you want to add a story-connect target selection component in your details area, simply add following code-templates in a separate details-area tab. Please see Details Pane Configuration for more information on how to configure templates in Details Area.
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
Restricting visibility
StoryConnect component visibility can be customized in the details area template. e.g. the visibility can be restricted such that the component will appear only when a Group is selected / edited / created. Please see following visibility options:
Visible for Groups Only
{{#if legacyController.form.entryIsAGroup}}
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
{{/if}}
This configuration is also available as ContentManager_Details_StoryConnect.PAR file in the PAR_examples folder of the delivered DPE software package.
Visible for Stories Only
{{#if (equal model.Story 3)}}
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
{{/if}}{{#if creatingNewEntry}}
{{#if (equal editModel.Story 3)}}
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
{{/if}}
{{/if}}
Visible for both Groups and Stories
{{#if (gt model.Story 0)}}
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
{{/if}}
{{#if creatingNewEntry}}
{{#if (gt editModel.Story 0)}}
{{content-manager/story-connect-wrapper legacyController=legacyController editable=editable model=model editModel=editModel showAllTarget=false}}
{{/if}}
{{/if}}
Display the "All" Target
Setting "showAllTarget" property in your Story-connect component controls whether "All" item is inserted at the top of the tree of available distribution targets (please see code snippet above). Sending a group to "All" does not necessarily mean the same as sending to every single target listed in the tree; rather, "All" is a special target whose meaning is determined in the configuration of the StoryConnect service.
URL of Addressbook service
Content Manager retrieves available target list from the StoryConnect Addressbook service whose URI must be configured in the parameter |Common|StoryConnect|UrlInterface
.
The StoryConnect Addressbook service is accessed when you open the StoryConnect component the first time in a CM session.
JSON Target list
Content Manager also supports providing StoryConnect targets as JSON String which can be configured inside |Common|StoryConnect|UrlInterfaceJson
In case Addressbook service URI is not found to be configured, Content Manager loads Target list from this parameter.
Functionality
Overview
The StoryConnect component lets you select StoryConnect distribution targets, e.g. other radio stations and/or departments across your StoryConnect network.
- The StoryConnect component lists on its left side all available targets.
- The right side lists the selected targets.
Selecting a Target
A target can be selected either by:
- Clicking on the button next to the destination name.
- Dragging a target item from left area (Available Targets) and dropping onto the left area (Selected Targets).
De-selecting a Target
A target can be de-selected either by:
- Clicking on button next to the destination name in the Selected Targets area.
- Dragging a target item from right area (Selected Targets) and dropping onto the left area (Available Targets)
Clicking on "Save" button in the Details Area will save the selected targets in the database as entry metadata.
Special targets
- The "All" target top of the list of available destinations is not simply "everything in the list". Its special meaning is defined by the StoryConnect configuration. The "All" target is only present if both internal and external targets are available.
- The "internal" targets usually are within your radio station. The "internal" group may be absent if no such destinations are provided by your StoryConnect Addressbook service.
- Likewise, the "External" target is absent if no external targets are configured.
- All destinations except "all" and internal destinations can have departments attached to them. You can either select the complete destination (radio station) or some of its departments as a distribution targets.
Parent and Child Targets
The left area of the StoryConnect tab displays targets in a hierarchical manner. Several targets have subordinate targets; in the example depicted above, "Internal" and "External" are subordinate to "All", and "MDR", "NDR", "BR", and "HR" are subordinate to "External". MDR, BR, and HR have subordinate targets (departments) which cannot be seen right now. We call subordinate targets children, and the node to which they are subordinate is called the parent.
When you add a parent node to the list of selected nodes, its selected children (if any) are automatically removed from the list, and all its children become unselectable. For example, this happens when you select "External":
However, when you remove the parent node from the list, the children which were removed are re-added to the list for your convenience.
Upgrading a Target
As was said above, a target cannot be removed from the list once the list is saved. You can, however, replace a saved target by its parent, grandparent, etc. We call this "upgrading" a target. Adding a parent to the list removes its children. When you remove the parent, the children are restored; however, you cannot remove the children unless they have been added in the current session.