What is Kno2file and where to install?
Kno2File runs as a Windows service. It needs to have permission to write to the folder to which you wish messages be downloaded. Kno2file should be installed on a server. If the server doesn't have the permissions to write to the folder, the log will show this error:
Unauthorized access to folder: [AttachmentWorker] - Error while writing file for message
User Activity on messages downloaded by Kno2file:
Will show EMR Exported with a blank username.
Download Cycle:
Set up in the Kno2file config folder; the default is 10 minutes. This can be modified from C:\Program Files (x86)\Kno2\Kno2file Kno2file.Service.exe.config - <add key="LoopInterval" value="600000" />. The value is in milliseconds. Kno2 does not recommend a loop interval of less than 1 minute.
Log:
This is available as a.txt file on the machine Kno2file is installed on, from C:\Program Files (x86)\Kno2\Kno2file log.txt
Message ID and Attachment:
When viewing the Kno2file log, each Message has a Message ID that correlates to the Message ID seen in Column C of the Activity Report. Each Message contains at least one attachment, and each attachment has unique attachment ID.
Changes to Download Profile or Query String
After you make changes to a Download Profile or its Query String, restart the Kno2file service in Windows to ensure it is running the most current query.
Formatting “From” numbers in Query Strings
When a Download Profile includes a From number, you must edit the Query String to update the formatting for the From number to a include %2B in front – this is the ‘escaped’ + sign that is seen in front of From numbers in My Intake.
Example:
pageStart=1&orderDir=desc&orderBy=receiveDate&startDate=2020-04-02T00%3A00%3A00.000Z&endDate=&rules=%5B%7B%22toAddress%22%3A%222085672205%22%2C%22fromAddress%22%3A%22%2B12086952380%22%7D%5D&statuses%5B%5D=None&statuses%5B%5D=Received&statuses%5B%5D=Suspended&statuses%5B%5D=Uploaded&statuses%5B%5D=Triaged&isAll=false&isUnassigned=false&sourceTypes%5B%5D=DirectMessage&sourceTypes%5B%5D=Fax&sourceTypes%5B%5D=Triage&sourceTypes%5B%5D=Carequality&sourceTypes%5B%5D=Ihde&isAssignedToSelf=false&filter=
Kno2file Service Download to EMR workflow
Workflow: Process faxes using Download to EMR steps – break/index fax and then Mark for Download using Download to EMR button. Kno2file will download the message upon its next loop.
Optional: Create an Intake Rule for messages so they are found under a rule in My Intake.
Create a Download profile from Settings > Download Profiles. Configure the Query String in the Download Profile for the To address as follows, replacing “##########” with the fax number:
statuses%5B%5D=Processed&processedtypes=AwaitingEMRExport&rules=%5B%7B%22toAddress%22%3A%222082666002 %22%2C%22fromAddress%22%3Anull%7D%5D
Optional: Use Advanced Filename Options to pull in hand-keyed information to name the file.
General Troubleshooting Steps
Is the Windows service running?
Does restarting the service resolve the issue?
Are there any errors in the log?
Has anything changed recently (server IP address, server permissions, fax numbers/Direct addresses, query string)?
Restarting the Windows Service
Windows 8 or 10: Open Start screen, type services.msc and press Enter.
Windows 7 and Vista: Click on the Start button, type services.msc in search field and press Enter.
In the Services pop-up, select the desired application and click the Restart Service button.
** 4/9/2025 - An issue has cropped up that is adding an "undefined" value to the end date in the query string. In order for these download profiles to function as expected this value needs to be deleted, this segment should read:
"endDate=&"
