EasyVista
EasyVista Service Manager manages the entire process of designing, managing and delivering IT services.
IT Services · EasyVista
Details
| ID | EasyVista |
|---|---|
| Provider | EasyVista |
| Category | IT Services |
| From Version | 5.0.0 |
| Docker Image | demisto/python3:3.12.13.10116658 |
| Supported Modules | Agentix XSIAM |
README
Overview
Use the EasyVista integration to search for incidents and requests, and retrieve their status and information.
This integration was integrated and tested with EasyVista v2016.1.300.2. For more information, visit the EasyVista REST API documentation.
Use Cases
Search for incidents and requests.
Prerequisites
The account you use must be the account Service Manager used, for example, 50004: Production base; 50005: Sandbox base.
Configure EasyVista on Cortex XSOAR
- Navigate to Settings > Integrations > Servers & Services.
- Search for EasyVista.
- Click Add instance to create and configure a new integration instance.
- Name: a textual name for the integration instance
- Server URL (example: https://your_company.easyvista.com)
- Username
- Do not validate server certificate (not secure)
- Use system proxy settings
- Click Test to validate the URLs and connection.
Commands
Search: easy-vista-search
Search for Incidents and requests.
Basic Command
!easy-vista-search
Input
| Parameter | Description |
| asset |
Asset to search for (example: requestor) |
| attribute |
Attribute to search for (example: last_name) |
| value |
Value to search (example: "Morley, Gaby") |
| request |
Integrated request of assets, attributes, and values (example: requestor.last_name:"Morley, Gaby"). This parameter replaces the other parameters given separately. |
Context Output
| Path | Description |
| EasyVista.Records.CatalogRequest.CatalogRequestPath | Catalog request path |
| EasyVista.Records.CatalogRequest.Code | Catalog request code |
| EasyVista.Records.CatalogRequest.SdCatalogId | SD catalog ID |
| EasyVista.Records.CatalogRequest.TitleEn | Request title |
| EasyVista.Records.Department.DepartmentCode | Department code |
| EasyVista.Records.Department.DepartmentEn | Department name |
| EasyVista.Records.Department.DepartmentId | Department ID |
| EasyVista.Records.Department.DepratmentLabel | Department label |
| EasyVista.Records.Department.DepartmentPath | Department path |
| EasyVista.Records.KnownProblem.KnownProblemPath | Known problem path |
| EasyVista.Records.KnownProblem.KnownProblemsId | Known problems ID |
| EasyVista.Records.KnownProblem.KpNumber | Number of known problems |
| EasyVista.Records.KnownProblem.QuestionEn | Known problem question |
| EasyVista.Records.Location.City | City |
| EasyVista.Records.Location.LocationCode | Location code |
| EasyVista.Records.Location.LocationEn | Location name |
| EasyVista.Records.Location.LocationId | Location ID |
| EasyVista.Records.Location.LocationPath | Location path |
| EasyVista.Records.Recipient.BeginOfContract | Date of beginning of contract |
| EasyVista.Records.Recipient.CellularNumber | Cellular number of recipient |
| EasyVista.Records.Recipient.DerpartmentPath | Department path of recipient |
| EasyVista.Records.Recipient.EMail | Email address of recipient |
| EasyVista.Records.Recipient.EmployeeId | Employee ID of recipient |
| EasyVista.Records.Recipient.LastName | Last name of recipient |
| EasyVista.Records.Recipient.LocationPath | Location of recipient |
| EasyVista.Records.Recipient.PhoneNumber | Phone number of recipient |
| EasyVista.Records.Status.StatusEn | Status of request |
| EasyVista.Records.Status.StatusGuid | Request GUID |
| EasyVista.Records.Status.StatusId | Request ID |
Command Example
!easy-vista-search asset=requestor attribute=last_name value="Morley, Gaby"
or
!easy-vista-search request=requestor.last_name:"Morley, Gaby"
Raw Output
{
"CATALOG_REQUEST":{
"CATALOG_REQUEST_PATH":"Incidents/Equipment/Desktop*/Diskette Drive",
"CODE":"70",
"SD_CATALOG_ID":"4710",
"TITLE_EN":"Diskette Drive"
},
"COMMENT":{
},
"DEPARTMENT":{
"DEPARTMENT_CODE":"",
"DEPARTMENT_EN":"Customer Support",
"DEPARTMENT_ID":"22",
"DEPARTMENT_LABEL":"",
"DEPARTMENT_PATH":"Sales/Direct/Customer Support",
},
"KNOWN_PROBLEM":{
"KNOWN_PROBLEMS_ID":"",
"KNOWN_PROBLEM_PATH":"",
"KP_NUMBER":"",
"QUESTION_EN":""
},
"LOCATION":{
"CITY":"",
"LOCATION_CODE":"",
"LOCATION_EN":"337",
"LOCATION_ID":"7091",
"LOCATION_PATH":"Europe/United Kingdom/Plymouth/Bldg 1/Floor 03/337"
},
"MAX_RESOLUTION_DATE_UT":"2011-03-15T20:00:00.000-04:00",
"RECIPIENT":{
"BEGIN_OF_CONTRACT":"1988-04-01",
"CELLULAR_NUMBER":"788-853-418",
"DEPARTMENT_PATH":"Sales/Direct/Customer Support",
"EMPLOYEE_ID":"14412",
"E_MAIL":"test@example.com",
"LAST_NAME":"Ernst, Walter",
"LOCATION_PATH":"Europe/United Kingdom/Plymouth/Bldg 1/Floor 03/337",
"PHONE_NUMBER":"+441442200573"
},
"REQUESTOR":{
"BEGIN_OF_CONTRACT":"1988-04-01",
"CELLULAR_NUMBER":"788-853-418",
"DEPARTMENT_PATH":"Sales/Direct/Customer Support",
"EMPLOYEE_ID":"14412",
"E_MAIL":"test@example.com",
"LAST_NAME":"Ernst, Walter",
"LOCATION_PATH":"Europe/United Kingdom/Plymouth/Bldg 1/Floor 03/337",
"PHONE_NUMBER":"+441442200573"
},
"RFC_NUMBER":"000216",
"STATUS":{
"STATUS_EN":"Reopened",
"STATUS_GUID":"{67FC30D6-06DC-4B75-976F-69BE4CE6BDDD}",
"STATUS_ID":"16"
},
"SUBMIT_DATE_UT":"2012-03-12T20:00:00.000-04:00"
}
Configuration parameters
server— Server URL (required)account— Account (required)credentials— Credentialsinsecure— Trust any certificate (not secure)proxy— Use system proxy settings
Commands (1)
-
easy-vista-searchThis method allows a list of incidents / requests (service, change, investment) to be obtained.
commonfields: id: EasyVista version: -1 sectionorder: - Connect - Collect name: EasyVista display: EasyVista category: IT Services provider: EasyVista description: EasyVista Service Manager manages the entire process of designing, managing and delivering IT services. configuration: - display: Server URL additionalinfo: e.g. https://your_company.easyvista.com name: server defaultvalue: "" type: 0 required: true section: Connect - display: Account name: account defaultvalue: "" type: 0 required: true section: Connect - display: Credentials name: credentials defaultvalue: "" type: 9 required: false section: Connect - display: Trust any certificate (not secure) name: insecure type: 8 required: false section: Connect - display: Use system proxy settings name: proxy type: 8 required: false section: Connect script: script: '' type: python subtype: python3 commands: - name: easy-vista-search arguments: - name: asset description: Asset to search, e.g. requestor (This argument is mandatory if the "request" argument is not given). - name: attribute description: Attribute to search, e.g. last_name (This argument is mandatory if the "request" argument is not given). - name: value description: Value to search, e.g. "Morley, Gaby" (This argument is mandatory if the "request" argument is not given). - name: request description: Integrated request of assets, attributes and values, e.g. requestor.last_name:"Morley, Gaby" (This argument replaces the other arguments given each one separately). outputs: - contextPath: EasyVista.Records.CatalogRequest.CatalogRequestPath description: Catalog Request Path. type: string - contextPath: EasyVista.Records.CatalogRequest.Code description: Catalog Request Code. type: string - contextPath: EasyVista.Records.CatalogRequest.SdCatalogId description: SD Catalog ID. type: string - contextPath: EasyVista.Records.CatalogRequest.TitleEn description: Request Title. type: string - contextPath: EasyVista.Records.Department.DepartmentCode description: Department Code. type: string - contextPath: EasyVista.Records.Department.DepartmentEn description: Department Name. type: string - contextPath: EasyVista.Records.Department.DepartmentId description: Department ID. type: string - contextPath: EasyVista.Records.Department.DepratmentLabel description: Department Label. type: string - contextPath: EasyVista.Records.Department.DepartmentPath description: Department Path. type: string - contextPath: EasyVista.Records.KnownProblem.KnownProblemPath description: Known Problem Path. type: string - contextPath: EasyVista.Records.KnownProblem.KnownProblemsId description: Known Problems ID. type: string - contextPath: EasyVista.Records.KnownProblem.KpNumber description: Number of Known Problems. type: string - contextPath: EasyVista.Records.KnownProblem.QuestionEn description: Known problem question. type: string - contextPath: EasyVista.Records.Location.City description: City. type: string - contextPath: EasyVista.Records.Location.LocationCode description: Location Code. type: string - contextPath: EasyVista.Records.Location.LocationEn description: Location En. type: string - contextPath: EasyVista.Records.Location.LocationId description: Location ID. type: string - contextPath: EasyVista.Records.Location.LocationPath description: Location Path. type: string - contextPath: EasyVista.Records.Recipient.BeginOfContract description: Begin Of Contract Date. type: string - contextPath: EasyVista.Records.Recipient.CellularNumber description: Cellular number of recipient. type: string - contextPath: EasyVista.Records.Recipient.DerpartmentPath description: Department path of recipient. type: string - contextPath: EasyVista.Records.Recipient.EMail description: Email address of recipient. type: string - contextPath: EasyVista.Records.Recipient.EmployeeId description: Employee ID of recipient. type: string - contextPath: EasyVista.Records.Recipient.LastName description: Last name of recipient. type: string - contextPath: EasyVista.Records.Recipient.LocationPath description: Location of recipient. type: string - contextPath: EasyVista.Records.Recipient.PhoneNumber description: Phone number of recipient. type: string - contextPath: EasyVista.Records.Status.StatusEn description: Status of request. type: string - contextPath: EasyVista.Records.Status.StatusGuid description: Request GUID. type: string - contextPath: EasyVista.Records.Status.StatusId description: Request ID. type: string description: This method allows a list of incidents / requests (service, change, investment) to be obtained. dockerimage: demisto/python3:3.12.13.10116658 tests: - No tests fromversion: 5.0.0