al-file-upload v1.0.11

al-file-upload

Supports a function to upload an input file to the AwardLetter Files API.

Environment Requirements:

• Internet access (port 80 and SSL over port 5443).
• Node.js installed.

Installing directly from github:

Clone or download as zip to local machine. For the later, unzip to desired location. In a command prompt at the root installation directory, execute the following command to install all module dependencies:

	>npm install

Configuration:

All configuration is contained within the config.json file.

Logging: The module is configured to log to a logs folder within the root directory of the application. Standard log entries will be written to a file named alfilesystemwatcher.log while unhandled exceptions will be logged to a file named alfilesystemwatchererrors.log.

  "logging" : { "directory" : "./logs" }

Authorization: The upload process requires an authorization token from a secure token service(STS).

  "oauthWrapRequest" : { "url":"sts_url", "creds":{"uid":"userid", "pwd":"password"}, "wrapScope":"scope" }

The following values must be provided in order to invoke the STS and acquire an authorization token:

AwardLetter Files API: Defines the root URL of the AwardLetter Files API. This API defines a method for uploading AwardLetter input file content.

  "filesApi" : { "rootUrl" : "root_url" }

File Format: The file format being uploaded. Expected values include "txt" and "json".

  "fileFormat" : "txt"

###Running al-file-upload:

Execute manually by opening a command prompt at the installation root directory:

	>node al-file-upload.js [filepath]

Examples:

	>node al-file-upload.js c:\temp\input.txt
	>node al-file-upload.js 'c:\input files\input file.json'