IBM BPM, V8.0.1, All platforms > Create processes in IBM Process Designer > Modeling processes > Integrating with Enterprise Content Management (ECM) systems > Outbound interactions with Enterprise Content Management systems

Data mapping in Enterprise Content Management operations

Each operation requires that variables be mapped to the input and output fields. Using the auto-map function automatically creates and assigns variables of the right type to each field.

This section describes the input and output fields of each operation as specified in the Data Mapping tab of the Properties view.

• Add document to folder
• Cancel check-out document
• Check-in document
• Check-out document
• Copy document
• Create document
• Create folder
• Delete document
• Delete folder
• Get all document versions
• Get documents in folder
• Get document
• Get document content
• Get folder
• Get folder by path
• Get folder tree
• Get type definition
• Get type descendants
• Move document
• Move folder
• Remove document from folder
• Search
• Set document content
• Update document properties

In Process Designer, the Content Management Interoperability Services (CMIS) specification is used to determine which operation parameters are marked as optional. However, parameters that are marked as optional may actually be mandatory for some ECM systems, such as Microsoft SharePoint. You can consult your ECM system documentation to determine whether a parameter is optional or mandatory for your ECM system.

Add document to folder

Input:

• Document ID (ECMID): A unique identifier of a document object.
• Parent folder ID (ECMID): An identifier of the folder that will contain the document.
• Server name (String): The name of the server containing the document.

Output:

• No output is returned.

Cancel check-out document

Input:

• Private working copy document ID (ECMID): A unique identifier for the private working copy of the document object.
• Server name (String): The name of the server containing the original document.

Output:

• No output is returned.

Check-in document

Input:

• Private working copy document ID (ECMID): A unique identifier for the private working copy of the document object.
• Major (Boolean): (Optional) An indicator of the version of the checked-in document. If set to true then the document is a major version, which is the default.
• Content stream (ECMContentStream): (Optional) A stream of data containing the content of the document such as a word processing document or an image. Information about the ECMContentStream data type is found in the topic Work with document content.

  If you have made updates to a document and your ECM system is Microsoft SharePoint, you cannot pass the content stream parameter with the Check-in document operation.

  You must first pass the content stream parameter with the Set document content operation and then you can use the Check-in document operation.

• Check-in comment (String): (Optional) A comment about the checked-in document.
• Properties (ECMProperty []): (Optional) A set of named properties that can be in any order.
• Server name (String): The name of the server to contain the original document.

Output:

• Document ID (ECMID): A unique identifier of the document object.

Check-out document

Input:

• Document ID (ECMID): A unique identifier of a document object.
• Server name (String): The name of the server containing the document.

Output:

• Private working copy document ID (ECMID): A unique identifier for a private working copy of the document object.

Copy document

Input:

• Document ID (ECMID): A unique identifier of a document.
• Parent folder ID (ECMID): A unique identifier of the parent folder for the document.
• Name (String): Optional - A new name for the copied document. When the name is set, it overrides the name in the ECMProperty list (if specified).
• Versioning state (String): (Optional) A name that defines the version of the document. Valid values are:
  • major: (Default) The copied document is a major version. If versioning is disabled, the major value is not a valid versioning state and use the none value instead.
  • minor: The copied document is a minor version.
  • checkout: The copied document has a checked-out state.
  • none: The copied document cannot be versioned.

• Properties (ECMProperty []): (Optional) A set of named properties that can be in any order.
• Server name (String): The name of the server for the document.

Output:

• Document ID (ECMID): A unique identifier of the new document.

Create document

Input:

• Object type ID (ECMID): The ID of the object's type. It's base type must be a document.
• Folder ID (ECMID): An identifier of the folder for the document.
• Name (String): The name of the document.
• Versioning state (String): (Optional) A name that defines the version of the document. Valid values are:
  • major: (Default) The created document is a major version. If versioning is disabled, the major value is not a valid versioning state and use the none value instead.
  • minor: The created document is a minor version.
  • checkout: The created document has a checked-out state.
  • none: The created document cannot be versioned.

• Content stream (ECMContentStream): (Optional) A stream of data containing the content of the document such as a word processing document or an image. Information about the ECMContentStream data type is found in the topic Work with document content.
• Properties (ECMProperty []): (Optional) A set of named properties that can be in any order.
• Server name (String): The name of the server for the document.

Output:

• Document ID (ECMID): A unique identifier of the new document.

Create folder

Input:

• Object type ID (ECMID): The ID of the object's type. It's base type must be a folder.
• Parent folder ID (ECMID): The identifier of the parent folder.
• Name (String): The name of the folder.
• Properties (ECMProperty []): (Optional) A set of named properties that can be in any order.
• Server name (String): The name of the server for the folder.

Output:

• Folder ID (ECMID): A unique identifier of the new folder.

Delete document

Input:

• Document ID (ECMID): A unique identifier of a document object.

• All versions (Boolean): (Optional) States whether all versions of the document are to be deleted. The default is true.
• Server name (String): The name of the server containing the document.

Output:

• No output is returned.

Delete folder

Input:

• Folder ID (ECMID): A unique identifier of a folder object.
• Server name (String): The name of the server containing the folder.

Output:

• No output is returned.

Get all document versions

Input:

• Document ID (ECMID): A unique identifier of a document object.
• Server name (String): The name of the server containing the document.

Output:

• Documents (ECMDocument []): All versions of the document.

Get documents in folder

Input:

• Folder ID (ECMID): A unique identifier of the folder containing the documents.
• Server name (String): The name of the server containing the folder.

Output:

• Documents (ECMDocument []): The documents contained in the folder.

Get document

Input:

• Document ID (ECMID): A unique identifier of the document.
• Server name (String): The name of the server containing the document.

Output:

• Document (ECMDocument): The document object.

Get document content

Input:

• Document ID (ECMID): A unique identifier of a document.
• Server name (String): The name of the server containing the document.

Output:

• Content stream (ECMContentStream): The stream of data containing the content of the document. Information about the ECMContentStream data type is found in the topic Work with document content.

Get folder

Input:

• Folder ID (ECMID): A unique identifier of a folder.
• Server name (String): The name of the server containing the folder.

Output:

• Folder (ECMFolder): The folder object.

Get folder by path

Input:

• Path (String): The path to the folder. A "/" represents a root folder.
• Server name (String): The name of the server containing the folder.

Output:

• Folder (ECMFolder): The folder object.

Get folder tree

Input:

• Folder ID (ECMID): A unique identifier of a folder. It indicates the top level of the tree structure.
• Depth (Integer): (Optional) The number of levels of folders to return. The default, -1, returns all descendant folders.
• Server name (String): The name of the server containing the folder.

Output:

• Folders (ECMFolder []): The folder objects contained within the specified folder and its level of descendants.

Get type definition

Input:

• Object type ID (ECMID): The ID of an Object-Type.
• Server name (String): The name of the server containing the object type.

Output:

• Object type definition (ECMObjectTypeDefinition): The definition of the type. The ECMObjectTypeDefinition object contains the type metadata.

Get type descendants

Input:

• Object type ID (ECMID): (Optional) An ID of an Object-Type. If not specified, all root object types are returned.
• Depth (Integer): (Optional) The number of levels of the type hierarchy to return. the default, -1, returns all descendant types.

• Include property definitions (Boolean): (Optional) An indicator that specifies whether type properties are to be returned. The default, false, means that the properties of the type are not to be included.
• Server name (String): The name of the server containing the object type.

Output:

• Object type definitions (ECMObjectTypeDefinition []): An array of type definitions. The ECMObjectTypeDefinition object contains the type metadata.

Move document

Input:

• Document ID (ECMID): A unique identifier of a document.
• Target folder ID (ECMID): A unique identifier of the new folder for the document.
• Source folder ID (ECMID): A unique identifier of the present folder for the document.
• Server name (String): The name of the server containing the document and folders.

Output:

• No output is returned.

Move folder

Input:

• Folder ID (ECMID): The identifier of the document.
• Target folder ID (ECMID): The identifier of the new parent folder.
• Source folder ID (ECMID): The identifier of the old parent folder.
• Server name (String): The name of the ECM server that identifies the corresponding ECM repository.

Output:

• No output is returned.

Remove document from folder

Input:

• Document ID (ECMID): A unique identifier of a document.
• Parent folder ID (ECMID): (Optional) The identifier of the parent folder. If not specified, the document is removed from all folders.
• Server name (String): The name of the server containing the document and folder.

Output:

• No output is returned.

Search

Input:

• CMIS query (String): Text containing a Content Management Interoperability Services (CMIS) query. See Building a query for an Enterprise Content Management search operation.
• Return type (String): (Optional) An indicator that determines the type of items returned by the search result. The following types can be specified:
  • ECMSearchResultRow: (Default) An ECMSearchResultRow contains an array of values. The name is the query name of the Content Management Interoperability Service (CMIS) property used in the SELECT clause of the query or the name can be determined by introspection of the metadata.
  • Business object name: When the name of a business object type is specified then an instance of that type is returned. The properties returned by the search are mapped to the properties of the business object if their names match.

• Search all versions (Boolean): (Optional) An indicator that specifies which document versions are to be considered.

  If true then it considers the latest and older versions of the document or documents in the search. If false, which is the default, then only the latest version is returned.

• Max items (Integer): (Optional) An indicator that specifies the maximum number of items to return. The default, -1, states that the default number is taken from the ECM server.
• Skip count (Integer): (Optional) An indicator that specifies the number of potential items to be skipped over before returning any items. The default is 0.
• Server name (String): The name of the server containing the documents and folders.

Output:

• Search result (ECMSearchResult): An object containing a set of qualifying items. The content is different based on the value of the Return type input parameter. The default is an object of type ECMSearchResultRow.

Set document content

Input:

• Document ID (ECMID): A unique identifier of a document.
• Content stream (ECMContentStream): The stream of data containing the content for the document such as a word processing document or an image. Information about the ECMContentStream data type is found in the topic Work with document content.
• Server name (String): The name of the server containing the document.

Output:

• Document ID (ECMID): The unique identifier of a document.

The Set document content operation can only be used after running the Check-out document operation and before running the Check-in document operation.

Update document properties

Input:

• Document ID (ECMID): An identifier of a document object.
• Name (String): (Optional) A new name for the document.
• Properties (ECMProperty []): (Optional) A set of named properties that can be in any order.
• Server name (String): The name of the server containing the document.

Output:

• Document ID (ECMID): The unique identifier of the document.

Outbound interactions with Enterprise Content Management systems

Related tasks:
Building a service that integrates with an Enterprise Content Management system