How does Creative Workflow works

1 Introduction
2 Prerequisites
- 2.1 Structures Updates history
  - 2.1.1 collaborativespace
  - 2.1.2 collaborativebrief
  - 2.1.3 massimportpreviousitem
  - 2.1.4 wkfcollaborativespace & wkfcollaborativespaceaction
  - 2.1.5 massimportitem
  - 2.1.6 massimportjob
  - 2.1.7 contentcomments
  - 2.1.8 role
  - 2.1.9 user
  - 2.1.10 asset
  - 2.1.11 colors instances
  - 2.1.12 wkfcontentcomments & wkfcontentcommentsaction instances
  - 2.1.13 wkfmassimportitem instances
  - 2.1.14 wkfmassimportitemaction instances
  - 2.1.15 wkfuser & wkfuseraction
  - 2.1.16 pkgroletemplate instances
  - 2.1.17 New tags:
  - 2.1.18 pkg/touch/on/comment, pkg/wkf/action/on/comment, pkg/wkf/action/on/comment/toreview, pkg/wkf/action/on/comment/toreview
  - 2.1.19 Diagram of dependencies
- 2.2 Portal config
3 Triggers logics
4 Notifications and emails
- 4.1 Immediate notifications
- 4.2 Delayed notifications
- 4.3 Personalization of notifications
5 Security
6 Features
- 6.1 Versions
  - 6.1.1 New versions
  - 6.1.2 Replacing current version
- 6.2 Comments
  - 6.2.1 Security
  - 6.2.2 Workflow
  - 6.2.3 Type of comments
    - 6.2.3.1 Positioned comments
    - 6.2.3.2 General comments
  - 6.2.4 Tagging users
  - 6.2.5 Configuration
- 6.3 Invitation of users
  - 6.3.1 Existing user
  - 6.3.2 Inexisting user
- 6.4 Management of duplicates
- 6.5 Owner transfer (since 2025.2)
  - 6.5.1 New endpoint : /spaces/owner-transfer
  - 6.5.2 Transfer owner of one space through the front-end
    - 6.5.2.1 What’s happening behind the scenes?
    - 6.5.2.2 User dropdown and restrictions
  - 6.5.3 Transfer owner of one or multiple spaces through api call
7 Workflow of items
8 New plugins configuration details
- 8.1 PACKAGED_Activity
- 8.2 PACKAGED_CreativeWorkflow

Introduction

Starting from the 2024.1.0 version, a new Creative Workflow feature has been introduced in the Portal (see functional documentation of the feature here : https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2862940195).

In this transition from the first upload service /portal/dam-import to the creative workflow /portal/spaces, continuity is maintained by seamlessly integrating with the existing Mass Import services. The REST services have been upgraded, enhancing mass indexing capabilities for the items inside spaces.

Central to this upgrade is introducing the object collaborativespace, intricately linked to a job with the object massimportjob. This collaborative space enriches the mass import process, allowing teams to communicate and manage assets collaboratively. Features include space team collaboration, comments and tag members of space, and version tracking for assets within the collaborative space.

Technical metadata still resides on the object massimportitem, while functional metadata adopts a flexible JSON format for efficient indexing across various asset funds stored at the level of the massimportjob.

This documentation serves as your comprehensive guide to implementing and maximizing the potential of the first upload service to Spaces feature upgrade. Let's dive into the details for a seamless transition and enhanced upload to the DAM.

Prerequisites

Detailed prerequisites => https://crossmedia.atlassian.net/wiki/spaces/WD/pages/2862678030/Creative+workflow+installation+guide#Prerequisites

Structures Updates history

collaborativespace

2023.4 =>Added

2023.5

Fields changes

owner
- Tags:
  - Added: rest_api_dam_data/name|lastname|firstname|email|avatar, rest_api_include/massimport
team
- Tags:
  - Added: rest_api_dam_data/name|lastname|firstname|email|avatar
job
- Tags:
  - Added: rest_api_include/massimport
brieffiles
- Tags:
  - Added: rest_api_dam_data/brieffile, rest_api_dam_data/owner

Faces

Selector

Old selector

New selector

Collection<String> faces = new HashSet<String>();

faces.add("mandatory");

if(!"4".equals(surfer.getRoleId().toString())){
}
    faces.add("not_editable");
// will be moved up when other roles will have access to the spaces

return faces;

Configuration

mandatory
- added
  - Viewable:
  - Editable:
  - Mandatory:
not_editable
- added
  - Viewable:
  - Editable:
  - Mandatory:

2023.5.3

Fields changes

created
- Tags:
  - Added: rest_api_include/massimport
modified
- Tags:
  - Added: rest_api_include/massimport
team
- Tags:
  - Added: rest_api_dam_data/name|lastname|firstname|email|avatar|status
  - Removed: rest_api_dam_data/name|lastname|firstname|email|avatar
targetlibrary
- Tags:
  - Added: rest_api_mass_import_agg

Tags

Added

pkg/security/collaborative

Faces

Selector

Old selector

Collection<String> faces = new HashSet<String>();

faces.add("mandatory");

if(!"4".equals(surfer.getRoleId().toString())){
}
    faces.add("not_editable");
// will be moved up when other roles will have access to the spaces

return faces;

New selector

Collection<String> faces = new HashSet<String>();

faces.add("mandatory");
faces.add("not_editable");


return faces;

Configuration

mandatory
- targetlibrary (added)
  - Viewable: true
  - Editable: true
  - Mandatory: true

2024.1

Fields changes

owner
- Index:
  Not indexed --> Indexed
name
- Index:
  Not indexed --> Indexed

collaborativebrief

2023.4 =>Added

2023.5

Tags

Added

rest_api_dam_create

2023.5.3

Tags

Added

pkg/security/collaborative
pkg/security/secugroup/all
rest_api_dam_update

massimportpreviousitem

2023.4 =>Added

2023.5

Fields changes

owner
- Tags:
  - Added: rest_api_include/massimport
binary
- Tags:
  - Added: dam_asset_raw_file_field

2023.5.3

Fields changes

itemlasteditdate (added)
- Type: datetime
- Nature:
- Label:
- Default value:
- Order: 1500
- Remote name:
- Max size: 0
- Attachment:
- In list:
- Editable: false
- Viewable: false
- Mandatory: false
- Null if empty: false
- Auto carriage return: false
- Index: Not indexed
- i18n: false
- i18n for:
- Tags: rest_api_include/massimport
itemlasteditor (added)
- Type: child
- Nature: user
- Label:
- Default value:
- Order: 1600
- Remote name:
- Max size: 0
- Attachment:
- In list:
- Editable: false
- Viewable: false
- Mandatory: false
- Null if empty: false
- Auto carriage return: false
- Index: Not indexed
- i18n: false
- i18n for:
- Tags: rest_api_include/massimport

Tags

Added

pkg/security/collaborative

2024.1

Tags

Added

rest_api_dam_delete

wkfcollaborativespace & wkfcollaborativespaceaction

2023.4 =>Added

Instances :

wkfcollaborativespace

wkfcollaborativespace/1 (ADDED)

activated: 2
child:
color: 1
created: 26/05/2023 17:29:23
id: 1
isarchived: 2
isonline: 2
modified: 26/05/2023 17:29:23
name: delete
onenter:
onleave:
owner: 1
parent:
position: 0
published: 2
status: 2

wkfcollaborativespace/2 (ADDED)

activated: 1
child:
color: 4
created: 26/05/2023 17:29:23
id: 2
isarchived: 2
isonline: 2
modified: 26/05/2023 17:29:26
name: draft
onenter:
onleave:
owner: 1
parent:
position: 0
published: 2
status: 2

wkfcollaborativespace/6 (ADDED)

activated: 1
child:
color: 2
created: 26/05/2023 17:29:23
id: 6
isarchived: 2
isonline: 1
modified: 26/05/2023 17:29:29
name: online
onenter:
onleave:
owner: 1
parent:
position: 0
published: 2
status: 2

wkfcollaborativespace/7 (ADDED)

activated: 1
child:
color: 8
created: 26/05/2023 17:29:23
id: 7
isarchived: 1
isonline: 2
modified: 26/05/2023 17:29:31
name: archived
onenter:
onleave:
owner: 1
parent:
position: 0
published: 2
status: 2

wkfcollaborativespaceaction

wkfcollaborativespaceaction/2 (ADDED)

activated: 1
child:
condition:
created: 26/05/2023 17:29:23
forward: 0
icon:
id: 2
modified: 26/05/2023 17:29:23
name: archive
ontransition:
owner: 1
parent:
position: 0
roles:
state_in: 6
state_out: 7
status: 2

wkfcollaborativespaceaction/3 (ADDED)

activated: 1
child:
condition:
created: 26/05/2023 17:29:49
forward: 0
icon:
id: 3
modified: 26/05/2023 17:29:49
name: publish
ontransition:
owner: 1
parent:
position: 0
roles:
state_in: 7
state_out: 6
status: 2

2024.1

Instances

wkfcollaborativespace

wkfcollaborativespace/6

modified: 26/05/2023 17:29:29 --> 04/01/2024 16:11:22
published: 2 --> 1

massimportitem

2023.4

Fields changes

space (added)
- Type: child
- Nature: collaborativespace
- Label:
- Default value:
- Order: 5900
- Remote name:
- Max size: 0
- Attachment:
- In list:
- Editable: false