EasyVista

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 Demisto

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