Importing Recipients from a Text File

Top  Previous  Next

To import a Comma Separated Values text file in to NotePager Pro to add or update Recipients, the file must be formatted very, very specifically.

 

The specific data structure of each record is as follows:

 

"Version","Name","FullName","Id","Carrier","MaxChars","Alpha","OnCall","AdHoc","DropControl","Group","SendSubject","RemoveFrom","Extra1","Extra2","Priority"

 

Field

Description and Values

Version

This field declares the version of the import file and should be set to: 500

Name

This field assigns the Short Name of the recipient to be imported. Names should be assigned with alphanumeric characters. Special characters such as ! @ # $ % ^ & * ( ) + = [ ] { } / ? \ | ; : ' " , < > and spaces are disallowed from this field. Underscores and dashes can be used.

FullName

This field assigns the Full Name of the recipient to be imported. Names should be assigned with alphanumeric characters. Special characters such as ! @ # $ % ^ & * ( ) + = [ ] { } / ? \ | ; : ' " < > are disallowed from this field. Spaces, commas, underscores and dashes can be used.

Id

This field declares the contact address or phone number of the recipient. For example, if this recipient will be tied to an SMTP/Email carrier, you would either enter an email address or a cell phone contact address (ex;7818290500@vtext.com). If this recipient will be tied to a non-SMTP/Email based carrier, enter the 10 digit cell phone or pager number with no spaces or dashes (ex;7818290500).

Carrier

This field declares the name of the Carrier that this recipient should be tied to. This field value MUST exactly match the name of a carrier that exists within NotePager Pro.

MaxChars

This field determines the maximum number of characters you wish to send to this recipient. If the recipient Max Chars value is higher than the carrier Max Chars value, the program will break up long messages in to multiple messages based on the carrier's character limit.

Alpha

If this recipient is device that can only receive numeric characters, this field value should be set to: #FALSE#

 

All other recipients should have this field value set to: #TRUE#

OnCall

For the Recipients import, this field value should be set to #FALSE#

 

If this recipient needs to be a part of an On-Call Group, that configuration should be done from within the NotePager Pro interface.

AdHoc

If this recipient is an Ad-Hoc recipient, set this value to: #TRUE#

 

If this recipient is a normal recipient, set this value to: #FALSE#

DropControl

This field value corresponds to the "Strip non-printable characters" value within a recipient's settings. Non-printable characters are things like carriage returns, line feeds, horizontal tabs and the like.

 

If you want these characters to appear in messages sent to this recipient, set this value to: #FALSE#

 

If you do not want these characters to appear in messages sent to this recipient, set this value to: #TRUE#

Group

For the Recipients import, set this value to: #FALSE#

SendSubject

This field value corresponds to the "Extract Subject" value within a recipient's settings.

 

If this value is set to #TRUE#, NotePager Pro will search the first 40 characters of any message sent to this recipient for a carriage return and line feed, carriage return, or line feed. If it finds a match, it will treat anything before those characters as the subject line of the message.

 

If this value is set to #FALSE#, NotePager Pro will use a default subject of: TEXT MESSAGE

RemoveFrom

This field value corresponds to the "Strip sender's name" value within a recipient's settings.

 

If you want for the sender's name to prefix messages sent to this recipient, set this value to: #TRUE#

 

If you do not want for the sender's name to prefix messages sent to this recipient, set this value to: #TRUE#

Extra1

This field corresponds to the Comment1 field within a recipient's settings. If you want to leave a comment about this recipient, enter it here.

Extra2

This field corresponds to the Comment2 field within a recipient's settings. If you want to leave a secondary comment about this recipient, enter it here.

Priority

This field value must be set to a value from 1 to 100, with 1 representing the highest priority. The default value all carriers and recipients is 100, however, numbers larger than 100 can be used. The default value is 100.

 

This is an example of an import line that would import a recipient tied to a carrier named Email whose short name is tech_support, full name is Tech Support, ID to send to is support@notepage.com with DropControl disabled, SendSubject enabled and also allowing the Sender's Name to prefix messages sent to this recipient:

"500","tech_support","Tech Support","support@notepage.com","Email","500",#TRUE#,#FALSE#,#FALSE#,#FALSE#,#FALSE#,#TRUE#,#FALSE#,"","","100"