Configuration Options

Element

Required?

Description

CompletedLocation

Required

Represents relative location that successful faxes will be moved to. Do not specify file path. (Default value: completed)

FailedLocation

Required

Represents folder name that failed faxes will be moved to. Do not specify file path. (Default value: failed)

HistoryLocation

Required

Represents folder name that history files will be written to. Do not specify file path. (Default value: history)

MessageStoreType

Required

Represents message store type. Only valid type currently is folder. (Default value: folder)

MessageType

Required

Represents how faxes will be sent. Valid types are:

  • webservice – Set to send faxes using Web Services.

  • SMTP – Set to send faxes using SMTP.

MonitorLocation

Required

Full path to folder that should be monitored for new files. Example: d:\foldertomonitor\

ServiceLocation

Required

URL or domain based on MessageType.

  • Webservice URL: https://ws.concordfax.com/fax/v5

  • Outbound SMTP Server: Example: smtp.mydomain.com

ServiceUsername

Required

Username or domain based on MessageType.

  • Webservice: mailbox username provided by Concord Example: mbx12065551212

  • SMTP To Domain: Example: @concordsend.com. Note: the domain used must be an authorized SMTP domain that Concord accepts. The default value is probably applicable.

ServicePassword

Required for web service

Only applicable if using Web Service MessageType. Is the password supplied by Concord for the ServiceUsername that you have defined.

EmailNotificationAddress

Required for SMTP

Email address that final notifications will be sent to. If you have SMTP set as the MessageType this also represents the FROM address that emails will be sent from. Example: myemail@mydomain.com

FaxNumber

Optional

If defined this is the default number that all faxes will be sent to if not overridden in the fax file or a file supplied xml file.

CoverName

Optional

If defined for web service must match concord server side cover page.

CoverSubject

Optional

Subject that will be added to a cover page.

CoverText

Optional

Text to be included in the body of a cover page.

RecipientCompany

Optional

Company name that will be used on a cover page.

RecipientName

Optional

Recipient name that will be used on a cover page.

RecipientTitle

Optional

Recipient Title that will be used on a cover page.

ReferenceId

Optional

Customer provided referenceId that the customer can use to indentify the specific request.

Resolution

Optional

Low or High. Default value: Low

SenderCompany

Optional

Name of Sender Company that will be used on the cover page.

SenderCSID

Optional

CSID that will be placed at top of fax.

SenderFax

Optional

Fax number of sender that will be used on a cover page.

SenderName

Optional

Name of sender that will be used on a cover page.

SenderPhone

Optional

Phone of sender that will be used on a cover page.

Example FolderFaxList.xml File

There is an example file included in the installation folder (FolderFaxList.xml) and this is the location that the file should reside. The following example shows a folder monitored which will use web services to submit faxes, the following page shows the continuation of this .xml example that adds a second folder which uses SMTP to submit faxes.

Xml Copy imageCopy
<?xml version="1.0" standalone="yes"?>
<DocumentElement>
    <MessageStore>
        <CompletedLocation>completed</CompletedLocation>
        <FailedLocation>failed</FailedLocation>
        <HistoryLocation>history</HistoryLocation>
        <MessageStoreType>folder</MessageStoreType>
        <MessageType>webservice</MessageType>
        <MonitorLocation>d:\faxfolder\folder1\</MonitorLocation>
        <ServiceLocation>https://ws.concordfax.com/fax/v5</ServiceLocation>
        <ServiceUsername>mbx12065551212</ServiceUsername>
        <ServicePassword>1234</ServicePassword>
        <EmailNotificationAddress>mynotifyemail@domain.com</EmailNotificationAddress>
        <FaxNumber></FaxNumber>
        <CoverName></CoverName>
        <CoverSubject></CoverSubject>
        <CoverText></CoverText>
        <RecipientCompany></RecipientCompany>
        <RecipientName></RecipientName>
        <RecipientTitle></RecipientTitle>
        <ReferenceId></ReferenceId>
        <Resolution></Resolution>
        <SenderCompany></SenderCompany>
        <SenderCSID></SenderCSID>
        <SenderFax></SenderFax>
        <SenderName></SenderName>
        <SenderPhone></SenderPhone>
    </MessageStore>
    <MessageStore>
        <CompletedLocation>completed</CompletedLocation>
        <FailedLocation>failed</FailedLocation>
        <HistoryLocation>history</HistoryLocation>
        <MessageStoreType>folder</MessageStoreType>
        <MessageType>smtp</MessageType>
        <MonitorLocation>d:\faxfolder\smtp\</MonitorLocation>
        <ServiceLocation>smtp.domain.com</ServiceLocation>
        <ServiceUsername>@concordsend.com</ServiceUsername>
        <ServicePassword></ServicePassword>
        <EmailNotificationAddress>mynotifyemail@domain.com</EmailNotificationAddress>
        <FaxNumber></FaxNumber>
        <CoverName></CoverName>
        <CoverSubject></CoverSubject>
        <CoverText></CoverText>
        <RecipientCompany></RecipientCompany>
        <RecipientName></RecipientName>
        <RecipientTitle></RecipientTitle>
        <ReferenceId></ReferenceId>
        <Resolution></Resolution>
        <SenderCompany></SenderCompany>
        <SenderCSID></SenderCSID>
        <SenderFax></SenderFax>
        <SenderName></SenderName>
        <SenderPhone></SenderPhone>
    </MessageStore>
</DocumentElement>