16. Web-сервисы.

Механизм Web-сервисов позволяет создавать Web-сервисы в конфигурации 1С:Предприятия 8, а также взаимодействовать в конфигурации 1С:Предприятия 8 с веб-сервисами, опубликованными сторонними поставщиками.

3. Прикладные механизмы платформы.

Стандартизация технологии разработки прикладных решений позволяет разработчику сосредоточить свои усилия на создании бизнес-логики приложения и не заниматься технологическими подробностями, такими, как организация взаимодействия с базой данных, обработка транзакционных блокировок, нюансы программирования экранных форм и пр. Это возможно благодаря тому, что прикладные решения в 1С:Предприятии разрабатываются в терминах проблеммно-ориентированных объектов, набор которых определен на уровне технологической платформы.

1. Справочники.

Справочники служат для описания таких сущностей, как товары, контрагенты, валюты, склады и пр. Все эти сущности имеют общие свойства: внутренняя идентификация объекта в системе, необходимость поддержки иерархии и группировки элементов, необходимость поддержки вложенных таблиц и т.п.

2. Константы.

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

3. Перечисления.

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

4. Документы.

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

5. Оперативный учет.

Система поддерживает проведение документов пользователями в режиме "реального времени", что особенно актуально при многопользовательской работе.

6. Хранение сведений.

Система обеспечивает хранение многомерных сведений о значениях различных величин. Такими значениями могут быть, например, курсы валют или цены на товары конкурентов по состоянию на определенную дату. Эта информация может быть как статической, так и изменяющейся с течением времени - в этом случае для нее предусмотрено хранение истории изменений.

7. Описание характеристик.

Система позволяет хранить информацию о характеристиках различных объектов. Позволяет пользователю создавать всевозможные характеристики, описывать тип этих характеристик и задавать их значения. Может использоваться, например, для предоставления пользователю возможности описывать товары произвольным количеством произвольных характеристик (цвет, размер, запах и т.д.). Позволяет создавать и хранить название характеристики и тип данных, который должны принимать значения этой характеристики.

8. Учет движения средств.

Система "отвечает" за учет движений ресурсов (финансов, товаров, материалов и т.д.). Позволяет автоматизировать такие направления, как складской учет, взаиморасчеты, планирование. В регистрах накопления хранится информация о поступлении и расходе тех или иных ресурсов, а функциональность этих объектов предоставляет возможность получения остатков на определенный момент времени, расчета итогов, кэширования итогов и т.д.

9. Бухгалтерский учет.

Система позволяет строить модели, реализующие систему двойной записи бухгалтерского учета. Реализуют многоуровневые планы счетов с фиксированной или переменной разрядностью кодов, многоуровневый и многомерный аналитический учет, учет по нескольким планам счетов, учет по нескольким организациям, опциональное ведение количественного, суммового и валютного учета по отдельным разрезам аналитики и т.д.

10. Сложные периодические расчеты.

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

11. Бизнес-процессы.

Позволяют создавать формализованные описания типичных последовательностей работ, выполняемых в организации, и на их основе формировать списки задач, которые необходимо выполнить тому или иному сотруднику организации в данный момент. Например, процесс продажи товара может быть представлен как последовательность выписки счета, его утверждения, получения наличной оплаты и отгрузки товара со склада. За выполнение каждого из этапов могут отвечать различные сотрудники, таким образом, в любой момент времени можно определить, в каком состоянии находится процесс продажи товара и кто из сотрудников в данный момент должен выполнить какие-либо действия.

12. Внешние источники данных.

Позволяют получать информацию из внешних баз данных, возможно, не основанных на 1С:Предприятии.

13. Ввод на основании.

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

14. Критерий отбора.

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

4. Интерфейсные механизмы.

Назначение интерфейсных механизмов платформы «1С:Предприятие 8» заключается в том, чтобы обеспечить взаимодействие пользователя с прикладным решением.

Интерфейс всех прикладных решений «1С:Предприятия 8» имеет единую концепцию, основанную на использовании стандартных элементов, предоставляемых платформой. Благодаря такому подходу, пользователи, знакомые с каким-либо одним прикладным решением, комфортно чувствуют себя при работе с любыми другими прикладными решениями «1С:Предприятия».

1. Формы.

Формы в «1С:Предприятии» служат для отображения и редактирования информации, содержащейся в базе данных. Формы могут генерироваться системой автоматически или создаваться разработчиком. Для выполнения стандартных действий с данными могут быть назначены формы для всех объектов прикладного решения.

2. Элементы формы.

Для отображения и редактирования данных в форме используются разнообразные элементы управления, размещенные в форме. Система содержит специализированный набор элементов управления, ориентированный на выполнение бизнес-задач, обладающий характерными особенностями.

3. Командный интерфейс.

Система автоматически строит командный интерфейс для конкретного пользователя на основе структуры подсистем, к которым привязаны объекты прикладного решения. Пользователь может настроить интерфейс в соответствии со своими личными предпочтениями. Внедренец может включить или выключить часть функциональности прикладного решения, не изменяя его код.

4. Табличный документ.

Табличный документ является мощным средством презентации любой информации и вывода ее на печать. Он обеспечивает не только эффективную подготовку печатных документов, но и просмотр их на экране в удобном для пользователя виде.

5. Форматированный документ.

С помощью форматированного документа можно создавать фрагменты текста, содержащие различное шрифтовое, цветовое оформление, выравнивание, включающие картинки и гиперссылки.

6. Текстовый документ.

В прикладных решениях «1С:Предприятия 8» наряду с табличными документами могут использоваться и текстовые документы для представления выходной информации пользователю. Система позволяет формировать их программно, на основании макетов, созданных разработчиком.

7. Диаграммы.

Использование диаграмм позволяет представлять итоговые данные в виде, удобном для восприятия. Диаграммы акцентируют внимание пользователя на динамике изменения данных и помогают быстро производить относительное сравнение данных. Кроме этого, специализированные виды диаграмм могут отражать закономерности, обычно скрытые за большими объемами данных.

8. Географическая схема.

Географическая схема наглядно представляет итоговые данные в разрезе их географического положения. Это позволяет создавать отчеты иллюстрирующие, например, объемы продаж тех или иных товаров в различных регионах страны. Также географическая схема может быть использована просто для отображения тех или иных географических данных, например, схемы проезда к офису или маршрута движения транспортного средства.

9. Графическая схема.

Графическая схема предназначена для оформления форм и отчетов, в которых требуется представить те или иные организационные схемы, блок-схемы и пр. Кроме этого графическая схема может быть использована как отдельный документ являющийся частью оформления прикладного решения. С помощью графических схем удобно создавать иллюстрации, поясняющие состав тех или иных алгоритмов, структуру тех или иных процессов, организационные схемы и пр.

10. Общие интерфейсные механизмы.

Встроенным языком поддерживается ряд процедур и функций, с помощью которых разработчик может обеспечить интерактивное взаимодействие с пользователем. Например, он может выводить на экран сообщения, предупреждения и информацию о ходе выполнения алгоритмов прикладного решения.

5. Механизмы отчетности

1. Механизм запросов.

Предназначен для выборки информации из базы данных. Запрос - это обращение к системе с просьбой выбрать определенную информацию из базы данных и, зачастую, произвести некоторую ее обработку: сгруппировать, отсортировать, вычислить. С помощью запроса, например, можно легко узнать объем продаж каждого товара в течение года с детализацией до месяца, или выбрать элементы справочников по определенному условию.

2. Табличный документ.

Является мощным средством презентации любой информации и вывода ее на печать. Он обеспечивает не только эффективную подготовку печатных документов, но и просмотр их на экране в удобном для пользователя виде.

3. Система компоновки данных.

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

4. Географическая схема.

Позволяет наглядно представить итоговые данные в разрезе их географического положения. Это позволяет создавать отчеты иллюстрирующие, например, объемы продаж тех или иных товаров в различных регионах страны. Также географическая схема может быть использована просто для отображения тех или иных географических данных, например, схемы проезда к офису или маршрута движения транспортного средства.

5. Механизм анализа данных и прогнозирования.

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

6. Диаграммы.

Использование диаграмм позволяет представлять итоговые данные в удобном для восприятия виде. Диаграммы акцентируют внимание пользователя на динамике изменения данных и помогают быстро производить относительное сравнение данных. Кроме этого, специализированные виды диаграмм могут отражать закономерности, обычно скрытые за большими объемами данных.

Приложение 2

Основные объекты конфигурации:

Объекты конфигурации, располагающиеся в ветви “Общие”

Подсистемы

Предназначены для группировки других объектов конфигурации, например, Кадры, Торговля, Маркетинг. Каждый объект может входить сразу в несколько подсистем. Подсистемы могут быть вложенными друг в друга. Затем на основе подсистем легко назначать роли (права доступа) и формировать интерфейсы.

Общие модули

Содержат процедуры и функции, используемые в других программных модулях, например, общий модуль “Процедуры обработки документов”. В общих модулях не может быть объявлений переменных модуля и нет раздела основной программы, там есть только раздел процедур и функций. Экспортируемые переменные, процедуры и функции модуля приложения не доступны в общих модулях. А экспортируемые процедуры и функции общих модулей доступны в модуле приложения, других общих модулях и остальных программных модулях.

Роли

Предназначены для определения прав пользователей конфигурации, например, роли “Кадровик”, “Администратор”. Особенностью версии 8 по сравнению с версией 7.7 является то, что каждый пользователь может иметь несколько ролей.

Критерии отбора

Критерии отбора нужны для отбора данных по определенному признаку. Например, по критерию отбора “Контрагент” можно выбрать все документы, относящиеся к заданному контрагенту. Критерии отбора применяются для отбора элементов справочников, документов и других объектов.

Интерфейсы

Представляют собой совокупность панелей интерфейса: меню и панели инструментов, например, интерфейс “Бухгалтер”, “Руководитель”. В версии 8 интерфейсы могут переключаться “на лету”, без перезапуска программы.

Общие формы

Общие экранные формы не принадлежат конкретному объекту конфигурации, а относятся к конфигурации в целом. Они могут использоваться в разных местах программы, например, форма “Ввод адреса контрагента”.

Общие макеты

Общие макеты (шаблоны печатных форм) не принадлежат конкретному объекту конфигурации, например, макет “Реестр документов”. Они используются из разных программных модулей.

Общие картинки

Картинки, используемые на кнопках, формах и других интерфейсных объектах. Например, картинка “Выполнить”. Картинки некоторых форматов можно изменять с помощью редактора картинок.

Стили

Стили оформления, включающие в себя различные элементы стиля: цвет отрицательных чисел, цвет фона редактирования полей и т.д. Стили позволяют гибко настроить форматирование некоторых частей конфигурации, например, выделить регламентные документы, важные обработки и т.д. В качестве примера можно назвать стили «Основной», «Яркий», «Регламентные процедуры».

Языки

Языки конфигурации, например, Русский и Английский. Можно разрабатывать конфигурации, рассчитанные на работу пользователей, говорящих на разных языках. Каждый язык имеет код языка, например, у русского языка код “ru” и т.д.

В платформе «1С:Предприятия 8» существуют следующие объекты конфигурации (кроме тех, которые располагаются в ветви Общие):

Константы

В константах хранятся редко изменяемые значения, например, Название организации, ИНН, ФИО руководителя и т.д. У константы обычно назначен примитивный, ссылочный или составной тип данных.

Справочники

В справочниках содержится условно-постоянная списковая информация, например, список товаров, список сотрудников. Такие объекты обычно характеризуются кодом и наименованием.

У справочников также могут быть реквизиты, задаваемые разработчиком, и табличные части, что является важным отличием от версии 7.7. Теперь информацию, связанную с объектом, целиком ему принадлежащую и не имеющую объектной сущности, можно хранить в табличных частях.

Также имейте в виду, что периодических реквизитов справочников в версии 8 больше нет и вместо них для хранения истории изменения данных можно использовать периодические регистры сведений. Подробнее о регистрах сведений написано ниже.

Документы

Документы хранят информацию о событиях в предметной области, о проведенных или планируемых хозяйственных операциях, например “Приходная накладная”, “Платежное поручение”, “План продаж” и т.д. Документ характеризуется номером и датой. Обычно при проведении документа изменяется состояние регистров, например, увеличивается количество товара в регистре Остатки при проведении приходной накладной.

У документа может быть несколько табличных частей, что является важным отличием от версии 7.7. Табличные части позволяют сохранить связанную с документом списковую разнородную информацию, например, перечень товаров, график платежей, список дополнительных расходов и т.д.

Журналы документов

Журналы -- это средство группировки связанных по смыслу документов, например, журнал Склад объединяет приходные и расходные накладные. Аналогично могут быть созданы журналы Банк, Кадры и т.д. Заметьте, что создавать журнал для отображения документов одного вида не нужно, поскольку у каждого документа есть форма списка, которая генерируется автоматически или которую можно создать самостоятельно. Журналы полезны только для группировки документов разного вида.

Нумераторы

Нумераторы -- это служебные объекты, связанные с документами и предназначенные для единой (сквозной) нумерации документов нескольких видов, например, нумератор “Кадровый”, который используется для присвоения номеров всем кадровым приказам. Опять же нумератор имеет смысл, когда требуется присваивать номера по единому правилу документам разных видов.

Последовательности

Предназначены для выстраивания документов в единую хронологическую последовательность, например, “Партионный учет”. Последовательности позволяют контролировать дату актуальности итогов регистров. Например, если документ при своем проведении использует итоги какого-либа регистра, то при изменении движений этого регистра, которые были до даты проведения документа, движения документа могут стать некорректными.

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

В отличие от версии 7.7, в версии 8 у последовательностей могут быть измерения, которые позволяют более точно отследить по каким данным были нарушены итоги, например, по конкретному товару или конкретному контрагенту. Тогда восстановление последовательности будет происходить быстрее за счет того, что будут перепроводиться не все документы, а только те, которые сделали движения по значению данного измерения.

Перечисления

Перечисление -- это предопределенный набор значений, заданный еще на этапе разработки приложения, который не редактируется в режиме Предприятие. Конфигурация рассчитывает на определенные значения, например, перечисление ТипКлиента со значениями Обычный и ОченьВажнаяПерсона. Для VIP-клиентов можно предусмотреть скидки.

Отчеты

На основе информации из базы данных отчеты выдают печатные формы, содержащие всевозможные реестры, детальную и сводную информацию, например, отчеты “Оборотно¬сальдовая ведомость”, “Список сотрудников”, “Анализ продаж”.

Отчеты, как и многие другие объекты конфигурации, могут иметь реквизиты и табличные части, но их смысл отличается от реквизитов и табличных частей справочников и документов. Дело в том, что отчет (и обработки) - это объекты, которые не сохраняются в базе данных, а существуют только в определенные периоды времени, пока с ними работает пользователь. Поэтому нужно понимать назначение реквизитов и табличных частей отчетов (обработок) - они используются для указания параметров формирования отчетов и выполнения обработок.

Обработки

Производят некоторую обработку информации, содержащейся в базе данных, например, обработка “Расчет зарплаты”, “Закрытие периода”.

У обработок могут быть реквизиты и табличные части, их смысл аналогичен реквизитам и табличным частям отчетов, и совершенно отличается от справочников и документов.

Планы видов характеристик

Предназначены для хранения дополнительных характеристик объектов, например дополнительных свойств товаров (вес, цвет, размер). Новые свойства можно вводить в режиме Предприятие. Через этот объект реализован механизм субконто в бухгалтерском учете.

Подробнее о планах видов характеристик можно прочитать в этом разделе.

Регистры сведений

Предназначены для хранения любой информации об объектах в разрезе заданных измерений, например, “Цены товаров”. Особенность регистра сведений от регистра накопления состоит в том, что в регистре сведений каждая запись уникальна и полностью определяется своими измерениями. Например, если регистр сведений “ЦеныТоваров” имеет измерения Номенклатура и ТипЦен, то мы не сможем ввести в этот регистр две цены одного типа по одной номенклатуре, например, две оптовые цены товара “Холодильник Bosh 1232?.

Если требуется хранить историю изменения информации, то регистр сведений делается периодическим, например, “Курсы валют”. Для таких регистров в ключ уникальности записи, кроме измерений, добавляется поле “Период”.

В регистрах сведений, подчиненных регистратору, каждая запись должна быть обязательно связано с документом-регистратором. Это не означает, что она вводится этим документом при своем проведении, но она обязательно должна содержать ссылку на документ в поле “Регистратор”.

Регистры накопления

Предназначены для хранения информации поддающейся суммированию и развернутой по комбинации измерений, например, “Остатки товаров”, “Продажи”, “Взаиморасчеты”. Регистры накопления делятся на регистры остатков и регистры оборотов. Первые выдают информацию на момент времени, а вторые - за период.

Планы счетов

Содержат список счетов для бухгалтерского или управленческого учета, например, план счетов “Основной”, “Управленческий”, “ПланGAAP”. Заметьте, что в отличие от версии 7.7, добавление нового плана счетов еще не означает полного разделения учета, поскольку все проводки хранятся в регистрах бухгалтерии, описанных чуть ниже. Поэтому для отделения одних проводок от других нужно завести еще новый регистр бухгалтерии, основанный на определенном плане счетов

Регистры бухгалтерии

Хранят записи (проводки), основанные на определенном плане счетов, например, регистр бухгалтерии “Управленческий” связан с планом счетов “Управленческий” (основан на нем). Регистр бухгалтерии всегда связан только с одним планом счетов, но один план счетов может использоваться в различных регистрах бухгалтерии.

Новым в версии 8 является также то, что бывают регистры бухгалтерии “без поддержки корреспонденции”, что отражается на его структуре. Для таких регистров каждая запись (проводка) имеет только одну сторону - дебет или кредит.

В отличие от версии 7.7 измерения и ресурсы регистра бухгалтерии задаются разработчиком самостоятельно. Измерения - это своего рода разделители учета, например, Организация, Подразделение, Валюта. Ресурсы регистра бухгалтерии - это числовые данные, по которым требуется получать остатки и обороты, например, Сумма, Количество, ВалСумма. В регистре бухгалтерии могут быть также и реквизиты, которые содержат дополнительную информацию для каждой записи (проводки), они могут быть практически любого типа, например, строковый реквизит “СодержаниеПроводки”.

Планы видов расчета

Содержат виды расчета, имеющие между собой нечто общее, как то: одинаковые базовые виды расчеты, одинаковые правила перерасчета, общие правила вытеснения по периоду. Например, планы “Основные начисления”, “Налоги”. Затем на основе планов создаются регистры расчета, содержащие непосредственно записи расчетов.

В отличие от версии 7.7, в версии 8 виды расчета хранятся в планах видов расчета как объекты данных, т.е. могут даже вводиться в режиме “Предприятие”. Конечно, в версии 8 можно ввести предопределенные виды расчета, на которых будет построена конфигурация, и задать для них правила вытеснения, ведущие и базовые виды расчета.

Регистры расчета

Предназначены для хранения записей сложных периодических расчетов, например, регистр расчета “Начисления”. Регистр расчета всегда основан на определенном плане видов расчета.

Измерения, ресурсы и реквизиты регистра расчета разработчик указывает самостоятельно. Например, в регистре расчета могут быть измерения Физлицо, Подразделение, Организация, ресурс Результат, и реквизиты - комментарий, график и т.д.

Бизнес-процессы

Бизнес-процессы в «1С:Предприятии 8» предназначены для объединения отдельных операций в цепочки взаимосвязанных действий, приводящих к достижению конкретной цели. Они дают возможность перейти к процессному управлению деятельностью компании. Все возможные состояния бизнес-процесса и переходы между ними представляются с помощью карты маршрута бизнес-процесса. Карта маршрута описывает логику бизнес-процесса и весь его жизненный цикл от точки старта до точки завершения в виде схематического изображения последовательности прохождения взаимосвязанных точек маршрута.

Приложение 3

Методы сервиса отправки смс - sms4b.

Для реализации рассылок с возможностью отложенной доставки и дополнительного функционала групп применяются следующие методы:

Авторизация, управление сессией

· StartSession - авторизация и открытие новой сессии - получение секретного кода сессии для работы с остальными методами сервиса.

· CloseSession - принудительное завершение сессии.

· ParamSMS - получение параметров аккаунта.

Исходящие SMS

· GroupSMS - отправляет группу сообщений, указывая существующий или запрашивая новый код группы. При этом все sms одной группы сохраняют код группы.

· CheckSMS - проверяет и возвращает статусы для указанных сообщений.

· CancelGroup - требует прекращения отправки - отказ от доставки всех неотправленных сообщений, сохраненных в группе.

· SendSMS - независимо от сессий отправляет одно сообщение. Это альтернативный метод отправки единичного сообщения для простых и малонагруженных приложений.

Входящие SMS

· LoadSMS - возвращает пакет входящих либо целых сообщений, либо фрагментов, с указанного момента времени.

Подробное описание методов SMS4B для клиентского ПО

CancelGroup

int CancelGroup(long SessionId, long Group )

Параметры

Имя	Описание
SessionId	код предварительно открытой сессии
Group	код отменяемой группы

Результат

Число: количество обработанных sms либо отрицательный код ошибки (см. коды ошибок ).

Описание

Включает требование отмены доставки сообщений указанной группы, которые еще не переданы мобильному оператору на доставку.

· Если произошел сбой вызова метода, то возвращается _10.

· Если в SessionID указан не действующий код сессии, то возвращается _2 или _1.

· Если не существует группы с кодом Group, то возвращается _36.

· Если sms в указанной группе не найдено, то возвращается 0.

· В случае без ошибки - возвращается количество обработанных sms.

CheckSMS

CheckSMSResult CheckSMS(long SessionId, string[] Guids)

Параметры

Имя	Описание
SessionId	код предварительно открытой сессии
Guids	массив - список GUID сообщений (см. формат передачи GUID )

Результат

Cтруктура типа CheckSMSResult:

Имя	Тип	Описание
Res ul t	int	количество принятых / обработанных sms либо отрицательный код ошибки (см. коды ошибок ), а в случае ошибки до обработки второго GUID поле List может отсутствовать для экономии трафика
List	CheckSMSList[]	массив - список результатов по каждому сообщению

Описание

Возвращает список с состоянием указанных в массиве Guids сообщений (рекомендуется передавать разумное количество сообщений, например, 100 в одном вызове). .

· Если произошел сбой вызова метода, то возвращается только CheckSMSResult.Result = _10.

· Если в SessionId указан не действующий код сессии, то возвращается только CheckSMSResult.Result = _2 или _1 .

CloseSession

int CloseSession(long SessionID )

Параметры

Имя	Описание
SessionID	код предварительно открытой сессии

Результат

Число: 0 при успешном завершении либо отрицательный код ошибки (см. коды ошибок ).

Описание

Завершает указанную сессию досрочно.

· Если произошел сбой вызова метода, то возвращается _10.

· Если в SessionID указан не действующий код сессии, то возвращается _2 или _1.

· Сессия закрывается сервисом автоматически, если не используется определенное время, например, более 10 минут.

GroupSMS

GroupSMSResult GroupSMS(long SessionId, long Group, string Source, int Encoding, string Body, string Off, string Start , string Period, GroupSMSList[] L ist)

Параметры

Имя	Описание
SessionId	код предварительно открытой сессии
Group	код созданной ранее группы (> 0) либо запрос на создание новой группы (< 0)
Source	номер или символьное имя отправителя (sms-имя)
Encoding	кодировка параметра Body: 0 для GSM 03.38 Character Set (Default Alphabet) либо 1 для алфавита UCS2 (включая кириллицу) (см. формат передачи текста )
Body	* шестнадцатеричная строка, содержащая групповой текст сообщения
Off	* момент прекращения попыток доставки - актуальность sms, указанное время воспринимается с 15 _минутной точностью (см. формат передачи времени )
Start	* момент начала доставки для отложенной рассылки (см. формат передачи времени )
Period	* разрешенный интервал времени доставки (см. суточный период доставки) (см. суточный период доставки )
List	массив - список получателей с персональными параметрами типа GroupSMSList

Каждый получатель представлен структурой типа GroupSMSList :

Имя	Тип	Описание
G	string	GUID, уникальный код сообщения (см. формат передачи GUID )
D	string	Destination, только ISDN _ номер получателя сообщения
B	string	* персональный аналог Body
E	int	* персональный аналог Encoding

Результат

Cтруктура типа GroupSMSResult:

Имя	Тип	Описание
Result	int	количество принятых / обработанных sms либо отрицательный код ошибки (см. коды ошибок ), а в случае ошибки до обработки второго сообщения поле List может отсутствовать для экономии трафика
Group	long	положительный код указанной/созданной группы (независимо от значения Result) либо код ошибки
List	CheckSMSList[]	массив - список результатов по каждому сообщению

Описание

Принимает на отправку список сообщений (пакет, рекомендуется передавать не более 100 сообщений в одном пакете). Переданные на обработку сообщения помещаются в одну группу, указанную параметром Group.

· Если произошел сбой вызова метода, то возвращается GroupSMSResult.Result = _10.

· Если в SessionID указан не действующий код сессии, то возвращается только GroupSMSResult.Result = _1 либо _2.

· Если Group > 0, но не существует такой группы, то возвращается только GroupSMSResult.Result = _36.

· При Group < 0 создается новая группа, причем при Group = _1 создается простая группа, при Group = _2 создается группа с равномерной доставкой; в результате будет выдано GroupSMSResult.Group, равное положительному коду группы либо коду ошибки (_32, _33, _34, _35 связаны с неправильным указанием временн ых параметров Off, Start и Period для новой группы).

· Если при обработке какого-либо одного сообщения произошла ошибка, но есть другие, обработанные успешно, то только в списке GroupSMSResult.List в соответствующей строке в поле R указывается код возникшей ошибки, а поле G содержит GUID сообщения, вызвавшего ее.

· Если не задан хотя бы один персональный текст нового сообщения в полях E и B , то обязательно указываются параметры Encoding и Body , которые и используются в этом случае по_умолчанию.

· Если не принято ни одно sms или ошибка (Result <= 0), GroupSMSResult.List отсутствует для экономии трафика.

LoadSMS

LoadSMSResult LoadSMS(long SessionId, string ChangesFrom, int Flags)

Параметры

Имя	Описание
SessionId	код предварительно открытой сессии
ChangesFrom	момент времени с точностью до миллисекунд, начиная с которого выбираются входящие sms/ сообщения (см. формат передачи времени )
Flags	битовая маска флагов: первый бит указывает на требование выдавать только полные склеенные сообщения, иначе - выдаются только входящие sms (в том числе и части составных сообщений, для склейки на стороне клиента), остальные биты зарезервированы

Результат

Cтруктура типа LoadSMSResult:

Имя	Тип	Описание
Res ul t	int	количество входящих в пакет sms /сообщений либо отрицательный код ошибки (см. коды ошибок ), а в случае (Result <= 0) поле List может отсутствовать для экономии трафика
List	SMSList[]	массив - список пакета входящих sms/сообщений

Каждое sms/сообщение представлено структурой типа SMSList :

Имя	Тип	Описание
G	string	GUID, уникальный код сообщения (см. формат передачи GUID )
D	string	Destination, только ISDN _ номер получателя (из sms-имен)
B	string	Body, шестнадцатеричная строка, содержащая текст сообщения или его фрагмента (см. формат передачи текста )
E	int	Encoding, кодировка поля B (см. формат передачи текста )
A	int	AllPartsCount, количество частей (sms) в сообщении
P	int	PartNumber, номер части (sms) либо 0 для целых сообщений
M	string	Moment, время входа последней части сообщения, не может быть меньше ChangesFrom (см. формат передачи времени )
T	string	Time, время входа первой части сообщения, актуально только для целых сообщений, иначе - пустая строка. Time <= Moment <= ChangesFrom (см. формат передачи времени )
S	string	Source, номер или символьное имя отправителя (абонента)

Описание

Возвращает пакет из N входящих упорядоченных по времени sms (при ( Flags and 1) = 0) либо целых сообщений (при ( Flags and 1) = 1), начиная со времени, указанного в ChangesFrom.

· если произошел сбой вызова метода, то возвращается только LoadSMSResult.Result = _10.

· Если в SessionId указан не действующий код сессии, то возвращается только LoadSMSResult.Result = _1 либо _2.

· если (( Flags and 1) = 0), то возвращаются любые входящие sms в порядке их поступления, иначе - возвращаются только целые сообщения в порядке поступления последних sms-фрагментов, составляющих сообщения.

ParamSMS

ParamSMSResult ParamSMS(long SessionId)

Параметр

Имя	Описание
SessionId	код предварительно открытой сессии

Результат

Cтруктура типа ParamSMSResult, в которой возвращаются следующие поля:

Имя	Тип	Описание
Res ul t	int	положительное число либо отрицательный код ошибки (см. коды ошибок ), а в случае ошибки остальные поля могут отсутствовать.
Rest	money	текущий остаток sms.
Addresses	string	cписок sms _ имен отправителя, разделенных последовательностью "конец строки" (CR LF). Не более 63 имен и номеров.
AddrMask	long	битовая маска для указания позиции номеров, на которые возможно получение входящих sms, в списке Addresses. Нулевое значение означает отсутствие возможности приема sms. Младший бит соответствует первому имени в списке, старший (не считая знака) - 63му. Отрицательное значение указывает на возможность принимать sms, когда позиция номера среди sms _ имен превышает 63.
UTC	string	текущее время UTC (см. формат передачи времени ).
Duration	int	предел длительности полного периода доставки, в часах.
Limit	int	предел для указания окончания доставки, в часах от текущего времени.

Описание

Выдает согласно указанной сессии текущие параметры аккаунта.

· Если произошел сбой вызова метода, то возвращается _10.

· Если в SessionId указан не действующий код сессии, то возвращается только ParamSMSResult.Result = _2 или _1.

SendSMS

String SendSMS (String Login, String Password , String Source, long Phone, String Text)

Параметры

Имя	Описание
Login	логин клиентского аккаунта
Password	пароль для внешних программ (может отличаться от пароля для личного кабинета)
Source	номер или символьное имя отправителя (sms-имя)
Phone	ISDN-номер получателя (число до 15 цифр, может предваряться знаком +)
Text	строка, содержащая текст сообщения (в формате UNICODE)

Результат

Cтрока, в которой возвращается отрицательный код ошибки (см. коды ошибок ) либо GUID сообщения (см. формат передачи GUID ).

Описание

Принимает на отправку одно сообщение. Повторы отправок сообщений не отслеживаются.

· Если произошел сбой вызова метода, то возвращается `_10'.

· Если неверно указаны логин или пароль, то возвращается `_1'.

· Все поля являются обязательными для заполнения.

· Каждая отправка выполняется независимо от получения результата по предыдущим отправкам клиентским ПО.

StartSession

long StartSession(string Login, string Password , int Gmt)

Параметры

Login	логин клиентского аккаунта
Password	пароль для внешних программ (может отличаться от пароля для личного кабинета)
Gmt	число часов (от -12 до 13) или минут (менее -14 или более 14), на которые местное время подключающегося клиента отличается от времени UTC.

Результат

Числовой положительный код новой сессии SessionID либо код ошибки (см. коды ошибок).

Описание

Возвращает положительный код авторизованной сессии для дальнейшей работы с методами сервиса.

· Если произошел сбой вызова метода, то возвращается _10.

· Если аккаунт не аутентифицирован, то возвращается _1.

· Если израсходовано допустимое количество одновременно открытых сессий, то возвращается 0.

· Указав местное смещение Gmt клиент может в этой сессии в методах GroupSMS и LoadSMS задавать и получать дату и время и период доставки в своем местном времени.

Приложение 4

Свойства и методы компоненты ROM-Asterisk.

Свойства:

1 Подключено / Connected - (чтение) состояние подключения к Asterisk

2. Фильтр / Filter - (чтение) обычный строковый фильтр, для поиска вхождения подстроки

3. РегулярноеВыражение / RegEx - (чтение) фильтр, на основе регулярного выражения

4. РежимПрослушивания / Listen - (чтение) режим прослушивания событий Asterisk AMI, 1-включен, 0-нет

5. Версия / Version - (чтение) версия внешней компоненты

Методы:

1. Подключиться / Connect ( <IP>,< Port>) - установить соединение с AMI сервера Asterisk

2. Отключиться / Disconnect() - разорвать соединение с сервером Asterisk

3. ВыполнитьКоманду / SendCommand(<СтрокаКоманды>) - выполнить произвольную команду Asterisk AMI

4. РежимПрослушивания / ListenMode(<Флаг>) - включить/выключить режим прослушивания событий Asterisk AMI, 1-включить, 0-выключить

5. УстановитьФильтр / SetFilter(<СтрокаФильтра>) - установить обычный вхождения подстроки

6. УстановитьРегулярноеВыражение / SetRegEx(<СтрокаФильтра>) - установить фильтр на базе регулярного выражения

Приложение 5

Управление Asterisk через AMI

Для коммуникации между АТС Asterisk и подсоединенным клиентом используется простой текстовый построчный протокол вида: "параметр: значение". Окончание строки определяется последовательностью CRLF.

Особенности работы:

1. Перед отправкой команд серверу Asterisk, необходимо установить manager API сессию.

2. Пакеты могут передаваться в любом направлении в любое время, после прохождения авторизации.

3. Первая строка в пакете должна содержать параметр "Action", если она отправляется от клиента серверу и ,соответственно, "Event" или "Response", когда пакет передается от Asterisk клиенту.

4. Порядок строк в пределах пакета не имеет значения.

5. Последовательность символов CRLF используется для отделения строк друг от друга, а пустая строка (два подряд идущих CRLF) указывает на окончание команды и Asterisk приступает к ее выполнению.

Типы пакетов.

Тип пакета определяется наличием одного из следующих значений параметра в паре “Параметр: значение”:

1. Action: Пакет отправляется подсоединенным клиентом серверу Asterisk, в значении параметра указывается требуемое действие, которое должно быть выполнено сервером Asterisk. Набор действий является ограниченным списком, который доступен клиенту, в зависимости от загруженных модулей сервера Asterisk и прав назначенных пользователю, от имени которого подсоединился клиент. За один раз (в пределах одного пакета) может быть указано только одно действие. Пакет “Action” содержит имя запрашиваемой операции, а также все требуемые параметры команды.

2. Response: Пакет содержащий ответ, отправленный сервером Asterisk, на последнюю команду, которую клиент отправил серверу.

3. Event: Пакет с данными относящимися к какому-либо событию сгенерированному сервером Asterisk или его загруженными модулями.

Типы запросов, которые можно осуществлять через Manager API.

§ AbsoluteTimeout: Установка абсолютно максимального времени для вызова.

§ AgentCallbackLogin: Установка статуса агента как зарегистрированного.

§ AgentLogoff: Установка статуса агента как _не_ зарегистрированного.

§ Agents: Список агентов и их статусы.

§ ChangeMonitor: Изменение имени файла для записи вызова для канала.

§ Command: Выполнение команды.

§ DAHDIDialOffHook?: Набор номера через DAHDI канал, при поднятой трубке.

§ DAHDIDNDoff?: Установка “Do Not Disturb” статуса в OFF. (DAHDI канал)

§ DAHDIDNDon?: Установка “Do Not Disturb” статуса в ON. (DAHDI канал)

§ DAHDIHangup?: Завершение вызова по каналу DAHDI. .

§ DAHDIRestart?: Полный рестарт DAHDI канала (завершение вызова),

§ DAHDIShowChannel? Получение статусов DAHDI каналов.

§ DAHDITransfer?: Перевод вызова (DAHDI канал).

§ DBGet: Получение значений из astDB.

§ DBPut: Вставка данных в astDB.

§ Events: Управление Manager API событиями поступающими в соединение.

§ ExtensionState: Проверка состояние екстеншена.

§ GetVar: Получение значения переменной канала.

§ Hangup: Завершение соединение на заданном канале.

§ IAXpeers: Список IAX пиров.

§ ListCommands: Получение списка доступных команд для Manager API.

§ Logoff: Выход из Manager API.

§ MailboxCount: Получение числа сообщений в голосовом ящике.

§ MailboxStatus: Получение состояния голосового ящика.

§ Monitor: Запись разговора на заданном канале.

§ Originate: Совершение исходящего вызова.

§ ParkedCalls: Список запаркованных вызовов.

§ Ping: В ответ получим “Pong”

§ QueueAdd: Добавление интерфейса в очередь вызовов.

§ QueuePause: Отмечает или снимает отметку временной недоступности участника, обрабатывающего очередь вызовов.

§ QueueRemove: Удаление интерфейса из очереди вызовов.

§ Queues: Список очередей вызовов.

§ QueueStatus: Статус очереди вызова.

§ Redirect: Перенаправление вызова.

§ SetCDRUserField: Установка поля UserField в CDR.

§ SetVar: Установка переменной канала или глобальной переменной.

§ SIPpeers: Список SIP пиров. (текстовый формат).

§ SIPshowPeer: Получение данных SIP пира (текстовый формат).

§ Status: Получение состояний активных каналов.

§ StopMonitor: Останов записи разговора на заданном канале.

§ GetConfig: Получение заданного файла конфигурации.

§ MeetmeMute: Выключение микрофона у участника конференции Meetme.

§ MeetmeUnmute: Включение микрофона у участника конференции Meetme.

§ Park: Парковка вызова.

§ PauseMonitor: Временная приостановка записи вызова.

§ PlayDTMF: Генерация DTMF сигнала на заданном канале.

§ UpdateConfig: Перезапись файла конфигурации.

§ UnpauseMonitor: Возобновление остановленной записи вызова.

§ UserEvent: Отправка пользовательского события в AMI

§ WaitEvent?: Ожидание определенного события.

Более подробно о синтаксисе каждого запроса можно прочесть тут http://voip.rus.net.

Рассмотрим на примере нескольких команд те текстовые пакеты, которые необходимо формировать в 1С для совершения и прерывания звонка.

1) Originate - свершение исходящего вызова.

Параметры команды:

1. Channel: Название канала, с которого совершается исходящий вызов.

2. Context: Название контекста для совершения исходящего вызова.

3. Exten: номер для вызова

4. Priority: Приоритет для соединения

5. Timeout: Таймаут (в миллисекундах) для соединения с инициатором исходящего вызова.

6. CallerID: Значение CallerID, используемое для совершения исходящего вызова.

7. Variable: Установка переменных канала (максимум 32). Переменные будут установлены для обоих каналов, участвующих в соединении.

8. Account: Значение для “Account code” исходящего вызова.

9. Application: Команда плана набора, используемая для совершения исходящего вызова (используется параметр “Data”, для указания ее параметров)

10. Data : Параметры команды плана набора, используемой для совершения исходящего вызова.

11. Async: Если указано “true” исходящий вызов будет производиться асинхронно. Результат ее выполнения будет возвращен позже, в пакете типа “Event”.

12. ActionID: Не обязательный идентификатор запроса. Позволяет сопоставить результат выполнения конкретному запросу.

Пример:

Action: Originate

Channel: SIP/900

Context: default

Exten: 89005678912

Priority: 1

Callerid: User900

Timeout: 30000

В данном примере мы совершили исходящий вызов с 900 внутреннего номера на телефон 89005678912

2) Hangup - команда завершает вызов на указанном канале.

Параметры команды

1. Channel: Канал, на котором необходимо закончить вызов.

2. ActionID: Необязательный ID команды, который будет возвращен в ответе.

Action: Hangup

Channel: SIP/900

Размещено на Allbest.ru