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

Consider browsing to iTop 3.2 documentation

iTop 2.6 Community

What's new in iTop 2.6 Community

Tag Attribute

This new attribute allows
a user to:

  • Tag an object with multiple values intuitively
  • Search for all objects having a given tag,

a configuration manager to:

  • Manage the “allowed values” for a TagSet directly in iTop as any Typology.
  • Add and remove tags to a set of objects in bulk mode,
  • Import and export those tags as any other fields,

More: check the User guide

In Standard Data Model, you can tag a FAQ with multiple domains
Available domains are manageable as any Typology

Other possibilities which might be useful for some organization, but won't be defined as part of the standard Datamodel:

  • Tag a “Functional CI with the environments” it impacts,
  • Tag the domains of a Ticket,
  • …

They could be developed as an extension

  • A user who has customized a Dashboard, can now switch back and force between the default dashboard and his own customized version.

  • Menu Dashboard are now printable, and can be sent to a virtual pdf printer as well.
  • Icon for editing a Menu Dashboard has been moved on the right of the Dashboard title

Dashboard Attribute

Basically, a new tab will be displayed on objet having that attribute and that tab will contain a dashboard displaying data specific to that particular objet.

  • A class can contain more than one Dashboard attribute.
  • Dashboard attribute must be added to the XML <class><presentation><details> to be displayed
  • This dashboard being part of the object details, it can be printed with the object.
In Dashboard Attribute you can use placeholders like :this->code within the OQL of your dashlets, where code is any field of the object

Example of an OQL within a Dashboard Attribute on Organization class. :

  SELECT UserRequest AS u 
  WHERE u.agent_id = :current_contact_id 
  AND u.status NOT IN ("closed", "resolved")
  AND u.org_id = :this->id

This list of User Requests is dynamically based on the current user (an option which was already available in Menu Dashboard) and the displayed organization (This is new and specific to Attribute Dashboard)

In Standard Data Model: We have added a Dashboard Attribute on Organization class, with a few dashlets:
  • Dynamic header for FunctionalCIs (standard)
  • List of Persons with an associated User in this organization (standard)
  • Graphs of Tickets (brought by request and ticket modules)

Customizing Dashboard Attribute

This new type of Attribute allows to replace many lines of code written to display related objects with special filtering, with multiple lists. Once replaced, their customization is much easier and safer, as it relies on XML instead of PHP, and it can be enhanced as soon as new dashlets are added to your iTop (for example a Calendar View Dashlet).

This Dashboard even if not customizable by the users, will be editable by iTop administrators, who can design and test it with real data, before copying the resulting XML in an extension or in the ITSM Designer as the Dashboard definition.

Uniqueness constrains

You can specify on a class, uniqueness rules, to prevent duplicate entries.

  • A rule would specify the scope of objects on which the uniqueness must be checked. For example, you may want to have a unique server name, but without taking into account obsolete servers.
  • During a single creation or modification made on the console or the portal, a rule can either
    • block the creation/update of the object

  • or just display a warning message after the creation/update.

  • A uniqueness rule applies on one or multiple fields of the class (including ExternalFields)
  • Uniqueness on attribute types such as File, Image, Dashboard, Stopwatch,… are not supported (incomplete list).
If you want a Uniqueness Rule for a Person on Organization and Employee number, but this rule only applies to your company, then you define the scope of the rule to be “Only Persons of organization XXX”
In Standard Data Model, we have added those rules:
  • Class Brand, field name must be unique.
  • Class Model, fields: name + brand_id must be unique.
  • Class Person, fields: org_id + employee_number must be unique only if employee_id is defined.
  • Class Person, fields: org_id + first_name + name should be unique (warning only).

Trigger on Update & Delete

Two new types of Trigger have been added to cover Notification needs on situation such as Update or Delete of an object. For the Update trigger, the list of fields which are monitored for a particular trigger can be specified.

Those triggers are called in all cases of update/deletion, not only when done on the Console and the Portal(s), but also through DataSynchro and API REST.

Be aware that if you set a TriggerOnUpdate on class Team for field members_list,

  • the trigger will occur only if the list of members is modified from the Team object
  • On the opposite, if you edit a person and add or remove it from the Team, the above trigger will not be activated, also the members_list was modified.
  • If a DataSynchro or a CSV import load directly objects lnkPersonToTeam, again the trigger will not be activated, unless the load of lnkPersonToTeam is done through a synchro/import of Team
As for every Trigger, when you specify a filter you can use :this→attribute_code and it contains the value after the change.
In the filter of a TriggerOnDelete the values of the current object can still be tested
If on a TriggerOnUpdate you omit to specify the fields, then any field change will activate the trigger
If on a TriggerOnUpdate you specify two fields, then a change on one or the other will activate the trigger
If the two fileds are modified in the same modification, only one single trigger will be activated
TriggerOnUpdate can be use on Caselog, but we don't recommend it as other triggers exist which brings more values, such as TriggerOnLogUpdate, TriggerOnEmailUpdate and TriggerOnPortalUpdate
Be cautious with Trigger on Update set 'email_asynchronous' ⇒ 'true', in the Configuration File, as a CSV import, a bulk update can generate a lot of emails and impact the performances

Trigger on update is not triggered on those type of Attribute:

  • AttributeDashboard
  • AttributeExternalField
  • AttributeFinalClass
  • AttributeFriendlyName
  • AttributeObsolescenceDate
  • AttributeObsolescenceFlag

Other enhancements

  • New placeholders to provide a direct url to an object on iTop portal is a specified mode: view or edit.
    • $this->hyperlink(itop-portal-view)$
    • $this->hyperlink(itop-portal-edit)$
  • Stronger encryption method supported

2.6.1 enhancements

Default search criterion defined on the datamodel, are now displayed on top of any prefilled criteria.

API/Rest Json

PR #25, thanks to Dennis Lassiter !

Core/Get pagination supports two new parameters :

  • limit (int): Amount of results to return (default: 0 = no limit)
  • page (int): Page number to return (cannot be < 1)

Example :

{
   "operation": "core/get",
   "class": "Person",
   "key": "SELECT Person",
   "output_fields": "friendlyname, email"
   "limit": "5",
   "page": "2"
}
2_7_0/release/2_6_whats_new.txt · Last modified: 2020/04/15 15:23 by 127.0.0.1
Back to top

Table of Contents

Contact us
Contact us