Nieuwe Lotusscript methods in de Lotus Domino Designer 8.5

maandag, 12 januari 2009 door Martin Schaefer

De highlight van de Lotus Domino Designer 8.5 is uiteraard "XPages". Hieraan zal ik binnenkort een artikel wijden. Er zijn echter ook een vijftal nieuwe methodes toegevoegd in Lotusscript.

StampAllMulti

StampAllMulti is aan te roepen vanuit een NotesDocumentCollection of NotesViewEntryCollection. Het grote verschil met de .StampAll methode is dat .StampAllMulti een NotesDocument als parameter meekrijgt waarin de velden staan die 'gestampt' moeten worden.

In onderstaand voorbeeld zie je hoe dit werkt.

	Dim ses As New NotesSession
	Dim dbOrders As NotesDatabase ' Orderdatabase
	Dim vwOrdersUnprocessed As NotesView ' View met niet verwerkte orders
	Dim vecolOrders As NotesViewentryCollection ' viewentries van niet verwerkte orders
	Dim docStampFields As NotesDocument ' tijdelijk document om velden mee weg te schrijven op de viewentries
	
	Set dbOrders = ses.CurrentDatabase
	Set vwOrdersUnprocessed = dbOrders.GetView ( "sysOrdersUnprocessed" )
	Set vecolOrders = vwOrdersUnprocessed.AllEntries
	
	' maak een tijdelijk document object aan om de velden aan toe te voegen
	Set docStampFields = New NotesDocument ( dbOrders )
	
	' Zet hier de waarde van de velden om straks de velden van de gehele collectie aan te passen
	docStampFields.DateProcessed = Now
	docStampFields.ProcessedBy = ses.CommonUserName
	docStampFields.ProcessedStatus = "Processed"
	
	' Pas de velden op de collectie aan met de velden die zijn aangemaakt op docStampFields
	Call vecolOrders.StampAllMulti ( docStampFields )

NotesRichtextDocLink

De NotesRichTextDocLink.RemoveLinkage methode verwijdert de link achter de doclink. De lay-out en de tekst van de doclink blijft gewoon bestaan.

NotesDocument en NotesViewEntry

Om te kijken of een document gelezen is kan vanaf versie 8.5 de 'GetRead' methode gebruikt worden.

• 'GetRead' zonder parameter geeft 'true' terug indien het document (of viewenty) gelezen is.
• 'GetRead' met als parameter de gebruikersnaam geeft een 'true' terug indien het document (of viewenty) door die specifieke gebruiker gelezen is.

NotesView

Met de ResortView methode is het mogelijk om een view opnieuw te sorteren op een andere kolom. De eerste optionele parameter is een string met de kolomnaam, de tweede optionele parameter is een boolean.  True=oplopend sorteren, False=aflopend sorteren (oplopend sorteren is default). Indien geen van de parameters is meegegeven zal de view worden gesorteerd op de eerste kolom in oplopende volgorde.

NotesSession

Met de introductie van de ID Vault in Lotus Domino 8.5 is het mogelijk om passwords door users te laten resetten. Hiervoor is de 'ResetUserPassword' methode in NotesSession toegevoegd. Deze methode is alleen aan te roepen vanuit een agent.