Category Archives: Posts

The Lotusscript class map is back

OpenNTF has done it again they have created an interactive class map of LotusScript like the one we all know from the old days as a poster on our office wall. Now you can buy a big touch screen and mount on you office wall displaying the classes. If you do have one post a comment with an image showing the new poster on your office wall.

you can find the map here https://openntf.org/ls/index.html and the annoncement here OpenNTF reintroduce the Lotusscript class map

Empty categories in views still visible

Views in HCL Domino can look clean or confusing depending on how you handle categories. A common issue is empty categories that appear for some users and disappear for others. This happens when the view depends on documents the user cannot read.

Domino shows a category only when at least one document in that category is visible. If all documents are restricted by Readers or Authors fields, the category stays hidden.

The problem starts when a response document is readable but the main document is not. The user can open the response through a link or lookup. The user cannot see the main document in the view. The category that the main document belongs to stays hidden. Domino treats the category as empty even if the response document exists. The response document does not create a category on its own.

You will notice this when users report that they see a response but cannot find it in the view. They think the category is missing. The real issue is access control on the main document.

You can reduce this problem with some simple checks.

• Keep Readers fields aligned across main and response documents.
• Avoid workflows where main documents are more restricted than their responses.
• Review the view selection so it includes documents users can read.
• Test with different user roles to see how categories collapse.

If you want to expose response documents even when the main document is hidden. Change so response documents is not displayed in a hierarchy . If you want predictable category behavior, give the parent and response documents the same visibility thru the readers and authors fields.

This keeps your views stable. It keeps users from wondering why a category disappears even when they know a response exists.

Quick LLM Access via 4 Lines of Code

4 lines of code to call a LLM, with zero maintenance in the future with DominoIQ.
Can you find any devtool that make it simpler to use LLM:s like
OpenAI, Claude, Llama, Mistral code setup?

This is the code that makes the magic happens

Dim LLM As NOTESLLMREQUEST,llmresp As NOTESLLMRESPONSE,resp as string
Set LLM=session.Createllmrequest()
Set llmresp=llm.Completion(db.server, "StdReplyEmail", “This is the text you want to respond to”)
resp=llmresp.Content

StdReplyEmail is the predefined LLM prompt to be used (This one is delivered with DominoIQ). Resp will hold the response from the LLM that you can use for your purpose.

Start testing with DominoIQ today, if you need to help with the setup check out Serdars great post

Domino IQ and OpenAI

Check out this great write up by Serdar Basegmez about how to use Domino IQ with an external LLM provider. And you could follow the same guide with any other provider, because almost everybody is using the same API syntax as OpenAI.

https://lotusnotus.com/2025/07/connecting-domino-iq-external-llm-providers

Read html from a docx file

If you are using the OpenNTF Poi extension this is quite simple to preform because there is an bean called poiBean that have a function called buildHTMLFromDocX this function takes an InputSteam and you can get an input stream from a NotesEmbeddedObject.

a simple example where you have stored an attachment in a richtext field called attachment and this doc is shown in hte view attachment. The code below is placed on an xpage button and the Xpage as an computed text that will show the Extracted viewScope data.

var v:NotesView=database.getView("test")
var doc:NotesDocument=v.getFirstDocument()
var rt:NotesRichTextItem=doc.getFirstItem("Attachment")
var att:NotesEmbeddedObject=rt.getEmbeddedObjects()[0]
var is:java.io.InputSteam=att.getInputStream()
var oi:java.io.ByteArrayOutputStream=poiBean.buildHTMLFromDocX(is)
viewScope.Extracted=oi.toString()

If you want to parse the HTML jsoup is a great library

Check out my other Poi example published several year ago

Single Sign-On configuration is invalid

If you are getting this error when adding a SAML or Multi server SSO configuration
HTTP Server: Error loading Web SSO Cookie Names Configuration ‘LtpaToken’ for Web Site ‘xxxx)’ (Single Sign-On configuration is invalid)

There is an technote article about this, but I don’t know if that help so much. Check if the server is added to participating server field in the LTPAToken document, because otherwise will not the server be able to see the document.
For other SAML problems check out my SAML article Debugging SAML setups in HCL Domino

Connect with multiple tenants using a single ip

With the ENABLE_SNI=1 notes.ini parameter you can have multiple host names and they can use https with with and without Let’s Encrypt certs. but the good thing is that this is also supported using SAML.

This means that if you company have multiple tenants in Office 365 or if you are using Okta you can add them and use SAML as login thru two different hostnames.

This isn’t a new thing probably worked since the parameter was introduced in Domino 11 only that I haven’t tested this until now 🙂

Once again does Domino simplify admin work in a complex it environment.

Check out my summary post about SAML in Domino if you haven’t

Disable access to the API endpoint in Domino

All newer versions of Domino has an API endpoint for the Domino Rest API. If you have a domino server that you do not want to expose this endpoint on you can create some webserver redirections to turn this off. This is how you do it, first create a substitution rule to another location in this cased api2 and after that a redirection rule.

And after that create an redirection rule to you preferred destination

Check out the new HCL Digital Solutions Community

The Digital Solutions Community is now public and open for you, register and start to participate


https://developer.ds.hcl-software.com or use my short link https://bit.ly/DominoForum

Attachment Filenames in lowercase

If you are getting all attachment filenames in lowercase in Domino 12.02 then that is because there is an option to normalize attachment filenames that if I’m guessing enabled by default in some fixpacks.
The default behavior is changed in FP6 back to how it was before

SPR# MDLSDCSMFV – Programmability – LotusScript – Attachments – Fixed an issue where the internal attachment filenames were being changed to lowercase/half pitch to fix an issue in TMAICWHDAY. This was resulting in applications that used LotusScript EmbeddedObjects.Name property to show attachment names in lowercase/half pitch – note that EmbeddedOjbect.Source property contains the user friendly name. To fix this, the fix for TMAICWHDAY is now off by default – set AttachNamesNormalize=1 to enable the fix for TMAICWHDAY. This regression was introduced in 11.0.1 FP9, 12.0.2 FP4 and 14.0 FP2.

https://ds_infolib.hcltechsw.com/ldd/fixlist.nsf/8ed1b46cfdba8957852570c90054623b/d01bc51222e6b8f985258c440048487b?OpenDocument