Flint provides out-of-the-box or ready to use workflows for ManageEngine Operations. Here are the details of workflows/Flintbits for  ManageEngine-

Flintbox nameLocationSSH Flintbits
flint-utilhttps://github.com/getflint/flint-util.gitflint-util > manageengine > operation

Available Flintbits

Perform all standard application operations available through the ManageEngine, Some of them are listed below:

ManageEngine available Flintbits

  • add_request.rb
  • update_request.rb
  • close_request.rb
  • assign_request.rb
  • get_request.rb
  • pickup_request.rb
  • add_resolution.rb
  • add_note.rb
  • add_worklog.rb

Add_request

To add new requests to ManageEngine service desk.

Input and output JSON for the Add_request operation

This section illustrates the Flintbit Input and output for Add_request operation.

Sample Input JSON for the Add_request operation
{
    "connector_name":"manageenginesdp",
    "requester":"Nikhil",
    "subject":"Added by Nikhil",
    "description":"Add to Network request",
    "requesttemplate":"Unable to browse",
    "requestType":"Incident",
    "priority":"High",
    "group":"Network",
    "technician":"Anurag Dubey",
    "level":"Tier 1",
    "status":"Open"
}

Flintbit input elements for the Add_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requesterThe requester who requested the requesttrue
subjectSubject of the requestfalse
descriptionDescription of the requestfalse
requesttemplatePassword associated with the database.false
requestTypeType of the requestfalse
priorityPriority given to the requestfalse
groupGroup to which the request belongsfalse
technicianTechnician assigned to the requestfalse

level

Level of the requestfalse

status

Status of the requestfalse

service

Service category to which the request belongsfalse
Sample JSON output for the Add_request operation
{  
   "meta":{  
      "job-id":"job-e663da06-d110-489d-854f-6bc2e18ff79f",
      "exit-code":0,
      "context":"flint-util:manageengine:add_request.rb",
      "message":"success",
      "timeout":60000,
      "timestamp":1469703105871,
      "status":"complete",
      "content-type":"application/json",
      "username":"admin"
   },
   "output":{  
      "result":{  
         "operation ":{  
            "result ":{  
               "message ":"Request details added successfully. ",
               "status ":"Success "
            },
            "Details ":{  
               "URGENCY ":" ",
               "IMPACTDETAILS ":" ",
               "WORKORDERID ":"51 ",
               "REQUESTTYPE ":"Incident ",
               "MODE ":" ",
               "SLA ":"Low SLA ",
               "APPROVAL_STATUS ":" ",
               "PRIORITY ":"Low ",
               "RESOLVEDTIME ":"0 ",
               "SUBCATEGORY ":" ",
               "RESPONSEDUEBYTIME ":"-1 ",
               "EDITING_STATUS ":"0 ",
               "GROUP ":"Network ",
               "STATUS ":"Open ",
               "DUEBYTIME ":"1469785683730 ",
               "DESCRIPTION ":"Add to request ",
               "CATEGORY ":" ",
               "FR_DUETIME ":"-1 ",
               "RESPONDEDTIME ":"0 ",
               "SERVICE ":" ",
               "CLOSURECODE ":" ",
               "TECHNICIAN ":"Anurag Dubey ",
               "CREATEDBY ":"Anurag Dubey ",
               "REQUESTTEMPLATE ":"Default Request ",
               "ISVIPUSER ":"No ",
               "SITE ":" ",
               "TECHNICIAN_LOGINNAME ":"anurag ",
               "EDITORID ":"null ",
               "YETTOREPLYCOUNT ":" ",
               "REQUESTER ":"Vijay ",
               "TIMESPENTONREQ ":"0hrs 0min ",
               "ASSET ":" ",
               "DEPARTMENT ":" ",
               "LEVEL ":"Tier 1 ",
               "ITEM ":" ",
               "IMPACT ":" ",
               "COMPLETEDTIME ":"0 ",
               "FCR ":"false ",
               "IS_CATALOG_TEMPLATE ":"false ",
               "SUBJECT ":"Added by Vijay ",
               "CREATEDTIME ":"1469702883730 ",
               "SHORTDESCRIPTION ":"Add to request ",
               "CLOSURECOMMENTS ":" "
            }
         }
      }
   }
}

Update_request

To update the request by unique request_id

Input and output JSON for the Update_request operation

This section illustrates the Flintbit Input and output for Update_request operation.

Sample Input JSON for the Update_request operation
{
    "connector_name":"manageenginesdp",
    "requestid":41,
    "requester":"Vrarun",
    "subject":"Added by Varun",
    "description":"Add to request",
    "requesttemplate":"browse",
    "requestType":"Incident",
    "priority":"low",
    "group":"Network",
    "technician":"Anurag Dubey",
    "level":"Tier 1",
    "status":"Open"
}

Flintbit input elements for the Update_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
requesterThe requester who requested the requestfalse
subjectSubject of the requestfalse
descriptionDescription of the requestfalse
requesttemplatePassword associated with the database.false
requestTypeType of the requestfalse
priorityPriority given to the requestfalse
groupGroup to which the request belongsfalse
technicianTechnician assigned to the requestfalse

level

Level of the requestfalse

status

Status of the requestfalse

service

Service category to which the request belongsfalse
Sample JSON output for the Update_request operation
{
  "meta": {
    "job-id": "job-d4936dad-441e-4f7b-92c2-f30c814caa7a",
    "exit-code": 0,
    "context": "flint-util:manageengine:update_request.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469703346350,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
   "output":{  
      "result":{  
         "operation ":{  
            "result ":{  
               "message ":"Request details edited successfully. ",
               "status ":"Success "
            },
            "Details ":{  
               "URGENCY ":" ",
               "IMPACTDETAILS ":" ",
               "WORKORDERID ":"51 ",
               "REQUESTTYPE ":"Incident ",
               "MODE ":" ",
               "SLA ":"Low SLA ",
               "APPROVAL_STATUS ":" ",
               "PRIORITY ":"Low ",
               "RESOLVEDTIME ":"0 ",
               "SUBCATEGORY ":" ",
               "RESPONSEDUEBYTIME ":"-1 ",
               "EDITING_STATUS ":"0 ",
               "GROUP ":"Network ",
               "STATUS ":"Open ",
               "DUEBYTIME ":"1469785683730 ",
               "DESCRIPTION ":"Add to request ",
               "CATEGORY ":" ",
               "FR_DUETIME ":"-1 ",
               "RESPONDEDTIME ":"0 ",
               "SERVICE ":" ",
               "CLOSURECODE ":" ",
               "TECHNICIAN ":"Anurag Dubey ",
               "CREATEDBY ":"Anurag Dubey ",
               "REQUESTTEMPLATE ":"Default Request ",
               "ISVIPUSER ":"No ",
               "SITE ":" ",
               "TECHNICIAN_LOGINNAME ":"anurag ",
               "EDITORID ":"null ",
               "YETTOREPLYCOUNT ":" ",
               "REQUESTER ":"mayank ",
               "TIMESPENTONREQ ":"0hrs 0min ",
               "ASSET ":" ",
               "DEPARTMENT ":" ",
               "LEVEL ":"Tier 1 ",
               "ITEM ":" ",
               "IMPACT ":" ",
               "COMPLETEDTIME ":"0 ",
               "FCR ":"false ",
               "IS_CATALOG_TEMPLATE ":"false ",
               "SUBJECT ":"Updated ",
               "CREATEDTIME ":"1469702883730 ",
               "SHORTDESCRIPTION ":"Add to request ",
               "CLOSURECOMMENTS ":" "
            }
         }
      }
   }
}

Close_request

To close the request by unique request_id

Input and output JSON for the Close_request operation

This section illustrates the Flintbit Input and output for Close_request operation.

Sample Input JSON for the Close_request operation
{
    "connector_name":"manageenginesdp",
    "requestid":17
}
Flintbit input elements for the Close_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
closecommentThe closing commentfalse
closeAcceptedTo close a service request valid values is "Accepted"false
Sample JSON output for the Close_request operation
{  
   "meta":{  
      "job-id":"job-649d0256-e10d-4d2a-94e4-d49301ac0cb8",
      "exit-code":0,
      "context":"flint-util:manageengine:close_request.rb",
      "message":"success",
      "timeout":60000,
      "timestamp":1469703485992,
      "status":"complete",
      "content-type":"application/json",
      "username":"admin"
   },
   "output":{  
      "result":{  
         "operation ":{  
            "result ":{  
               "message ":"Request closed successfully. ",
               "status ":"Success "
            },
            "Details ":{  
               "URGENCY ":" ",
               "IMPACTDETAILS ":" ",
               "WORKORDERID ":"51 ",
               "REQUESTTYPE ":"Incident ",
               "MODE ":" ",
               "SLA ":"Low SLA ",
               "APPROVAL_STATUS ":" ",
               "PRIORITY ":"Low ",
               "RESOLVEDTIME ":"1469703263271 ",
               "SUBCATEGORY ":" ",
               "RESPONSEDUEBYTIME ":"-1 ",
               "EDITING_STATUS ":"0 ",
               "GROUP ":"Network ",
               "STATUS ":"Closed ",
               "DUEBYTIME ":"1469785683730 ",
               "DESCRIPTION ":"Add to request ",
               "CATEGORY ":" ",
               "FR_DUETIME ":"-1 ",
               "RESPONDEDTIME ":"0 ",
               "SERVICE ":" ",
               "CLOSURECODE ":" ",
               "TECHNICIAN ":"Anurag Dubey ",
               "CREATEDBY ":"Anurag Dubey ",
               "REQUESTTEMPLATE ":"Default Request ",
               "ISVIPUSER ":"No ",
               "SITE ":" ",
               "TECHNICIAN_LOGINNAME ":"anurag ",
               "EDITORID ":"null ",
               "YETTOREPLYCOUNT ":" ",
               "REQUESTER ":"mayank ",
               "TIMESPENTONREQ ":"0hrs 6min ",
               "ASSET ":" ",
               "DEPARTMENT ":" ",
               "LEVEL ":"Tier 1 ",
               "ITEM ":" ",
               "IMPACT ":" ",
               "COMPLETEDTIME ":"1469703263271 ",
               "FCR ":"false ",
               "IS_CATALOG_TEMPLATE ":"false ",
               "SUBJECT ":"Updated ",
               "CREATEDTIME ":"1469702883730 ",
               "SHORTDESCRIPTION ":"Add to request ",
               "CLOSURECOMMENTS ":" "
            }
         }
      }
   }
}

Assign_request

To assign the request by request_id to other technician

Input and output JSON for the Assign_request operation

This section illustrates the Flintbit Input and output for Assign_request operation.

Sample Input JSON for the Assign_request operation
{
    "connector_name":"manageenginesdp",
    "requestid":7,
    "technicianid":"2"
}
Flintbit input elements for the Assign_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
technicianidId of the techniciantrue
Sample JSON output for the Assign_request operation
{  
   "meta":{  
      "job-id":"job-d9b18f03-551a-424a-879b-864dbfbdd8cb",
      "exit-code":0,
      "context":"flint-util:manageengine:assign_request.rb",
      "message":"success",
      "timeout":60000,
      "timestamp":1469703707239,
      "status":"complete",
      "content-type":"application/json",
      "username":"admin"
   },
   "output":{  
      "result":{  
         "operation ":{  
            "result ":{  
               "message ":"Request assigned successfully for request 7 ",
               "status ":"Success "
            }
         }
      }
   }
}

Get_request

To view the request details by unique request id

Input and output JSON for the Get_request operation

This section illustrates the Flintbit Input and output for Get_request operation.

Sample Input JSON for the Get_request operation
{
    "connector_name":"manageenginesdp",
    "requestid":22
}
Flintbit input elements for the Get_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
Sample JSON output for the Get_request operation
{
  "meta": {
    "job-id": "job-127c02ad-901b-4c2a-a0fe-b27bc67f98e9",
    "exit-code": 0,
    "context": "flint-util:manageengine:get_request.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469702805376,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
  "output": {
    "result": {
      "URGENCY": "",
      "IMPACTDETAILS": "",
      "WORKORDERID": "22",
      "REQUESTTYPE": "Incident",
      "MODE": "E-Mail",
      "SLA": "High SLA",
      "APPROVAL_STATUS": "",
      "PRIORITY": "High",
      "RESOLVEDTIME": "0",
      "SUBCATEGORY": "",
      "RESPONSEDUEBYTIME": "-1",
      "EDITING_STATUS": "0",
      "GROUP": "",
      "STATUS": "Open",
      "DUEBYTIME": "1469016982905",
      "DESCRIPTION": "For testing request-update functioning",
      "CATEGORY": "Internet",
      "FR_DUETIME": "-1",
      "RESPONDEDTIME": "0",
      "SERVICE": "Hardware",
      "CLOSURECODE": "",
      "TECHNICIAN": "$DEPT_HEAD$",
      "CREATEDBY": "Anurag Dubey",
      "REQUESTTEMPLATE": "Default Request",
      "ISVIPUSER": "No",
      "SITE": "",
      "TECHNICIAN_LOGINNAME": "",
      "EDITORID": "null",
      "YETTOREPLYCOUNT": "",
      "REQUESTER": "Arjun",
      "TIMESPENTONREQ": "0hrs 0min",
      "ASSET": "",
      "DEPARTMENT": "",
      "LEVEL": "Tier 3",
      "ITEM": "",
      "IMPACT": "",
      "COMPLETEDTIME": "0",
      "FCR": "false",
      "IS_CATALOG_TEMPLATE": "false",
      "SUBJECT": "Testing update service request",
      "CREATEDTIME": "1469013382905",
      "SHORTDESCRIPTION": "For testing request-update functioning",
      "CLOSURECOMMENTS": ""
    }
  }
}

Pickup_request

To Pickup the request by request_id

Input and output JSON for the Pickup_request operation

This section illustrates the Flintbit Input and output for Pickup_request operation.

Sample Input JSON for the Pickup_request operation
{
    "connector_name":"manageenginesdp",
    "request-id":3
}
Flintbit input elements for the Pickup_request operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
Sample JSON output for the Pickup_request operation
{
  "meta": {
    "job-id": "job-a8316c8b-109b-4afc-9ee4-7ce281ea70e5",
    "exit-code": 0,
    "context": "flint-util:manageengine:pick_request.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469704714110,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
  "output": {
    "result": {
      "operation": {
        "result": {
          "message": "Request picked successfully for request 3",
          "status": "Success"
        }
      }
    }
  }
}

Add_Resolution

To add a resolution to the request by request_id

Input and output JSON for the Add_Resolution operation

This section illustrates the Flintbit Input and output for Add_Resolution operation.

Sample Input JSON for the Add_Resolution operation
{
    "connector_name":"manageenginesdp",
    "requestid":37,
    "resolutiontext":"Solution for request is here"
}
Flintbit input elements for the Add_Resolution operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
resolutiontextSome resolution text to addtrue
Sample JSON output for the Pickup_request operation
{
  "meta": {
    "job-id": "job-3ca1b129-ddf9-471e-8414-2d8ef4873148",
    "exit-code": 0,
    "context": "flint-util:manageengine:add_resolution.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469713166118,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
  "output": {
    "result": {
      "operation": {
        "result": {
          "message": "Resolution added successfully for request 37",
          "status": "Success"
        }
      }
    }
  }
}

Add_Note

To Add note to request by unique id

Input and output JSON for the Add_Note operation

This section illustrates the Flintbit Input and output for Add_Note operation.

Sample Input JSON for the Add_Note operation
{
    "connector_name":"manageenginesdp",
    "request-id":25,
    "ispublic":"true",
    "notestext":"Text to be added as note"
}
Flintbit input elements for the Add_Note operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
requestidId of the requesttrue
notetextText to be added as notetrue
ispublicUsed to represent whether note is shown to allfalse
Sample JSON output for the Add_Note operation
 {
  "meta": {
    "job-id": "job-f820e7af-8ad2-4200-af97-1963f505b728",
    "exit-code": 0,
    "context": "flint-util:manageengine:add_note.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469773514305,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
  "output": {
    "result": {
      "operation": {
        "result": {
          "message": "Note added successfully",
          "status": "Success"
        },
        "Details": [
          {
            "WORKORDERID": "25",
            "NOTESTEXT": "Text to be added as note",
            "USERID": "10",
            "ISPUBLIC": "true",
            "USERNAME": "Anurag Dubey",
            "NOTESID": "603",
            "NOTESDATE": "1469773514289"
          }
        ]
      }
    }
  }
}

Add_Worklog

To add new worklog for the given input.

Input and output JSON for the Add_Worklog operation

This section illustrates the Flintbit Input and output for Add_Worklog operation.

Sample Input JSON for the Add_Worklog operation
{
    "connector_name":"manageenginesdp",
    "associated_entity":"request",
    "associated_entity_id": 37,
    "description": "Add to worklog request",
    "name":"Howard Stern"
}
Flintbit input elements for the Add_Worklog operation
ParameterDescriptionrequired
connector_nameName of the ManageEngine Connector to be configured.true
associated_entityModule to which the worklog belongs.true
associated_entity_idId of the entity to which the worklog belongs.true
nameContains name and/or id of the technician to whom the worklog is assigned.true
start_timeDate and time to start Worklog.false
end_timeDate and time to End Worklog.false
Sample JSON output for the Add_Worklog operation
 {
  "meta": {
    "job-id": "job-a00ae234-3e2a-4fcd-b948-bb8057c86a29",
    "exit-code": 0,
    "context": "flint-util:manageengine:add_worklog.rb",
    "message": "success",
    "timeout": 60000,
    "timestamp": 1469778225647,
    "status": "complete",
    "content-type": "application/json",
    "username": "admin"
  },
  "output": {
    "result": {
      "response_status": {
        "messages": [
          {
            "type": "Success",
            "message": "Worklog added successfully"
          }
        ],
        "id": 1213,
        "status": "Success"
      },
      "worklog": {
        "created_time": {
          "display_value": "Jul 29, 2016 01:13 PM",
          "value": 1469778225641
        },
        "associated_entity": "request",
        "end_time": {
          "display_value": "Jul 29, 2016 01:13 PM",
          "value": 1469778225629
        },
        "description": "Add to Network request",
        "other_charge": "0.0",
        "technician": {
          "name": "Howard Stern",
          "id": 8
        },
        "task_id": null,
        "inc_nonOperationalHours": false,
        "total_charge": "0.0",
        "created_by": {
          "name": "Anurag Dubey",
          "id": 10
        },
        "tech_charge": "0.0",
        "start_time": {
          "display_value": "Jul 29, 2016 01:13 PM",
          "value": 1469778225629
        },
        "total_time_spent": "0 Hrs 0 Mins ",
        "associated_entity_id": "37",
        "id": "1213"
      }
    }
  }
}

On this page: