powerKNOW Tree Loader command line usage

powerKNOW Tree Loader can be started from the commandline with or without using GUI.

These are the possible commandline arguments:

Argument Description

-Base xxx Base folder / directory to be scanned for files to be loaded.

-InclSub If argument is given the subfolders of the directory given will be scanned as well.
If argument is omitted only the base folder itself will be scanned.

-Ext xxx List of file extensions to be loaded.
Separate the extension by comma. All other files in the diretory / tree will be ignored.
Default: List of extensions indexed by this installation of powerKNOW

-Do xxx xxx is a combination of the three letters 'N', 'U', 'D'. (e.g.: "-Do NU')

Meaning of 'N': Action to be taken when a new file is found (not already present in the knowledge base):
'N' present: Load = create new knowledge document with this file loaded as the first attachment. First text, title and status filled as specified in the corresponding fields.
'N' omitted: ignore new files

Meaning of 'U': Action to be taken when a file is found which has already been loaded to the knowledge base by powerKNOW Tree Loader and which has been changed in the meantime:
'U' present: Update = reload the file found as the first attachment of the knowledge document. Refresh first text, title and status as specified in the corresponding fields.
'U' omitted: ignore changed files

Meaning of 'D': Action to be taken when a file is found in the knowledge base belonging to the directory / tree specified, previously loaded by powerKNOW Tree Loader and no longer present in the directory / tree:
'D' present: Delete the corresponding knowledge document
'D' omitted: ignore removed files

-Title xxx Title of the knowledge document created / updated for a file found.
See "replacement of variables" for a list of variables which can be used in this text.

-Text xxx Contents of the first internal text (first text to be listed und 'MyStructure') of the knowledge document.
See "replacement of variables" for a list of variables which can be used in this text.

-TextTrigger xxx Trigger to be used to update only parts of the first text in case of a changed file. See "Replacing only parts of the text" for details.

-Status x Status of the knowledge document created/updated.
x is one of the letters 'U', 'C', 'R':
'U'=Under construction
'C'=Completed
'R'=Released

-User xxx Username to be used to login to the powerKNOW database. This must be a valid username of powerKNOW.

-Pw xxx Password of the powerKNOW user.

-v Verbose mode.
Will also report/log files already up to date.

-noGUI Run powerKNOW Tree Loader in commandline mode without using the GUI
All logging / reporting will be send to standard-out / error-out.

-cfg xxx Path of powerKNOW config file to be used.
If you specify this argument be sure to use an absolute path for all directory / file path parameters in this config file.

It's best to use an absolute path. If you want to use a relative path see description of '-noCd'.

Default: .\data\config.config

-Argfile xxx Path of a sequential file containing additional commandline arguments.
This arg. is especially useful if all the arguments you want/need do not fit into the limitations of the commandline.

It's best to use an absolute path. If you want to use a relative path see description of '-noCd'.

Example:
-Base= C:\temp -InclSub= -Do= dnu -Ext= doc,xls,htm,html,txt,pdf -Text= path: %path% %\n%Last update: %TimeUPD% ##-TextTrigger=_StartHere_ -Title= File: %name% -Status= c -User= kmanager -PW= xxxx
('#' starts a comment)

-noCD Do not change directory.
Normally powerKNOW Tree Loader changes the working directory to exe-directory\.. (one directory up from the directory where the powerKNOWtreeLoader.exe resides). This way powerKNOW Tree Loader makes sure to be able to work with the powerKNOW config file even if relative paths are used within the config file.

If you want to use '-noCd' be sure to use absolute paths for command line arguments and within the config file.

Argument	Description
-Base xxx	Base folder / directory to be scanned for files to be loaded.
-InclSub	If argument is given the subfolders of the directory given will be scanned as well. If argument is omitted only the base folder itself will be scanned.
-Ext xxx	List of file extensions to be loaded. Separate the extension by comma. All other files in the diretory / tree will be ignored. Default: List of extensions indexed by this installation of powerKNOW
-Do xxx	xxx is a combination of the three letters 'N', 'U', 'D'. (e.g.: "-Do NU') Meaning of 'N': Action to be taken when a new file is found (not already present in the knowledge base): 'N' present: Load = create new knowledge document with this file loaded as the first attachment. First text, title and status filled as specified in the corresponding fields. 'N' omitted: ignore new files Meaning of 'U': Action to be taken when a file is found which has already been loaded to the knowledge base by powerKNOW Tree Loader and which has been changed in the meantime: 'U' present: Update = reload the file found as the first attachment of the knowledge document. Refresh first text, title and status as specified in the corresponding fields. 'U' omitted: ignore changed files Meaning of 'D': Action to be taken when a file is found in the knowledge base belonging to the directory / tree specified, previously loaded by powerKNOW Tree Loader and no longer present in the directory / tree: 'D' present: Delete the corresponding knowledge document 'D' omitted: ignore removed files
-Title xxx	Title of the knowledge document created / updated for a file found. See "replacement of variables" for a list of variables which can be used in this text.
-Text xxx	Contents of the first internal text (first text to be listed und 'MyStructure') of the knowledge document. See "replacement of variables" for a list of variables which can be used in this text.
-TextTrigger xxx	Trigger to be used to update only parts of the first text in case of a changed file. See "Replacing only parts of the text" for details.
-Status x	Status of the knowledge document created/updated. x is one of the letters 'U', 'C', 'R': 'U'=Under construction 'C'=Completed 'R'=Released
-User xxx	Username to be used to login to the powerKNOW database. This must be a valid username of powerKNOW.
-Pw xxx	Password of the powerKNOW user.
-v	Verbose mode. Will also report/log files already up to date.
-noGUI	Run powerKNOW Tree Loader in commandline mode without using the GUI All logging / reporting will be send to standard-out / error-out.
-cfg xxx	Path of powerKNOW config file to be used. If you specify this argument be sure to use an absolute path for all directory / file path parameters in this config file. It's best to use an absolute path. If you want to use a relative path see description of '-noCd'. Default: .\data\config.config
-Argfile xxx	Path of a sequential file containing additional commandline arguments. This arg. is especially useful if all the arguments you want/need do not fit into the limitations of the commandline. It's best to use an absolute path. If you want to use a relative path see description of '-noCd'. Example: -Base= C:\temp -InclSub= -Do= dnu -Ext= doc,xls,htm,html,txt,pdf -Text= path: %path% %\n%Last update: %TimeUPD% ##-TextTrigger=_StartHere_ -Title= File: %name% -Status= c -User= kmanager -PW= xxxx ('#' starts a comment)
-noCD	Do not change directory. Normally powerKNOW Tree Loader changes the working directory to exe-directory\.. (one directory up from the directory where the powerKNOWtreeLoader.exe resides). This way powerKNOW Tree Loader makes sure to be able to work with the powerKNOW config file even if relative paths are used within the config file. If you want to use '-noCd' be sure to use absolute paths for command line arguments and within the config file.