Configuring the AutofilingMembership.xml file for auto-filing

To set up Auto-filing in the FileHold system using the pre-configured scripts, you need to do the following:

  • Get the list of GUIDs to assign membership to the automatically created Cabinets, Drawers, and Folders. A GUID is a unique ID number for each user and group.
  • Edit the AutofilingMembership.xml file with the unique GUIDs.

Retrieving the GUIDs (FileHold 14 and later)

To retrieve the list of GUIDs

  1. On the FileHold server, run FH Instrumentation Tools (FHIT) in C:\Program Files\FileHold Systems\Application Server\FHInstrumentation.
  2. In FHIT, go to Actions > Users management and select the Export GUIDs option.
  3. Click Start.
  4. In the Export GUIDs window, do the following:
  • Enter the name of the Microsoft SQL server that FileHold runs on.
  • Select an authentication option. Enter the username and password if required.
  • Set the destination to save the file on the server.
  1. Click Next.
  2. Click Export. You will receive a message that states that the export completed successfully.
  3. Click Finish.
  4. Open the GUIDs.txt file that was successfully exported.
  5. Use the GUIDs in the file to assign membership to the Cabinets, Drawers, and Folders in the AutofilingMembership.xml file using the procedure below.

Retrieving the GUIDs (FileHold 12 and earlier)

A GUID is a unique ID number for each user and group in the FileHold system. You will need the GUID number in order to assign the automatically generated Cabinets/Drawers/Folders to a user or group. To get a list of the GUIDs for the users, you will need to run the ADAMDump application on the server.

Retrieve the List of GUIDs

  1. On the FileHold server, go to C:\Program Files\FileHold Systems\Application Server\ADAMDump
  2. Double-click the ADAMDump.exe file.
  3. In the ADAM Dump window, click Retrieve GUIDs. You need to run the application as a System Administrator.
  4. You will receive a message that states that the FHURM Objects have been retrieved and stored in the FHURMObjects.txt file. Click OK.
  5. In the same directory as the ADAMDump.exe file, open the FHURMObjects.txt file.
  6. Use the GUIDs in the file to assign membership to the Cabinets, Drawers, and Folders in the AutofilingMembership.xml file.
Image
Sample GUIDS.txt file

Using the GUIDs in the AutofilingMembership XML file

In order to use the auto-filing scripts provided in FileHold, you will need to edit the AutofilingMembership.xml file.

Edit the AutofilingMembership.xml file

  1. On the FileHold server, go to C:\Program Files\FileHold Systems\Application Server\LibraryManager\AutoFiling
  2. Open the XML file in Notepad or an XML editing tool.
  3. Save the XML file once you have done editing the file with the GUIDs.

Example of an unedited AutofilingMembership.xml File

<?xml version="1.0" encoding="utf-8"?>

<AutoFilingScripts xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">

<!-- If you are using the Date-Based auto-filing script, fill out this section -->

  <AutoFilingScript>
    <Name>Date-Based</Name>
    <Cabinet>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
    </Cabinet>
    <Folder>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

<!-- If you are using the SchemaName-Date-Based auto-filing script, fill out this section -->
  <AutoFilingScript>
    <Name>SchemaName-Date-Based</Name>
    <Cabinet>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
    </Cabinet>
    <Folder>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

<!-- If you are using the FilePathFromMD auto-filing script, fill out this section -->
  <AutoFilingScript>
    <Name>FilePathFromMD</Name>
    <!-- Enter name of metadata field containing the destination location -->
    <MD_FieldName>Destination</MD_FieldName>
    <!-- Enter single character used as separator of location parts -->
    <Separator>/</Separator>
    <Cabinet>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
    </Cabinet>
    <Folder>
      <!--Here you can put a description of a member-->
      <Member>Please provide here a guid of a requested user in format dddddddd-dddd-dddd-dddd-dddddddddddd</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript> 
</AutoFilingScripts>

Example of an edited AutofilingMembership.xml file updated with the GUIDs

<?xml version="1.0" encoding="utf-8"?>
<AutoFilingScripts xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <AutoFilingScript>
    <Name>Date-Based</Name>
    <Cabinet>
      <!--Engineering Publishers-->
      <Member>00c92bd5-aaa5-468b-a1b0-9353961295da</Member>
      <!--Engineering group with editing rights-->
      <Member>3afc37c3-8ce6-49c4-97c3-77cd6e5b48da</Member>
    </Cabinet>
    <Folder>
      <!--Engineering - all-->
      <Member>ad56465b-73d9-4a4a-ac3d-59c3f23c5c4e</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

  <AutoFilingScript>
    <Name>SchemaName-Date-Based</Name>
    <Cabinet>
      <!--Basie McMarvin-->
      <Member>3afc37c3-8ce6-49c4-97c3-77cd6e5b48da</Member>
    </Cabinet>
    <Folder>
      <!--Sabine Marie-->
      <Member>d4290ff8-033e-4948-b4ed-05b6db1a337</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

  <AutoFilingScript>
    <Name>FilePathFromMD</Name>
    <!--Autofiling Destination location -->
    <MD_FieldName>AutofilingLocation</MD_FieldName>
    <!-- Enter single character used as separator of location parts -->
    <Separator>/</Separator>
    <Cabinet>
      <!--Library Admin-->
      <Member>dd8d3baf-2c55-4f03-8e22-b511610c8a75</Member>
    </Cabinet>
    <Folder>
      <!--Document Publishers-->
      <Member>c2682088-d20e-4ef5-8603-c314ba5af238</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>

  </AutoFilingScript> 
<AutoFilingScript>
    <Name>Date-Based</Name>
    <Cabinet>
      <!--Engineering Publishers-->
      <Member>00c92bd5-aaa5-468b-a1b0-9353961295da</Member>
      <!--Engineering group with editing rights-->
      <Member>3afc37c3-8ce6-49c4-97c3-77cd6e5b48da</Member>
    </Cabinet>
    <Folder>
      <!--Engineering - all-->
      <Member>ad56465b-73d9-4a4a-ac3d-59c3f23c5c4e</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

  <AutoFilingScript>
    <Name>SchemaName-Date-Based</Name>
    <Cabinet>
      <!--Basie McMarvin-->
      <Member>3afc37c3-8ce6-49c4-97c3-77cd6e5b48da</Member>
    </Cabinet>
    <Folder>
      <!--Sabine Marie-->
      <Member>d4290ff8-033e-4948-b4ed-05b6db1a337</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript>

  <AutoFilingScript>
    <Name>FilePathFromMD</Name>
    <!--Autofiling Destination location -->
    <MD_FieldName>AutofilingLocation</MD_FieldName>
    <!-- Enter single character used as separator of location parts -->
    <Separator>/</Separator>
    <Cabinet>
      <!--Library Admin-->
      <Member>dd8d3baf-2c55-4f03-8e22-b511610c8a75</Member>
    </Cabinet>
    <Folder>
      <!--Document Publishers-->
      <Member>c2682088-d20e-4ef5-8603-c314ba5af238</Member>
      <!--Alternatively uncomment this node to make folders inherit members from cabinet-->
      <!--<Inherit />-->
    </Folder>
  </AutoFilingScript> 
</AutoFilingScripts>