Создание настраиваемого файла XML для шлюза SMTP

Раздел «Регионы» файла XML состоит из трех пунктов.

• Двухбуквенный код страны ISO2   Это двухбуквенный код из стандарта ISO 3 166-1 alpha-2.
  
  
• Код страны   Этот код берется из Списка кодов страны, назначаемых в соответствии с рекомендацией ITU-T E.164.
  
  
• Образец телефонного номера   Этот формат образца является необязательным пунктом.
  
  
• Раздел «Регионы» в файле XML может выглядеть следующим образом:
  
  

	Скопировать код
<Regions> <Region Iso2="CN"> <CountryCode>86</CountryCode> <PhoneNumberExample>139 0000 0000</PhoneNumberExample> </Region> </Regions>

Примечание.
Если в настраиваемом файле XML производится попытка определить регион, совпадающий с содержащимся в файле по умолчанию, то запись в файле по умолчанию будет перезаписана.

Раздел сведений об операторах содержит два следующих пункта.

• ID   Это 5-значный номер, который является уникальным в пределах файлов XML конфигурации SMTP: по умолчанию и настраиваемого.
  
  
• Локализованное имя оператора   Каждый оператор может иметь несколько имен. Это локализованное имя для оператора в местном регионе. Можно задать отображаемые имена для ряда мест. Отображаемое имя на английском языке должно всегда задаваться как параметр по умолчанию.
  
  

Раздел «Операторы» в файле XML может выглядеть следующим образом:

	Скопировать код
<Carriers> <Carrier Identity="30344"> <LocalizedInfo Culture="en"> <DisplayName>Gold Systems, Inc.</DisplayName> </LocalizedInfo> </Carrier> <Carrier Identity="30345"> <LocalizedInfo Culture="en"> <DisplayName>China Mobile</DisplayName> </LocalizedInfo> <LocalizedInfo Culture="zh"> <DisplayName>????</DisplayName> </LocalizedInfo> </Carrier> </Carriers>

Примечание.
Если файл XML содержит текст в кодировке Юникод для локализованного имени оператора, необходимо сохранить файл XML в кодировке UTF-8 или Юникод.

В этом разделе определяется спецификация для шлюза SMTP. В этот раздел файла XML включаются сведения трех типов.

• Код региона ISO   Этот задаваемый код должен быть предварительно определен в разделе «Регионы» файла XML.
  
  
• Оператор   Идентификатор оператора должен быть предварительно определен в разделе «Операторы» файла XML.
  
  
• SMTPToSMSGateway   В этом разделе файла содержатся следующие сведения:
  
  
  • SMTP-адрес   Это SMTP-адрес для маршрутизации сообщения при создании SMS-уведомления. В этом поле имеется два ключевых слова. %c — это код страны, заданный в разделе региона, а %n — местный номер телефона.
    
    
  • MessageRendering   В этом контейнере определяется способ отображения сообщения. Он включает в себя несколько параметров. Параметр Container может иметь одно из двух значений. Если значением является текст, то содержимое SMS-сообщения хранится в тексте сообщения. Если значением является тема, то содержимое SMS-сообщения хранится в теме сообщения. Параметр Capacity указывает максимальное количество символов в одном SMS-сообщении. Свойство CodingScheme параметра Capacity может иметь значения GSMDefault, Unicode или Euc-KR.
    
    

Пример раздела «Служебная информация» может выглядеть следующим образом:

	Скопировать код
<Service> <RegionIso2>CN</RegionIso2> <CarrierIdentity>30345</CarrierIdentity> <Type>SmtpToSmsGateway</Type> <SmtpToSmsGateway> <RecipientAddressing> <SmtpAddress>%n@139.com</SmtpAddress> </RecipientAddressing> <MessageRendering Container="Body"> <Capacity CodingScheme="GsmDefault">140</Capacity> <Capacity CodingScheme="Unicode">50</Capacity> </MessageRendering> </SmtpToSmsGateway> </Service>

Для сети GSM всегда должна быть задана емкость GsmDefault, а параметр Unicode является необязательным. Когда он не задан, все символы Юникод в системе автоматически преобразуются в символ «?».

Для сети CDMA должен быть задан как минимум один параметр емкости.

Примечание.
Как правило, шлюзом SMTP используются некоторые символы для получения дополнительной информации, например поле отправителя «От:». При указании длины сообщения для такого рода информации следует выделять буфер достаточного объема.