Migrate an Extension to 3.3
XML datamodel
Breaking changes
Other nodes added to the standard datamodel
-
New class id Cloud
-
New menu node id ServiceCatalog under ServiceManagement menu group.
Class properties
-
New obsolescence rule on classes
Contract,Service,ServiceSubcategory, -
New uniqueness rule name on class
OSFamily -
New uniqueness rule name_brand on class
IOSVersion -
New uniqueness rule name_osfamily on class
OSVersion -
New fields_semantic logo on classes
NetworkDeviceType,OSFamily,BusinessProcess,Application Solution,Software,MiddlewareInstanceandWebApplication,
Lifecycle
-
New transition id ev_auto_resolved on states escalated_tto, approved and waiting_for_approval for class
UserRequest -
New transition id ev_auto_resolved on state escalated_tto for class
Incident
Presentation
-
New default_search on class
Model,IOSVersion -
Add logo to presentation list of class
Brand
Fields
-
New Dashboard field id overview on class
Team.
-
New LinkedSet field id ospatches_list on class
OSVersion, added to the presentation details -
New LinkedSet field id osversions_list on class
OSFamily, added to the presentation details -
New LinkedSet fields id models_list and iosversions_list on class
Brand, added to the presentation details -
New LinkedSet field id networkdevices_list on class
IOSVersion, added to the presentation details -
New LinkedSet field id groups_list on class
FunctionalCI, added to the presentation details of every CI sub-classes
-
New Image field id logo on classes
OSFamily,NetworkDeviceType,BusinessProcess,Application Solution,Software,MiddlewareInstance,WebApplication, added to the presentation details
-
New Date field id
end_of_supporton classesModel,OSVersion,IOSVersionandSoftware, added to the presentation details -
New External field id model_end_of_support on class
PhysicalDevice, added to the presentation details of every PhysicalDevice sub-classes -
New External field id ios_end_of_support on class
NetworkDevice, added to the presentation details -
New External field id os_end_of_support on classes
Server,VirtualMachineandPC, added to the presentation details -
New External field id software_end_of_support on classes
SoftwareInstance, added to the presentation details of every SoftwareInstance sub-classes -
New External field id osfamily_id on classes
OSPatchandOSLicence
-
New SubItem fields id tto_time_spent and ttr_time_spent on classes
IncidentandUserRequest
Colors on Enum
Add colors on enum:
-
field priority on classes
IncidentandUserRequest -
field request_type on classes
IncidentandUserRequest -
field status on classes
Document,Contract,Service,ServiceSubcategory -
field status on classes
PhysicalDevice,VirtualDeviceandGroup
Access rights
-
New action on group Incident to enable transitions id stimulus:ev_dispatch and stimulus:ev_reopen
Given to SuperUser:
-
New action on group Incident transition on Incident in full ITIL mode
-
New action on group Ticketing to enable transitions id stimulus:ev_close
-
collectors and datasynchro
Portal
-
New scope id service-manager on classes
ServiceandServiceSubcategory
Other nodes removed from the standard datamodel
-
Tab tickets_list removed from
Teampresentation details -
Remove transition id ev_autoresolve on state resolved of class
IncidentanduserRequest -
field id request_type removed from presentation details of class
UserRequestin full ITIL mode -
Portal
gotoaction rule-
It's definition
/itop_design/module_designs/module_design/action_rules/action_rule[@id='go-to-open-request-on-submit'] -
It's usage
/itop_design/module_designs/module_design/bricks/brick[@id='services']/levels/level/levels/level/levels/level/actions/action[@id='create_from_this']/rules/rule[@id='go-to-open-request-on-submit']
-
Removed file
No XML file removed.
Removed dictionary entries
No removed dictionary entries
Deprecations
Other nodes deprecated in the standard datamodel
No other nodes deprecated in the standard datamodel.
PHP APIs
Breaking changes
Removed APIs
As announced in the previous migration notes, the following APIs have been removed. Refer to the previous migration notes to know what replaced them.
| Domain | Type | Name | Deprecated since | Covered by migration audit (customers only) |
|---|---|---|---|---|
| Global | API | utils::GetClassesForInterface | 3.2.0 | N°221 |
| Global | API | utils::ResizeImageToFit | 3.3.0 | N°250 |
| Backoffice | API | ThemeHandler::GetCurrentThemeId | 3.0.0 | N°243 |
| Backoffice | API | iPageUIExtension | 3.1.0 | N°65 |
| Backoffice | API | AbstractPageUIExtension | 3.1.0 | N°65 |
| Backoffice | API | iApplicationObjectExtension | 3.0.0 | N°251 |
| Backoffice | API | AbstractApplicationObjectExtension | 3.0.0 | N°251 |
| Backoffice | API | WebPage::add_linked_script | 3.2.0 | N°242 |
| Backoffice | API | WebPage::add_linked_stylesheet | 3.2.0 | N°242 |
| Object | API | CMDBObject::DBCloneTracked | 3.1.0 | N°125 |
| WizardHelper | API | WizardHelper::GetJsForUpdateFields | 3.0.4 | N°177 |
| Datatable | API | DataTableUIBlockFactory::MakeForRenderingObject | 3.1.0 | N°157 |
| Newsroom | API | MetaModel::EnumPlugin('iNewsroomProvider') | 3.2.0 | N°191 |
| Portal | Method | AbstractController::ForwardFromRoute | 3.0.0 | N°63 |
| Portal | Method | AbstractController::GetControllerNameFromRoute | 3.0.0 | N°63 |
| Renderer | Method | SelectObjectField::VerifyCurrentValue | 3.1.0 | N°245 |
| Twig | Class | Combodo\iTop\TwigExtension | 3.1.0 | N°116 |
Deprecations
Deprecated APIs
| What changed | Why was it deprecated | What to search for | What to do if found | Covered by migration audit |
|---|---|---|---|---|
| \InlineImage::ResizeImageToFit | Duplication of \ormDocument::ResizeImageToFit | InlineImage::ResizeImageToFit($oVar,
$aDimensionsAfterResizingMind that variables names can change. |
Replace with
$oVar→ResizeImageToFit(MAX_WIDTH, MAX_HEIGHT,
$aDimensionsAfterResizing |
N°299 |
Unused APIs
JS APIs
Breaking changes
Removed APIs
As announced in the previous migration notes, the following APIs have been removed. Refer to the previous migration notes to know what replaced them.
| Domain | Type | Name | Deprecated since | Covered by migration audit (customers only) |
|---|---|---|---|---|
| Global | Library | js/json.js | 3.2.0 | N°196 |
| Global | Library | js/json/json2.js | 3.2.0 | N°196 |
| Global | Library | js/jquery.treeview.pack.js | 3.2.0 | N°196 |
| Global | Library | js/themes | 3.2.0 | N°196 |
| Global | Library | js/wizard.utils.js | 3.2.0 | N°300 |
| Global | Function | EncodeHtml() | 3.0.0 | N°39 |
Removed files
We removed the JS files and folder that were deprecated in 3.2.0
js/
json/
json2.js
json.js
jquery.treeview.pack.js
themes/*
if (version_compare(ITOP_DESIGN_LATEST_VERSION, '3.2', '<')) {
// Deprecated lib in iTop 3.2.0
$oP->add_linked_script(utils::GetAbsoluteUrlAppRoot().'js/json.js');
}
jquery.treeview.pack.js : use /js/jquery.treeview.min.js instead
We removed some files from JS libraries and moved them to `node_modules`
js/
ace/*
mousetrap/*
c3.js
c3.min.js
d3.js
d3.min.js
clipboard.min.js
jquery.autocomplete.js
jquery.contextMenu.js
jquery.fileupload.js
jquery.iframe-transport.js
jquery-ui.custom.min.js
jquery.min.js
jquery.magnific-popup.js
jquery.magnific-popup.min.js
jquery-migrate.dev.js
jquery-migrate.prod.min.js
moment-with-locales.min.js
showdown.min.jsDeprecations
Deprecated APIs
Unused APIs
CSS APIs
Breaking changes
Removed APIs
Removed files
We removed a bunch of CSS files from legacy iTop look
css/
css-variables.scss
light-grey.scss
We also removed some files from external libraries and moved them to `node_modules`
css/
c3.min.css
jquery.contextMenu.css
magnific-popup.cssDeprecations
Deprecated APIs
Deprecated files
Breaking changes
We removed a bunch of images from iTop, mostly deprecated icons from pre-3.0 rework
datamodels/2.x/
itop-change-mgmt/images/*.png
itop-change-mgmt-itil/images/*.png
itop-config-mgmt/images/*.png
itop-datacenter-mgmt/images/*.png
itop-endusers-devices/images/*.png
itop-faq-light/images/*.png
itop-incident-mgmt-itil/images/*.png
itop-knownerror-mgmt/images/*.png
itop-problem-mgmt/images/*.png
itop-request-mgmt/images/*.png
itop-request-mgmt-itil/images/*.png
itop-service-mgmt/images/*.png
itop-service-mgmt-provider/images/*.png
itop-storage-mgmt/images/*.png
itop-structure/images/*.png
itop-tickets/images/*.png
itop-virtualization-mgmt/images/*.png
itop-welcome-itil/images/*.png
