Monday, February 14, 2011

Alfresco Test Day 4 - Transferring - documentation of transfer activities

Today I am testing the feature allowing documentation of transfer activities in an electronic format that can be saved as a record. This feature is important as it provides an automated audit trail of movements, and relates to the Generally Accepted Record Keeping Principles (GARP) of Complaince and Integrity.

If a record were ever transferred for inappropriate reasons (unathorized disposal of a valued or controversial record), this audit trail should identify who, where, and when it was transferred.

I created two folders under different categories, downloaded multiple documents to one folder, then used the "Copy to...", "Move to..." and "File to..." actions to move several documents to the other folder. I then viewed the audit log for the copied document.

Both times I tried to copy, my initial attempt failed, but worked on second try. I was unable to successfully Move a document. Below is the error message I received. There must be a bug in the system and I will be forwarding this problem to the Alfresco community page for a fix. I'll update this page if it gets worked out.



I rate this test as a conditoinal PASS
The "Move to..." action failed. However, the audit logs tracked all changes and was available to view and print, as required.

Records Manager
  • There are audit logs for Series, Category, Folder, and Document. Here is as sample audit log for a document.



  • The audit log at the category level, the first row describes the current metadata for the category. Below that, all moves, adds and changes, including added folders, and action to all folders, is recorded. This would be a useful report showing folder activity.
  • The audit log at the folder level, similarly the first row describes the current metadata for the file. Below that, all moves, adds and changes, including added documents (records) is recorded.
  • The audit log at the document (record) level shows all changes to the document.
Business User
  • "Copy to.." and "File to..." allow you to copy your document to a different folder. Every time I tried this, I had to do the action twice to get past the fail.
  • "Move to..." failed every time I tried it. I will report this bug to the developers. 
  • Thankfully the audit log function is for your reassurance only. Your Records and Information Management professionals are responsible to monitor the logs for complaince.

Developer
  • The "Move to..." activity fails, that must be fixed.
  • I would like to see a new summary audit log of all activity (for a specified time period) including series, category, folder, and document. The columns might be: Time stamp,Unique Record Identifer, level (Series, Category, Folder, or Document),  Type of change, and User. The Records Manager then could then scan the list for audit checks and reference the Unique Record Identifier for details.
  • I noted that a copied record did not track it's source as a "previous value". This reduces the value of the audit log as there is no way to track back copies to their original source.

Notes
Checking standard DOD 5015.2, Feature C2.2.7.5.5, C2.2.9.1.3, C2.2.9.1 and MoReq 3.4.15, 3.4.16, 3.4.29, 4.2.1, 4.2.2, 4.2.4, 4.2.6, 4.2.8, 4.2.9, 4.2.10, 4.2.11. Relates to GARP Compliance, Integrity.

Saturday, February 12, 2011

Alfresco Test Day 3 - Transfer Record Elements - Parse metadata elements from ingested data using GUI

Today I chose to review the feature to "Parse metadata elements from ingested data using Graphical User Interface (GUI)." What this rather awkward sentence is trying to say, is that metadata should transfer along with the document. Alfresco should recognize metadata and put it where it belongs (parse). GUI simply means as users we have an easy to use entry screen. While I was at it, I also checked if additional metadata from e-mail messages transfers (date received, addressee, other addressee)". My special interest in these features is to confirm that source metadata transfers seamlessly, in the hope that we can reduce or eliminate the need for human intervention.

For this test, I manually updated the metadata of a word document and uploaded it to a folder. I also uploaded an HTML and MSG format e-mail to see if their additional metadata elements transferred.

The updated metadata element, author, did transfer; the metadata element for "Company" did not. The additional HTML and MSG metadata elements did not transfer either.



The metadata elements that do transfer are Name, Title, Author, Creation Date, Size and Mimetype. I notice in the Wiki instruction, "Records Management Administration Console", that the Administrator has the power to map metadata elements from E-mail to Alfresco, and also allows for "drag and drop" of e-mail in to Alfresco. Though I cannot test this, I suggest that it be an important feature to be reviewed at initial set up, with all mandatory metadata elements mapped.


I rate this test as a bare PASS
It looks like it is possible to map automated transfer of metadata elements, but it is unavailable to test in the cloud.

Records Manager
  • Warn your users that the current Alfresco requires some manual intervention to populate mandatory metadata elements.
  • Talk to IT about bulk populating the documents in your system; for instance, Originating Organization with your business name. This should be possible as the opportunity to bulk populate is listed in the DOD standard (C2.2.7.5.6).
Business User
You can view the metadata elements of your Word 2010 document at any time under File>Info. Microsoft calls the metadata elements "properties".

Developer
Build additional links between the metadata elements of documents and Alfresco; for instance,
  • Company to Originating Organization
  • Author to Author AND Originator
  • E-mail, Correspondence - Date Received, Addressee, and Other Addressee.
This should be done at setup, but I can't test in the cloud. The Wiki tutorial describes mapping elements from IMAP e-mail clients.

Notes
DOD 5015.2, C.2.2.4.7 and C5.1.6 for parsing metadata elements from ingested documents.

Friday, February 11, 2011

Alfresco Test Day 2 - Declare a Record

This is day two of a ten day trial of Alfresco RM, the next step to a paperless office by allowing you to file  records so that your electronic record is authentic and defensible. Today I am testing the "Declare a Record" feature, which includes uploading documents in to folders, updating mandatory metadata, and declaring (or publishing) the record.

The act of declaring the record flips the switch to authenticity. You are declaring, "On this day, this is what is said, by me." (Who, What, When).

I tested uploads in the following formats:

Graphic Interchange Format Image (GIF)
HyperText Markup Language document (e-mail) (HTML)
Joint Photographic Experts Group Image (JPEG)
Microsoft Excel (XLX)
Microsoft Power Point (PPT, PPTX)
Microsoft Word (DOC, DOCX)
Outlook Item (e-mail) (MSG)
Portable Document Format Document (PDF)
Portable Network Graphics Image (PNG)
Text Document (saved e-mail) (TXT)


The upload feature worked beautifully until I tried mixing Outlook and HTML formats with other types. The upload did not show as being completed, but the documents did load after a couple tries. (On subsequent days I had no problems uploading or mixing types). The Outlook format MSG did upload but is not readable within Alfresco. When I downloaded, however, the current version of Outlook opened the document for me. The MSG format fails the authenticity test, as the document must be readable for the lifetime of the record and cannot be dependent on outside software.

I then added mandatory metadata fields for selected records, and declared them. Note the updated documentation for a declared record.

Another test of authenticity is to check if a declared record can be subesquently changed or overwritten. Alfresco does allow me to download and modify a declared record. If I try to upload the modified document under the same name, however, Alfresco modifies the title (i.e. DeclaredRecord.doc and new DeclaredRecord-1.doc). When I tried to modify the title to overwrite the declared record, I was given an error message, below (red text mine). This is good.



I rate this test as a PASS

Records Manager
Work with your IT support to confirm that all users are identified on the system (full name and originating document) to support autofill of mandatory fields. Here are the mandatory fields. Originator, Originating Organization, Date, Publication Date, Name of Document, and Title of Document. Some of these fields are autofilled by Alfresco from the source document.




If your project includes any significant scanning, make sure your scanning process includes capture of the mandatory record characteristics: Originator, Originating Organization, Date, Publication Date, Name of Document, and Title of Document.

Posting of e-mail as records is cumbersome, turning a three-step process in to four steps (save as HTML to shared drive, upload, add metadata, declare).
  • I first saved an e-mail on to my drive in HTML format then uploaded it. The HTML appeared to fail but it uploaded anyways.
  • The Outlook format (msg) fails the authenticity test as it is software-dependent (Outlook)
  • The (txt) format fails the authenticity test as all formatting is lost.
I notice in the Wiki instruction, "Records Management Administration Console", that the Administrator has the power to map metadata elements from E-mail to Alfresco, and also allows for "drag and drop" of e-mail in to Alfresco. Though I cannot test this feature, I suggest that it be an important feature to be reviewed at initial set up, with all mandatory metadata elements mapped.

Because the RM product distinguishes declared records from drafts/copies, I recommend that you do not set up the Records Management module for drafts and working papers. Rather, use Alfresco Document Management (DM) or Collaboration (Share). If users require structure to manage your working documents, create a similar structure to your RM in DM or Share.

I estimate perhaps 5% of total unstructure documents maintained by a system (e-mail, shared drive) would need to be declared a records in RM. An exception to this would be transactional and case activities such as applications and client records, where nearly all documents created would end up as records.
  • If an organization adopted the tight ISO 15489 definition of a record (evidence of a business transaction);
  • Publishes Records and Information Management (RIM) policy including the role of every employee to identify and declare their records to the file plan;
  • Instructs every employee on their obligation to declare business records (evidence of work completed, decisions made, commitments);
  • Audits the RM system for compliance, following up where gaps are found;
  • THEN the organization can make a strong argument, if ever involved in e-discovery, that scrutiny be limited to the official record only (5% of total documents held). Draft, informal, reference, and incomplete information, with potentially inconsistent or embarrassing content, would be excluded from prying eyes.
This managed use of the RM system could be very good for the organization, making RM achievable again.

Business User
From within a file folder, uploading a document and declaring it as a record is a three step process:
  1. Upload: Click "File" from your top bar. You are prompted; "Are you filing an electronic or paper record?" Select electronic.Click on the button "Files to Upload" and browse to the location to upload files. Select by double clicking, and when you have all your files selected, click OK.
  2. Add Metadata: Your documents are now loaded in the folder, "Undeclared Record". You may have the option to "Declare as Record", but most likely you will need to add metadata first. Click on the "Add Metadata" option on the right of the document, add all mandatory fields (starred), and Save.
  3. Declare Record: Click on the "Declare Record" option on the right of the document. You will notice that the yellow "Undeclared Record" warning is removed, and date filed, publication, and originators are all recorded.


The advantage of declaring a record:
  • You can distinguish the original, official, or "master" record from drafts.
  • You always know where your original is.
  • Declared records help you manage all your commitments, evidence of work promised and done.
  • If ever challenged through litigation, you could argue that discovery be limited to your official record repository, reducing risk and cost to your organization. (This could only be argued if you can produce evidence that declaring records is the stated and followed process for all records in your organization).
I am compelled to list these advantages because this three-step process is cumbersome. There are too many mandatory fields to be entered manually. This is not the fault of the developer; these are all mandatory entries as identified by the DOD and Dublin Core standards to confirm and maintain the authenticity of the record  (see notes below). A solution would be to build intelligence in to the software to autofill these mandatory fields.

Because of this distinguishing of declared records and drafts/copies, I recommend that you do not file drafts and working papers from your unmanaged content (shared drives and e-mail) in the Records Management module. Rather, use Alfresco Document Management (DM) or Collaboration (Share). If you need structure to manage your working documents, create a similar structure to your RM in DM or Share.

Developer
The manual entering of mandatory metadata elements is cumbersome.
  • I see that Title autofills with the Name, with the option to ovveride. This is good.
  • Wherever possible, the system should autofill mandatory elements. Publication Date, for instance, could default to the current date (with the user having the option to override).
  • Can we tighten up the metadata page to one screen?
  • Put "Declare as Record" button at the bottom of the Metadata entry screen to eliminate a step.
  • Does the enterprise version allow for drag-and-drop? This would be especially useful for e-mail.

Notes 
Can a declared record be modified or overwritten? DOD 5015.2, C2.2.3.7.
Dublin Core for Metadata, cross referenced to DOD 5015.2  and Alfresco field names as listed below.

DOD 5015.2Dublin CoreAlfresco Field
C2.T3.5contributor, creator, publisherOriginator (mandatory)
C2.T3.6contributorOriginating Organization (mandatory)
C2.T3.4datePublication Date (mandatory)
C2.T3.2subject, titleName, Title (mandatory)
C2.T3.1identifierUnique Record Identifier (mandatory)
rights
C2.T3.11relationAddressees
coverage
C2.T3.3date
C2.T3.10dateDate Received
descriptionDescription
C2.T3.9format [MIME]Format
language
C2.T3.13Location
C2.T3.8typeMimetype, Media Type
C2.T3.14
C2.T3.12relationOther Addressees
relation
source
C2.T3.7Supplemental Marking List

Wednesday, February 9, 2011

Alfresco Test Day 1 - Implement File Plans

This is day one of a ten day trial of Alfresco RM, the next step to a paperless office by allowing you to file electronic records so that your electronic record is authentic and defensible. Today I am testing the "Implement File Plans" feature which should allow me to create a file plan, edit, sort and view. With each test I will declare a pass or fail, recommendations for the developers, RM community and business user, and lessons learned along the way.


  • In two clicks from the Alfresco cloud, I am at the Records Management Site.
  • Note the Wiki and File Plan options from the banner.
  • The Wiki contains some tutorials; a good start for new users.
  • I quickly built a couple series, categories, and folders. I uploaded documents in to a couple folders with little difficulty (I received one error message that an entry had failed, but when I tried again it succeeded).
  • I uploaded seventeen documents of various types (jpg. pdf, xls) all at once. It took a few minutes in the cloud, but it also tracked my progress by green bar.
  • I also edited category names by changing the metadata.
I rate this test as a PASS

Records Manager
New Series - show up in the left Navigation pane after refreshing the screen (F5).



  • Add first your Series, then Category then Folder.
  • If you are using a functional file plan for your organization, then Series would relate to Function, Category to Sub-Function, and Folder to Activity.
  • If you are using a block-numeric subject classification system, then Series would relate to Block, Category to Primary, and Folder to Secondary.
  • Records can then be imported in to the folders you have made. This is the first level where documents can be added.
  • Schedule information is added at the Category level.
  • The term "Expression" is referring to a scheduling function, the number of days/months/years after an event when the records reach final disposition action.
  • All mandatory fields are starred (*). Alfresco won't let you move on from an entry window until all mandatories are completed. (good).
  • The system will not allow a Category to be saved with a review period of "Not Set", and if "None" is selected, it will not allow the expression field to be completed. (good).

Business User
  • Before you can upload documents, the File Plan Series, Categories, and Folders must first be set up.
  • You may or may not be granted permission to edit these, so see someone with those permissions (Out of the box, this would likely be the Administrator, Records Manager, and Power User)?
  • Documents are added to folders.
Developer
Is there a way for a complete file manual to be imported? I suspect this may be available in the full version -  not in the cloud - as there are greyed out buttons on the RM site. I expect an import document would need to be in a specific format (i.e. tab delimited) with a one-to-one relationship to all mandatory fields. It looks like there would need to be separate imports for Series, Category, and Folder.

Notes:
This test checked compliance to DOD 5015.2 requirements C.2.1.1.1 to C.2.2.1.6 and MoReq 3.1.4

Tuesday, February 8, 2011

Ten Days of Testing

Starting tomorrow, I will undertake ten days of User Acceptance Testing of Alfresco RM 2.0, designed to manage an organization's electronic records. Products like these pave the way for a green, paperless office. I must know if it lives up to its claims before I actively promote it, and by dedicating these ten days I will build a list of recommendations and tips that will help business users implement with a minimum of fuss.

Implementation Enterprise Content Managment (ECM)/Electronic Document Management System (EDMS) can often exceed the cost of the product itself, as successful implementation depends on the business having a clear understanding of what it does and how work flows. There are frameworks to build, decisions on accessibility and security, and intelligent roll-out with plenty of hands-on training. You just can't take away a man's files without giving him a sensible replacement.

So let's reduce the fuss and make these products easy to implement.

I've picked ten critical features to test that are identified on both the DoD 5015.02-STD and MoReq standards. You can request a copy of my comparison matrix by popping me an e-mail.

Over ten days I will test the following features:
  1. Implement File Plans
  2. Declare and file - prevent subsequent changes (integrity of the record)
  3. Transfer Record Elements - Parse metadata elements from ingested data using GUI
  4. Transferring  -  documentation of transfer activities including system audits
  5. Destroying - deleting in a manner that prevents reconstruction
  6. Searching and Retrieving - including wild card and boolean searches
  7. Authorizations - only authorized individuals can view portions, edit file plan and schedule
  8. Schedule - create and edit schedule
  9. Schedule  - implementation up to disposal
  10. Schedule - freezing and unfreezing records
With each test I will declare a pass or fail, recommendations for the developers, RM community and business user, and lessons learned along the way. RIM professionals must remember that the end result must be a support to the business, rather than a barrier. Let's not allow our native passion for order blind us to the gutsy reality of daily use. Even if imperfect, it must be easy to use.

The Recipe for Influence

One of the great skills for the Records and Information Management (RIM) professional to build is influence. For the sake of this article, I am talking about inflluencing your boss or organization to take the leap for your next great idea or to recognize the importance of managing our information assets. Inflluence has value beyond the executive team. Because ours is often a quiet, overlooked discipline, everyone from the new hire in the file room to the Senior Records Officer has a role to play in promoting and inflluencing excellent RIM behavior.



There are so many ways to try and influence people, but with very different results. Nagging and whining, for instance, is learned from childhood, is well understood, and garners a predictable result. But if you want to be heard, it is time to learn new techniques. A format I have grown fond of is a recipe style, or pattern, that names the technique, places it in context, describes the problem, forces that could make or break the technique, solution, rationale, and resulting context (that is, postitive and negative consequences for applying the technique). You have the opportunity then to flip through the patterns and pick the best style to match your situation. I acquired a whole book of forty-eight patterns, Fearless Change: Patterns for Introducing New Ideas and if you want to learn more, I encourage you to check it out.

Before you blurt out your next great idea, analyse the situation considering these factors.

1. Know your audience. Who will you be presenting your idea to? What matters to them? Do they have a stated vision and mission that you can help them achieve? If so, show how your idea will help them meet their needs and goals. Also, pay attention to their listening style. Does your audience the reflective type that needs to see it in writing to take your idea seriously? Then put it in writing. If your idea is for the executive floor, also provide an executive summary. Respect their time. Or alternatively is yours a person of action, impatient with power point? If so, condense your message to a sound byte (an "elevator pitch").

2. Consider timing.  This could be as simple as approaching your supervisor when they are at their peak energy. If your boss needs two cups of coffee to be civil, don't pitch first thing in the morning. For an organization-wide idea, know the rhythms and cycles of your company. When does their planning cycle start, when your boss will be looking for new ideas? When is fiscal year-end approaching? Often year-end funds become available for a short window of time. Be ready with an idea if an opportunity comes up. Slow cycles might be the best time to implement some new ideas, to minimize disruption.

3. Seeing is believing. You may have a complete visualization on how your idea will help the organization. The barrier often is communicating the idea effectively so that others can see what you do. If your idea is a new tool, bring one in to the office to generate interest. I once asked a vendor for a sample shredding bin to sit in my office for a few weeks. The office had never seen such a thing, so a lot of interest was generated by walk-by traffic. Curiosity led to questions led to new interest in an improved way of disposing of shredding. Try before-and-after pictures, diagrams, napkin conversations (ref. Paul Lauterbur, inventor of MRI), several different visualizations to help your audience to see what you see.

4. Moving past resistance. In every organization you have a spectrum of interest from your early adopters to active resisters (laggards). A great idea, adopted by the innovators in your office, may still not be adopted by the mainstream. A book that addresses this is Crossing the Chasm by Goeffrey A. Moore. As difficult as active resisters can be, they provide the voice to the majority of people who worry that change will bring new problems. Use them as a voice to the potential problems and address them. Make sure participants and their issues are heard (Covey's fifth habit, Seek to Understand). Present your ideas informally and at brown bag functions to curry out your innovators and resisters. Ask your innovators to pilot your idea, and then to promote to the majority of the organization. If your boss is the resister, make sure all concerns are heard and addressed.

In conclusion, you can improve on your influence by listening, being prepared, developing your idea in to various formats including written, sound byte, and visualizations, addressing concerns and tying your ideas to the vision of the organization. There are then dozens of recipes, or patterns to influence change that you can apply to success.

Sunday, February 6, 2011

Bureaucracy Truisms

Janet's list of bureaucracy truisms.
  1. Never blame conspiracy when incompetence will do.
  2. A leader who has achieved perfect obedience will never see the group exceed her intelligence.
  3. Those in charge are no smarter than you or I.
  4. Competency is rendered powerless in an incompetent structure.
  5. The primary goal of government is to avoid embarrassment. The primary goal of bureaucracy is to sustain itself.
  6. In a culture of scarcity, hoarding will occur.
  7. The gears of bureaucracy grind slowly.
  8. Fear of embarrassment hinders change.
  9. In an incompetent structure, embarrassment is inevitable.
  10. Incompetent structures transcend governments


The public service here in Alberta is so lean, so hard working, so invisible to the average citizen. It has sustained significant cuts to it's work force and maintained services in the face of growing demand. Yet public perception is decades behind the reality. Government is seen as too big, too bulky, too slow, unresponsive. Why is this?

Obama suggests a few reasons in his book, "The Audacity of Hope". "I am convinced -- although I have no statisical evidence to back it up -- that antitax, antigovernment, antiunion sentiments grow anytime people find themselves standing in line at a government office with only one window open and three or four workers chatting among themselves in full view." (p. 73) and "Just as too many corporate managers, shielded from competition, had stopped delivering value, too many government bureaucracies had stopped asking whether their shareholders (the American taxpayer) and their consumers (the users of government services) were getting their money's worth." (p. 185)

I like also Jim Diers' perspective in his book, Neighbor Power. "Voters are reluctant to approve additional resources because they feel a sense of alienation from their government at all levels...This deep sense of alienation is often misdiagnosed as apathy...This analysis, I believe, blames the victim. Citizens don't vote because they have seen little evidence that their votes matter...I quickly realized that public officials felt as powerless to address these issues as did the citizens." (p. 18-27)

So here we have an endless catch-22 (or catch-44). Citizens won't spend more if they don't see value. Politicians won't approve more without public backing. The public service can't offer more as they are constrained in the bureacracy they are in. The bureacuracy can't change in a culture of scarcity.

I refuse to end here because I believe that improvement comes from positive action. The way out is for each stakeholder; citizen, politician, public worker and bureaucracy, to take inventory of what is in their power to do towards positive change. Then each must build trust towards the other toward our common goals.

Obama's administration has matured in it's first year, and has collected it's share of detractors. The complaint that bothers me most is those who criticize Obama for not doing enough to bring the nation out of  financial crisis. Those who followed Obama's campaign and the hope he gave the nation should remember that he never claimed any superhuman power. A nation must save itself. The hope comes from everyone pulling together. "This nation's founders, who somehow rose above petty ambitions and narrow calculations to imagine a nation unfurling across a continent. And those ... who ultimately laid down their lives in the service of perfecting an imperfect union. And all the faceless men and women, slaves and soldiers and sailors and butchers, constructing lives for themselves and their children and grandchildren, brick by brick, rail by rail, calloused hand by calloused hand, to fill in the landscape of our collective dreams.

It is this process I wish to be a part of." (p. 427)