Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
doc:1cajam:api:setvar [2012/01/31 09:04] nabek |
doc:1cajam:api:setvar [2014/11/14 22:32] (текущий) |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Команда Asterisk Manager API: SetVar ====== | ====== Команда Asterisk Manager API: SetVar ====== | ||
- | |||
Команда устанавливает глобальную переменную либо переменную канала. | Команда устанавливает глобальную переменную либо переменную канала. | ||
- | Необходимые привилегии: call,all | + | ===== Параметры ===== |
+ | |||
+ | * **Channel**: Канал, для которого устанавливается переменная. Если не указано, то устанавливается глобальная переменная. | ||
+ | * **Variable**: Имя переменной. | ||
+ | * **Value**: Значение переменной. | ||
+ | * **ActionID**: ID команды, который будет возвращен в ответе. | ||
+ | * **Result**: В эту переменную будет возвращен результат выполнения функции. | ||
+ | |||
+ | <note important>Все переменные передаваемые в функцию должны иметь тип Строка!</note> | ||
+ | <note warning>Для переменной Variable не применяется [[http://ru.wikipedia.org/wiki/URL#.D0.9A.D0.BE.D0.B4.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_URL|URLENCODE]], имейте это ввиду при передаче сложных переменных! | ||
- | **Параметры команды** | + | Делайте замену символов на "безопасные" в среде 1С. Например, символ пробела нужно заменить последовательностью %20, символ / заменяем на %2F и т.д. </note> |
- | * Channel: Канал, для которого устанавливается переменная. Если не указано, то устанавливается глобальная переменная. | + | ===== Пример вызова ===== |
- | * Variable: Имя переменной. | + | |
- | * Value: Значение переменной. | + | |
- | * ActionID: Необязательный ID команды, который будет возвращен в ответе. | + | |
- | **Запрос:** | + | <code 1c> |
- | <code> | + | Channel = "Zap/1-1"; |
- | Action: Setvar | + | Variable = "AtestVariable"; |
- | Channel: Zap/1-1 | + | Value = "This is now set"; |
- | Variable: AtestVariable | + | ActionID = "123123"; |
- | Value: This is now set | + | Result = ""; |
- | </code> | + | |
- | **Ответ asterisk:** | + | Если Компонент.SetVar( Channel, Variable, Value, ActionID, Result) = Истина Тогда |
- | <code> | + | Сообщить(Result); |
- | Response: Success | + | КонецЕсли; |
- | Message: Variable Set | + | </code> |
- | </code> | + | |
+ | ===== Полезные ссылки ===== | ||
+ | * [[doc:1cajam|Описание SDK: "Компонента связи 1С и Asterisk"]] | ||
+ | * [[doc:1cajam:api|Все функции компоненты связи 1С и Asterisk]] | ||
+ | * [[kb:asterisk:ami:setvar|Прототип текущей функции, команда AMI Asterisk: SetVar]] | ||
+ | * [[kb:asterisk:ami|Интерфейс управления сервером Asterisk (Asterisk Manager API)]] | ||
+ | * [[kb:asterisk:events|Список известных событий возвращаемых Asterisk Manager API]] | ||
===== Комментарии ===== | ===== Комментарии ===== | ||
~~DISQUS~~ | ~~DISQUS~~ |