Using iTop

Creating your iTop

iTop Customization

"How to" examples

User Interface

Automation & Ticket management

Portal Customization

:: Version 3.2.0 ::

Add a TagSet in PHP

Prerequisite: You must be familiar with the Syntax used in Tutorials and have already created an extension.
We also assume that you are familiar with dashboard design within iTop and OQL.

Within a PHP method, adding a value to a TagSet
PHP, TagSet, Attribute
PrefillTransitionForm, Set, Get, GetTagFromLabel, Warning
min version:

If you want to add within a method a particular value to a TagSet attribute.
In the below non-standard example, we have a class Bug,

  • with a String field version ( an external field inherit from the Sprint during which that Bug will be worked on.)
  • and a TagSet versions which corresponds to the versions of the products in which that Bug was fixed
  • by default, on bug resolution, we want to be sure that at least the “version” of the Sprint is part of the “fixed in versions”
public function PrefillTransitionForm(&$aContextParam)
    switch ($aContextParam['stimulus']) {
        case 'ev_resolve':
            try {   // Get the version which is a string
                    $sVersion = $this->Get('version');
                    // Get the versions in which the Bug is supposed to be fixed (it's an ormTagSet)
                    $oVersions = $this->Get('versions');
                    // Get the TagSetFieldData code, corresponding to a given label (here my version)
                    $Tag = $oVersions->GetTagFromLabel($sVersion);
                    // Add this code to the TagSet if not already in.
                    // Set the result in the object
                    $this->Set('versions', $oVersions);
            } catch (Exception $e) {
                // An exception is raised by GetTagFromLabel(), if the label is not a valid one for this TagSet
                // You may log it or ignore the issue

You can get an exception if the label is not an existing value in your tagset: CoreUnexpectedValue: 4.0.0 is not defined as a valid tag for Bug:versions in…

3_2_0/customization/add-value-to-tagset.txt · Last modified: 2024/06/20 17:28 (external edit)
Back to top
Contact us