Multiple times we have to attach docuemnt to BPMN process which is part of process execution or if its required to perform HumanTask operation. Here are the steps for attaching Document to BPMN process in jBPM 7.

• In the kie-workbench, in project settings goto deployment-descriptor file(kie-deployment-descriptor.xml) and define the marshalling strategy for document

• XML

• 1

<marshalling-strategies>

• 2

  <marshalling-strategy>

• 3

  <resolver>mvel</resolver>

• 4

  <identifier>new  org.jbpm.document.marshalling.DocumentCollectionImplMarshallingStrategy(new org.jbpm.document.marshalling.DocumentMarshallingStrategy())</identifier>

• 5

   <parameters/>

• 6

   </marshalling-strategy>

• 7

</marshalling-strategies>

• Define process variable of type org.jbpm.document.DocumentCollection.

'DocumentCollectionImplMarshallingStrategy’ and process variable of type _‘org.jbpm.document.DocumentCollection’ _support use of multiple documents in BPMN process, i.e at a time you can upload multiple documents while starting process/case execution or while performing task operation. For single document, we can use process variable of type ‘_o_rg.jbpm.document.Document’ with marshalling strategy ‘org.jbpm.document.marshalling.DocumentMarshallingStrategy’.

How to Pass a Document While Starting Process Execution

• If you are using kie-workbench/business-central console to start process then you can create process form where you will have to browse through the system and upload the document while starting process instance.

• If you want to use JAVA code to start it then you can use DocumentInstance API’s for same, like as:

• Java

• 1

DocumentInstance documentInstance = new DocumentInstance();

• 2

documentInstance.setIdentifier("myDoc");

• 3

documentInstance.setName("doc.pdf");

• 4

java.net.URL docURL = new java.net.URL("file:///path/to/uploadDoc.pdf");

• 5

documentInstance.setLink(String.valueOf(docURL));

• 6

documentInstance.setLastModified(java.util.Calendar.getInstance().getTime());

• 7

final InputStream inputStream = new java.io.FileInputStream("path/to/uploadDoc.pdf");

• 8

byte[] content = org.apache.commons.io.IOUtils.toByteArray(inputStream);

• 9

documentInstance.setContent(content);

• 10
• 11

Map<String, Object> processVars = new HashMap<String, Object>();

• 12

processVars.put("document_ProcessVariable", documentInstance);

• 13
• 14

long pid = processClient.startProcess(ContainerId, "DocuemntTest", processVars);

• When we send request to start process payload will look like as:

• JSON

• 1

{

• 2

  "document" : {

• 3

    "org.jbpm.document.service.impl.DocumentImpl":{

• 4

       "identifier":"myDoc.pdf",

• 5

       "name":"Doc.pdf",

• 6

       "link":"",

• 7

       "size": 53,

• 8

       "lastModified" : 45,

• 9

       "content":"......."

• 10

    }

• 11

  },

• 12

"docName":"uploadDoc.pdf",

• 13

"comments": "your comments"

• 14

}

• 15

`

Like This Article? Read More From DZone

#document #jbpm core engine api #jbpm features #jbpm workflow example