Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This process is useful for cases where the standard “Share” action that can be used to share objects with other users is not sufficient. This “Share” action does not only share objects with selected users, it also notifies them about the shared document and requires a confirmation for the process to be completed. The process can be also used as a template for further customization of sharing use cases, if they are to be used in projects.

Process

...

Start

To initiate this process, you must have Edit rights for the object type you want to share. Select the “Share” action, add the users or user groups you want to share this document with and write a comment:

Version 1

und

and 2

Image Modified

Version 3

Image Modified

To start the process, click OK. The custom sharing logic is contained within the BeforeStartEvent which gives the users or user groups specified Read rights for the shared document.

With version 3, the startform start form assures that the process can only be started of if the given Object given object type is shareable. If not, the OK button is inactive and the an error message at fieldbelow the check box Object type is shareable signals that condition will be displayed.

Inbox

Each member of the group receives the task 'Confirm sharing' in his inbox. 

...

Each recipient must accept the task, read the document and confirm the task when finished. When As soon as each user has confirmed, the process ends.

Language

This process model ist is available in English and German.

...

Download the zip file below. Extract the Sharing directory into the location of your enaio projects, which usually is ..\user\documents.

Open the project in the designer and copy the Sharing process model into your project. Then validate the process and if nothing is reported, deploy it.

Version 1

View file
nameSharing.zip
height150

Version 1 and 2

View file
nameSharing2.zip
height150

Version 1,2 and 3

View file
nameSharing3.zip
height150



The model looks like this:

Version 1

Image Modified

Version 2

Image Modified

Version 3

Image Modified

Version 1: The process model consists of one parallel container with an activity notice. This activity notice has to be confirmed by the recipients you specify at the beginning of the process.

Version 2: The initiator gets a notice as well when each addressed person has confirmed their task. And a deadline of two days in the future is set for the sharing confirmation task.

Version 3: The startform start form usually prevents the start, if the object type is not shareable. Otherwise the main acticity activity BeforeStartEvent script reacts on the condition and leads to a notification which the initiator gets into his inbox afterwards.

...

Code Block
languagejs
titleBeforeStartEvent Script
linenumberstrue
// set object title indirectly as process subject

$.variable('objecttitle').value = $.file.get()[0].title;

// Share the object with the organisational unit set in user usergroupgroup
// Take into account that this code will echangechange the current sharing values of the object type.
// TodoTo do: add this value to existing ones

var processFile = $.file.get();            // get all process file objects into the array processFile
var dmsObject = processFile[0];            // take the first element 

var putBody = {
		objects : [],
	 	organizationobjectstype : 'id',
	 	organizationobjects : []
};
putBody.objects.push( { itemid : dmsObject.id, type: dmsObject.type } );
putBody.organizationobjects.push($.variable('usergroup').value);    

$.http.post();
$.http.path('/service/dms/batch/addtoadditionalvisibility');
$.http.body(putBody);
$.http.execute();  


// extension of version 3: process result
if(!response.reason) {
    $.variable('canbeshared').value = true;
} else {
    // this condition will only occureoccur, if the startformstart form did not prevent the start in case of no non-shareable object types
	$.variable('canbeshared').value = false;
}

$.done();

...

Check Allow sharing. Please note that this feature will slighty slightly impact the performance of the system.

...

VersionDateAuthorDescription
3March 22, 2019Martin Bartonitz

6. Startform Start form prevents process start in case of none-shareable object types. The object type and the attribute shareable is shown in the startform start form as well.
7. Main activity BeforeEventScripts handles none-shareable object types as well. If the startfrom start form does not prevent the process start, the initiators get a notification in their inbox.

2March 21, 2019Martin Bartonitz

4. Notice for initiator about all confirmations
5. Deadline for the sharing notification including e-mail notification for reached deadline

1March 19, 2019Martin Bartonitz

Start with basics:

  1. Fill out group and comment during process start
  2. Set display rights in BeforeStartEvent of the mainactivitymain activity
  3. Inform each member of the group

...