Kofax XML format

To populate TotalAgility fields with document or folder fields of an XML file, TotalAgility must have the correct document or folder type. Once the target document type is identified, TotalAgility can acquire the list of the fields defined in the document or folder type and populate their values. The following table specifies how the XML field values are mapped to TotalAgility fields.

XML	TotalAgility
Batch class name	Process name The availability of the batch class name field in the XML overrides the setting in the import configuration. If the batch class name is not specified in the Kofax XML, then the process configured using import configuration is used.
Form type name in Document tag	Classification group and document type Kofax XML provides the classification group and document type in the document’s FormTypeName attribute, delimited by "\|". Example: FormTypeName=”ClassGroup\|DocType”. The selection of document type is determined by the process type. If the document type is not specified in the Kofax XML, then the document type is selected from the process type.
Folder Class Name in Folder tag	Folder type
Table field values	Document table columns
Tables	Table fields
Document field values	Document fields
Folder field values	Folder fields
Batch field values	Process variables
Batch Totals	Process variables
If the Page option is selected in the Kofax XML page tag processing level field	Each page tag is converted to a page.
RelativeImageFilePath	Path for importing external files that are referenced in XML file. The files are imported depending on the path contained in this field: Full path: The files from this path are imported. Blank: The location of the XML file is used for importing the files. Relative path: The location of the XML file is used as the base path.
An e-document type document	Converted to a document.
If the Document option is selected in the Kofax XML page tag processing level field	Each page tag is converted to a document.
Each XML document tag for a Folder initialization variable	Converted to a document. If the Document option is selected in the Kofax XML page tag processing level field, a TotalAgility folder with one TotalAgility document for each XML page tag, is created. This will be in one TotalAgility job. If the Page option is selected in the Kofax XML page tag processing level field, a TotalAgility folder is created. For each XML document, one TotalAgility document with all XML page tags as pages is created. This will be in one TotalAgility job. For each XML folder, one TotalAgility job is created.
Each XML document for a Document initialization variable	Converted to a job. If the Document option is selected in the Kofax XML page tag processing level field, for each XML page tag, a job with one TotalAgility document is created. If the Page option is selected in the Kofax XML page tag processing level field, for each XML document, a job with a document with all XML page tags as pages is created. XML folders are ignored and the documents within the folder are processed as documents without a folder.

All exceptional conditions are controlled as specified below:

An XML with an empty form or document type is imported as an unclassified document.
An XML with an invalid form or document type can be imported as unclassified or can be rejected.
If the Batch class name is not specified in XML and a process is not specified in the import configuration, the XML file is rejected.
If Document or Folder fields are not defined in TotalAgility, the XML file can be either imported and marked as rejected or rejected.
If there is a mismatch in the Document or Folder field type, the XML file can be either imported and marked as rejected, or rejected.
If the Folder type is not available in the XML file, the XML file can be imported as unclassified, and mark rejected or can be rejected.
If a file referenced in the XML file to be imported is not available at the specified path in the XML file, the XML file is rejected.
All files which are not referenced in the XML file for folder-level processing are imported as unclassified documents. All non-referenced documents are grouped in one last job.
All files which are not referenced in the XML file for document-level processing are imported as unclassified documents in their own jobs.

<?xml version="1.0" encoding="UTF-8"?>
<ImportSession xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Batches>
    <Batch BatchClassName="CaptureEnabled_Folder" RelativeImageFilePath="C:\temp\">
      <BatchFields>
    <BatchField Value="42367" Name="PONumber"/>
  </BatchFields>
  <Documents>
  <Document FormTypeName=" project|AAMInvoice ">
    <IndexFields>
      <IndexField Value="32.95" Name="Subtotal"/>
      <IndexField Value="2.55" Name="SalesTax"/>
      <IndexField Value="5.00" Name="Shipping"/>
      <IndexField Value="40.50" Name="Total"/>
    </IndexFields>
    <Tables>
      <Table Name="Articles">
        <TableRows>
          <TableRow>
            <IndexFields>
              <IndexField Value="1" Name="Quantity"/>
              <IndexField Value="638" Name="ItemNr"/>
              <IndexField Value="LANG STERLING PIE SERVER" Name="Description"/>
              <IndexField Value="32.95" Name="UnitPrice"/>
              <IndexField Value="32.95" Name="Amount"/>
            </IndexFields>
          </TableRow>
        </TableRows>
      </Table>
      <Table Name="ShipTo">
        <TableRows>
          <TableRow>
            <IndexFields>
              <IndexField Value="Martin" Name="FirstName"/>
              <IndexField Value="Janeway" Name="LastName"/>
            </IndexFields>
          </TableRow>
        </TableRows>
      </Table>
    </Tables>
    <Pages>
      <Page ImportFileName="page002.tif"/>
      <Page ImportFileName="page003.tif"/>
    </Pages>
  </Document>
</Documents>
</Batch>
</Batches>
</ImportSession>

<?xml version="1.0" encoding="UTF-8"?>
<ImportSession xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <Batches>
		<Batch BatchClassName="CaptureEnabled_Folder" RelativeImageFilePath="C:\temp\">
			<BatchFields>
				<BatchField Name="From" Value="42367"/>
			</BatchFields>
			<Folders>
				<Folder FolderClassName="Root Folder">
					<IndexFields>
						<IndexField Name="Name1" Value="Sasha"/>	
					</IndexFields>	
				<Documents>
				  <Document FormTypeName="project|AAMInvoice">
					<IndexFields>
						<IndexField Name="Subtotal" Value="32"/>
					</IndexFields>
            <Tables>
              <Table Name="Articles">
                <TableRows>
                  <TableRow>
                    <IndexFields>
                      <IndexField Name="Quantity" Value="1"/>
                      <IndexField Name="ItemNr" Value="638"/>
                      <IndexField Name="Description" Value="LANG STERLING PIE SERVER"/>
                      <IndexField Name="UnitPrice" Value="32.95"/>
                      <IndexField Name="Amount" Value="32.95"/>
                    </IndexFields>
                  </TableRow>
                </TableRows>
              </Table>
              <Table Name="ShipTo">
                <TableRows>
                  <TableRow>
                    <IndexFields>
                      <IndexField Name="FirstName" Value="Martin"/>
                      <IndexField Name="LastName" Value="Janeway"/>
                    </IndexFields>
                  </TableRow>
                  <TableRow>
                    <IndexFields>
                      <IndexField Name="FirstName" Value="Loose"/>
                      <IndexField Name="LastName" Value="Way"/>
                    </IndexFields>
                  </TableRow>
                </TableRows>
              </Table>
            </Tables>
					<Pages>
						<Page ImportFileName="DriversLicense2.tif"/>
						<Page ImportFileName="DriversLicense22.tif"/>
					</Pages>
				</Document>
          <Document FormTypeName="ClassGroup|DocType">            
            <Pages>
              <Page ImportFileName="DriversLicense2.tif"/>
              <Page ImportFileName="DriversLicense22.tif"/>
            </Pages>
          </Document>
			</Documents>
        </Folder>
      </Folders>
		</Batch>
	</Batches>
</ImportSession>