Forms Integration - ManageEngine

Overview

ManageEngine forms and request templates are incredibly powerful when combined with Moveworks’ Smart Forms. You can use them together to:

Permission Required

Moveworks will use the existing service account created in ManageEngine for fetching the forms from your instance.

Form Ingestion

Forms are referred to as request_templates under the Service Catalog in ManageEngine. Moveworks will ingest all request templates that are available in the Service Catalog.

Form Finding

To fetch all the request templates, we use the following API:
GET https://{manageengine_url}/api/v3/request_templates

To fetch additional details about a single request template, we use the following API:
GET https://{manageengine_url}/api/v3/request_templates/{request_template_id}

Form Filling

To create a request using the form fields of a request template, we use the following API:
POST https://{manageengine_url}/api/v3/requests , with the following body:

Body: x-www-form-urlencoded
input_data: {
              "request": {
                "template": {
                  "id": "{template_id}"
                },
                "requester": {
                  "id": "{requester_id}"
                }
                "request_template_task_ids": [],
                "subcategory": null,
                "item": null,
                "subject": "{subject_string}",
                "description": "{description_string}",
                "email_ids_to_notify": [],
                "created_time": {created_time},
                "due_by_time": {due_by_time},
                "attachments": []
              }
            }

Architecture

Untitled

Supported Field Types

IntegrationExternal Field TypesMoveworks Type
ManageEnginestringText: Multi-line
ManageEnginehtmlHTML
ManageEnginelookupDropdown: Single
ManageEnginebooleanBINARY
ManageEngineintText: Numerical
ManageEnginelongText: Numerical
ManageEnginedoubleText: Numerical
ManageEnginedatetimeDatetime
ManageEngineudfUnsupported
ManageEngineunknownUnsupported
ManageEnginegroupUnsupported

FAQ

Q: Does Moveworks support request templates that contain mandatory attachments?

A: No, not at the moment.

Q: Does Moveworks support request templates with no fields present in them other than the requester field?

A: No, not at the moment.

Q: Does Moveworks support request templates with fields that are present in the template but containing no metadata?

A: No, not at the moment.