MMS App
The MMS OCE app provides for converting an USDS formatted message to an MMS and sending it. This is a grey area application in place to bridge gaps until Fautore is more widely used. In the strict senses, sending an MMS message is turning the POD protected data over to a third party, a definite violation of the OSA principles. Use of this app should be constrained to simple "Hey you got a message" notifications that do not actually contain message data. Visibility enforcement is in progress to ensure OSA principles are not violated in the use of this app.
Table of contents
Registration
The fauMMSSMS app is registered to the OCE via command line.
{OCE home}/apps/fauMMSSMS/fauMMSSMS.pl -r <membername> <password>
where
- {OCE home}
- the location to which the OCE is installed
- <membername>
- the login name of a POD member authorized to register applications
- <password>
- the current tribe password for the registering member. The password is exposed when entered as a parameter on the command line
DBD::SQLite::db prepare failed: no such table:
Management
The fauMMSSMS app is managed via command line.
{OCE home}/apps/fauSMTP/fauSMTP.pl [opts] <action>
Action Commands
| stop | Stop the server |
| start | Start the server |
| restart | Stop server (if it was running) and then start it |
Options
| Option | Param | Example | Description |
|---|---|---|---|
| -r | username | -r Harold MyVisiblePassword | Register this application with Fautore OSA/OCE |
| -usdsport | integer | -usdsport 24240 | Set a new port number to listen for for USDS messages (default is 20010) |
| -jsonport | integer | -jsonport 5981 | Set a new port number to send OCE communications (default is 1895) |
| -usefromsmtp | 0 or 1 | -usefromsmtp 1 | Switch outgoing SMTP mail to use the from address SMTP server (its realm) rather than using that of the to address. Value may be any of 0 1 on off |
| -dedicatedsmtp | string | -dedicatedsmtp myhost.com,26,mruser,somepass | Switch outgoing SMTP mail to use a dedicated SMTP server as defined within the values. The values are a comma delimited string of hostname,port,username,password. |
| -settings | N/A | -settings | Display control/configuration settings |
| -pullinfo | N/A | -pullinfo | Retrieve and Display OSA data synchronisation status. |
| -pullcfg | N/A | -pullcfg | Retrieve and Display OSA member settings data synchronisation status. |
| -clearqueue | N/A | -clearqueue | Clear the outgoing unsent mail queue (all mail will be lost) |
| -test | membername | -test bigfoot | Send a test message to the specified tribe member name |
Operational Overview
The fauMMSSMS application is an entirely reactionary tool that cannot initiate an inbound message to the OCE. For this reason the only way to use this application is in response to some other action within the OCE. The general concept is that some event within the OCE, such as receiving an expected message would trigger the sending of an MMS message to an intended recipient.
Use of the fauMMSSMS application is set up via Fautore Instructions. An example workflow would be that of setting up an instruction trigger so that if a (USDS) message comes in from a specific tribe member that the message itself is passed to a specified application and a text stating "The message you've been waiting for has arrived" is additionally sent to the recipient.
Member Configuration
Once installed this application is available to all members. It cannot however be used until the member wishing to make use of the application is set up. The fauMMSSMS application sends the MMS message by parsing the inbound USDS message from the OCE into an email format and sending it to the receiving member's telephone MMS or SMS service. The sending members "text by email" service must be configured in Fautore in order for the converted OSA/USDS message to be sent.
1.1.1. Accessing Application Configuration
All applications are configured from the "External Applications" button in the main button bar.
From here all application available to the currently logged in tribe member will be listed.
App & Member Selection
The External Applications screen will list all applications available to the logged in member.
Two screen objects will appear for applications that have member specific configuration options available to it. These screen object will not be available for application that cannot be configured to specific tribe member needs.
- Member Name
- The "Member Name field is a drop down that will list all members for which the currently logged in member has privileges to changes application values. The tribe "Chieftain" can change anyone's values, a "Chief" can change anyone but the "Chieftain" related values. All others can change only their own values.NoteThe "Default" dropdown selection is supposed to set the Fautore defaults for the application. This has not yet been proven to work. Please delete this note if you have proven it to work.
- App Specs
- The "App Specs" button will bring forward the screen specific to the external application for entering member specific configuration values. The values entered to this screen will be applied only to the member selected in the "Member Name" dropdown.
Application Configuration Values
The "Application Configuration Values" screen is different for every application that accepts member specific configuration items. The below listed screen is specific to the fauMMSSMS application.
| Field | Example | Description |
|---|---|---|
| 10 Digit Phone Number | 5557462281 | The ten digit number for the phone that will receive the text message when sent. Use digits only and no other characters like dots, dashes or parens. |
| Domain Name of Service | mms.att.net | In technical circles this is called the Fully Qualified Domain Name of the server to receive the text for processing. For simplicity sake you can think of this as being very much like the URL one often types into the address bar of their browser. |
| Service Type | MMS | Dropdown field with option to select either MMS for "MultiMedia Service" or "SMS" for "Simple Messaging Service." The entry to the "Domain Name Service" field will often provided clues as to the correct value to select. If the entered domain contains "mms" them MMS is the correct selection here. If the entered domain contains "sms" or "text," then chances are SMS is the correct selection. Most smart phones will use a MMS service and flip type phones will use a SMS type service. |
| From Email Address | MyEmail@TekAdv.com | The recipient of the text cannot reply directly back to the OCE (Fautore). The email address provided here will receive any replies. |
| Dedicated Outgoing SMTP Server:Port | mail.tekadv.com:26 | This is the email server Fautore should use to send the text message. Text message are sent to phone service providers as email. the provider then converts it to a text and send it to the phone at the number above. What is being listed here is the email server to use sending the email containing the text. The port value is "25" as the common standard. Some Internet Service Providers block port 25 from going out and in these cases value "26" is a good substitute. Trial and error often gets it pretty quickly, or you can consult the documentation for your mail service provider. |
| Dedicated Outgoing User Name | BigFoot@tekadv.com | This value is for the mail service account name expected by the "Dedicated Outgoing SMTP Server" to be identified as a valid user of that server. |
| Dedicated Outgoing Password | NotHiddenHere | This value is for the password for the account listed as the mail service account name expected by the "Dedicated Outgoing SMTP Server" to be identified as a valid user of that server. |
Click "Submit" and the values will be recorded and you will be returned to the External Applications screen.