Page Comparison

...

• $anystatus: Any state

• $anyowner: No restriction on ownership

• $newcreation: Creating a fresh instance (eg click on the “New” button)

• $anyaction: Any workflow action (including publishing and archiving actions)

• $teammember : surfer is in instance’s team prop value

  Keyword’s activation conditions :

  • The structure must have this tag : pkg/security/collaborative

  • The structure must have a team property which is a childmultilngdb of user

• $teamleader : surfer is team’s leader
  Keyword’s activation conditions :

  • The structure must have this tag : pkg/security/collaborative

  • The structure must have a jobowner property which is a child of user

• $never : surfer not allowed

Setting Up Permissions and Roles

2/ Install on projects starting on 2024.1

In this case, you will only have to respect the Prerequisites. And they are all coming by default with the 2024.1.

Just be sure to call the update (admin) endpoint given by PACKAGED_Security.

You will need to create all your new library structures by copying the current asset structure, because you will need to have the spaces prop and the tags from the asset on your library structures.

3/ New massimportitem workflow

The existing wkfmassimportitem and its actions have been updated for the creative workflow. Also, this workflow is still usable for the upload feature, only some status/action labels will be different.

These are the main updates on the workflow :

• Position reordering

• The colors have been changed

...

• New statuses

  • id 3 : check => default status for imported items

  • id 4 : validate

• “Index” status (id 8 ) has been renamed to review

• Wkfmassimportitemactions have been reorganized. Actions have been added from and towards each one of these statuses : rejected, check, review, validate, approved

• Also for the existing statuses, when it was possible, existing actions have been updated to avoid adding actions and having other actions become useless. Depending on the modified instance, the update was on the target status or the action name.

• Statuses names, IDs, and action names are used on the portal’s configuration for dam-import and spaces domain.

4/ Configuration possibilities

Change the status of assets created by the Creative workflow

...

Role 29 : Reader

2/ Install on projects starting on 2024.1

In this case, you will only have to respect the Prerequisites. And they are all coming by default with the 2024.1.

Just be sure to call the update (admin) endpoint given by PACKAGED_Security.

You will need to create all your new library structures by copying the current asset structure, because you will need to have the spaces prop and the tags from the asset on your library structures.

3/ New massimportitem workflow

The existing wkfmassimportitem and its actions have been updated for the creative workflow. Also, this workflow is still usable for the upload feature, only some status/action labels will be different.

These are the main updates on the workflow :

• Position reordering

• The colors have been changed

...

• New statuses

  • id 3 : check => default status for imported items

  • id 4 : validate

• “Index” status (id 8 ) has been renamed to review

• Wkfmassimportitemactions have been reorganized. Actions have been added from and towards each one of these statuses : rejected, check, review, validate, approved

• Also for the existing statuses, when it was possible, existing actions have been updated to avoid adding actions and having other actions become useless. Depending on the modified instance, the update was on the target status or the action name.

• Statuses names, IDs, and action names are used on the portal’s configuration for dam-import and spaces domain.

4/ Configuration possibilities

Change the status of assets created by the Creative workflow

By default, an asset published from the creative workflow has the status Published.

At first, the asset has the default status set on the asset’s structure (Draft state the object asset provided by the NAR). Then, the following asynchronous transformation, configured on the parameter dam_denormalization_config of the plugin PACKAGED_DAM_Utils, will be applied on top of it to execute a workflow trigger that takes the asset to the Published state :

...

• If the damobject instance has been created by a user who has the rights to publish the asset, the workflow action publish will be executed for the asset

• If the damobject instance has been created by a user who has the rights to submit the asset, the workflow action submit will be executed for the asset.
  To sum up, with those 2 transformations, the new asset will have the Published status if the user who created the asset has rights to publish it. Otherwise, if the surfer has the rights to submit it, the workflow action submit will be executed on the asset.

Portal configuration

You’ll find above the tree view of the new config domain for spaces. We will now go through all the config points and see their customization possibilities.

back-to.json

Status
colour Purple title CAN BE CUSTOMISED

Here you will define the name of the route that will be used with the click of the back-to button from the space list view.

...

Here you can define/redefine cursors. Inside this folder we can find: collaborative-spaces.json, this cursor defines the way that spaces are retrieved.

...

Here you are defining the cursor to use for the space entities retrieval

...

Inside this folder, we are defining the layouts config, the same way it is defined for the dam domain. We have a default-resource-config.json file which describes all the available layouts and the default layout used to display space item entities

...

Inside this folder, we can find configuration files and folders about the space entities display.

We have a sort folder that will contain JSON files like in the dam domain. These files can be customized.

We also have a folder called items inside this folder we have actions.json which will contain all the available actions for a space entity. You can edit this file to add new actions (if they are prepared and if they exist) or to remove unwanted ones.

...

This folder contains a lot of configuration files and folder about the space items display and features, we will go through them in a slightly different way.

• filters

  • default-resource-config.json

    Status
    colour Purple title CAN BE CUSTOMISED

    • Filters for items can be modified, you can only add filters on massimportitems props.

    • Mainly composed by named-filters which can be found under common/named-filters.

items

detail

comments

...

filter-options.json

• Configuration for comments filter feature dropdown.

...

Workflow configuration

The creative workflow is based on using “massimport” objects just as the upload. The workflow currently used on the object massimportitem (wkfmassimportitem) can be customized.

But If you need a new status, you can add it directly on wkfmassimportitem. Then if you add some actions …

...

… and this is what you get without any portal configurations.

...

...

We can see that the new status is correctly displayed on the dropdown. But we need to configure the filter and the hidden-actions or add an i18n key to have the correct behavior. If the position of the “customstatus” is not the one you want, you can configure it on the display-order config.

Here is the result after some config on the files mentioned above.

Image AddedImage AddedImage Added

Add new targeted notifications

Notifications are delivered by default; here is the complete list: Creative workflow notifications

It is possible to add notifications based on project needs that would be triggered by specific actions (upload, status change, or others).

Here you will find more detailed information about the notification system setup for the creative workflow.

We are currently sending email notifications on each status change for each teammember or only for the owner according to PACKAGED_CreativeWorkflow.send_notification_to_team 's value.

As status change email notifications are based on the delayed notification system, if you want to add a customized behavior for a specific status (for example), you will have to create your Groovy script (you can check existing ones for inspiration) and update the configuration of PACKAGED_CreativeWorkflow.batch_topics_processors. You will have to follow the instructions described in the link provided above.

Portal configuration (advanced configuration)

You’ll find above the tree view of the new config domain for spaces. We will now go through all the config points and see their customization possibilities.

back-to.json

Status
colour Purple title CAN BE CUSTOMISED

Here you will define the name of the route that will be used with the click of the back-to button from the space list view.

cursors

Status
colour Purple title CAN BE CUSTOMISED

• Configuration for comments sort feature dropdown. You can modify this configuration to add sorting options or modify the existing one(s).

display

default-config

...

Here you can define/redefine cursors. Inside this folder we can find: collaborative-spaces.json, this cursor defines the way that spaces are retrieved.

default-cursor-name.json

Status
colour Purple title CAN BE CUSTOMISED

Here you are defining the cursor to use for the space entities retrieval

layouts

Status
colour Red title CAN'T BE CUSTOMISED

...

duplicates: In the creative workflow, we continue to offer a duplicate management system using the comparison modal, just as we did for the Upload feature.

...

Inside this folder, we are defining the layouts config, the same way it is defined for the dam domain. We have a default-resource-config.json file which describes all the available layouts and the default layout used to display space item entities

explore

Status
colour Purple title CAN BE CUSTOMISED

• This config is currently set to null because no restrictions were required.
  But it can be updated, it works in the same way as for the dam-import config.

...

Inside this folder, we can find configuration files and folders about the space entities display.

We have a sort folder that will contain JSON files like in the dam domain. These files can be customized.

We also have a folder called items inside this folder we have actions.json which will contain all the available actions for a space entity. You can edit this file to add new actions (if they are prepared and if they exist) or to remove unwanted ones.

explore-items

Status
colour

...

Yellow title CAN BE

...

• Currently this config is empty, but it can be edited to display additionnal informations about item’s props in the comparison modal.

...

PARTLY CUSTOMISED

This folder contains a lot of configuration files and folder about the space items display and features, we will go through them in a slightly different way.

• filters

  • default-resource-config.json

    Status
    colour Purple title CAN BE CUSTOMISED

    • This config is used to define the color of the text used on the duplicates label. It can be edited.

    workflows

    • asset

      display-order

      Filters for items can be modified, you can only add filters on massimportitems props.

    • Mainly composed by named-filters which can be found under common/named-filters.

• items

  • detail

    • comments

      • filter-options.json

        Status
        colour PurpleRed title CAN'T BE CUSTOMISED

        • This config is used to reorder the status dropdown displayed on the item block card.
          It can be modified.

        hidden-statuses

        • Configuration for comments filter feature dropdown.

      • sort-options.json

        Status
        colour Purple title CAN BE CUSTOMISED

        • This config is used to hide statuses and avoid showing them in the dropdown on the item block card. Mainly set for the “processing statuses” that are used when items are published. It can be modified.

        rejected-status-id

        • Configuration for comments sort feature dropdown. You can modify this configuration to add sorting options or modify the existing one(s).

  • display

    • default-config

      • space-item-block.json

        Status
        colour Purple title CAN BE CUSTOMISED

        • This config is used to configure the rejected status ID. This allows the CwSpacesBlockItem.vue component to know correctly which one of all the massimportitem's statuses is the real rejected status. It is used to define if the comparison modal link should be displayed. It can be modified.

      hidden-actions

      • Red title CAN'T BE CUSTOMISED

        • This config contains the name of the named-display that is used to display an item of a space. The current spaceItemBlockis displayed with the itemBlockconfig (common/named-displays/item-block). We do not recommend this config to be updated, but if you want another title or subtitle for the space block items you can redefine the properties used to display title or subtitle.

  • duplicates: In the creative workflow, we continue to offer a duplicate management system using the comparison modal, just as we did for the Upload feature.

    • authorized-resources.json

      Status
      colour Purple title CAN BE CUSTOMISED

      • This config is currently set to null because no restrictions were required.
        But it can be updated, it works in the same way as for the dam-import config.

    • display.json

      Status
      colour Purple title CAN BE CUSTOMISED

      • This config is used to hide workflow actions. The main purpose of Currently this config in the space domain is to hide all the workflow actions on the comparison modal. Only “torejected” is permitted. The config is empty, but it can be edited if you want to enable other actions from the comparison modal (or if you’ve added other statuses and actions and want the actions to be displayed).

      statuses-config

      • to display additionnal informations about item’s props in the comparison modal.

    • status-color.json

      Status
      colour RedPurple title CAN 'T BE CUSTOMISED

      • This config is a mapping config. It is mainly used to map a status config (id, label, tooltip, color) for the items indexingstatus value. While we do not recommend editing this configuration, you still have the flexibility to modify colors, labels, or icons (displayed just before the dropdowns on the item's block card).

    actions

    • • used to define the color of the text used on the duplicates label. It can be edited.

  • workflows

    • asset

      • display-order.json

        Status
        colour Purple title CAN BE CUSTOMISED

    • Contains all the available actions for a space item (massimportitem) entity. You can edit this file to add new actions (if they are prepared and they exist) or to remove unwanted ones.

Workflow configuration

The creative workflow is based on using “massimport” objects just as the upload. The workflow currently used on the object massimportitem (wkfmassimportitem) can be customized.

But If you need a new status, you can add it directly on wkfmassimportitem. Then if you add some actions …

...

… and this is what you get without any portal configurations.

...

...

We can see that the new status is correctly displayed on the dropdown. But we need to configure the filter and the hidden-actions or add an i18n key to have the correct behavior. If the position of the “customstatus” is not the one you want, you can configure it on the display-order config.

Here is the result after some config on the files mentioned above.

Image RemovedImage RemovedImage Removed

Add new targeted notifications

Notifications are delivered by default; here is the complete list: Creative workflow notifications

It is possible to add notifications based on project needs that would be triggered by specific actions (upload, status change, or others).

Here you will find more detailed information about the notification system setup for the creative workflow.

We are currently sending email notifications on each status change for each teammember or only for the owner according to PACKAGED_CreativeWorkflow.send_notification_to_team 's value.

...

• • • • • This config is used to reorder the status dropdown displayed on the item block card.
          It can be modified.

      • hidden-statuses.json

        Status
        colour Purple title CAN BE CUSTOMISED

        • This config is used to hide statuses and avoid showing them in the dropdown on the item block card. Mainly set for the “processing statuses” that are used when items are published. It can be modified.

      • rejected-status-id.json

        Status
        colour Purple title CAN BE CUSTOMISED

        • This config is used to configure the rejected status ID. This allows the CwSpacesBlockItem.vue component to know correctly which one of all the massimportitem's statuses is the real rejected status. It is used to define if the comparison modal link should be displayed. It can be modified.

    • hidden-actions.json

      Status
      colour Purple title CAN BE CUSTOMISED

      • This config is used to hide workflow actions. The main purpose of this config in the space domain is to hide all the workflow actions on the comparison modal. Only “torejected” is permitted. The config can be edited if you want to enable other actions from the comparison modal (or if you’ve added other statuses and actions and want the actions to be displayed).

    • statuses-config.json

      Status
      colour Red title CAN'T BE CUSTOMISED

      • This config is a mapping config. It is mainly used to map a status config (id, label, tooltip, color) for the items indexingstatus value. While we do not recommend editing this configuration, you still have the flexibility to modify colors, labels, or icons (displayed just before the dropdowns on the item's block card).

  • actions.json

    Status
    colour Purple title CAN BE CUSTOMISED

    • Contains all the available actions for a space item (massimportitem) entity. You can edit this file to add new actions (if they are prepared and they exist) or to remove unwanted ones.