Page Identifiers

DivePort has two identifiers for each page:

When you create a new page, DivePort assigns a page ID that is unique within the current environment. You can change that page ID (using Edit > Settings) to whatever you want.

If you copy the page, the new copy retains the same page ID. If you copy an environment, all the pages in the copied environment retain the page IDs of their counterparts in the original environment. Likewise, if you import an environment, the page IDs are not changed.

The page ID does not appear in the URL by default, but it is accepted. You can link to a DivePort page by using its page ID (...diveport#page=my_page_id). You can also use the page ID when creating menu portlets, table of contents portlets, or click actions (such as portal page click actions).

If you use a page ID that is not unique, DivePort attempts to find the closest page with that ID. The search algorithm is:

  1. The current page.
  2. Children and descendents, depth-first (that is, the same order as if you expanded everything in the sidebar and read straight down)
  3. The parent page.
  4. Children and descendents of the parent page, depth-first.
  5. Repeat steps 3 and 4 until all pages in the environment have been searched.
  6. Pages in other environments, depth-first.

If you copy an environment, links between pages in the original environment work, and links in the new environment also work. Likewise, if you import an environment, links between pages will work.

The page ID does not appear in logs, scan environment, or the portal dump tables.

UUID

Also known as a GUID, this is a long string that is unique for each page (for example: 8839965b-be36-4a5f-9625-38e2d651bd2f). When you create a new page, DivePort assigns a randomly-generated UUID which is highly likely to be unique for all pages. You cannot change the UUID.

If you copy a page, the copy is assigned a new UUID. If you copy an environment, all pages in the copied environment are assigned new UUIDs. Likewise, if you import an environment the UUIDs are different from the original pages.

The UUID is what typically appears in the URL (because it is the true unique identifier). If you use a page ID in a URL, when DivePort finds a matching page, it replaces the page ID in the URL with the page UUID. This ensures browser bookmarks always bring you to the same place.

DI recommends that you not use the UUID in click actions, because those links will not work if you copy or import that environment later.

The UUID appears in the scan environment report, and the portal dump tables as Item ID or Page ID. Log files display the UUID and page ID.

See also Finding a Page UUID.