Professional Documents
Culture Documents
of changes
1
Document history
Version Date Author Changes made
1.0 10/31/2008 Laurent SEYMAN Document creation
1.1 10/12/2009 Laurent SEYMAN Addition of AM_LOCATION and new template
1.2 7/18/2011 Laurent SEYMAN Historization of new fields
1.3 8/2/2012 Laurent SEYMAN Update and new template
1.4 8/12/2012 Laurent SEYMAN Update for EasyVista 2013
This document presents the list of fields, the content of which can be historized in EasyVista.
2
Index
A. Definition....................................................................................9
B. Actions (AM_ACTION).............................................................10
B.1. Change the support in charge of the action...........................................10
C. Assets (AM_ASSET)................................................................11
C.1. Asset location change...............................................................................11
C.2. Automatic renewal change........................................................................11
C.3. Change CI Name / Network identifier.......................................................11
C.4. Change CI next version.............................................................................11
C.5. Change CI status........................................................................................11
C.6. Change CI version......................................................................................12
C.7. Change discard date..................................................................................12
C.8. Change last physical inventory date........................................................12
C.9. Change of available field 16..................................................................12
C.10. Change number of max. installations......................................................12
C.11. Change of pipeline status.........................................................................12
C.12. Change SLA of availability........................................................................12
C.13. Change scheduled end of contract..........................................................13
C.14. Change SLA................................................................................................13
C.15. Change start date of contract...................................................................13
C.16. Contract duration change.........................................................................13
C.17. Contract notice change.............................................................................13
C.18. Departments ASSET change....................................................................13
C.19. Due date expiration change......................................................................14
C.20. End of warranty change............................................................................14
C.21. Equipment configuration change.............................................................14
C.22. Equipment installation date change........................................................14
C.23. Equipment model change.........................................................................14
C.24. Equipment status change.........................................................................14
C.25. Equipment tag change...............................................................................15
3
C.26. License description change......................................................................15
C.27. License start date change.........................................................................15
C.28. License version change............................................................................15
C.29. Managed as CI............................................................................................15
C.30. Managed as service...................................................................................15
C.31. Next renewal decision change..................................................................15
C.32. Serial number change................................................................................16
C.33. Users asset change..................................................................................16
H. Departments (AM_DEPARTMENT).........................................18
H.1. Change default cost center of department..............................................18
H.2. Change department manager...................................................................18
H.3. Change department name.........................................................................18
4
I. Employees (AM_EMPLOYEE).................................................19
I.1. Change employee number........................................................................19
I.2. Change of available field 16..................................................................19
I.3. Employee arrival date change..................................................................19
I.4. Employee cellular number change...........................................................19
I.5. Employee cost center change..................................................................19
I.6. Employee department change..................................................................19
I.7. Employee departure date change............................................................20
I.8. Employee e-mail change...........................................................................20
I.9. Employee function change.......................................................................20
I.10. Employee IT correspondent change........................................................20
I.11. Employee location change........................................................................20
I.12. Employee login change.............................................................................20
I.13. Employee phone number change............................................................20
I.14. Employee supplier change........................................................................20
I.15. Employee VIP change................................................................................21
I.16. Last name employee change....................................................................21
J. Groups (AM_GROUP)..............................................................21
J.1. Change the service contract of the group...............................................21
K. Locations (AM_LOCATION)....................................................21
K.1. Change address 1......................................................................................21
K.2. Change address 2......................................................................................21
K.3. Change city.................................................................................................21
K.4. Change fax..................................................................................................22
K.5. Change location name...............................................................................22
K.6. Change of phone........................................................................................22
K.7. Change of ZIP code....................................................................................22
5
L. Shared elements (AM_SHARED_USE)...................................22
L.1. Add/delete a cost center............................................................................22
L.2. Add/delete other equipment......................................................................22
L.3. Add/delete other user................................................................................22
M. Suppliers (AM_SUPPLIER)......................................................23
M.1. Change the country for the supplier........................................................23
R. Invoices (EP_BILL)..................................................................24
R.1. Accounting date change...........................................................................24
R.2. Change Accounting number.....................................................................24
R.3. Change Invoice date..................................................................................25
R.4. Change Invoice number............................................................................25
R.5. Change Invoice status...............................................................................25
R.6. Change of available field 16..................................................................25
R.7. Change of Internal invoice number..........................................................25
R.8. Change of manager....................................................................................25
R.9. Change of Supplier....................................................................................25
S. Orders (EP_ORDER)................................................................25
S.1. Analytical cost allocation change............................................................26
S.2. Change of Invoicing department..............................................................26
S.3. Change of Delivery location......................................................................26
S.4. Change of Order manager.........................................................................26
6
S.5. Change of Supplier....................................................................................26
S.6. Closing date change..................................................................................26
S.7. Scheduled delivery date change..............................................................26
S.8. Send date change......................................................................................27
V. Questionnaires (SD_QUESTION_RESULT)............................30
V.1. Change the response to a question.........................................................30
W. Incidents/Requests/Events/Problems (SD_REQUEST)........30
W.1. Change of external call..............................................................................30
W.2. Change of Request manager....................................................................31
W.3. Change of Request status.........................................................................31
7
W.4. Change of support group of request.......................................................31
W.5. Change project name.................................................................................31
W.6. Request urgency change..........................................................................31
W.7. Requests root cause change...................................................................31
W.8. Request service management catalogue change...................................31
Z. Triggers.....................................................................................33
8
A. Definition
The history of changes allows tracking the changes made on the data of EasyVista tables. This process is based on triggers, as
description of which is mentioned at the end of the current document. The history configuration is made via the menu
Parameters/Rules for History Generation of the Administration module.
Assets (AM_ASSET) contains equipment, licenses, contracts and CIs (Configuration Items)
Departments (AM_DEPARTMENT)
Employees (AM_EMPLOYEE)
Locations (AM_LOCATION)
Invoices (EP_BILL)
Orders (EP_ORDER)
Questionnaires (SD_QUESTION_RESULT)
Incidents/Requests (SD_REQUEST)
Actions (AM_ACTION)
Groups (AM_GROUP)
Suppliers (AM_SUPPLIER)
Projects (SD_REQUEST)
By default the Rules for the creation of history menu, only displays fields for which the history of changes is currently
activated. In order to historize other fields, the default filter has to be deactivated (Fields in history), the full list of fields will be
visible so. Check the box of the field to be kept in history before saving the changes with . All changes must be made before
selecting the next page.
9
Once made, the changes will be visible on the related tab:
History of changes (equipment, licenses, contracts, configuration items, orders, incidents catalog, requests
catalogs, consumable catalog, known errors, incidents, actions, employees, groups, invoices, change requests,
investment requests, continuity plans, budget allocations, Projects, Release projects, Service levels)
Note: History of changes is triggered by manual operations or data integration. Changes made through wizards are
taken into account, as well.
B. Actions (AM_ACTION)
The table of actions contains all the information relative to the actions of incidents, service requests, change requests,
problems. No field in this table is historized by default. The changes made are visible on the Life Cycle tab displayed in the
upper part of the action form.
10
C. Assets (AM_ASSET)
This table contains equipment, licenses or configuration items data. This is the reason why some history parameters are used
by many elements such as the location change whereas others are specific to an article type such as the license start date.
11
Recording is triggered by changing the value contained in the field CI_VERSION (Current Version) visible only on the form for a
Configuration Item. Changing the CI version can be made with the Version: Update wizard after use of the Version: Prepare
wizard. These wizards can be used from the list or, directly, on the form of a Configuration Item.
12
C.13. Change scheduled end of contract
The value of this field is not historized by default
Recording is triggered by changing the date contained in the field SCHEDULED_END (Scheduled End) visible only on the form
for a contract. This field must not be confused with the end date, which is used for archiving a contract.
13
to it are payable at the beginning of the period. If it is payable in arrears, amounts due in relation to it are payable at the end of
the period.
14
C.25. Equipment tag change
The value of this field is historized by default.
Recording is triggered by changing the value contained in the field ASSET_TAG present on the forms for items of equipment
(Asset Tag), licenses (license number), contracts (contract number) or configuration items (CI number).
C.29. Managed as CI
The value of this field is not historized by default
Changing the date contained in the field IS_CI triggers recording. This field is not displayed on the CI form.
16
E.1. Connection/Disconnection of equipment
Recording is triggered by inserting a link between two items of equipment, between a contract and an item of equipment,
between a license and an item of equipment or between a license and a contract, which has the effect of changing the value of
the field PARENT_ASSET_ID.
17
G. Installation type catalogue
(AM_CONFIGURATION)
The installation type catalogue contains all the models of installation types to be related to equipment. The changes made are
visible on the History of changes tab displayed in the upper part of the form.
H. Departments (AM_DEPARTMENT)
The table of departments contains all the information relative to departments defined in the EasyVista database. No field in this
table is historized by default. The changes made are visible on the History of changes tab displayed in the upper part of the
departments form.
I. Employees (AM_EMPLOYEE)
The table of employees contains all the information relative to users defined in the EasyVista database. No field in this table is
historized by default. The changes made are visible on the History of changes tab displayed in the upper part of the employee's
form..
18
I.1. Change employee number
Recording is triggered by changing the value contained in the field IDENTIFICATION (Employee Number) storing the
employees corporate number.
19
I.9. Employee function change
Recording is triggered by changing the value contained in the field FUNCTION_ID (Function) storing the employees job
function.
20
J. Groups (AM_GROUP)
The groups directory contains the list of groups to which actions can be assigned. No field in this table is historized by default.
The changes made are visible on the History of changes tab displayed in the upper part of the groups form.
K. Locations (AM_LOCATION)
The table of locations contains all the information relative to locations defined in the EasyVista database. No field in this table is
historized by default. The changes made are visible on the History of changes tab displayed in the upper part of the locations
form.
21
K.7. Change of ZIP code
Recording is triggered by changing the value contained in the field ZIP_CODE (Zip Code).
M. Suppliers (AM_SUPPLIER)
The suppliers directory contains the list of suppliers for equipment, licenses, contracts, consumables The changes made are
visible on the History of changes tab displayed in the upper part of the suppliers form.
22
N. Continuity plans (CMDB_CONTINUITY_PLAN)
A continuity plan is an organizational document: It consists of an action plan listing necessary procedures and systems for
continuity or the restoration of an interrupted or disrupted service. No field in this table is historized by default. The changes
made are visible on the History of changes tab displayed in the upper part of the continuity plans form.
23
Q. Budget allocations
(EP_ANALYTICAL_CHARGE)
No field in this table is historized by default. The changes made are visible on the History of changes tab displayed in the
upper part of the budget allocation form.
R. Invoices (EP_BILL)
The table of invoices contains all the information relative to recorded bills. According to its status (Pending or Closed), the
displayed fields will be editable or not. All fields present in this table are historized by default. The changes made are visible on
the History of changes tab displayed in the upper part of the form.
24
R.6. Change of available field 16
Changing the value contained in the fields AVAILABLE_FIELD_1 to AVAILABLE_FIELD_6 triggers recording. These fields are
not visible on the standard interface, but may be displayed via the "edit" mode.
S. Orders (EP_ORDER)
The table of orders contains all the information relative to orders. No field in this table is historized by default. The changes
made are visible on the Life Cycle tab displayed in the upper part of the order form.
25
S.4. Change of Order manager
Recording is triggered by changing the value contained in the field VALIDATOR_ID (Person in charge). The person in charge of
an order is, by default, the person who entered this order.
27
T.9. Service management catalogue impact change
Recording is triggered by changing the value contained in the field IMPACT_ID (Impact). The incident impact is inherited from
the catalogue. Combined with the urgency, it allows a priority to be defined for an incident/request.
28
U.5. Known errors urgency change
Recording is triggered by changing the value contained in the field URGENCY_ID (Urgency). This is for information only.
V. Questionnaires (SD_QUESTION_RESULT)
The table of answers to questions contains all the changes made on the answers of a questionnaire. All fields present in this
table are historized by default.
29
W. Incidents/Requests/Events/Problems
(SD_REQUEST)
The table of incidents/requests/events contains all the information relative to the service management activities. No field in this
table is historized by default. The changes made are visible on the Life Cycle or History tabs displayed in the upper part of the
incident/request/event/problem form. In spite of their labels, most of the parameters listed below are also used for incidents.
30
W.7. Requests root cause change
Recording is triggered by changing the value contained in the field ROOT_CAUSE_ID (Root cause) visible on the Solution tab
above the incident form. The requests are not associated with a real cause. The assignment of a real cause to an incident takes
place when its report is entered. The real cause of an incident may be pre-specified provided it is associated with the topic of
the incident in the corresponding catalogue. It can be modified when the report is entered.
history list by creating new change tracking rules. To do this, we use the "add" button . On the mask that is displayed, we
enter the following items:
The added field is automatically activated. In the above example, the change of value will be visible on the History of changes
tab above the Employee form:
31
Z. Triggers
Movements are historized using triggers associated with tables whose fields may be historized. Here is the list of triggers by
table:
For Assets: AM_ASSET_TRIG_HISTORY
For Attributes: AM_ASSET_CHARACTERISTICS_TRIG_HISTORY_NEW
For Asset links: AM_ASSET_LINKS_TRIG_HISTORY_NEW
For Configuration items links: CONFIGURATION_ITEM_LINK_TRIG_HISTORY_NEW
For Employees: AM_EMPLOYEE_TRIG_HISTORY
For Locations: AM_LOCATION_TRIG_HISTORY
For Departments: AM_DEPARTMENT_TRIG_HISTORY
For Shared elements: AM_SHARED_USE_TRIG_HISTORY_NEW
For Invoices: EP_BILL_TRIG_HISTORY
For Orders: EP_ORDER_TRIG_HISTORY
For the Incidents/requests catalogue: SD_CATALOG_TRIG_HISTORY
For Known Errors: SD_KNOWN_PROBLEMS_TRIG_HISTORY
For Incidents/Requests/Events/Problems/Projects: SD_REQUEST_TRIG_HISTORY
For Questionnaires: SD_QUESTION_RESULT_TRIG_HISTORY_NEW
For Actions: AM_ACTION_TRIG_HISTORY_NEW
For Asset catalog: AM_CATALOG_TRIG_HISTORY_NEW
For Installations types: AM_CONFIGURATION_TRIG_HISTORY_NEW
For Groups: AM_GROUP_TRIG_HISTORY_NEW
For Suppliers: AM_SUPPLIER_TRIG_HISTORY_NEW
For Continuity Plans: CMDB_CONTINUITY_PLAN_TRIG_HISTORY_NEW
For Release projects: CMDB_RELEASE_TRIG_HISTORY_NEW
For Budget allocations: EP_ANALYTICAL_CHARGE_TRIG_HISTORY_NEW
For Service levels: SD_SL_AGREEMENT_TRIG_HISTORY_NEW
Note: These triggers are generated "on the fly", meaning that they are dynamically created when at least one field is
historically recorded on the table in question. Modifying a trigger with tools such as SQL Server Management Studio is
prohibited. Furthermore, existing triggers are overwritten during EasyVista version changes.
32