You are browsing the documentation for iTop 3.0 which is not the current version.

Consider browsing to iTop 3.2 documentation

Actions

The actions are used to modify objects in iTop. Actions can be executed:

  • from a list of objects (Refer to the Chapter Managing Lists), in which case the selected action is applied to all the objects in the list
  • from the details of an object

The actions buttons are only displayed to users with sufficient rights to execute them.

The standard actions in iTop are:

Other Actions

New

This action is used to create a new object of the same type as the object currently displayed. When clicking on “Create…”, the creation form of the object is displayed.

By default this action is displayed all the time as a Creation icon icon, and so is no more in the drop-down.

Some of the fields may be pre-filled automatically, depending on the context. For example, if the context is set to the Demo organization, when you click on Create to create a new Person, a form will be displayed with the organization, prefilled to *Demo*.

Modify

This action displays the form to update an object. Both creation and modification forms are very similar, except that when modifying an object, the values in the form are prefilled with the current values of the object being modified.

By default this action is displayed all the time as a Edit icon icon, and so is no more in the drop-down.

Delete

The Delete action is usually located in the Other Actions popup menu.

This action is used to permanently delete an object from iTop. In order to guarantee the consistency and integrity of the data in iTop, deleting an object may also affect other objects. Depending on the rules defined in the data model, other objects may be modified or deleted automatically, or the deletion may not be possible until some depending object is deleted manually.

In any case, a confirmation screen listing all the impacted objects, is displayed.

Delete confirmation page

For example, if you want to delete the whole organization, the following confirmation screen is displayed:

Object Deletion Disabled

In this particular case, iTop detects that there are several Persons belonging to this Organization. Since the definition of the data model requires that a Person must belong to an Organization and that the deletion of a Person is not automatic, the Organization cannot be deleted while there are Persons belonging to it.

The same logic applies for all other objects which must have an organization.

  • This is why the Delete! button is grayed out.
  • In order to delete the Organization, all objects in error must be processed first, either by deleting them or by assigning them to a different Organization.

Relations

Depending on the type of object displayed, additional Relations menus are available. For example, for most Configuration Items, two relations are defined: “Impacts” and “Depends On”. In this case, two extra menus are available in the Other Actions popup menu.

"Impacts..." popup menu action

When selecting such an action, the page showing the relation is displayed:

Impact diagram for a Server

  • You can use the checkboxes with the icons at the top, to filter the display (just press Refresh after updating the selection).
  • Move the mouse over an object to display a tooltip showing additional information (plus a link to its details)
  • Click and drag onto an object to re-arrange the chart
  • Click and drag in the background to move the whole chart
  • The + and - buttons, as well as the slider at the top right of the chart (and the mouse wheel) are used to adjust the zoom level
  • The Grouping threshold defines the minimum number of similar objects (same type, same status) for creating a group which replaces the individual objects in the chart, in order to simplify the chart. When changing this value, click Refresh to re-compute the chart with the new grouping level
By right-clicking on an object in the chart, you can go back to its details by selecting Details from the popup menu. For groups of objects, the Details menu displays the list of the elements within this group.

"Details"

Context

  • The Additional context drop-down list defines how Tickets are taken into account when computing and displaying the chart (just press Refresh after updating the selection).
  • When an object in the chart is linked to (at least) one of the context tickets, a small icon representing the type of the ticket (Incident, Change) is displayed next to the icon of the object. The list of tickets linked to a given object is available in the tooltip for this object.

"Context"

  • Open changes context correspond to 'Changes' which are neither closed nor rejected, are generating an outage and do impact some of the displayed CIs (Impact != 'Not impacted')
  • Recent changes (72h) context correspond to 'Changes which are closed since less than 3 days, have generated an outage and did impact some of the CIs displayed.
  • Open incidents context correspond to Incidents which are neither closed nor resolved and do impact some of the CIs displayed.

Exporting the chart as a PDF document

To export the chart as a PDF document, use the Toolkit menu at the top-right of the chart: Export as PDF menu

This displays the following dialog box:

Export as PDF dialog-box

The export generates a printable PDF document where the first page contains the chart (as laid out on the screen), with a legend on the left and an optional comment area at the bottom. The list of objects can be added as a set of tables (one per class of object) on additional pages.

The following options are available:

  • Page format: the dimensions of the PDF document: either A3, A4 or Letter.
  • Page orientation: either horizontally (Landscape) or vertically (Portrait)
  • Title: a title for the document, to be added as a header at the top of each page
  • Comment: A free text area that will be integrated (if not empty) on the first page of the document, below the chart.
  • Include the list of objects: if checked, the list of the objects in the chart will be added as a big table as additional pages in the PDF document.
The creation of the PDF document can be very slow when Include the list of objects is ticked and the list of objects to export is large (> 100 objects).

eMail

The email action is located in the Other Actions popup menu.

This action creates a new eMail message containing a link to the selected object in iTop. The email is created and sent from the client mail program configured on the end-user's computer.

The recipient of the message will receive an URL link to navigate to the details of the object, but she/he must have an iTop account to view the information, since she/he will be prompted to authenticate for viewing the page.

CSV Export

The CSV export of one object is similar to the CSV export of a list, except that there is only one line of data in the resulting export.

Excel Export

The Excel export of one object is similar to the Excel export of a list, except that there is only one row of data in the resulting export.

Printer Friendly Version

This action opens, in another tab of your browser, a Printer Friendly version of the details of the current object. This version of the details is optimized for printing: all the tabs are listed as sections inside the page, most of the surrounding elements (menu, search bar…) are removed.

Moreover, the page can also be configured by hiding/showing some of its sections before printing, by clicking on the Eye icons.

 Configure the print output

To print the page you can use the Print button located at the top of the page, but you can also get a WYSIWYG preview before printing by using the Print Preview accessed from the browser menu.
The banner at the top of the page is not visible in the print output.

Ticket Transitions

Some objects managed in iTop follow a specific life-cycle that correspond to a specific process. This is the case, for example, for the different tickets managed in iTop (incident tickets, change management tickets, etc.). For these objects, additional actions are available, corresponding to process execution workflow.

Life-cycle actions are available either as extra menu items in the Transitions popup menu:

Menu for Ticket Specific Actions

Or directly as extra buttons in the modification form for the object:

Ticket Specific Actions buttons

In the latter case, clicking on the Wait for Approval button is strictly equivalent to clicking on Apply to save the current modifications of the object, then selecting Wait for Approval from the Other Actions drop-down menu.

The actions available on each object depend on:

  • The life-cycle of the object (each type of object may have a different life-cycle)
  • The current state of the object (not all actions are possible in all states)
  • The user-rights as defined by her/his profile(s): some actions are restricted to a given profile.

Object specific actions

Extensions can brings specific actions on particular objects.

Here are examples brought by User action configurator extension:

Person Specific ActionsTicket Specific Actions buttons

3_0_0/user/actions.txt · Last modified: 2022/01/21 16:52 (external edit)
Back to top
Contact us