Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Name

Type

Description

success

int32

Индикатор успеха

Настройка параметра PERIOD

...

titleПодробнее...

Период времени указывается в виде строки в следующем формате:

            подпериод[, подпериод...]

Между собой подпериоды разделены запятой и имеют логическую связь «или».

Подпериод принимает следующий вид:

            измерение {значение [значение...]} [измерение { значение [значение...]}]

У каждого измерения внутри фигурных скобок указываются значения.  Значения могут быть двух типов

  • Перечисление. Значения отделены между собой пробелами
    wk {1 3 5}
  • Диапазон. Значения задаются в виде «от» и «до» включительно и разделяются пробелами.
    wd {2-4 7-1}
Info
В случае, если в диапазоне число слева больше, чем число справа, то значение рассчитывается как зацикленное (например, если для часа указать 23-4, допустимыми будут 23,1,2,3,4).

Разные типы значений должны иметь отдельное описание для измерения.

Допустимое описание: wd {2-4 } wd {5 7}

Недопустимое описание: wd {2-4 5 7}

Расчёт активности номера ведется только по полям, которые указаны в подпериодах. Нет необходимости описывать каждое измерение. Последовательность измерений тоже не важна.

Для вычисления дней недели, указанных в числовом формате, отсчет ведется с понедельника. Например, период wd {1-5} подразумевает время с понедельника по пятницу

Для вычисления времени стоит учитывать, что значение часа, например, hr {9am} подразумевает промежуток времени с 9:00:00 до 9:59:59.
Аналогично hr {9am-9pm} подразумевает промежуток времени с 9:00:00 до 21:59:59.

...

Таблица измерений и допустимых значений:

...

Название

...

Измерение

...

Допустимые значения измерений

...

year -год

...

yr 

...

0-3000

...

Month -месяц 

...

mo 

1-12 или

jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec 

Jan, Feb, Mar, Apr, May, Jun, Jul, Aug, Sep, Oct, Nov, Dec 

...

week – неделя в месяце

...

wk 

...

1-6

...

yday – день года

...

yd 

...

1-365

...

mday – день месяца

...

md 

...

1-31

...

wday – день в неделе

...

wd 

...

1-7 или

mo, tu, we, th, fr, sa, su или

Mo, Tu, We, Th, Fr, Sa, Su или

mon, tue, wed, thu, fri, sat, sun или

Mon, Tue, Wed, Thu, Fri, Sat, Sun

...

hour – час

...

hr 

...

0-23 или

12am 1am-11am 12pm(12noon) 1pm-11pm

...

minute - минута

...

min 

...

0-59

...

second  - секунда

...

sec 

...

0-59

Примеры

Чтобы указать период времени с понедельника по пятницу, с 9:00 до 17:00, можно использовать следующий период:

...

Понедельник, среда и пятница и с 9:00 до 17:00 во вторник и четверг с 9:00 до 15:00, используйте следующий период:

...

Чтобы указать период времени с понедельника по пятницу, с 9:00 до 17:00, но чередуя недели в месяце, используйте следующий период:

wk {1 3 5} wd {Mon-Fri} hr {9am-4pm} 

Аналогично дни недели можно указать цифрами:

wk {1 3 5} wd {1-5} hr {9am-4pm} 

 

Для периода, указывающего на зиму:

mo {Nov-Feb} 

Следующие примеры эквивалентны предыдущему:

mo {Jan-Feb Nov-Dec}  //один подпериод ((январь или февраль или ноябрь или декабрь))

...


...

Чтобы указать период каждые другие полчаса:

min {0-29} 

Чтобы указать каждые первые полчаса чередующихся дней недели, а вторые полчаса в остальные дни недели используйте следующий период:

...

Подробнее о настройке параметра PERIOD...

Пример

Code Block
languagejava
themeMidnight
titleJSON
linenumberstrue
{
   "id":"1",
   "jsonrpc":"2.0",
   "method":"SetFollowMe",
   "params":{
      "sip_id":"выбранный аккаунт",
      "event_URL":"URL для отправки онлайн уведомлений о ходе звонка*",
      "event_extended":"Параметр для получения расширенных логов по звонку",
      "client_id":"Сквозной идентификатор вызова от API клиента",
      "redirect_type":Тип переадресации,
      "file_to_A":"id промпта для стороны A",
      "file_to_B":"id промпта для стороны B",
      "answer":"проигрывание промпта в ответном состоянии/проигрывание промпта в предответном состоянии.",
      "masking":" Скрытие/Транслирование А- номера",
      "controlCallStruct":[
         {
            "I_FOLLOW_ORDER":Порядок следования номера при перенаправлении вызова,
            "PERIOD":"Период (дни недели и диапазон времени) активности перенаправления на данный номер",
            "PERIOD_DESCRIPTION":"Описание периода перенаправления вызова",
            "TIMEOUT":Таймаут (в секундах) время ожидания ответа,
            "ACTIVE":"Активность ",
            "NAME":"Символьное имя номера для перенаправления вызова",
            "REDIRECT_NUMBER":"Номер для перенаправления вызова",
            "DTMF":"Ввод добавочного номера"
         },
         {
            "I_FOLLOW_ORDER":2,
            "PERIOD":"Период (дни недели и диапазон времени) активности перенаправления на данный номер",
            "PERIOD_DESCRIPTION":"Описание периода перенаправления вызова",
            "TIMEOUT":Таймаут (в секундах) время ожидания ответа,
            "ACTIVE":"Активность ",
            "NAME":"Символьное имя номера для перенаправления вызова",
            "REDIRECT_NUMBER":"Номер для перенаправления вызова"
         }
      ]
   }
}

...