EasyVista

This Integration is part of the EasyVista Pack.

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

1. Navigate to Settings > Integrations > Servers & Services .
2. Search for EasyVista.
3. 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
4. Click Test to validate the URLs and connection.

---

Commands

• Search: easy-vista-search

---

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"
}