I have recently been asked to batch load a bunch of InfoPath Forms into a SharePoint Server for access via Forms Server. The customer had a database extract, in the form of a CSV file, and they wanted to convert this data into pre-filled forms, and then load the forms into SharePoint Server. They also wanted to apply some specific ACLs on the forms, because they contained some confidential content.
I looked a little bit around for a ready-made solution, but couldn't find an easy way to use CSV data to pre-generate InfoPath Forms & upload them to SharePoint, so I decided to write a little C# program to solve the problem.
Basically, I divided the problem in 3 chunks:
- Convert the CSV file into generic XML
- Convert the generic XML into proper InfoPath XML using an XSLT
- Upload the generated XML file into SharePoint and modify the ACLs programmatically
1. Converting the CSV into XML
I could probably just use Excel's XML capabilities to do this, but I wanted to automate all the steps in a single program. After digging a bit around the Web, I found this simple solution: XmlCsvReader on MSDN (and a slightly newer version on CodePlex). It's an implementation of an XmlReader that reads CSV input and generates an XML stream. It's really nifty and allows you to convert from CSV to XML very simply:
XmlDocument doc = new XmlDocument();
XmlCsvReader reader = new XmlCsvReader(new Uri("file:///C:/temp/StatusReportData.csv"), Encoding.UTF8, doc.NameTable);
reader.FirstRowHasColumnNames = true;
I started with this data:
1-1-2007,1,Thomas Conté,Harry Cover,firstname.lastname@example.org,Finance
2-1-2007,2,Bernard Barnier,Harry Cover,email@example.com,Finance
3-1-2007,3,Charles Duchemin,Harry Cover,firstname.lastname@example.org,Finance
4-1-2007,1,Ludovic Cruchot,Harry Cover,email@example.com,HR
5-1-2007,2,Claude Ratinier,Harry Cover,firstname.lastname@example.org,HR
6-1-2007,3,Jean Durand,Paul Dugenou,email@example.com,HR
7-1-2007,1,Paul Martin,Paul Dugenou,firstname.lastname@example.org,HR
8-1-2007,2,Gaston Lagaffe,Paul Dugenou,email@example.com,IT
9-1-2007,3,Paul Marcel,Paul Dugenou,firstname.lastname@example.org,IT
10-1-2007,1,Marcel Paul,Paul Dugenou,email@example.com,IT
And XmlCsvReader generates an XML document that looks like this:
The complete document contains one row element for each line in the original CSV file. Now I need to break up this document in chunks, and convert each row element into a properly formatted InfoPath XML document.
2. Converting the XML into an InfoPath document
An InfoPath document, or form, is just a regular XML file, with a couple of XML Processing Instructions that indicate that the XML file is indeed an InfoPath form. These two expressions, that must be present at the top of the XML file, are:
<?mso-application progid="InfoPath.Document" versionProgid="InfoPath.Document.2">
and the mso-infoPathSolution instruction that indicates, among other things, the location of the for template.
Now, our base data being XML and the target InfoPath document being XML as well, the easiest way to convert from one to the other is of course to use an XSL Transformation (XSLT). This XSLT will simply output the InfoPath XML document, while inserting the data from our generic XML file in the right places. The easiest way to create the XSLT is to start from the target InfoPath XML: use the InfoPath client (or SharePoint Forms Server) to create an empty form. Then open the resulting XML file using your favorite text editor, and copy the whole XML skeleton into the body of your XSLT. The result, including the processing instructions, will look like this:
<?xml version="1.0" encoding="UTF-8" ?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:text>name="urn:schemas-microsoft-com:office:infopath:Status-Reports:-myXSD-2005-09-22T20-42-56" solutionVersion="22.214.171.124" productVersion="126.96.36.199" PIVersion="188.8.131.52" href="http://w2k3sp2-spdev/SiteDirectory/infopath/Status%20Reports/Forms/template.xsn"</xsl:text>
<my:statusReport xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:my="http://schemas.microsoft.com/office/infopath/2003/myXSD/2005-09-22T20:42:56" xmlns:xd="http://schemas.microsoft.com/office/infopath/2003" xml:lang="en-US">
Note that we insert our original XML file element values into the XSLT output, using xsl:value-of in the right places. Now, all we need to do is to actually apply this XSLT to our XML document:
XslCompiledTransform transform = new XslCompiledTransform();
foreach (XmlNode n in doc.DocumentElement.ChildNodes)
string fileName = n.ChildNodes.InnerText + ".xml";
string filePath = "C:\\temp\\" + fileName;
StreamWriter writer = new StreamWriter(filePath);
transform.Transform(n, null, writer);
The key here is the XslCompiledTransform.Transform() method, that actually executes the transformation. Note that we iterate over our document's child nodes (i.e. row elements) and apply the XSLT to each chunk. In this example, the result is written to a temporary file on the disk, so that you can actually test the result by opening it with InfoPath.
Congratulations, you just converted a CSV data export into a bunch of InfoPath forms!
3. Upload the forms to SharePoint
The last part of our little operation is to actually publish the forms to a SharePoint Server, so that employees can open and update the forms using Forms Server (allowing them to complete these tasks using a Web browser, instead of having to edit the form on their desktop with the InfoPath client).
Since my batch program was intended to run on the SharePoint server itself, I was able to use the SharePoint API directly to upload the form. The code is fairly straightforward:
SPWeb web = new SPSite("http://w2k3sp2-spdev/SiteDirectory/infopath").OpenWeb();
FileStream fStream = File.OpenRead(filePath);
byte contents = new byte[fStream.Length];
fStream.Read(contents, 0, (int)fStream.Length);
web.Files.Add("Status%20Reports/" + fileName, contents);
The last part is a bit more tricky: using SharePoint 2007 new Role Assignment API to automatically apply security settings on the uploaded forms; the idea being, for example, to make sure each form can only be edited by the corresponding employee. The code will look like this:
SPFile newFile = web.GetFile("Status%20Reports/" + fileName);
SPRoleDefinitionCollection roleDefs = web.RoleDefinitions;
SPRoleAssignmentCollection roleAssignments = newFile.Item.RoleAssignments;
SPRoleAssignment newAssignment = new SPRoleAssignment("W2K3SP2-SPDEV\\SPUser", "firstname.lastname@example.org", "SP User", "");
In this code, we first use BreakRoleInheritance() to stop inheriting the ACLs from the library. We then retrieve the current site Role Definitions (i.e. "Read", "Contribute", "Full Control", etc.) We then create a new Role Assignment (for a test user called SPUser), apply the "Read" role to it, and add it to the RoleAssignments collection for the form we just uploaded.