Discover millions of ebooks, audiobooks, and so much more with a free trial

Only $11.99/month after trial. Cancel anytime.

Rich Text 101
Rich Text 101
Rich Text 101
Ebook72 pages58 minutes

Rich Text 101

Rating: 0 out of 5 stars

()

Read preview

About this ebook

Rich Text 101 was a series of articles about Lotus Notes rich text that were originally posted on the Genii Software blog over a period of a few years starting in 2003. Most of the information is still accurate and useful today, and some details have been updated for the release of this ebook, including updates to reflect changes in later versions of IBM Lotus Notes, now IBM Notes 9 Social Edition.

LanguageEnglish
Release dateNov 11, 2013
ISBN9781310017612
Rich Text 101
Author

Ben Langhinrichs

Ben Langhinrichs is a software designer living in Shaker Heights, Ohio with his lovely wife and two cats. All three of their children have left the nest. He has had stories published or accepted in many magazines and anthologies, most recently several published by Pill Hill Press and the Library of Science Fiction and Fantasy.

Related to Rich Text 101

Related ebooks

Teaching Methods & Materials For You

View More

Related articles

Reviews for Rich Text 101

Rating: 0 out of 5 stars
0 ratings

0 ratings0 reviews

What did you think?

Tap to rate

Review must be at least 10 words

    Book preview

    Rich Text 101 - Ben Langhinrichs

    1 - Doclinks

    Doclinks are an integral part Lotus Notes/Domino, and have been for a long time (OK, I started back in R3 days, and they were used then, but I don't know when they were added), but they still seem a bit mysterious to some developers. I thought I'd kick off this occasional series on rich text topics by explaining a few of the mysteries. I'll try to keep this at a comprehensible level, but no promises.

    Composition of a doclink Doclink symbol

    There are several parts to a doclink. The most critical parts are:

    the DB Replica ID (identifies the database)

    the View Universal ID (identifies the view through which to open the document - more on this later)

    the Note Universal ID (identifies the actual document to open)

    As might be expected, a view link View link symbol contains a null (zero filled) Note Universal ID, while a db link DB link symbol contains both a null Note Universal ID and a null View Universal ID. What is not so expected is that even though a document can be retrieved by universal id from a database (e.g. GetDocumentByUNID method in LotusScript), the view universal id is still critical. See below for the Mystery of the Invalid View.

    There two other optional parts to doclink which are also related to navigation. The first is the Server Hint, which is either blank or contains the name of a server. The second is the anchor, which exists when the link is an anchor link Anchor link symbol . The Server Hint is the subject of much confusion and consternation, as it can lead to accessing a database in Tokyo even when you have a perfectly usable replica at your server in London. See below for the Mystery of the Roving Replica.

    Besides the navigational pieces, there is popup text/mouseover text, which is the text which displays in the status bar when you put the mouse over the link in the Notes client. This is known in R5 as the Link description and is editable in the properties box when the doclink is selected. It usually contains the database title, the view title and the document subject, but these are purely for visual aid. Similarly, there are various HTML attributes which can be set using the tab of the properties box for the doclink.

    Mystery of the Invalid View

    It is not uncommon to try to access a doclink and have an error such as Doclink not found come up, even though you can check and see that the document exists. There are three closely related causes for this mystery, but all three are related to the View Universal ID mentioned above.

    Created from a private view - The user who created the doclink did so while accessing the document from a private view stored on their desktop. When the doclink is accessed, Lotus Notes looks to the view to see if the Note Universal ID exists in that view. If the view does not exist, Notes returns either an error that the doclink is not found or that the view is not found.

    Created from a secured view - The user who created the doclink did so while accessing the document from a view which the current user is not permitted to access. When the doclink is accessed, Lotus Notes looks to the view to see if the Note Universal ID exists in that view. If the view cannot be opened, Notes returns an error that the doclink is not found or that the view is not found or that access is denied, depending on the circumstance.

    Created from a view which no longer contains the document - The user who created the doclink did so while accessing the document from a view which no longer contains the document. This can happen if the document changes status, or if the doclink is created programmatically and the default view does not contain the document. When the doclink is accessed, Lotus Notes looks to the view to see if the Note Universal ID exists in that view. If the document does not exist in that view, Notes returns an error that the document has been deleted or that the linked document cannot be found in the view.

    It is important to ensure that in the normal workflow, doclinks are created from shared views, preferably from an All Documents type of view. It is also important that designers make the default view an All Documents type of view. If these are not possible, it may be wise to use a tool such as our Midas Rich Text LSX to programmatically fix the links by re-assigning the View Universal ID in a QuerySave event or a scheduled cleanup agent. In Notes 6, you can also do this with the NotesRichTextDoclink class (but why would you when Midas is so easy?).

    Mystery of the Roving Replica

    One of the most annoying bugs/features with doclinks has to do with the Hint Server. This is supposed

    Enjoying the preview?
    Page 1 of 1