5.14.3 SMSServiceのプロパティ
以下にSMSService.propertiesの内容を示します。これらは、LANSA Integratorの標準インストールに付属しています。これらの値は、SERVICE_LOADコマンドを実行すると省略値でロードされます。
SMSService.propertiesファイルはキーワードの2つのセットで構成されます。1つはHTTP転送に関するセット、もう1つはSMTP転送に関するセットです。
省略値ではSMTP転送がSMSServiceによって使用されます。HTTP転送を使用するには、transport=smtpプロパティのコメントを外し、transport=httpプロパティがアクティブになることを許可するか、transport=smtpプロパティの後にtransport=httpプロパティを追加します。または、TRANSPORTコマンドのキーワードを使用して、転送プロパティ値をオーバーライドします。
新しいLANSAインストールに付属のSMSService.propertiesファイルのHTTP転送キーワードは、SMSゲートウェイ・サービス・プロバイダーとしてwww.streetdata.com.auを使用する場合に限定されます。別のSMSゲートウェイ・サービス・プロバイダーを使用する場合、これらの設定を修正する必要があります。設定を直接修正するには、SMSServices.propertyファイルを修正するか、アプリケーションでSETコマンドを使用します。別のプロバイダーからHTTP転送サービスを使用する場合は、LANSA販売代理店にお問い合わせください。
SMTP転送を使用する場合、SMSゲートウェイ・サービス・プロバイダーのディレクティブに従ってSMSService.propertiesファイルで省略値を設定する必要があります。または、アプリケーションでSETコマンドを使用して、これらの値を実行時に設定します。
#!<studio-project id="20000000-000000" name="lansa">
#
# SMSService resources ( Default )
#
transport=http
provider=streetdata
uri=/admin/msg.php
host=www.streetdata.com.au
# secure=*yes
account.user=12345
account.password=abcde
#
transport=smtp
port=25
server=nnn.nnn.nnn.nnn
subject=user+password
mail.domain=mycompany.com
mobile.domain=smscompany.com
# charset=iso-8859-1
# encoding=ISO8859_1
#
#!</studio-project>
次に、SMSServices.propertiesファイルで定義されるキーワードについて説明します。
キーワード
|
transport |
SMSゲートウェイ・サービス・プロバイダーへのSMS詳細の送信に使用する転送メカニズムの指定に使用されます。 以下の2つのオプションがあります。 値が*SMTPの場合、SMS詳細がSMSゲートウェイ・サービス・プロバイダーにメールで送信されます。*SMTPが省略値転送です。 値が*HTTPの場合、SMS詳細がSMSゲートウェイ・サービス・プロバイダーにHTTPポスト経由で送信されます。*SMTPが省略値であるため、*HTTPを使用するには、アプリケーション内のSETコマンドでこのキーワードに*HTTPを指定する必要があります。 選択した転送は、ほとんどの場合、SMSゲートウェイ・サービス・プロバイダーで登録するサービスに基づきます。 この値をアプリケーションでオーバーライドするには、SETコマンドでTRANSPORTキーワードを使用します。 |
|
provider |
このキーワードは*HTTP転送でのみ使用されます。 インストール時の省略値はSTREETDATAです。 SMSServiceの*HTTP転送オプションは、www.streetdata.com.auプロバイダーをサポートするように構成されています。各プロバイダーでは一意の実装やメソッドをそれぞれ用意しているため、その方法でSMSデータを受け取る必要があります。サポートされていないプロバイダーを使用する場合は、LANSA販売代理店にお問い合わせください。 この制限は*SMTP転送に適用されない点に注意してください。 この値をアプリケーションでオーバーライドするには、SETコマンドでPROVIDERキーワードを使用します。 |
|
uri |
このキーワードは*HTTP転送でのみ使用されます。 SMSゲートウェイ・サービス・プロバイダーから提供されるHTTPリソースです。 省略値は/admin/msg.phpです。 この値をアプリケーションでオーバーライドするには、SETコマンドでURIキーワードを使用します。 |
|
host |
このキーワードは*HTTP転送でのみ使用されます。 SMSゲートウェイ・サービス・プロバイダーから提供されるホスト値です。 インストール時の省略値はwww.streetdata.com.auです。 この値をアプリケーションでオーバーライドするには、SETコマンドでこのHOSTキーワードを使用します。 |
|
secure |
このキーワードは*HTTP転送でのみ使用されます。 SSL (暗号化されたHTTPS)を使用して詳細を送信するには、この値を*YESに設定する必要があります。 インストール時の省略値は*NOです。 この値をアプリケーションでオーバーライドするには、SETコマンドでSECUREキーワードを使用します。 |
|
account.user |
このキーワードは*HTTP転送でのみ使用されます。 SMSゲートウェイ・サービス・プロバイダーから提供されるアカウント名です。 この値をアプリケーションでオーバーライドするには、SETコマンドでACCOUNT_USERキーワードを使用します。 |
|
account.password |
このキーワードは*HTTP転送でのみ使用されます。 アカウントのパスワードです。 この値をアプリケーションでオーバーライドするには、SETコマンドでACCOUNT_PASSWORDキーワードを使用します。 |
|
port |
このキーワードは*SMTP転送でのみ使用されます。 SMTPメール・サーバーが実行するTCP/IPポートです。 省略値は25です。 このキーワードは任意です。 この値をアプリケーションでオーバーライドするには、SETコマンドでPORTキーワードを使用します。 |
|
server |
このキーワードは*SMTP転送でのみ使用されます。 SMS詳細を含むメール送信に使用しているSMTPサーバーのアドレスです。 この値をアプリケーションでオーバーライドするには、SETコマンドでSERVERキーワードを使用します。 |
|
subject |
このキーワードは*SMTP転送でのみ使用されます。 メールの件名が含まれます。 通常、この中には、使用しているSMSゲートウェイのユーザー・アカウントとアカウント・パスワード(形式はユーザー+パスワード)が含まれます。プロバイダーでは各自の形式を用意しているため、プロバイダーで形式を確認してください。 この値をアプリケーションでオーバーライドするには、SETコマンドでSUBJECTキーワードを使用します。 |
|
from.address |
このキーワードは*SMTP転送でのみ使用されます。 SMSゲートウェイ・サービス・プロバイダーからのメール応答の戻り先アドレスです。このような応答にはSMSステータス情報(SMSの失敗など)が含まれます。 通常は、企業のいずれかのメール・アドレスになり、おそらくこのような応答受信専用のアドレスになります。有効なメール・アドレスにしてください。多くのプロバイダーでは、すでに登録されているアドレスしか受け入れません。 この値をアプリケーションでオーバーライドするには、SETコマンドでFROMキーワードを使用します。 |
|
mail.domain |
このキーワードは*SMTP転送でのみ使用されます。 SMTP HELOコマンドで発行されるメール・ドメインです。この値によって、これがメール・ドメインであることがSMTPサーバーに伝えられます。 このキーワードは任意です。 この値をアプリケーションでオーバーライドするには、SETコマンドでMAILDOMAINキーワードを使用します。 |
|
mobile.domain |
このキーワードは*SMTP転送でのみ使用されます。 メールとSMS詳細の送信先メール・ドメインです。 通常、この値の先頭はSMSの送信先携帯番号になります。例えば、SMSを12345678という番号に送信し、携帯ドメインがstreetdata.com.auの場合、メッセージの送信先のメール・アドレスは[email protected]になります。 この値をアプリケーションでオーバーライドするには、SETコマンドでMOBILEDOMAINキーワードを使用します。 |
|
charset |
このキーワードは*SMTP転送でのみ使用されます。 本文と件名の文字セット・エンコーディングです。 このキーワードは任意です。 この値をアプリケーションでオーバーライドするには、SETコマンドでCHARSETキーワードを使用します。 |
|
encoding |
このキーワードは*SMTP転送でのみ使用されます。 本文エンコーディングです。 このキーワードは任意です。 この値をアプリケーションでオーバーライドするには、SETコマンドでENCODINGキーワードを使用します。 |