After you have successfully installed the application, you should configure HTTP Integration. Open M-Files Admin
- In the left-side tree view, expand the desired connection to M-Files Server.
- In the left-side tree view, expand the Document Vaults node.
- Still, in the left-side tree view, expand the vault where you installed the connector and select Configurations.
- Expand Other Applications
- Expand Extension Kit
- Click on HTTP integration
Field Description #
| Field | Value | Description |
| Enabled | Yes/No | Specifies whether the module is in use. |
| Configuration mode | Simple/Advanced | Display simple or advanced configuration options for module. |
| Rule groups [n] > Group [n] | ||
| Name | Text | Specifies the name of the rule group. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] | ||
| Name | Text | Specifies the name of the rule. |
| Description | Text | Specifies rule description. |
| Enabled | Yes/No | Specifies whether the rule is in use. |
| Configuration mode | Simple/Advanced | Display simple or advanced configuration options for rule. |
| Trigger type | One of the following: • ObjectCreated • ObjectChanged • ObjectChangedSrare • ObjectEnteredState • OnComment • Scheduled • RunOnce • OnDeleted | Type of event that triggers the execution of this rule. ObjectCreated. If this option is selected, rule will be executed when source object is created. ObjectChanged. If this option is selected, rule will be executed when source object is changed. ObjectChangedState. If this option is selected, rule will be executed when source object has changed state. ObjectEnteredState. If this option is selected, rule will be executed when source object has entered a new state. OnComment. If this option is selected, rule will be executed when new comment is written to source object. OnDeleted. If this option is selected rule will be executed when source objet is deleted. |
| Error handling behaviour | One of the following: Continue SuspedTransaction | Defines how errors in event handlers are handled: Continue: log errors and continue execution. Suspend transaction: rollback transaction and show error message. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Monitored properties [n] > Property definition [n] | ||
| Property definition | Property definition | Displayed only when Trigger type is ObjectChanged. Optional filter by properties on source object whose change triggers rule execution. |
| Business critical | Yes/No | If set to true, rule will be logged in SEQ. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Trigger source | ||
| Object Type | Object Type | Object type of source object. |
| Class | Class | Class of source object. |
| Workflow | Workflow | Workflow of source object |
| State | State | Workflow state of source object. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Trigger source > Search filters [n] > Filter [n] | ||
| SearchConditions | Search condition | Optional additional conditions that source object needs to satisfy. Conditions inside a single filter are combined with AND, while multiple filters are combined with OR operator. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Trigger source > Look in | ||
| Look in | One of the following: • LatestObjVersion • AllObjVersions | When trying to match the above source conditions look in all object versions or only the latest one. Latest obj version. If this option is selected, the current object version must match the specified conditions for object to be treated as source for this rule. All obj versions. If this option is selected, any object version must match the specified conditions for object to be treated as source for this rule. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Vault search [n] > Status field condition | ||
| Field | One of the following: • ID • Type • Version | Specifies which type of field will be used in vault search. |
| Operator | One of the following: • = • != • < • > • <= • >= | Operator to apply in comparison of actual and expected property value. |
| Value | Integer | Expected property value. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Vault search [n] > Property condition [n] | ||
| Property | Property Definition | Specifies the property whose value will be checked. |
| Operator | One of the following: • = • != • < • > • <= • >= • Contains • Does not contain • Starts with • Does not start with | Specifies the property whose value will be checked. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n]> Search timeout (sec) | ||
| Search timeout | Integer | Search timeout in seconds. This timeout is applied to any search that’s executed inside operation. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Vault search | ||
| Search result type | One of the following: • Any • None | Displayed only if Advanced is selected as configuration mode] Expected search result type. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings | ||
| Mode | Simple/Advanced | Display simple or advanced configuration options for HTTP. |
| URL | URL | URL to invoke. |
| Method | One of the following: • GET • POST • PUT • DELETE | HTTP method to invoke. GET method is used to read information from server using given URL. PUT method is used to update an existing resource. POST is used to create subordinate resources. DELETE method is used to delete a resource specified by its URL. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Vault search sort | ||
| Sort by | Property definition | Displayed only if Advanced is selected as configuration module. Sort search results by property. |
| Sort direction | One of the following: • Ascending • Descending | Displayed only if Advanced is selected as configuration module. Specifies in which direction results can be shown. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings >Query parameters [n] > Query parameter [n] | ||
| Name | Text | Specifies parameter name. |
| Value type | One of the following: • Expression • Property | Controls how value is specified. Use Expression Value type to specify either static values or dynamic property expressions. Use Property Value type to specify either name or ID of lookup-based property value. |
| Value | Value | Display when Expression is Value type. Parameter value expression. |
| Hide missing values | Yes/No | Display when Expression is Value type. Hide missing values in dynamic property value expansion. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings >Query parameters [n] > Query parameter [n] > Value | ||
| Property | Property definition | Property value to use in Query parameter. |
| Attribute | One of the following: • ID • Name | Use ID or name of referenced property value. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings > Headers [n] > Header | ||
| Name | Text | HTTP header name. |
| Value type | One of the following: • Expression • Property | Controls how value is specified. Use of Expression Value type to specify either static values or dynamic property expressions. Use Property Value type to specify either name or ID of lookup-based property value. |
| Value | Value | Display when Expression is Value type. Parameter value expression. |
| Hide missing values | Yes/No | Display when Expression is Value type. Hide missing values in dynamic property value expansion. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings > Headers [n] > HTTP header [n] > Value | ||
| Property | Property definition | Display only if Property is selected as Value type. Property value to use in Query parameter. |
| Attribute | One of the following: • ID • Name | Display only if Property is selected as Value type. Use ID or name of referenced property value. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings | ||
| Body type | One of the following: • None • FormUrlEncoded • Json • Raw | Body type possibilities. |
| Json body | Json | Displayed only if Json is selected as Body type. HTTP Request body. |
| Raw body | Raw | Displayed only if Raw is selected as Body type. HTTP Request body |
| Value from | One of the following: • Source • VaulSearch | Specifies whether to resolve placeholder expressions from trigger source or from vault search. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > HTTP settings > Form URL encoded body [n] > Parameter [n] | ||
| Name | Text | Specifies a name of parameter. |
| Value type | One of the following: • Expression • Property | Controls how value is specified: Value type to specify either static values, or dynamic property expressions. Use Property Value to specify either name or ID of lookup-based property value. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Set properties [n] > TargetProperty [n] | ||
| Response transformation | One of the following: • None • JsonPath • XPath | Optional response transformation can be applied to HTTP response to extract or modify data that will be set as property value. |
| Result kind | One of the following: • Text • Number • Date • Other | Kind of results. |
| Result cardinality | Single/Array | Expected results cardinality. |
| Result M-Files property type | One of the following: • None • SimpleValue • ObjectID • ObjectName • ValueListItemID • ValueListItemName | Object type of results. |
| Result property | Property definition | Property to set. |
| Rule groups [n] > Group [n] > Rules [n] > Rule [n] > Set properties on | ||
| Set properties on | One of the following: • Source • VaultSearch | Object to set properties on. |
| Execution mode | One of the following: • EventHandler • Background | Choose when rule will be executed: • EventHandler: during object check in • Background: in background, after object has been checked in |
| Advanced settings | ||
| Time to wait (milliseconds) | Integer | Number of milliseconds to wait before executing any rule in background. |
| Number of retries | Integer | Maximum number of times COM errors are retried. |
| Retry interval (milliseconds) | Integer | Number of milliseconds to wait between retries. |
| Rule [n]> Rule groups [n] > Network credentials | Network credentials to send with request. Requires vault restart for changes to take effect. | |
| Autentification type | One of the following: Basic Digest NTLM Kerberos Negotiate | |
| Domain | Text | |
| Username | Text | |
| Password | Text |
