EasyVista Service Manager
EasyVista Service Manager is an IT service management solution that automates and streamlines IT service delivery.
EasyVista Service Manager is a comprehensive IT Service Management (ITSM) platform that streamlines service delivery and support. This connector enables seamless integration with Swimlane Turbine, allowing users to automate the creation, retrieval, and updating of tickets within EasyVista. By leveraging this integration, Swimlane Turbine users can enhance their ITSM processes, reduce manual effort, and improve response times, ultimately leading to more efficient incident management and service delivery.
The EasyVista Service Manager connector integrates with Swimlane Turbine to create, view and update tickets.
Prerequisites
Before you can use the EasyVista Service Manager connector for Turbine, you'll need access to the EasyVista API. This requires the following:
- HTTP Bearer authentication using the following parameters:
- URL: The endpoint URL for accessing EasyVista Service Manager.
- Token Name: The bearer token used for authentication.
- HTTP Basic authentication using the following parameters:
- URL: The endpoint URL for accessing EasyVista Service Manager.
- Username: The username for authenticating with EasyVista Service Manager.
- Password: The password associated with the username for authentication.
Capabilities
This connector provides the following capabilities:
- Get Ticket
- Post Ticket
- Update Ticket
Notes
- EasyVista Service Manager Rest API Documentation can be found: API Documentation
- In the case of Post Ticket, you must use at least one of the JSON objects below in the body of the HTTP request.
- The subject can be specified with catalog_guid (use in preference) or catalog_code.
- If catalog_guid is wrong, the process stops without reading catalog_code.
Additional Documentation
Configurations
HTTP Basic Authentication
Authenticates using username and password.
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
username | Username | string | Required |
password | Password | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
HTTP Bearer Authentication
Authenticates using bearer token.
Configuration Parameters
Parameter | Description | Type | Required |
|---|---|---|---|
url | A URL to the target host. | string | Required |
token | Token | string | Required |
verify_ssl | Verify SSL certificate | boolean | Optional |
http_proxy | A proxy to route requests through. | string | Optional |
Actions
Get Ticket
Obtain detailed information for a specified ticket in EasyVista Service Manager, including incidents, service requests, change requests, investment requests, problems, and events. Requires the RFC number as a path parameter.
Endpoint
- URL: /requests/{{rfc_number}}
- Method: GET
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
path_parameters.rfc_number | string | Required | Ticket number |
parameters.fields | string | Optional | Parameters for the Get Ticket action |
parameters.formatDate | string | Optional | Parameters for the Get Ticket action |
Input Example
{"parameters":{"fields":"available_field_1,comment","formatDate":"/M/Y ==> last_update_format: Friday/Nov/2018"},"path_parameters":{"rfc_number":"S161123_000034"}}
Output
Parameter | Type | Description |
|---|---|---|
status_code | number | HTTP status code of the response |
status | string | Status value |
HREF | string | Output field: HREF |
ANALYTICAL_CHARGE_PATH | string | Output field: ANALYTICAL_CHARGE_PATH |
AVAILABLE_FIELD_1 | string | Output field: AVAILABLE_FIELD_1 |
AVAILABLE_FIELD_2 | string | Output field: AVAILABLE_FIELD_2 |
AVAILABLE_FIELD_3 | string | Output field: AVAILABLE_FIELD_3 |
AVAILABLE_FIELD_4 | string | Output field: AVAILABLE_FIELD_4 |
AVAILABLE_FIELD_5 | string | Output field: AVAILABLE_FIELD_5 |
AVAILABLE_FIELD_6 | string | Output field: AVAILABLE_FIELD_6 |
BUDGET_EFFECTIVE | string | Output field: BUDGET_EFFECTIVE |
BUDGET_ID | string | Unique identifier |
BUDGET_PLANNED | string | Output field: BUDGET_PLANNED |
CAN_BE_DUPLICATED | string | Output field: CAN_BE_DUPLICATED |
CLICK_2_GET_INSTALL_RESULT | string | Result of the operation |
COMMENT | object | Output field: COMMENT |
COMMENT.HREF | string | Output field: COMMENT.HREF |
CREATION_DATE_UT | string | Output field: CREATION_DATE_UT |
DELAY | string | Output field: DELAY |
DEPARTMENT_PATH | string | Output field: DEPARTMENT_PATH |
DESCRIPTION | object | Output field: DESCRIPTION |
DESCRIPTION.HREF | string | Output field: DESCRIPTION.HREF |
DYNAMIC_DETAILS | object | Output field: DYNAMIC_DETAILS |
DYNAMIC_DETAILS.HREF | string | Output field: DYNAMIC_DETAILS.HREF |
EFFECTIVE_CHANGE_DATE_END | string | Output field: EFFECTIVE_CHANGE_DATE_END |
Output Example
{"status_code":200,"status":"OK","response_headers":{},"json_body":{"HREF":"https://{your_server}/api/v1/{your_account}/requests/S161123_000034","ANALYTICAL_CHARGE_PATH":"","AVAILABLE_FIELD_1":"","AVAILABLE_FIELD_2":"","AVAILABLE_FIELD_3":"","AVAILABLE_FIELD_4":"","AVAILABLE_FIELD_5":"","AVAILABLE_FIELD_6":"","BUDGET_EFFECTIVE":"","BUDGET_ID":"","BUDGET_PLANNED":"","CAN_BE_DUPLICATED":"0","CLICK_2_GET_INSTALL_RESULT":"","COMMENT":{"HREF":"https://{your_server}/api/v1/{your_account}/requests/comm...
Post Ticket
Create a new ticket in EasyVista Service Manager, including incidents, service requests, change requests, investment requests, problems, and events.
Endpoint
- URL: /requests
- Method: POST
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
requests | array | Optional | Parameter for Post Ticket |
requests.catalog_guid | string | Optional | Identifier for the subject of the ticket |
requests.Catalog_Code | string | Optional | Identifier/Code for the subject of the ticket |
requests.AssetID | string | Optional | Unique identifier |
requests.AssetTag | string | Optional | Parameter for Post Ticket |
requests.ASSET_NAME | string | Optional | Name of the resource |
requests.Urgency_ID | string | Optional | Identifier of the urgency level |
requests.Severity_ID | string | Optional | Identifier of the severity level |
requests.External_reference | string | Optional | Parameter for Post Ticket |
requests.Phone | string | Optional | Phone number of the requestor |
requests.Requestor_Identification | string | Optional | Unique identifier |
requests.Requestor_Mail | string | Optional | Parameter for Post Ticket |
requests.Requestor_Name | string | Optional | Name of the resource |
requests.Location_ID | string | Optional | Unique identifier |
requests.Location_Code | string | Optional | Parameter for Post Ticket |
requests.Department_ID | string | Optional | Unique identifier |
requests.Department_Code | string | Optional | Parameter for Post Ticket |
requests.Recipient_ID | string | Optional | Unique identifier |
requests.Recipient_Identification | string | Optional | Unique identifier |
requests.Recipient_Mail | string | Optional | Parameter for Post Ticket |
requests.Recipient_Name | string | Optional | Name of the resource |
requests.Origin | string | Optional | Identifier of the origine (Examples are Phone, Email) |
requests.Description | string | Optional | Description of the object |
requests.ParentRequest | string | Optional | Parameter for Post Ticket |
requests.CI_ID | string | Optional | Unique identifier |
Input Example
{"json_body":{"requests":[{"Catalog_Code":"46","catalog_guid":"44","AssetID":"","AssetTag":"","ASSET_NAME":"","Urgency_ID":"1","Severity_ID":"40","External_reference":"","Phone":"93-63 - 65-23","Requestor_Identification":"","Requestor_Mail":"[email protected]","Requestor_Name":"","Location_ID":"","Location_Code":"","Department_ID":"","Department_Code":"","Recipient_ID":"","Recipient_Identification":"","Recipient_Mail":"[email protected]","Recipient_Name":"","Origin":"3","Description":"Request created via REST API","ParentRequest":"","CI_ID":"","CI_ASSET_TAG":"","CI_NAME":"","SUBMIT_DATE":"","Impact_ID":8,"Title":""}]}}
Output
Parameter | Type | Description |
|---|---|---|
response_code | number | Output field: response_code |
status | string | Status value |
HREF | string | Output field: HREF |
Output Example
{"response_code":201,"status":"Created","response_headers":{},"json_body":{"HREF":"https://{your_server}/api/v1/{your_account}/requests/I161019_000003"}}
Update Ticket
Modify a specified ticket in EasyVista Service Manager, including incident, service request, change request, investment request, problem, and event. Requires the rfc_number as a path parameter.
Endpoint
- URL: /requests/{{rfc_number}}
- Method: PUT
Input
Argument Name | Type | Required | Description |
|---|---|---|---|
path_parameters.rfc_number | string | Required | Ticket number |
ANALYTICAL_CHARGE_ID | string | Optional | Unique identifier |
asset_id | number | Optional | Unique identifier |
ASSET_SERIAL | string | Optional | Parameter for Update Ticket |
ASSET_TAG | string | Optional | Parameter for Update Ticket |
AVAILABLE_FIELD_1 | string | Optional | Parameter for Update Ticket |
CI | string | Optional | Parameter for Update Ticket |
CI_ID | number | Optional | Unique identifier |
CI_SERIAL | string | Optional | Parameter for Update Ticket |
Comment | string | Optional | Parameter for Update Ticket |
CONTINUITY_PLAN_ID | string | Optional | Unique identifier |
Description | string | Optional | Parameter for Update Ticket |
External_reference | string | Optional | Parameter for Update Ticket |
IMPACT_ID | number | Optional | Unique identifier |
KNOWN_PROBLEMS_ID | number | Optional | Unique identifier |
NET_PRICE_CUR_ID | string | Optional | Unique identifier |
ORIGIN_TOOL_ID | number | Optional | Unique identifier |
OWNER_ID | string | Optional | Unique identifier |
OWNING_GROUP_ID | string | Optional | Unique identifier |
RELEASE_ID | string | Optional | Unique identifier |
RENTAL_NET_PRICE_CUR_ID | string | Optional | Unique identifier |
REQUEST_ORIGIN_ID | string | Optional | Unique identifier |
REQUESTOR_PHONE | string | Optional | Parameter for Update Ticket |
ROOT_CAUSE_ID | string | Optional | Unique identifier |
SUBMIT_DATE_UT | string | Optional | Parameter for Update Ticket |
Input Example
{"json_body":{"ANALYTICAL_CHARGE_ID":"","asset_id":27618,"ASSET_SERIAL":"MGTRDF","ASSET_TAG":"10164R","AVAILABLE_FIELD_1":"available_field_1_test","CI":"SQL-RDB_IT*","CI_ID":1,"CI_SERIAL":"KD78QGJYU","Comment":"Here, your comment","CONTINUITY_PLAN_ID":"CP01","Description":"Here, your description","External_reference":"external_ref_test","IMPACT_ID":1,"KNOWN_PROBLEMS_ID":1,"NET_PRICE_CUR_ID":"EUR","ORIGIN_TOOL_ID":1,"OWNER_ID":"Leblanc, Fred","OWNING_GROUP_ID":"Desktop USA","RELEASE_ID":"REL01","RENTAL_NET_PRICE_CUR_ID":"EUR","REQUEST_ORIGIN_ID":"Fax","REQUESTOR_PHONE":"93-63-65-23","ROOT_CAUSE_ID":"Virus","SUBMIT_DATE_UT":"07/22/2017","SYSTEM_ID":"Supervisor","URGENCY_ID":1},"path_parameters":{"rfc_number":"S161123_000034"}}
Output
Parameter | Type | Description |
|---|---|---|
response_code | number | Output field: response_code |
status | string | Status value |
HREF | string | Output field: HREF |
Output Example
{"response_code":201,"status":"OK","response_headers":{},"json_body":{"HREF":"https://{your_server}/api/v1/{your_account}/requests/I161019_000003"}}
Response Headers
Header | Description | Example |
|---|---|---|
Content-Type | The media type of the resource | application/json |
Date | The date and time at which the message was originated | Thu, 01 Jan 2024 00:00:00 GMT |