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

Consider browsing to iTop 3.1 documentation

Archiving

Purpose: Improve search performance when your outdated data start to represent much more than the active ones.

Enabling Archiving

It is not enabled by default on any class. It can be activated only on root classes in the Data Model, classes such as FunctionalCI, Contact, Ticket. See the XML reference for details.

  <classes>
    <class id="Ticket">
      <properties>
        <archive _delta="define">
          <enabled>true</enabled>
        </archive>
      </properties>
    </class>
  </classes>

Allowing objects of a class to be archived has no direct impact on the user interface, until a module provides the capability to archive and unarchive an object.

Deploy the module Simple Data Archiver to enable manual bulk archiving of old Tickets, limited to iTop Administrator

If you want to archive automatically every ticket closed and older than two years, then a specific extension could be developed to do this, using a background task. This module does not yet exist.

API for an archiving module

  DBSearch::DBBulkArchive()
  DBSearch::DBBulkUnarchive()
  DBSearch::DBBulkWriteArchiveFlag.

User experience

In standard mode

All archived objects are hidden, for all users including admins, like if they were deleted.

A reference to their friendly name can be found in other objects pointing to them. Example on an archived contact which is the caller of a non-archived Change.
Toggling menu As you can see the link is inactive, you can't open the caller details.

In the history of other objects to which they are or were linked, you just get the id of that archived object:  Archive history on external key

If you try to open the details of that archived object using a bookmarked url or building the url like this: http://myitop/pages/UI.php?operation=details&class=Person&id=11&

Archived object not visible

When an object is archived, all its n:n linkages to other objects are archived as well, meaning that they aren't visible anymore

in Archive mode

You can toggle the archive mode: Activate archive mode

  • In archived mode, you have a orange tag to remind you that you have activated it.
  • All objects are read-only
  • Archived objects are visible and tagged as archived

Archived object visible

  • An attribute referencing an archived object is clickable:

External Key to an archived object in archived mode

If you desactivate archive mode while you are on an archived object:  Desactivate archive mode

you get again the feedback message

Archived object not visible

Question & Answers

Question: The menu “Activate archive mode” is not available?
Answer: Archiving must be enabled on at least, one class.
If you have just done it though a Setup, Move To Test, Move To Production or iTop Hub extension installation, be sure to empty your web browser cache, as this is a known issue.

Question: Can I see “Archived objects” in the User Portal?
Answer: No, archived objects can never be displayed in any user portals.

3_0_0/feature/archiving.txt · Last modified: 2023/10/16 16:24 (external edit)
Back to top
Contact us