Здесь показаны различия между двумя версиями данной страницы.
Следующая версия | Предыдущая версия | ||
doc:1cajam:api:updateconfig [2012/01/30 07:43] amzh создано |
doc:1cajam:api:updateconfig [2014/11/14 22:32] (текущий) |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Функция Updateconfig из SDK: "Компонента связи 1С и Asterisk" ====== | ====== Функция Updateconfig из SDK: "Компонента связи 1С и Asterisk" ====== | ||
- | Команда создает, модифицирует или удаляет элемент конфигурации в указанном конфигурационном файле Asterisk. Обратите внимание, что Вы потеряете все комментарии в файле, который подвергается изменению конфигурации! | + | Команда создает, модифицирует или удаляет элемент конфигурации в указанном конфигурационном файле Asterisk. |
+ | |||
+ | Обратите внимание, что Вы потеряете все комментарии в файле, который подвергается изменению конфигурации! | ||
===== Параметры ===== | ===== Параметры ===== | ||
- | *SrcFilename: Имя конфигурационного файла asterisk для чтения параметров (например: foo.conf). | + | * **SrcFilename**: Имя конфигурационного файла asterisk для чтения параметров (например: foo.conf). |
- | *DstFilename: Имя конфигурационного файла asterisk для записи измененной конфигурации (например: foo.conf). | + | * **DstFilename**: Имя конфигурационного файла asterisk для записи измененной конфигурации (например: foo.conf). |
- | *Reload: Если указано «yes”,то производиться перезагрузка конфигурации Asterisk, если указано имя модуля, то только данный модуль будет перезагружен. | + | * **Reload**: Если указано "yes",то производиться перезагрузка конфигурации Asterisk, если указано имя модуля, то только данный модуль будет перезагружен. |
- | *Action-XXXXXX: Действие, которое нужно произвести с конфигурацией. Возможные значения: | + | * **Action-XXXXXX**: Действие, которое нужно произвести с конфигурацией. Возможные значения: |
- | *NewCat: Добавление новой пустой категории в конфигурационный файл. Категория указывается в поле: Cat-XXXXXX . | + | *NewCat: Добавление новой пустой категории в конфигурационный файл. Категория указывается в поле: Cat-XXXXXX . |
- | *RenameCat: Переименование категории в конфигурационном файле, которая указана в поле: Cat-XXXXXX, в значение, которое указано в поле: Value-XXXXXX. | + | *RenameCat: Переименование категории в конфигурационном файле, которая указана в поле: Cat-XXXXXX, в значение, которое указано в поле: Value-XXXXXX. |
- | *DelCat: Удаление всей категории в конфигурационном файле. Категория указывается в поле: Cat-XXXXXX . | + | *DelCat: Удаление всей категории в конфигурационном файле. Категория указывается в поле: Cat-XXXXXX . |
- | *Update: изменение значения конфигурационного параметра, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX. На значение, которое указано в поле: Value-XXXXXX. Если нужно изменить значение параметра только в том случае, если он имеет определенное значение, то это значение необходимо указать в поле Match-XXXXXX, иначе все параметры с заданным именем (если их несколько) примут новое значение. | + | *Update: изменение значения конфигурационного параметра, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX. На значение, которое указано в поле: Value-XXXXXX. Если нужно изменить значение параметра только в том случае, если он имеет определенное значение, то это значение необходимо указать в поле Match-XXXXXX, иначе все параметры с заданным именем (если их несколько) примут новое значение. |
- | *Delete: Удаление параметра конфигурации, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX. Если нужно удалить все параметры с заданным именем в данной категории, то можно не указывать поле: Match-XXXXXX, иначе необходимо указать значение удаляемого параметра в этом поле. Например, при работе с директивами «allow”, “disallow” в файле sip.conf, если надо удалить конкретный кодек, то нужно указать его значение в поле: Match-XXXXXX! | + | *Delete: Удаление параметра конфигурации, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX. Если нужно удалить все параметры с заданным именем в данной категории, то можно не указывать поле: Match-XXXXXX, иначе необходимо указать значение удаляемого параметра в этом поле. Например, при работе с директивами «allow”, “disallow” в файле sip.conf, если надо удалить конкретный кодек, то нужно указать его значение в поле: Match-XXXXXX! |
- | *Append: Добавление значения конфигурационного параметра, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX, со значением, которое указано в поле: Value-XXXXXX. | + | *Append: Добавление значения конфигурационного параметра, имя которого указано в Var-XXXXXX, в категории конфигурационного файла, которая указана в поле: Cat-XXXXXX, со значением, которое указано в поле: Value-XXXXXX. |
- | *Cat-XXXXXX: Категория конфигурационного файла, в которой необходимо произвести изменения. | + | * **Cat-XXXXXX**: Категория конфигурационного файла, в которой необходимо произвести изменения. |
- | *Var-XXXXXX: Имя параметра, с которым производиться действие. | + | * **Var-XXXXXX**: Имя параметра, с которым производиться действие. |
- | *Value-XXXXXX: Значение соответствующего заданного параметра, над которым производиться действие. | + | * **Value-XXXXXX**: Значение соответствующего заданного параметра, над которым производиться действие. |
- | *Match-XXXXXX: Необязательный параметр, с которым проверяется соответствие значение параметра в файле конфигурации, при операциях Append, Update и Delete. | + | * **Match-XXXXXX**: Необязательный параметр, с которым проверяется соответствие значение параметра в файле конфигурации, при операциях Append, Update и Delete. |
- | *ActionID: ID команды, который будет возвращен в ответе. | + | * **Line-XXXXXX**: Line in category to operate on (used with delete and insert actions). X's represent 6 digit number beginning with 000000. |
- | *Result: В эту переменную будут возвращен результат выполнения функции. | + | * **ActionID**: ID команды, который будет возвращен в ответе. |
+ | * **Result**: В эту переменную будет возвращен результат выполнения функции. | ||
Символы XXXXXX – это 6 цифр, начиная с 000000, дополненные до шести знаков нулями спереди. Служит для разделения нескольких действий в одном запросе и определения, какие параметры, к какому действию относятся. Максимальное значение – 100000. | Символы XXXXXX – это 6 цифр, начиная с 000000, дополненные до шести знаков нулями спереди. Служит для разделения нескольких действий в одном запросе и определения, какие параметры, к какому действию относятся. Максимальное значение – 100000. | ||
Строка 30: | Строка 33: | ||
<code 1c> | <code 1c> | ||
- | Channel = "SIP/123-1c20"; | + | |
- | Timeout = "10"; | + | SrcFilename = "manager.conf"; |
- | SrcFilename = | + | DstFilename = "manager.conf"; |
- | DstFilename = | + | Reload = "yes"; |
- | Reload = | + | Action = "append"; |
- | Action = | + | Cat = "ami-test"; |
- | NewCat = | + | Var = "exten"; |
- | RenameCat = | + | Value = "999,1,Dial(SIP/Bob)"; |
- | DelCat = | + | Match = "object"; |
- | Update = | + | Line = ""; |
- | Delete = | + | |
- | Append = | + | |
- | Cat = | + | |
- | Var = | + | |
- | Value = | + | |
- | Match = | + | |
ActionID = "123123"; | ActionID = "123123"; | ||
Result = ""; | Result = ""; | ||
- | Если Компонент.UpdateConfig( SrcFilename, DstFilename, Reload, Action, NewCat, RenameCat, DelCat, Update, Delete, Append, Cat, Var, Value, Match, ActionID, Result) = Истина Тогда | + | Если Компонент.UpdateConfig( SrcFilename, DstFilename, Reload, Action, Cat, Var, Value, Match, Line, ActionID, Result) = Истина Тогда |
Сообщить(Result); | Сообщить(Result); | ||
КонецЕсли; | КонецЕсли; | ||
</code> | </code> | ||
- | |||
===== Полезные ссылки ===== | ===== Полезные ссылки ===== | ||
* [[doc:1cajam|Описание SDK: "Компонента связи 1С и Asterisk"]] | * [[doc:1cajam|Описание SDK: "Компонента связи 1С и Asterisk"]] | ||
* [[doc:1cajam:api|Все функции компоненты связи 1С и Asterisk]] | * [[doc:1cajam:api|Все функции компоненты связи 1С и Asterisk]] | ||
- | * [[kb:asterisk:ami:updateconfig|Прототип текущей функции, команда AMI Asteriks: Updateconfig]] | + | * [[kb:asterisk:ami:updateconfig|Прототип текущей функции, команда AMI Asterisk: Updateconfig]] |
* [[kb:asterisk:ami|Интерфейс управления сервером Asterisk (Asterisk Manager API)]] | * [[kb:asterisk:ami|Интерфейс управления сервером Asterisk (Asterisk Manager API)]] | ||
* [[kb:asterisk:events|Список известных событий возвращаемых Asterisk Manager API]] | * [[kb:asterisk:events|Список известных событий возвращаемых Asterisk Manager API]] | ||
+ | |||
+ | ===== Комментарии ===== | ||
+ | ~~DISQUS~~ |