UNIDs in QuickPlace Links, URLs, and Documents

Product documentation


Abstract

This document provides an overview of how Universal IDs (UNIDs) are used in Lotus Quickr for Domino or Lotus QuickPlace links, URLs, and documents.

Content

This document is written for Lotus QuickPlace; the concepts also apply to Lotus Quickr for Domino.

The main storage place of a QuickPlace is its MAIN.NSF database. This database contains the QuickPlace's configuration and user documents (pages). Most main links in the QuickPlace Web interface (discussion, library, index, and so forth) directly reference documents in MAIN.NSF. These references are based on the Universal ID (UNID) of the target document and are shown in the Links URL. The UNID is a 32-character combination of hexadecimal digits (0-9, A-F) that uniquely identifies a document across all replicas of a database.

The following table lists the main links in a QuickPlace, the referenced target documents, and the UNID of these documents:

LINK NAME
h_SystemName of document in MAIN.NSF
UNID
welcome h_Welcome 4DF38292D748069D0525670800167212
discussion h_Discussion 47B91A2AC603E0340525670800167201
library h_Library 505538F1EB2B9DBF0525670800167214
calendar h_Calendar 2A922D48C75DD00B052567080016723A
tasks h_TaskList ED8254464B105395852567EF0069625F
index h_Index CE6A3D6B1F546C9405256708001671FF
customize h_Tailor A6090949E584BB1105256708001671FE
basics h_RoomBasics 4E349349713E0900052567080016720D
customize news h_RoomSettings E5625BD1B8F3E85005256823005AAF05
decorate h_Decorate 104D34D949C7D578052567080016720E
choose a theme h_AestheticsSettings 9EEB7D0C2C9DF92405256820007751D3
offline h_Accessories A22C4328A85E9873052568B0005C0C98
forms h_Forms 612BBB6DF7B418C4052567080016720F
rooms h_Rooms 811D51D422F71EC60525670800167210
place type options h_PlaceTypeOptions E0070AFB7E85FE33052568B0005C0CC7
custom themes h_Skins 8138745487BCB874052568B0005C0EE0
place bots h_Agents 4921D22C639348F0852568000068635D
members h_Members 7CB1ED9DCD9FCEAB852567C3006E2DBE
add/remove members h_Security 406AC6104BD821D30525670800167200
groups h_Groups CE4BF888D57FB3F60525670800167218
home h_Welcome

URLs

The format of URLs for Links in QuickPlace is as follows:

http:// server/QuickPlace/ QPname/Main.nsf/ view/ UNID/?OpenDocument

server = (fully qualified) hostname of your QuickPlace server
QPname = Name of QuickPlace
view = either 'h_Toc' or UNID of a view in MAIN.NSF
UNID = Universal ID of QuickPlace document *

Examples for URLs

Index: http://myServer/QuickPlace/myQP/Main.nsf/h_Toc/ CE6A3D6B1F546C9405256708001671FF/?OpenDocument


Place Type Options: http://myServer/QuickPlace/myQP/Main.nsf/AD143AC211C5A ED40525670800167228/E0070AFB7E85FE33052568B0005C0CC7/?OpenDocument


Documents and UNIDs

Every document in a Notes database is uniquely identified by a 32-character combination of hexadecimal digits (0-9, and A-F), its Universal ID or UNID. This is also true for the documents in MAIN.NSF. It is important to note that the UNID of the haiku documents, for example, h_Index or h_Calendar, in MAIN.NSF have fixed UNIDs. That is, the UNID of a haiku document is identical in each and every QuickPlace in all installations! For instance, the document 'h_PlaceTypeOptions' always has the UNID E0070AFB7E85FE33052568B0005C0CC7. (Haiku was the project code name for QuickPlace 1.0. Haiku document in this context means a document in MAIN.NSF with a h_SystemName starting with "h_." These documents can be thought of as system or configuration documents, essential to the operation of a QuickPlace.)

This fact is very important when it comes to troubleshooting and fixing problems in MAIN.NSF. Sometimes, duplicates of a haiku document exist. This is often a source of problems in a QuickPlace, for example, a link not working or an Icon showing up twice. In order to fix such a problem, duplicate documents must be removed manually. This is done by opening MAIN.NSF from a Notes client, finding the duplicate, and removing it.

To identify which document is the original and which is the duplicate, examine the document's UNID. This can be done by executing a simple formula. The easiest way to execute a formula is by assigning the formula to a SmartIcon Macro button (File, Preferences, SmartIcon Settings...). then selecting the document (in view System\QDK) and pressing that button. The formula to identify a document's UNID is as follows:

@Prompt([OKCANCELEDIT];"UNID";"UNID of this document is";@Text(@DocumentUniqueID);"")

This formula produces a dialog box displaying the selected document's UNID.

If you do not know which document the UNID in a link's URL refers to, you can search for the document using its UNID in MAIN.NSF. You can create an agent in MAIN.NSF using LotusScript code, an example of which is shown below.

NOTE: The scripts below are samples, provided to illustrate one way to approach this issue. In order for these examples to perform as intended, the scripts must be laid out exactly as indicated below. QuickPlace Support cannot customize these scripts for a customer's own configuration. For more information about using LotusScript, consult the product Help.

Sub Initialize

Dim session As New NotesSession
Dim db As NotesDatabase
Dim doc As NotesDocument
Dim item As NotesItem

Set DB = session.CurrentDatabase
findUNID = Inputbox("Find Document","Enter UNID of Document you are looking for")
Set doc = db.GetDocumentByUNID(findUNID)
If Not (doc Is Nothing) Then
docName = doc.h_SystemName(0)
If docName<>"" Then
Msgbox "h_SystemName of Document is " + doc.h_SystemName(0)
Else
Msgbox "Document found, but not identified."
End If
Else
Msgbox "Document not found"
End If

End Sub


The agent first prompts for the UNID of the document being searched for and, if the document is located, display the document's h_SystemName in a dialog box.


If you find that a document does not have the correct Universal ID (as listed in the table above), you can use the following agent to change the UNID back to the correct value:

Agent code for change Universal ID of a Notes Document

Option Public
Option Explicit


'--------------------------------------------------------------------------------------------------------------------------------------------
'
' This agent changes the Universal ID of a Notes Document
'
' That is, it creates a copy of the document with the new copy having the desired UNID ...
' ... and deletes the original document with the "old" UNID
'
'--------------------------------------------------------------------------------------------------------------------------------------------


Sub Initialize

Dim session As New NotesSession
Dim db As NotesDatabase
Dim olddoc, newdoc As NotesDocument
Dim oldUNID, newUNID As String
Dim coll As NotesDocumentCollection
Dim s As Variant
Dim DefaultUNID As String

DefaultUNID = ""
Set db = session.CurrentDatabase
Set coll = db.UnprocessedDocuments
If coll.count>0 Then
Set olddoc = coll.GetFirstDocument
DefaultUNID = olddoc.UniversalID
End If

oldUNID = Inputbox$("Enter current UNID of document","Reset UNID", DefaultUNID)
If oldUNID = "" Then
Msgbox "Nothing entered. Aborting..."
Exit Sub
End If

newUNID = Inputbox$("Enter NEW UNID of document","Reset UNID")
If newUNID = "" Then
Msgbox "Nothing entered. Aborting..."
Exit Sub
End If

Set newdoc = db.GetDocumentbyUNID(oldUNID)
If Not (newdoc Is Nothing) Then
newdoc.UniversalID=newUNID
s = newdoc.save(True,False)
If s=True Then
Set olddoc = Nothing
Set olddoc = db.GetDocumentByUNID(oldUNID)
Call olddoc.Remove(True)
End If
Else
Msgbox "Unable to find document"
End If


End Sub


Cross reference information
Segment Product Component Platform Version Edition
Messaging Applications Lotus End of Support Products Lotus QuickPlace AIX, i5/OS, Linux, Solaris, Windows 7.0, 6.5

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Lotus Quickr for Domino
Customization

Software version:

8.0, 8.1, 8.2, 8.5, 8.5.1

Operating system(s):

AIX, IBM i, Linux, Solaris, Windows, i5/OS

Reference #:

7003362

Modified date:

2013-03-25

Translate my page

Machine Translation

Content navigation