Lotus Notes: The Complete Reader and Author Field Troubleshooter

http://lotus-blogs.blogspot.com/2007/08/compleat-reader-and-author-field...

Tips and Tricks for Lotus Domino and Domino Java

Search

Search
Aug

16

The Complete Reader and Author Field Troubleshooter

Lotus Notes Add comments

About Me Rishi Singapore Certified Lotus Notes developer with 8+ years experience in developing and supporting Lotus Notes,Quickplce,SharePoint and Java applications. Additionally I'm an author of SharePoint Journals (http://sharepointjournals.wordpress.com/) which focus on SharePoint development and customization. View my complete profile Recent Comments Wiebe, Only solution I found whenever you modify a... I have exactly the same problem Rishi has. We'... Here is the Search Domino URL http://searchdomino.... This problem exists since Note 6.5x IBM/Lotus neve... @Rishi, Best practice which I know is to recompi... Recent Posts Lotus Script agent sometimes unable to include Script Library, Any solution ? Is it really hard to deploy custom SharePoint applications ? Any clue about this error ? Accessing pdf form fields using Domino Java What is the best place to keep external jars in Domino Java ? Categories Dojo (2) Domino designer 8.5.1 (8) Domino Java (9) Java (1) Lotus Designer 8.5 (3) Lotus Designer 8.5.1 (2) Lotus Designer 8.5.2 (1) Lotus Notes (44) Miscellaneous (3) Quickplace (7) SharePoint (1) Web Development (17) XPage (2) Let's Connect..

Here's a general-purpose Author and Reader field troubleshooting guide. This document explains how these fields work and the causes of common perplexities. There's a helpful tool that analyzes and explains your access to read or edit the document, but you should still read the information below so you'll understand what the tool does and what can go wrong. To begin, look at one of the documents that has the readers fields in it. If the documents are hidden even from you, the database manager, then you will have to access the database from the server console, or use full access administration, which lets you see all documents regardless of Reader access. You may also have to temporarily disable the local security property ("Use consistent access control") in the database ACL. TIP: To prevent the database manager/administrator ever losing read access to documents, put a Computed when Composed Authors field (not a Readers field) on every form, with a formula such as "[Admin]". This will allow all members of [Admin] role to read the document, without preventing others from reading it as a Readers field would. From a view, open the Document Properties box. Here's an example of what it should look like:

Highlight each of your reader fields in turn and look for differences from this ideal image. Note that: - Field flags must say READ-ACCESS NAMES. If not, read in Domino Designer help about IsReaders property of NotesItem. - If there are multiple values, they should appear as separate quoted strings on separate lines. In this case there are two values, "CN=Rex Rightway/O=Pings" and "[Admin]". If instead the value were listed as "CN=Rex Rightway/O=Pings, [Admin]" (or any other character instead of comma) then the problem is that you are storing multiple values as a string instead of a proper multivalue. If this is the problem:

Sites I follow The XPages Blog Code Store Ed Brill

1 of 4

20/07/2011 6:01 PM

Lotus Notes: The Complete Reader and Author Field Troubleshooter

http://lotus-blogs.blogspot.com/2007/08/compleat-reader-and-author-field...

- Make sure the multivalue checkbox is checked in the field properties. - If you assign the field with LotusScript, assign it from an array with one value in each element, as opposed to a string with some character in it as the delimiter. Example: Dim readerNames(0 to 1) As String readerNames(0) = "CN=Rex Rightway/O=Pings" readerNames(1) = "[Admin]" doc.Readers = readerNames ' If field did not previously exist, tell Notes ' it's a Readers field. doc.GetFirstItem("Readers").IsReaders = True - If assigning the field from macro language, say FIELD Readers := "CN=Rex Rightway/O=Pings" : "[Admin]" as opposed to "CN=Rex Rightway/O=Pings;[Admin]" (for instance). - If you use a username, you must use the full canonical username. If you store "Rex Rightway/Pings" the readers field will not work in all situations. You need that CN= garbage. - Make sure there are not excess characters in the name, e.g. leading or trailing or multiple consecutive spaces. In other words, always use @Trim. - If the field is not visible in the document properties from the view, but only when the document is open, you've probably made the field Computed for Display, or created the document using an agent that neglected to set the field as shown above, so that it's not being stored in the document when it's saved. To take effect, a readers field must actually be saved in the document, before the user tries to access it. Notes looks at the document, not the form, when deciding whether to grant access. - Should you have a problem with users being able to read the document whom you think should not have access: - Check whether the READ-ACCESS flag is set on your Readers fields as shown above. - If all Readers fields are blank, anyone can read the document. - An Authors field also allows read access (see below). Author fields work like Readers fields for all the above tests, except that: - the Field flags should read READ/WRITE-ACCESS NAMES instead of READ-ACCESS NAMES, and - a blank Authors field does not enable everyone to edit the document. "*" does, though.
Wed, Jul 20th
9:12 AM : Lotus Germany Social Business Roadshow Berlin / Frankfurt / Ehningen 8:45 AM : Olivier Franchet Firefox 5 et IE 9 supports avec la sortie du 8.5.2FP3 8:13 AM : Mitch Cohen Upgrading from 32 bit to 64 bit Domino (what is a flatform?) 8:13 AM : Jonathan Distad 20 reasons not to collaborate you enjoy a silo-driven company View posts from 300+ Lotus bloggers at planetlotus.org

Archives 2010 (13) 2009 (53) 2008 (11) 2007 (29) December (3) November (1) October (2) September (2) August (13) Profiling LotusScript Agents in Lotus Notes/Domino... Inline PDF viewing in quickplace All About pre-delivery(Before new mail arrives) ag... Before new mail arives agent Lotus Notes/Domino 7 application performance: Part... The Complete Reader and Author Field Troubleshoote... How does the Notes Indexer work? What causes Notes database indexes to rebuild? IBM Redbooks | IBM Lotus Notes and Domino 8 Deploy... Quickplace:Corrupt data exception while adding new... Quickplace: Creating a new welcome page Quickplace: How to resolve "Document has been dele... Quickplace : What to do when you get 'Invalid docu... July (8) Ed Brill Bob Sutor: IBM to donate Symphony code to Apache for consideration AllThingsD: IBMs Cloud Is Big in Japan With Two New Data Centers From Alistair Rennies Enterprise 2.0 presentation: "The enterprise itself is changing forever" IBM at 100: Weve always been about communication DominoPoint Italy conference recap Notes Design Blog A question for you about Notes Advanced search

1 Response to "The Complete Reader and Author Field Troubleshooter"

1.

Terry Pearson Says:

March 11, 2009 1:59 PM

Thanks for the tips on using Lotus Script to assign multiple values to a readers field. I was just running into that very issue, and your post answered my question quickly!

Leave a Reply

2 of 4

20/07/2011 6:01 PM

Lotus Notes: The Complete Reader and Author Field Troubleshooter

http://lotus-blogs.blogspot.com/2007/08/compleat-reader-and-author-field...

Calling all video critics Many thanks to Joyce Davis for coordinating the IBM Champion selection process XPages controls from Extension Library prioritization Do those Sametime status message influence what you use to communiciate? (short survey!) Best Practice Makes Perfect What Ive been working on... Creating a replica ID item for adminp requests What is this boy doing? LS2J static method calls and a little

Comment as:

Links to this post

Create a Link

introspection Another way to make an efficient date/based view The IBM Lotus Community IdeaJam (all ideas) Notes Client / Mail: Move Stationery and Rules to top section of left navigator Notes Client / Mail: Make key navigators in mail not scrolled with folders list Traveler / : Add support for Tasks/To Dos Idea Jam / Other: Create one list that shows the current version/fix pack level for IBM products, preferrably Lotus/Domino Apps Notes Client / Mail: Search in Lotus Notes-display unread emails within search results Microsoft SharePoint Products and Technologies Team Blog October 2010 Cumulative Updates for SharePoint & Project Server 2010 Republished Eric Swift on Connecting Lync to SharePoint SharePoint 2010 October Cumulative Update Issue: Details and Workaround Critical Information about the SharePoint Server 2010 October Cumulative Update Eric Swift on Office 365 Java blogs How to get C like performance in Java How much Java SE 7 is secure than Java SE 6 Spock Grails environment extension Apache Tomcat 7.0.19 Released Apache Isis 0.1.2 (incubating) Released ScottGu's Blog(.NET) June 26th Links: ASP.NET, ASP.NET MVC, .NET and NuGet Free Guathon all day event in London on June 6th Upcoming Conference talks in Norway, Germany and the UK Great Free Video Training on ASP.NET Web Forms and ASP.NET MVC ASP.NET MVC 3 and the @helper syntax within Razor The Official Google Blog Using data to protect people from malware g.co, the official URL shortcut for Google websites Shareable Google News badges for your

3 of 4

20/07/2011 6:01 PM

Lotus Notes: The Complete Reader and Author Field Troubleshooter

http://lotus-blogs.blogspot.com/2007/08/compleat-reader-and-author-field...

favorite topics What Do You Love? Hats off to the winners of the inaugural Google Science Fair Subscribe To Posts Comments

4 of 4

20/07/2011 6:01 PM