User Manual
Contents
1. 14 characters Enter the mobile numbers of the recipients in the field To and the text of the message in the text box below You can select recipients using Outlook profile by clicking on the button To The dialog that pops up will contain the list of contacts that have a mobile number property Click on the Send button to move the SMS message to the Outbox folder The SMS message will be forwarded to the server when the SMSport Client is connected Online mode When final delivery report is available from the server the SMS message will be moved to the Sent I tems folder Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort s 9 SMSport Application interface It is very easy to integrate SMSport with almost any application utilizing both outbound and inbound SMS messages To send a SMS message from an application the application needs to run the sms_a exe program than enter the cellular phone number and than add the text the example below shows how this is done C Program Files SMSport Client sms_a exe 0547559939 Hello To receive SMS messages it is needed to define how to receive them and where the following screen shows the 3 methods 1 Send the received SMS to an e mail it is needed to specify in the Send to email box the desired email address 2 Post the received SMS in a folder it is ne2. OniPort 9 Sot O On Index General Overview SMSport Server Installation SMSport Server Monitoring and Configuration Utility System Architecture 3 1 SMSport Server Monitoring and Configuration Utility Menu Items Users and Tasks 4 1 task parameters 4 2 Anatomy of the incoming sms message 4 3 Creating SMSport tasks 4 3 1 Task Contact 4 3 2 Task Email 4 3 2 1 Task Usage New Mail 4 3 2 2 Task Usage Forward Reply Mail 4 3 3 Task SQL 4 3 3 1 Task Usage Data Retrieval Script 4 3 4 Task CMD 4 3 5 Default task 4 3 6 Secure tasks 4 4 Creating SMSport users Ports Mailbox monitoring agent Email settings SMSport Client 8 1 SMSport Client Installation 8 2 SMSport Client Configuration 8 3 SMSport Client Operation SMSport Application interface 10 Hardware Software Requirements Checklist Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 1 General Overview SMSport Server is a Windows NT service application responsible for sending and receiving SMS messages using a cellular modem SMSport Server communicates with the SMSport Client application to meet the needs of the desktop clients By providing prompt access to the corporate intranet and office applications SMSport improves services working methods and business efficiency The main built in functions of SMSport are e Outlo
3. The exclamation mark is not a part of the value If the text of the incoming SMS message doesn t end with an exclamation mark the text after the last exclamation mark will replace the MSG placeholder in the task configuration Note The exclamation mark is a unique symbol and therefore cannot be used as part of the value in the request Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 4 3 Creating SMSport Tasks 4 3 1 Contact Task The screen below will open when you click on Add Task in the SMSport Configuration screen and select menu item Search for Contact ID fc Name Find Contact Secure ACL Max number of returned contacts 5 Exchange address book Server flocal Mailbox testi Check Name C LDAP Server Ss User i Password a a Formula Name Fav Phone Mobile ST Cancel _ ID is the task identification which will be the first space delimited tag in the incoming SMS message to inform the system of the task it must perform Name is the tasks full name Unlike the task ID the task name will not appear in the incoming SMS message therefore should not be abbreviated but rather fully represent the tasks function as will appear in the task list in the SMSport Configuration screen Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadw
4. monitoring 4 Users and Tasks SMSport User is the identity that the SMSport Client applications use in order to connect to the SMSport Server The SMSport User Name itself is the code for sending a message to his own SMS Client inbox EX Games test Games is the code for sending a message to his sms client inbox SMSport Task defines the set of operations which the server needs to perform upon accepting a task request sent by SMS from a mobile phone user The SMSport Server recognizes the type of incoming SMS messages by analyzing the first word in the message text which is the first space delimited tag If said tag represents a user or task ID to be found in the database the server will proceed with the relevant operations called for by the task the incoming ID stands for using the rest of the SMS message text as parameter s for the operation Following are several examples of optional tasks and the operations they initiate For tasks type Search for Contact the server will perform a contact lookup and send the results back to the mobile device that originated the request via SMS For task type Execute SQL Script the server will perform the configured database operation SQL script and send the results back to the mobile device that Originated the request via SMS Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort o For
5. Forward Reply or Reply All is checked the first space delimited tag after the task ID and user identification for secure tasks is the ID of the message to be forwarded replied The SMSport Mailbox Monitoring Agent sends the message ID to the mobile device with the notification of a received email If Send to Address in the SMS is checked the first space delimited tag after the task ID user identification for secure tasks and email ID for Forward Reply or Reply All client jobs is the recipient s address If the Default Domain field is filled in and a is not found in the recipient s address a and the value entered as Default Domain will be added to the address If Send to this Email Address is checked the address specified will be added to the email recipients list Subject is the subject of the email Parameters allowed are 1 2 n PHONE TIME and SUBJ only for client jobs e 1 2 n will be replaced with the first second al exclamation mark delimited value e PHONE will be replaced with the sender s mobile number e TIME will be replaced with the date and time in which the SMS was received e SUB will be replaced with the subject of the original email the Mailbox Monitor Agent received Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniP
6. displyed below SMSport Registration key 59DCE NCKCD C4024 ZJW WO License aeaa9 SH2Z2T2 WYYEVS MYRGF B9D89 Expiration date Never expire Ports Unlimited Users Unlimited Cancel SMSport requires a unique license generated only by authorized SMSport distributors this license code is necessary for installation and operation of the system Note before going on to the configuration segment of this manual the license code must be entered in order to enable system configuration and operation In order to validate your license you need to contact a distributor in your area This license code is necessary for configuring and operation of the system Menu item Administrator prompts the Administrator screen displayed below Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort be 4 Administrator 5 x When Date Kinds vFrom To Status Message al 9 24 2005 11 43 26 9 24 2005 11 43 31 Sent ml 123456789 Ok this is at 9 25 2005 12 05 07 9 25 2005 12 05 07 Sent s 123456789 Ok DEF DS mi 9 25 2005 12 12 13 9 25 2005 12 12 22 Sent ml 123456789 Ok this is at Kind Sent When 9 24 2005 11 43 26 PM Date 9 24 2005 11 43 31 PM To 123456789 From m1 Status Ok this is atest message status information 123456789 9 24 2005 11 43 31 PM Ok ae z
7. is right there where it says lt ODBC gt in gray color unless it is checked otherwise ODBC is used and the DSN field should specify a valid ODBC data source name The User and Password fields should contain the user s identification needed to connect to the database SQL is the SQL script to be executed Parameters allowed are 1 2 n PHONE and TIME e 1 2 n will be replaced with the first second no exclamation mark delimited value e PHONE will be replaced with the sender s mobile number e TIME will be replaced with the date and time in which the SMS was received If SQL fails the text entered into the On Failure field will be returned Parameters allowed are 1 2 n PHONE TIME and ERR e ERR will be replaced with the failure details e All other parameters will behave in the same manner as specified for the SQL fields see description above For successful SQL operations e if Data Manipulation Script is selected the text entered into the Return Text field will be sent back via SMS to the mobile device that Originated the request This option should be selected for scripts that are not intended to return records such as INSERT UPDATE or DELETE statements For the Return Text field 1 2 PHONE TIME and ROWS parameters are allowed where ROWS will b
8. to the user will be written to a file if Post to Folder is checked Send Email Notification determines whether or not to email incoming SMS messages to the user Forward to Phone determines whether or not to send incoming email to the user s mobile device via SMS to the number specified in the Phone field Post to Folder determines whether or not incoming SMS messages will be sent to the user should be written to a file saved under the folder path specified in the Folder field Priority is used to arrange the sending order of concurrent outgoing SMS messages Priority 9 is highest 5 is default Admin controls the user s administrative privileges Only system administrators can access the Administrator screen through the SMSport Client User Cannot Change Settings is used to ensure that the parameters email phone and folder options set in the SMSport server configuration through the Add User screen cannot be overwritten by the user via SMSport Client Click Add to prepare the user for registration To change an existing user s properties select a row in the list change the parameters and click Update Click Clear to start entering properties for a new user Select a row or rows in the list and click Delete if you wish to remove users from the registration queue Click OK to start the registration or Cancel to abort Click Import to open the dialog below Uniport Ltd 13 Hasadna
9. 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 2 SMSport Server I nstallation Click the Next button to start the SMSport Server installation Setup SMSport Server Install Destination path c Program Files Bl Service account User FAXPORT administrator Password ee Re enter password E _guide pdf Done Installing SMS Server service Done Create registration key SUB374E 7HGX Writing registry key Done INSTALLED Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPorr 3 SMSport Server Monitoring and Configuration Utility System Architecture SMSport Server Monitoring and Configuration Utility is used for setting SMSport Server parameters starting and stopping the service managing users and tasks and monitoring of the service activity Following is the main screen ioj xi SMSport 08 49 08 Server Starting Eml 127001 084913 7 49 08 Server Port number s Z 2 49 08 Server Initialize DB 7 49 08 Server Initialize Server 2 49 08 Server eee STARTED 49 13 127 0 0 1 gt CONN 127 0 0 1 7 49 13 127 0 0 1 gt INIT 7 49 13 127 0 0 1 gt CMD AUTH 7 49 13 127 0 0 1 ml gt AUTH_OK ml 7 49 13 127 0 0 1 ml gt CMD CLIENT CONFIG 08 49 13 CMD CLIENT_CONFIG 08 49 13
10. 2 USA www faxport com OniPort Parameters allowed are 1 2 n PHONE TIME and DSN e DSNS is the task execution status information e All other parameters will behave in the same manner as specified for the Subject Body fields see description above 4 3 5 Default Task The screen below will open when you click on Def Task in the SMSport Configuration screen Default Task x Send to email defaut local Past to folder Bt J Insert to SQL database MS SQL Server lt ODBC gt DSN a uss Password y Renter password Es Send back SMS with status notification Manage Acceess Contral List Restrict task usage Cancel This task will be executed for every incoming SMS message that has an unknown identifier first parameter of the message text If Send to Email is not empty the text of the SMS message will be sent to the email address specified in this field If Post to Folder is not empty the text of the SMS message will be saved as a file under the folder path specified in this field There is no need to specify a file Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort name only the path should be entered the server will create the file with its internal file name format If Insert to SQL Database is checked the SQL statement
11. 3650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 4 4 Creating SMSport Users The screen below will open when you click on Add Users in the SMSport Configuration screen xi ID m3 Name Test_3 Password 3 Email test3 local Phone fi 23456789 Folder Priority 5 V Admin J Send email notification J Forward to phone Post to folder I User cannot change settings ID Name Email_ Phone Folder_ Test_3 test3 123456789 m4 Test_4 test 123456789 Email Delete ID is the user identification used by the SMSport Clients for authentication or used as a Send to SMSport User task identifier when processing incoming SMS messages Name is the user s full name as will appear in the user list in the SMSport Configuration screen Password is the value which the SMSport Clients must supply together with the user ID to connect to the SMSport Server Email is the user s email address If Send Email Notification is checked all incoming email addressed to the user will be sent to this email address Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort j Phone is the user s mobile device number If Forward to Phone is checked all incoming email addressed to the user will be sent via SMS to this mobile number Folder is the path to which incoming SMS messages sent
12. 7 New York NY 10032 USA www faxport com OniPort s If the user wishes to enable the SMSport Mailbox Monitoring agent and receive SMS notifications regarding new email messages received in the exchange mailbox a value must be supplied in the Profile field The SMSport Mailbox Monitoring Agent can run on the same machine where the SMSport Client is installed as a Windows NT service application or as part of the SMSport Server service depending on the Process on the Server check box SMSport Server can handle monitoring of up to 200 mailboxes The emails that generate SMS notifications can be filtered according to the Sender and Subject Body fields The email will generate notification if it has any of the keywords specified in the fields on the left and does not have any of the keywords specified in the fields on the right If the check box above a field is not checked all emails are considered satisfactory according to this criterion Below is the connect dialog which will pop up when authentication is needed and Auto Logon is not checked in the configuration screen x Server paoor User name test o Password OoOO Cancel _ Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 7 8 3 SMSport Client Operation The screen below shows the dialog for sending SMS messages ioi x SMS Edit RY To imm oO Send this is atest
13. AUTH_OK m1 08 49 13 CMD AUTH 08 49 13 INIT 08 49 13 CONN 127 0 0 1 P P Service status Running Z The SMSport monitoring screen displays both the SMSport Clients and Desktop Agents that are currently online or have been online recently top left part of the screen and the Server Activity log displayed on the right part of the screen Selecting a client from the list will display its recent activity in the box below The SMSport Server Monitoring and Configuration Utility menu enables configuring operating and managing the system via this one utility Following is a short description of said menu to provide basic orientation before beginning the configuration procedure and operation of the system Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 3 1 SMSport Server Monitoring and Configuration Utility Menu Items Menu items Start and Stop control the state of the service The current state of the service is displayed on the status bar at the bottom of the screen Menu item Start without ports starts the service in test mode in which all communication with the modem is routed to a simulator Menu item Hide closes the main screen The screen can be reopened through the SMSport tray icon Menu item Clear Log clears the server activity log Menu item License prompts the SMSport licensing screen as
14. Close The Administrator screen displays all system operations where each row refers to a single action The bottom section of the screen enables filtering through all logged actions in order to view relevant ones alone To do so simply choose a search criterion such as dates users addressees or action type and click Refresh to retrieve the relevant list of messages from the server Menu item Configuration prompts the SMSport Configuration screen as displayed below C SMSport Configuration JE ol x Default Add Users Email default local iS amp Users Add Task E amp m1 123456789 Test_1 foe eee 123456789 Test_2 Edit Email test2 local Phone 123456789 Delete Options Email Admin El m Tasks Expand H E c Contact Find Contact B f Email Forward Collapse Client F Address fax faxport com Subject FAx 0401 Z SUBIF Body 4 BODY DSN LDSN DSN 1 n Email New MB Mon r Email Reply Email Ports Def Task Close Users gt 2 Tasks 4 Ports gt 1 EMAIL No MBMON No h ekkki PE ie E Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort The SMSport Configuration screen is where all system configurations are initiated This screen will be the starting point for the following chapters explaining the configuration procedure of system users tasks ports email settings and mailbox
15. G Send Back SMS with Delivery Status Notification field contains n DNS TIME DNS SMS Message Sent n John This is a test John the mail recipient is in the local com domain otherwise the entire email address must be entered The originator s information is mobile device number 0123456789 user s mail account Paul local com The message was sent at 12 45 on May 7 2005 Email Received A new email will be sent to ohn local com it will be sent from Paul local com the subject will be SMS to Email from 0123456789 the mail body will be From 0123456789 Date 12 45 07 05 2005 This is a test The From will appear as F to save characters space Delivery Status Notification The originating mobile device will then receive an SMS saying n DNS 12 45 07 05 2005 Message Sent 4 3 2 2 Task Usage Forward Reply Mail Task configuration ID r Name Reply Secure is checked Send from Client is not checked Reply radio button is selected Send to Address in the SMS is checked Default Domain ocal com Subject field contains SMSport RE SUB Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort k Body field contains This is a reply message sent via SMSport Original Message HEADERS MSG Send Back SMS with Delivery Status Notification field contains r DNS T ME D
16. LED Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort gt 8 2 SMSport Client Configuration Menu item SMSport Configuration will open the configuration screen below Configuration x Connection Server fi 27 0 0 1 Password E User test Re enter password J Auto logon Mobile phone fina Monitor mailbox Profile testi IV Process on the server JV Notify if sender is JV Skip if sender is local a admin local Notify if text include one of JV Skip if text include one of joke smile cool zi NOTE Use semicolon as delimiter Cancel Server is the host address where the SMSport Server is running User and Password is the user s identifying information used for the authentication In order to connect to the SMSport Server a valid user ID and password must be supplied i e these should mach a record in the user list on the SMSport Server Mobile Phone is the user s mobile number which should match the user s Phone property as configured on the server Upon successful connection to the server the Phone property will be updated with the value in the Mobile Phone field If Auto logon is checked the SMSport Client application will not ask the user to supply a valid password upon startup Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 13
17. NS SMS Message Sent r paul 9876 John mail com This is a reply to your email The originator s information is mobile device number 0123456789 user s mail account Paul local com username paul password 9876 The original message detected and handled by the Mailbox Monitoring Agent was sent from John mail com to Paul local com and Jane local com subject urgent matter at 17 25 on May 7 2005 The reply task SMS message was sent at 17 30 on May 7 2005 Email Received A new email will be sent to ohn mail com it will be sent from Paul local com The subject will be SMSport RE urgent matter The mail body will be This is a reply message sent via SMSport Original Message From John mail com To Paul local com Jane local com Date 17 25 07 05 2005 This is a reply to your email Delivery Status Notification The originating mobile device will then receive an SMS saying r DNS 17 30 07 05 2005 Message Sent Note The usage for forwarding an email via SMSport is very similar to the procedures described above and as with sending a new email or a reply configuring options within the task structure are great and cannot all be detailed These two examples should assist in configuring and operating any specific task Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort i 4 3 3 SQL Task The screen below will open
18. SMSport provides access to back office SQL database for retrieval of needed information in real time customer details pricing etc e Scheduling on the fly SMSport will provide daily schedule and notifications of any changes directly to the cellular device this function is not supplied in the first release o Emergency alerts Any defined Task Application Service that runs on the network can be configured to generate an SMS alert in case they fail e Least Cost Routing In case there are several cellular operators in a given geography SMSport routes each SMS message directly to the cellular Operator s network via the specific cellular modem on the server This function saves telecommunications costs Cost savings e Management SMSport provides useful management tools for the system manager and the user The SMSport Server Monitoring and Configuration Utility is the heart of the operation where clients are registered tasks are defined parameters are set and the system is tailored to the customers needs The greater part of this manual will be dedicated to the configuration procedure of the SMSport Server SMSport Client is the application that runs on the user s desktop and is used for sending and receiving of SMS messages as well as configuring the SMSport Mailbox Monitoring Agent The final section of this manual will be dedicated to the configuration and operation of the SMSport Client Uniport Ltd
19. St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort f Exchange address book Server local Mailbox ftes Check Name LDAP Server User Password Connect Formule M Name o Email o Sf Phone 7 Cancel Users can either be imported from an Exchange Address Book or LDAP enabled server Select the appropriate import type to add users to the registration queue 5 Ports The screen below will open when you click on Ports in the SMSport Configuration screen Communication Ports w 0o w ao a amp wise b b O 12 13 14 15 COH 2 In Out 7 Max 70 aj Jv UcS2 V Su M Du Cancel Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort j Select a row with the desired COM port number and determine whether it will be used for incoming SMS messages outgoing SMS messages or both If UCS2 is checked SMS messages will be received in UNICODE format Outgoing messages will be sent in UNICODE format if non English text is found in the message The Su check box should be checked if the modem returns originator s number in UNICODE format for incoming SMS messages The Du check box should be checked if the modem expects to receive the destination number in UNICODE format for outgoing SMS messages Some modems do not
20. ay 137 New York NY 10032 USA www faxport com OniPort L Checking the Secure check box will classify this task as a secure task which requires including a username and password in the incoming SMS message in order to set the task in motion see Secure Tasks chapter 4 3 5 Max Number of Returned Contacts will limit the number of results sent back to the user according to the specified value The source of the contacts which will be searched through in the task can either be from the Exchange Address Book or an LDAP server Selecting LDAP will enable using the task parameter MSG in the Formula field as a placeholder for the text of the incoming SMS message Note The task ID and user identification are not a part of the message text Task Usage As configured in the example above where Task ID is c Max Number of Returned Contacts is set to 5 and the contact source is Exchange Address Book gt If an SMS is sent to the SMSport server with the following text C John gt SMSport will reply with an SMS message to the task originator s mobile device including up to 5 contacts found in the Exchange address book under the name of John Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 4 3 2 Email Task The screen below will open when you click on Add Task in the SMSport Configuration scree
21. d during the configuration of a task the task is declared secure which then means the mobile user must provide identifying information with the task request This information is sent as part of the incoming SMS message its location is the second parameter in the message text after the first space which terminates the task identifier always the first parameter in the incoming message The identification information is sent in the form of lt Username gt lt Password gt followed by space lt Username gt can be a valid user ID or left empty If lt Username gt is empty user s property Phone will be scanned for the caller ID lt Password gt should match the Password property of the identified user In addition the user must be allowed in the Access Control List to perform the task The Access Control List screen will open when clicking on the ACL button to the right of the Secure check box this will enable verifying and editing the user list allowed to perform the configured task Access Control List IO Name Phone mall Pity mi test 1 1111111111 test local 3 O m2 test 2 22222222 5 Allow Deny Apply Cancel Users that are checked in the list are allowed to use the task If you do not wish to select the users one by one use the Allow and Deny buttons to check or uncheck a group of selected users Click Apply or OK to save the changes Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 4
22. e replaced with the number of affected rows The Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort j rest of the parameters will behave in the same manner as specified for the SQL fields see description above e The Data Retrieval Script should be selected when the SQL script contains the SELECT statement meant to retrieve data o If the execution returns with no result the text from the On No Records field will be returned Allowed parameters for this field are 1 2 PHONE and TIME as defined for the SQL field o If the execution returns a non empty record set the value in the Result Header field will be used as prefix followed by the data with columns separated by a comma and rows separated by a semicolon The text returned will be cut to the number of characters specified in the Limit field 4 3 3 1 Task Usage Data Retrieval Script Task configuration ID gl Name Query DB MS SQL Server is not checked Using ODBC with valid user and password SQL field contains SELECT name phone FROM employees WHERE name LIKE 1 On Failure field contains QFai 1 Code ERR Data Retrieval Script is selected not Data Manipulation Script Result Header field contains Name Phone Limit field is set to 150 characters On No Records field contains Not F
23. ecific task 4 2 Anatomy of Incoming SMS Messages The first word in the incoming SMS message is used to identify the task If the task is secure user identification user name and password must follow in the form of lt Username gt lt Password gt followed by space Note lt Username gt can either be a valid user ID or left empty There is a need to add Username amp Password ONLY if the sms sender cell number is not registered in the User List and the task is secured Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort i If the task is of type Send Email and the email that will be sent is a forward or reply message of an email that previously generated an SMS notification a notification was sent to the mobile device regarding an email that was received and the user now wants to forward or reply to the email which he was notified about the next space delimited parameter in the incoming SMS message must be the ID of the original message as shown in the notification SMS The following text of the incoming SMS message can be divided into values delimited by exclamation marks Each value which ends with an exclamation mark has an ordinal number and can be used separately in task configuration if the task permits The placeholders for these values in the task configuration are 1 for the first value 2 for the second and so on
24. eded to specify in the Post to folder box the desired folder location 3 Insert to SQL database once checking this box it is needed to specify the database details Default Task x Send to email avi faxport com Post to folder C Smsport falied w I Insert to SOL database tS SGL Server f ODBC gt DN i C sdYCO C CS Password az Re enter password SaL Send back SMS with status notification Code Invalid Please resend your message F Pit as ag Manage Acceess ContalList_ Cancel Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort j 10 Hardware Software Requirements Checklist Hardware Requirements Pentium 4 256 MB RAM 20 GB free hardware space Network interface card A Cellular line SIM Card An external Cellular Modem connected to the Com Port the modem has to communicate in AT Command We recommend the Siemens MC35 modem It is possible to hook multiple numbers of modems on the server in this case the server needs to accommodate the required number of com ports use a com port extension Or in case the cellular modem has a USB connector use a USB extender Software Requirements Windows 2000 Professional Server SP 4 and above Static IP Microsoft Internet Explorer 5 and higher Exchange server admi
25. from the SQL field will be executed The statement will most likely be of type INSERT It is recommended to use the MSG parameter in the SQL field as a placeholder for the SMS message text Parameters PHONE and TIME can be used as well recording the sender and date of the SMS message Parameters 1 2 etc are not allowed If the Send Back SMS with Status Notification field is not empty when the task is done an SMS will be sent back to the mobile device that originated the request Use the DSN parameter as a placeholder for the task execution status information If Restrict Task Usage is checked the task will be executed only for SMS messages sent by users who are allowed in the Access Control List Click on the Manage Access Control List button to open the ACL configuration screen Access Control List ID Name Phone mall Pity mi test 1 1111111111 test local 3 O m2 test 2 22222222 5 Allow Deny Apply Cancel Users that are checked in the list are allowed to use the task When editing the list if you do not wish to select the users one by one use the Allow and Deny buttons to check or uncheck a group of selected users Click Apply or OK to save the changes Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort a 4 3 6 Secure Tasks If the Secure check box is checke
26. n and select menu item Send Email Message Add Task Email ID le Name Send Email Secure ACL Send from client New Forward Reply Reply all IV Send to address in the SMS Default domain flocal IV Send to this email address Jadmin local Subject Sms to EMAIL from 2 PHONE Body From Z PHONE Date TIME Z MSG Send back SMS with delivery status notification e DSN TIME HZ DSN Cancel ID is the task identification which will be the first space delimited tag in the incoming SMS message to inform the system of the task it must perform Name is the tasks full name Unlike the task ID the task name will not appear in the incoming SMS message therefore should not be abbreviated but rather fully represent the tasks function as will appear in the task list in the SMSport Configuration screen Checking the Secure check box will classify this task as a secure task which requires including a username and password in the incoming SMS message in order to set the task in motion see Secure Tasks chapter 4 3 5 Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort gt If Send from Client is checked the email will be sent using the Mailbox Monitoring Agent running on the server or client machine otherwise the email will be sent using the server email configuration If either
27. n privileges for the SMSport Exchange Connector and a mailbox for fax use only Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com
28. ok to SMS Client to SMS SMS messages can be sent from Outlook or from SMSport s Client as an e mail The SMS recipients can be entered casually or taken from the corporate GAL directory or taken from any address book e SMS to e mail The SMSport cellular user can send e mails to any e mail address from the cellular device It is possible to reply to e mails to Forward e mails and to generate new e mails Receive E mail Anywhere Complete access to office e mail whilst on the move including e mail alerts throughout the day The user defines which e mail will generate an SMS alert sorted by Key words Sender Subject and CSID number in case it is a fax Print e mails while on the road Powered by FAXport fax server SMSport allows the mobile user whilst on the move to print his e mails on any fax machine e mail amp attachment inbound fax o SMS Broadcasting SMS broadcasting is easy to use fast and efficient The SMSport server can accommodate multiple modems allowing reduction in broadcasting cycle SMS Sending Priorities t is possible to assign SMS sending priorities to specific users Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort e Contact information retrieval SMSport allows access to corporate directories or personal address book from the cellular device e Access to back office data
29. ort j Body is the body of the email Parameters allowed are 1 2 n PHONE TIME MSG SUBJ only for client jobs and HEADER only for client jobs e MSG will be replaced with the SMS text e HEADER will be replaced with information about the sender recipients and the date of the original email the Mailbox Monitor Agent received e All other parameters will behave in the same manner as specified for the Subject field see previous page If Send Back SMS with Delivery Status Notification field is filled in when delivery is done an SMS message will be sent back to the mobile device that Originated the request Parameters allowed are 1 2 n PHONE TIME MSG and DSN e DSNS is the task execution status information e All other parameters will behave in the same manner as specified for the Subject Body fields see description above 4 3 2 1 Task Usage New Mail Task configuration D n Name Mew Mail Send from Client is checked New radio button is selected Send to Address in the SMS is checked Default Domain ocal com Subject field contains SMS to Email from PHONE Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort k Body field contains From PHONE Date TIME MS
30. ound 1 Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort SMS Message Sent ql John Entry in DB There is a single entry in the database under the name J ohn Name John Phone 0123456789 Return SMS The originating mobile device will then receive an SMS saying Name Phone John 0123456789 Note f there was no record of a John in the database the return SMS according to the above mentioned configuration would have been Not Found John f on the other hand there were several records of John in the database the return SMS according to the above mentioned configuration would have been Name Phone John 0123456789 ohnA 0987654321 ohnB 0369852147 up to 150 characters as mentioned in the Limit field 4 3 4 CMD Task The screen below will open when you click on Add Task in the SMSport Configuration screen and select menu item Execute Command File ID kk Name Copy File Secure ACL Application o winnt systema2 xcopy exe By Parameters ers 2ge Wait sec p a Send back SMS with status notification Cancel Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort n ID is the task identification which will be the first space delimited tag in the incoming SMS message to inform the system of the
31. support UNICODE therefore the SMS messages are sent as PLAIN TEXT In case the modem does not support UNICODE this check box shouldn t be checked Max is the maximum length in characters for the outgoing SMS messages Long messages will be divided in up to 9 parts each part will be up to 140 characters in length for English text and up to 70 characters for UNICODE Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 6 Mailbox Monitoring Agent The screen below will open when you click on MB Mon in the SMSport Configuration screen x V Enable Mailbox Monitoring Server local Mailbox test Check IV Enable Email 2 SMS C Secure AGL Public Default priority En DSN Enable Mailbox Monitoring enables ad disables the Mailbox Monitoring service The Server and Mailbox determines which mailbox should be monitored on which Exchange server and enables the connection between the agent and the Exchange mailbox Check enables verifying connection to the specified Exchange server If Enable Email 2 SMS is checked all incoming email sent to the specified mailbox will be forwarded via SMS to the user s mobile device Secure Public This task is sending sms via email The security works as follows Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA ww
32. task it must perform Name is the tasks full name Unlike the task ID the task name will not appear in the incoming SMS message therefore should not be abbreviated but rather fully represent the tasks function as will appear in the task list in the SMSport Configuration screen Checking the Secure check box will classify this task as a secure task which requires including a username and password in the incoming SMS message in order to set the task in motion see Secure Tasks chapter 4 3 5 Application is the file which will be executed with the parameters specified in the Parameters field Allowed parameters in the Parameters field are 1 2 n PHONE and TIME e 1 2 n will be replaced with the first second a exclamation mark delimited value e PHONE will be replaced with the sender s mobile number e TIME will be replaced with the date and time in which the SMS was received If the value entered into the Wait field is greater than a zero the application will run said number of seconds and will be terminated if not done in that specified time set in the Wait field If the Send Back SMS with Status Notification field is not empty when the task is done an SMS will be sent back to the mobile device that originated the request Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 1003
33. task type Execute Command File the server will run the application configured for the task Currently this operation will not prompt a response to be sent back to the mobile device that originated the request For task type Send Email Message the server will send an email message as configured for the task and optionally return a delivery status notification by SMS to the mobile device that originated the request Processing of the incoming SMS message that has a user identity as the first space delimited tag is a special type of task which is configured individually with the user In this Send to SMSport User task the SMS message can be sent to the user s SMSport Client email account forwarded by SMS to the user s mobile device and or written to a file depending on the user s configuration In this case notification of delivery will not be sent back to the mobile device that originated the request 4 1 Task Parameters When configuring tasks parameters can be used as placeholders for the values which will be retrieved from the incoming SMS messages The format of the parameters is name where name is the name of the parameter Parameters that correspond with values extracted from text in SMS messages can be 1 2 and MSG Other parameters extracted from the SMS message are PHONE and TIME The usage of these and further task specific parameters will be explained below for each sp
34. the message If MAPI is chosen it is possible to either use a predefined Outlook profile by selecting the Outlook radio button and supplying the profile information or create a profile on the fly if Exchange is selected this requires supplying the Exchange server information and a Mailbox ID 8 SMSport Client SMSport Client is the application that runs on the user s desktop machine and is used for sending and receiving SMS messages as well as configuring the SMSport Mailbox Monitoring Agent The main screen is shown below ee lox sMSport Edit View Help F New Q Reply Forward Check ff Delete Move cr Inbox Date ______ From__ To _ Message Bp Outbox WE 5 10 2005 9 47 36 AM 123456789 test Sent Personal this is a test From 123456789 To test Date 9 10 2005 9 47 36 AM this is a test 4 27 0 0 1 test Online Agent Stopped MBMon Ok OFF Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 8 1 SMSport Client Installation Click on the Next button to start the SMSport Client Installation Setup SMSport Client Install Destination path c Program Files a Service account User FAXPORT administrator Password Sao Re enter password a Click the Finish button when installation is Done Setup SMSport Client Writing registry key Done INSTAL
35. w faxport com OniPort A user sends an email to smsport com smsport gateway mailbox and type the mobile number in the subject line of the Outlook SMSport Server sees the email and look for the senders email address in the User list If sender is in this list it seeks for permissions to use Email to SMS If sender email address is not in the list or in the list but does not have permissions the SMS won t be delivered Priority is used to arrange the sending order of concurrent outgoing SMS messages Priority 9 is highest 5 is default 7 Email settings The screen below will open when you click on Email in the SMSport Configuration screen SMTP Host local User ftest Password i Re enter password r Reply ftest local C Dutlook Profile C Exchange SEMET OK Cancel O These settings are used by the server to send email in the following cases e Users that check the Send Email Notification option e Task type Email when the Send From Client option is not checked e Default tasks that are configured to send email e Email to SMS delivery status notifications Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort 2 SMTP or MAPI can be used as email transport methods For SMTP the Host and Reply parameters must be filled in these are the SMTP server host address and the reply address for
36. when you click on Add Task in the SMSport Configuration screen and select menu item Execute SQL script Add Task SQL ID Jat Name Query DB Secure ACL MS SQL Server DSN test User Password Re enter password SQL SELECT name phone FROM employees WHERE name LIKE 1 On failure QFail 4 1 a Code ERR F gt Data manipulation script Return text a Data retrieval script Result header INP Limit fi 50 On no records il z E Cancel _ ID is the task identification which will be the first space delimited tag in the incoming SMS message to inform the system of the task it must perform Name is the tasks full name Unlike the task ID the task name will not appear in the incoming SMS message therefore should not be abbreviated but rather fully represent the tasks function as will appear in the task list in the SMSport Configuration screen Checking the Secure check box will classify this task as a secure task which requires including a username and password in the incoming SMS message in order to set the task in motion see Secure Tasks chapter 4 3 5 Uniport Ltd 13 Hasadna St P O Box 2630 Raanana 43650 Israel 4049 Broadway 137 New York NY 10032 USA www faxport com OniPort If MS SQL Server is checked the field to its right will become editable this field should contain the name of the SQL server and the Database The DB field
Download Pdf Manuals
Related Search