Hyperlinks configurator

Create hyperlink buttons to jump from one object in iTop into another application, via configurable URLs, without writing a single line of code.

• Hyperlink, label, tooltip and icon are configurable
• The scope option makes it possible to display the hyperlink only on objects matching a specific rule
• The target of the link is configurable as well (by default _blank to open the link in another tab/window)
• The contexts option specifies if the link is available in the backoffice (console) and/or in the portal(s) (and in which portal if there are several of them).
• The action/button can be limited to users having at least one of the allowed_profiles.

• Button labels cannot be localized (they are not dictionary entries)

iTop 2.3.0 or newer

Use the Standard installation process for this extension.

For each “link” to be displayed, the following configuration parameters are available:

Configuration file

'combodo-custom-hyperlinks' => array (
   'hyperlinks' => array (
      'Person' => array (
         'linkedin_me' => array (
            'label' => 'Linkedin Me!',
            'url' => 'https://www.linkedin.com/search/results/all/?keywords=$this->friendlyname$',
            'scope' => 'SELECT Contact WHERE org_id_friendlyname=\'demo\'',
            'icon' => 'fab fa-linkedin',
         ),
         'google_me' => array (
            'label' => 'Google Me!',
            'url' => 'https://www.google.com/search?q=$this->friendlyname$',
            'scope' => 'SELECT Contact',
            'icon' => 'fab fa-google-plus-g',
            'tooltip' => 'Search on Google for the person full name',
         ),
      ),
      'Location' => array (
         'maps_me' => array (
            'label' => 'GoogleMaps Me!',
            'url' => 'https://www.google.com/maps/search/$this->address$+$this->postal_code$+$this->city$+$this->country$',
            'scope' => 'SELECT Location WHERE org_id_friendlyname=\'demo\'',
            'icon' => 'fas fa-globe-africa',
         ),
      ),
   ),
),

Just click on the button(s) !

Q: Can I use this extension to propose a user action which would create or update objects on multiple classes at once?
A: Yes, this extension can be one part of the solution. In addition you will need to write you own extension to provide that complex action as a PHP method on the class on which the user will trigger the action.

An exemple a customer to whom you deliver services, is terminating its contract, as a result, you would like to close all the tickets open by its users, set all its contact status to inactive, disable all its user account, set all its CDMB owned CIs to obsolete and so on… For this you will need to write a PHP method for eg on the Organization class. That method will called by an action on the details of the Organization. So the User will trigger that Terminate customer action on the organization he wants to terminate.

class:Organization

public function TerminateCustomer()
{
   $iOrgID = $this->GetKey();
   // Desactivate Contacts
   $oSet = new CMDBObjectSet(DBObjectSearch::FromOQL("SELECT Contact WHERE org_id =$iOrgID"));
   while ($oContact = $oSet->Fetch())
   {
       $oContact->Set('status','inactive');
       $oContact->DBUpdate();
   }
   // Disable Users
   $oSet = new CMDBObjectSet(DBObjectSearch::FromOQL("SELECT User WHERE org_id =$iOrgID"));
   while ($oUser = $oSet->Fetch())
   {
       $oUser->Set('status','disabled');
       $oUser->DBUpdate(); 
   }
   // Auto-resolve UserRequests
   $oSet = new CMDBObjectSet(DBObjectSearch::FromOQL(
     "SELECT UserRequest WHERE org_id =$iOrgID AND status IN ('new','assigned','pending','approved')"
   ));
   while ($oUserRequest = $oSet->Fetch())
   {
       $oUserRequest->ApplyStimulus('ev_autoresolve');
       // No need to call DBUpdate(), it's done within ApplyStimulus 
   }
   // Other automations...
}

Then add an entry in the Configuration File, to display that action to the users with enough rights to do it

config-itop.php

'combodo-custom-hyperlinks' => array (
    'hyperlinks' => array (  
        'Organization' => array (
                'terminate_customer' => array (
                      'label' => 'Terminate Customer',
                      'url' => 'method://TerminateCustomer()',
                      'scope' => 'SELECT Organization',
                      'allowed_profiles' => 'Administrator',
                      'icon' => 'fas fa-skull-crossbones',
                      'contexts' => 'backoffice',
                ),
        ),
    ),
),