Skip to main content
Windward

Gather Metadata

Overview

Gather Metadata is a command line utility that allows the user to acquire tons of information about all of their AutoTag templates. 

Features

Information that can be gathered:

  • Number of tags
  • Datasource information
    • Displays all of the information that is stored about each datasource
      • Includes the type of source, the server connected to, Username + Password, etc...
  • Fonts
    • This list of fonts contains ALL fonts in the document. May display more fonts than anticipated.
  • Variables tags
    • Displays the variable name and it's default value, assuming there is one.
  • Import tags
    • Attempts to display all of the data stored within an import tag.

How to Run

First open a command prompt and navigate to the directory of the exe.

To gather the metadata of a single template run:

GatherMetadata.exe [FILE PATH] 

Ex:

GatherMetadata.exe c:\template.docx

 

To gather the metadata of a whole directory run:

GatherMetadata.exe -d [DIRECTORY PATH]

Ex:

GatherMetadata.exe -d c:\templates

 

For more advanced and/or optional parameters see Usage.

Usage

When you first attempt to run the program, this is the message that you will be greeted with:

 

Usage: GatherMetadata [-v][templateFile | -d directory_path | -s directory_path]                 [filter_string]

     The template file(s) can be docx, xlsx, or pptx
     -v[erbose]: Displays extra information about the datasources
     -d directory_path: Selects and counts template files within the directory
     -s directory_path: Selects and counts template files within the directory and its subdirectories

     filter_string: <string>*.docx | *<string>.docx
         Ex: "*-template.docx"  This will select the file(s) that end
         with "-template.docx"
         Ex: "template-*.docx"  This will select the file(s) that start
         with "template-"

 

Let's break this down.

The first parameter is '-v.' '-v' stands for Verbose. '-v' is an optional flag that will receive ALL available information about your datasources. Some of this information is useful and some is not.

 

The second parameter, and the most important parameter, tells the program what to look at. You have a couple of options here. If you would like to look at a single file, just enter the path to said file. However, if you would like to look at the contents of an entire directory, you have two options.    

If you want to look at just the contents of a single directory, and not its subdirectories, use a '-d' flag along with the path to the directory.

However, if you want to look at the contents of a directory AND its subdirectories, use a '-s' flag along with the path to the base directory.

 

Finally, the third parameter allows you to filter the contents of a directory. This optional parameter is intended to be used in conjunction with a '-d' or '-s' flag. To use a filter, you first must decide what portion of a file name you want to filter for. For example, if you only want to look at files that end with "- Template.docx", your filter parameter would look something like this: " *- Template.docx". Please note that location of the *. The * tells the program that the only thing that is required of the file names is that it ends with "- Template.docx"

Details

Gather Metadata is a command-line utility. The main files are:

GatherMetadata.exe

GatherMetadata.exe.config

Please note: You must put a valid Windward license into the config file in order to use GatherMetadata.

Download

Download here.

  • Was this article helpful?