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

Consider browsing to iTop 3.1 documentation

Display and Modification of an object

The details of an object are always displayed in the same manner in iTop, as shown below:

Details of a Contact

The title area contains the icon representing the given class (or type) of the object followed by the class (here “Person”), followed by the actual name of the object.

The blue tab “Search” above the title toggles the display of the search form for this class of objects.

The actions allowed for this object are listed, as orange buttons, at the top-right of the page. The most frequent actions are displayed as direct buttons, the remaining actions are accessible through the popup menu “Other Actions…”.

The tab “Properties” displays the actual properties of the object.

The tab “History” displays the history of all modifications performed on this object (who modified what and when).

Depending on the class of the object displayed (for example for Tickets), an extra tab “Notifications” may be available, showing all the notifications sent in response to events on this object.

The other tabs display the relationships between the selected object and other objects in the database.

For example, the tab “Teams” displays all the teams for which the selected person is a member of the team. The tab “Tickets” displays the tickets for which the selected person is the requester.

Modification of an object

To modify an object, click on the “Modify…” action from the details of the object (The same action is also available on a list containing only one object).

The form to modify an object is quite similar to its details, except that the fields are editable. For example, the form to modify a Person looks like as shown below:

Form for modifying an Person

Note the small red exclamation mark icon (Exclamation Mark) next to the “First Name”. This icon appears when a mandatory field is left blank, or when a field does not follow the expected format for the field (for example for an email address). The modifications to the object can only be saved (using the “Apply” button) if all the fields are properly filled.

For some of the fields, the value is not a free-text but instead must be picked from a drop-down list:

Drop Down List

The “tree button” (Tree Button) is available for values that are organized as a hierarchy.

The “plus button” (Plus) is a shortcut to create an object and add it into the list. The button is only available for users who are allowed to create this type of object. For example when creating or modifying a ticket, clicking on the (Plus) button of the field “Caller” displays - as a popup dialog - the form to create a new Person:

New Person Popup Dialog

When the number of possible values for a given field exceeds a configured value (by default 50), the drop-down list is replaced by an autocomplete field, as shown below:

Autocomplete input

Type at least three letters to trigger the search and pick from the list of objects matching the typed letters, or use the magnifier button (Magnifier Button) to open a searchdialog:

Popup dialog to search for Persons

The search dialog lists all the objects, but you can use the form at the top to narrow the search before selecting an object and clicking Ok to return to the main form.

Handling Tickets Attachments

Attachments allow to upload a document (any file or image) into iTop and “attach” it to a given object in iTop. This is very similar to email attachments.

Attachments are related to the object they are attached to, and will be deleted when the object is deleted from iTop. If you want to upload files into iTop and have them “attached” to several objects in iTop, then consider creating “Document” objects. Refer to File documents.

To manage the attachments to a Ticket, click on the “Attachments” tab while creating or modifying a Ticket:

Ticket Attachments tab

To upload a new attachment, click on the “Browse…” button and select the desired file. Note that the maximum size for a single uploaded file is displayed next to the “Browse…” button. If a file is bigger than this value, it cannot be uploaded into iTop. This maximum size depends on several settings on the server and can be changed only by an administrator.

Once attachments have been uploaded they are listed in the tab, with one icon per file. The name of the attachment is an hyperlink to download it.

Selected Attachment

Move the mouse above an icon to display the “Delete” button. Clicking on “Delete” will then remove the attachment from the ticket.

When the attachements is an image, then a preview will be shown anytime the mouse moves over the attachement icon.

The changes to the Ticket (addition or removal of attachments) are actually performed when the “Apply” button is clicked. Clicking on “Cancel” for the Ticket form will cancel any change to the attachments.

Drag and drop

Attachments can also be added by performing a drag drop of the files to attach, directly over the browser's window. When files are dragged over the “Attachments” tab, a blue shadow appears around the area where attached files are normally displayed:

Dragging files over the "Attachments" tab

If the “Attachments” tab is not the active one when dragging, files can still be attached to the ticket and the tab itself shows the blue shadow during the drag operation:

Dragging files with the attachment tab hidden

Managing Objects Relations

In iTop most of the tabs displayed on the details of an object represent relations between objects. All these relations are managed in the same manner. For example the form to manage the members of a “Team” looks like as shown below:

Managing team members

In order to add members to the team, click on the “Add Persons…” button at the bottom. This displays - as a popup - the search form to select Persons. Check the desired persons in the list and click “Add” to go back to the main form.

Adding Persons to a Team

You can narrow the search using the criterias at the top, then click on the Search button to refresh the list.

To remove objects from the relation, check the corresponding line in the form, then click on the “Remove selected objects” button at the bottom.

Remove Persons from Team

Note that removing objects from the relation does not actually delete these objects from iTop. Only the relation between the objects is removed.

On Tickets, a slightly different type of relation is available where the related objects are other tickets.

Managing n:1 relations on Tickets

To detach related tickets from the current ticket, just select them by checking the corresponding checkbox and click on “Remove”.

Note that removing objects from the relation does not delete these objects from iTop. Only the relation between the objects is reset. (On the related Ticket the field that was pointing to the current Ticket is reset)

You can use the “Add objects of type…” button to relate other Tickets to the current Ticket. When clicking on the button, a popup dialog is displayed with the standard search form at the top and a list with check boxes at the bottom:

Adding n:1 relations on Tickets

You can use the Search button to refresh the list after entering some filtering criteria at the top. Make your choice by checking the corresponding checkboxes, then press the “Add” button to dismiss the dialog.

2_2_0/user/display_and_modification.txt · Last modified: 2018/12/19 11:40 (external edit)
Back to top
Contact us