GetStatusCommand

Команда взаимодействия с СМС-сервером "СМС-Центр"; возвращает статус отправленных сообщений СМС-рассылки.

Шаблон GetStatusCommand

<Command Name="" Type="GetStatusCommand" Assembly="SMSCenterEngine">
  <UserSqlQuery>
    <Text></Text>
  </UserSqlQuery>
  <PasswordSqlQuery>
    <Text></Text>
  </PasswordSqlQuery>
  <Background Value="True" />
  <PhonesSqlQuery>
    <Text></Text>
  </PhonesSqlQuery>
  <PostSqlQuery>
    <Text></Text>
  </PostSqlQuery>
</Command>

Описание GetStatusCommand

<Command Name="GetStatusCommandName" Type="GetStatusCommand" Assembly="SMSCenterEngine">
  <!--Тэги, общие для всех команд-->
  <!--Тэги, общие для всех команд сборки SMSCenterEngine-->
  <!--Тэги, специфичные для определенной команды (зависит от типа) сборки SMSCenterEngine-->
</Command>

Тэги, специфичные для GetStatusCommand

Background

Признак, определяющий, будет ли проверка статуса отправки СМС происходить в фоновом режиме (в отдельном потоке, то есть без задержки для приложения, вызвавшего данную команду).

Необязательный тэг. Значение тэга <Background>: не ожидается.

Если тэг <Background> отсутствует, то для атрибута Value используется значение False.

<Background Value="False" />

Атрибуты тэга <Background>

Value

Значение. Обязательный атрибут. Ожидается логическое значение.

PhonesSqlQuery

Sql-запрос, возвращающий список телефонов и идентификатором СМС в системе "СМС-Центр", для которых нужно определить статус.

Обязательный тэг. Значение тэга <PhonesSqlQuery>: тэг <Text>.

<PhonesSqlQuery>
  <Text>
    SELECT
    sms_phone_id AS "Id",
    phone AS "Phone",
    message_id AS "MessageId"
    FROM
    sms_phone
  </Text>
</PhonesSqlQuery>

Тэг <Text>

Содержит sql-запрос.

Обязательный тэг. Значение тэга <Text>: текст sql-запроса.

Sql-запрос должен возвращать список полей со следующими заголовками (алиасами):

1. Id - произвольный идентификатор, соответствующий телефону, указанному при отправке СМС, который будет использоваться в Post-запросе.

2. Phone - телефон, указанный при отправке СМС.

3. MessageId - идентификатор отправленного СМС в системе "СМС-Центр".

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями параметров с соответствующими названиями, передаваемых клиентом.

СМС, отправленные до 18.00 текущего дня, переходят в системе "СМС-Центр" в архивные в 03.00 следующего дня. Запрос на определение статуса отправки архивного СМС всегда будет возвращать пустую строку (""). Это политика "СМС-Центра". Подробнее читайте обо всех свойствах рассылок СМС на сайте.

PostSqlQuery

Sql-запрос, выполняющийся при успешном определении статуса отправки каждого СМС.

Необязательный тэг. Значение тэга <PostSqlQuery>: тэг <Text>.

<PostSqlQuery>
  <Text>
    UPDATE
    sms_phone
    SET
    sms_status_id = {SMSStatusId}
    WHERE
    sms_phone_id = {Id}
  </Text>
</PostSqlQuery>

Тэг <Text>

Содержит sql-запрос.

Обязательный тэг. Значение тэга <Text>: текст sql-запроса.

Sql-запрос должен возвращать список полей со следующими заголовками (алиасами):

Текст sql-запроса поддерживает переменные типа {Parameter}, заменяемые при его выполнении значениями параметров с соответствующими названиями, передаваемых клиентом.

Текст sql-запроса поддерживает переменную {MessageId}, заменяемые при его выполнении значением идентификатором СМС в системе "СМС-Центра".

Текст sql-запроса поддерживает переменную {Id}, заменяемую при его выполнении значением, возвращенным для очередного телефона в запросе, указанном в тэге <PhonesSqlQuery>.