Преобразование OPI -> OInt (workflow)

OInt/core/Modules/OPI_Telegram.os

@@ -228,12 +228,18 @@
 
 // Отправить группу медиафайлов
 // Отправляет набор файлов в чат или канал. Варианты типов медиа: audio, document, photo, video
+// Структура данных медиагруппы
+// {
+//     "ПутьКФайлу": "ТипМедиа",
+//     "ПутьКФайлу": "ТипМедиа",
+//     ...
+// }
 // 
 // Параметры:
 //  Токен      - Строка                - Токен бота                                - token
 //  IDЧата     - Строка,Число          - ID целевого чата или IDЧата*IDТемы        - chat
 //  Текст      - Строка                - Текст сообщения                           - text
-//  СоответствиеФайлов - Соответствие из Строка - Коллекция файлов  - path - JSON - JSON вида { ""Путь"": ""Тип"", ...}:
+//  СоответствиеФайлов - Соответствие из Строка - Коллекция файлов  - path - JSON - JSON файлов или путь к .json:
 //    * Ключ     - ДвоичныеДанные,Строка - Файл 
 //    * Значение - Строка                - Тип файла: audio, document, photo, video
 //  Клавиатура - Строка                - См. СформироватьКлавиатуруПоМассивуКнопок - keyboard - Текст
@@ -336,12 +342,14 @@
 
 // Отправить опрос
 // Отправляет опрос с вариантами ответа
+// Пример строки массива вариантов ответа
+// --options ""['Вар1','Вар2']""
 // 
 // Параметры:
 //  Токен         - Строка                - Токен бота                                 - token
 //  IDЧата        - Строка,Число          - ID целевого чата или IDЧата*IDТемы         - chat
 //  Вопрос        - Строка                - Вопрос опроса                              - question
-//  МассивОтветов - Массив из Строка  - Массив вариантов ответа - options - Массив - Массив вида [""Вар1"",""Вар2"",..]
+//  МассивОтветов - Массив из Строка      - Массив вариантов ответа                    - options    - Массив
 //  Анонимный     - Булево                - Анонимность опроса                         - anonymous
 // 
 // Возвращаемое значение:
@@ -836,9 +844,11 @@
 
 // Сформировать клавиатуру по массиву кнопок
 // Формирует простую JSON клавиатуру из массив кнопок для сообщения или нижней панели
+// Пример строки массива кнопок:
+// --buttons ""['Кнопка1','Кнопка2']""
 // 
 // Параметры:
-//  МассивКнопок  - Массив из Строка - Массив кнопок - buttons - Массив - Массив вида [""Кнопка1"",""Кнопка2"",..]
+//  МассивКнопок  - Массив из Строка - Массив кнопок                                        - buttons - Массив 
 //  ПодСообщением - Булево           - Клавиатура под сообщением или на нижней панели       - under
 //  ОднаПодОдной  - Булево           - Истина > кнопки выводятся в столбик, Ложь > в строку - column
 // 

OInt/core/Modules/OPI_VK.os

@@ -39,14 +39,15 @@
 
 #Область ПолучениеТокена
 
+// Создать ссылку получения токена
 // Получение ссылки для интерактивного получения токена (access_token), который необходим
 // для дальнейших действий
 // 
 // Параметры:
-//  app_id - Строка,Число - app_id из настроек приложения
+//  app_id - Строка,Число - app_id из настроек приложения - app
 // 
 // Возвращаемое значение:
-// Строка - URL, по которому необходимо перейти в браузере 
+//  Строка - URL, по которому необходимо перейти в браузере 
 Функция СоздатьСсылкуПолученияТокена(Знач App_id) Экспорт
     
     // access_token нужно будет забрать из параметра в строке адреса браузера
@@ -60,17 +61,30 @@
 
 #Область РаботаСГруппой
 
-// Создать пост.
+// Создать пост
+// Создает пост с картинками
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
+// 
+// Пример строки массива картинок:
+// --pictures ""['C:\Картинка1.png', 'https:\\exemple.com\Картинка2.png']""
 // 
 // Параметры:
-//  Текст - Строка - Текст
+//  Текст              - Строка                          - Текст поста                           - text
-//  МассивКартинок - Массив из Строка,ДвоичныеДанные - Массив картинок
+//  МассивКартинок     - Массив из Строка,ДвоичныеДанные - Массив картинок                       - pictures - Массив  
-//  Рекламный - Булево -  Признак "Это реклама"
+//  Рекламный          - Булево                          - Признак ""Это реклама"" (Ложь по ум.) - ad
-//  СсылкаПодЗаписью - Строка -  Ссылка под записью, если нужна
+//  СсылкаПодЗаписью   - Строка                          - Ссылка (URL) под записью (необяз.)    - url
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры  - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СоздатьПост(Знач Текст
     , Знач МассивКартинок
     , Знач Рекламный = Ложь
@@ -116,14 +130,26 @@
     
 КонецФункции
 
-// Удалить пост.
+// Удалить пост
+// Удаляет пост по id
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
+// Пример строки массива картинок:
+// --options ""['Вариант1', 'Вариант2']""
 // 
 // Параметры:
-//  IDПоста - Строка,Число - ID поста
+//  IDПоста    - Строка,Число - ID поста - post
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры  - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция УдалитьПост(Знач IDПоста, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);    
@@ -135,16 +161,26 @@
     
 КонецФункции
 
-// Создать опрос.
+// Создать опрос
+// Создает опрос с вариантами ответа
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  Вопрос - Строка - Вопрос опроса
+//  Вопрос        - Строка                - Вопрос опроса              - question
-//  МассивОтветов - Массив из Строка - Массив вариантов ответа
+//  МассивОтветов - Массив из Строка      - Массив вариантов ответа    - options  - Массив
-//  Картинка - Строка,ДвоичныеДанные -  Картинка опроса
+//  Картинка      - Строка,ДвоичныеДанные - Картинка опроса            - path
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры  - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СоздатьОпрос(Знач Вопрос, Знач МассивОтветов, Знач Картинка = "", Знач Параметры = "") Экспорт
     
     Параметры_    = ПолучитьСтандартныеПараметры(Параметры);
@@ -219,15 +255,26 @@
     
 КонецФункции
 
-// Создать альбом.
+// Создать альбом
+// Создает альбом для хранения картинок
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  Наименование - Строка - Наименование альбома
+//  Наименование - Строка - Наименование альбома - name
-//  Описание - Строка -  Описание альбома
+//  Описание     - Строка - Описание альбома     - description
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СоздатьАльбом(Знач Наименование, Знач Описание = "", Знач Параметры = "") Экспорт
     
     Параметры_ = ПолучитьСтандартныеПараметры(Параметры);
@@ -242,14 +289,25 @@
     
 КонецФункции
 
-// Удалить альбом.
+// Удалить альбом
+// Удаляет ранее созданный альбом
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDАльбома - Строка,Число - ID альбома
+//  IDАльбома - Строка,Число        - ID альбома - album
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция УдалитьАльбом(Знач IDАльбома, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);    
@@ -261,15 +319,26 @@
     
 КонецФункции
 
-// Создать историю.
+// Создать историю
+// Создает историю из картинки
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  Картинка - Строка,ДвоичныеДанные - Фон истории
+//  Картинка     - Строка,ДвоичныеДанные - Фон истории                           - path
-//  URL - Строка -  URL для кнопки под историей
+//  URL          - Строка                - URL для кнопки под историей (необяз.) - url
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СоздатьИсторию(Знач Картинка, Знач URL = "", Знач Параметры = "") Экспорт
         
     Параметры_ = ПолучитьСтандартныеПараметры(Параметры);
@@ -282,16 +351,27 @@
     
 КонецФункции
 
-// Сохранить картинку в альбом.
+// Сохранить картинку в альбом
+// Сохраняет картинку в альбом сообщества
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDАльбома - Строка,Число - ID альбома
+//  IDАльбома - Строка,Число          - ID альбома        - album                           
-//  Картинка - ДвоичныеДанные,Строка - Двоичные данные или путь к картинке
+//  Картинка  - ДвоичныеДанные,Строка - Файл картинки     - path
-//  Описание - Строка -  Описание картинки
+//  Описание  - Строка                - Описание картинки - description
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СохранитьКартинкуВАльбом(Знач IDАльбома, Знач Картинка, Знач Описание = "", Знач Параметры = "") Экспорт
     
     Параметры_      = ПолучитьСтандартныеПараметры(Параметры);
@@ -303,14 +383,25 @@
     
 КонецФункции
 
-// Удалить картинку.
+// Удалить картинку
+// Удалить картинку из альбома
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDКартинки - Строка,Число - ID картинки
+//  IDКартинки - Строка,Число       - ID картинки - picture 
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция УдалитьКартинку(Знач IDКартинки, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);
@@ -326,15 +417,26 @@
 
 #Область РаботаСОбсуждениями
 
-// Создать обсуждение.
+// Создать обсуждение
+// Создает новое обсуждение
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  Наименование - Строка - Наименование обсуждения
+//  Наименование          - Строка  - Наименование обсуждения - name
-//  ТекстПервогоСообщения - Строка - Текст первого сообщения
+//  ТекстПервогоСообщения - Строка  - Текст первого сообщения - message
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СоздатьОбсуждение(Знач Наименование, Знач ТекстПервогоСообщения, Знач Параметры = "") Экспорт
     
     Параметры_ = ПолучитьСтандартныеПараметры(Параметры);
@@ -347,15 +449,26 @@
     
 КонецФункции
 
-// Закрыть обсуждение.
+// Закрыть обсуждение
+// Закрывает или удаляет обсуждение
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDОбсуждения - Строка,Число - ID обсуждения
+//  IDОбсуждения     - Строка,Число - ID обсуждения                                          - topic
-//  УдалитьПолностью - Булево -  Удалить полностью или закрыть (сделать неактивным)
+//  УдалитьПолностью - Булево       -  Удалить полностью (Истина) или закрыть (Ложь, по ум.) - remove
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Закрыть обсуждение
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция ЗакрытьОбсуждение(Знач IDОбсуждения, Знач УдалитьПолностью = Ложь, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);
@@ -368,14 +481,25 @@
 
 КонецФункции
 
-// Открыть обсуждение.
+// Открыть обсуждение
+// Открывает ранее закрытое обсуждение
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDОбсуждения - Строка,Число - ID обсуждения
+//  IDОбсуждения - Строка,Число - ID обсуждения - topic
-//  Параметры - Структура из Строка -  См. ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция ОткрытьОбсуждение(Знач IDОбсуждения, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);
@@ -387,15 +511,26 @@
 
 КонецФункции
 
-// Написать в обсуждение.
+// Написать в обсуждение
+// Добавляет сообщение в обсуждение от имени группы
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDОбсуждения - Строка,Число - ID обсуждения
+//  IDОбсуждения - Строка,Число - ID обсуждения   - topic
-//  Текст - Строка - Текст сообщения
+//  Текст        - Строка       - Текст сообщения - message
-//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция НаписатьВОбсуждение(Знач IDОбсуждения, Знач Текст, Знач Параметры = "") Экспорт
     
     Параметры_  = ПолучитьСтандартныеПараметры(Параметры);
@@ -412,15 +547,26 @@
 
 #Область ИнтерактивныеДействия
 
-// Поставить лайк.
+// Поставить лайк
+// Ставит лайк на пост
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDПоста - Строка,Число - ID поста
+//  IDПоста   - Строка,Число - ID поста                    - post
-//  IDСтены - Строка,Число -  ID стены расположения поста
+//  IDСтены   - Строка,Число - ID стены расположения поста - wall
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция ПоставитьЛайк(Знач IDПоста, Знач IDСтены = "", Знач Параметры = "") Экспорт
     
     Параметры_      = ПолучитьСтандартныеПараметры(Параметры);
@@ -439,17 +585,28 @@
 
 КонецФункции
 
-// Сделать репост.
+// Сделать репост
+// Делает репост записи
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDПоста - Строка,Число - ID поста
+//  IDПоста      - Строка,Число - ID поста                      - post
-//  IDСтены - Строка,Число -  ID стены расположения поста
+//  IDСтены      - Строка,Число -  ID стены расположения поста  - from
-//  ЦелеваяСтена - Строка,Число -  ID целевой стены/группы
+//  ЦелеваяСтена - Строка,Число -  ID целевой стены/группы      - to
-//  Рекламный - Булево -  Признак рекламного поста
+//  Рекламный    - Булево -  Признак рекламного поста           - ad
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция СделатьРепост(Знач IDПоста
     , Знач IDСтены = ""
     , Знач ЦелеваяСтена = ""
@@ -476,17 +633,28 @@
 
 КонецФункции
 
-// Написать сообщение.
+// Написать сообщение
+// Написать сообщение пользователю в диалоге сообщества
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  Текст - Строка - Текст сообщения
+//  Текст          - Строка - Текст сообщения                                                 - message
-//  IDПользователя - Строка - ID пользователя-адресата
+//  IDПользователя - Строка - ID пользователя-адресата                                        - user
-//  Communitytoken - Строка - Токен бота чата сообщества, котрый можно получить в настройках
+//  Communitytoken - Строка - Токен бота чата сообщества, котрый можно получить в настройках  - ct
-//  Клавиатура - Строка - JSON клавиатуры. См.СформироватьКлавиатуру
+//  Клавиатура     - Строка - JSON клавиатуры. См.СформироватьКлавиатуру                      - keyboard
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция НаписатьСообщение(Знач Текст
     , Знач IDПользователя
     , Знач Communitytoken
@@ -512,16 +680,27 @@
 
 КонецФункции
 
-// Написать комментарий.
+// Написать комментарий
+// Создает комментарий под выбранной записью
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  IDПоста - Строка,Число - ID целевого поста
+//  IDПоста   - Строка,Число - ID целевого поста            - post
-//  IDСтены - Строка,Число -  ID стены расположения поста
+//  IDСтены   - Строка,Число -  ID стены расположения поста - wall
-//  Текст - Строка - Текст комментария
+//  Текст     - Строка       - Текст комментария            - text
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция НаписатьКомментарий(Знач IDПоста, Знач IDСтены, Знач Текст, Знач Параметры = "") Экспорт
     
     Параметры_ = ПолучитьСтандартныеПараметры(Параметры);
@@ -539,11 +718,22 @@
 
 КонецФункции
 
-// Сократить ссылку.
+// Сократить ссылку
+// Создает сокращенный URL из обычного
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  URL - Строка - URL для сокращения
+//  URL       - Строка - URL для сокращения - url
-//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
 // Строка - Сокращенный URL 
@@ -564,15 +754,26 @@
 
 #Область Статистика
 
-// Получить статистику.
+// Получить статистику
+// Получает общую статистику сообщества за период
+// 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
 // 
 // Параметры:
-//  ДатаНачала - Дата - Дата начала периода
+//  ДатаНачала    - Дата - Дата начала периода    - datefrom
-//  ДатаОкончания - Дата - Дата окончания периода
+//  ДатаОкончания - Дата - Дата окончания периода - dateto
-//  Параметры - Структура из Строка -  Параметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
-//  ДвоичныеДанные, Неопределено, Произвольный -  Ответ сервера ВК
+//  Соответствие Из КлючИЗначение - сериализованный JSON ответа от VK
 Функция ПолучитьСтатистику(Знач ДатаНачала, Знач ДатаОкончания, Знач Параметры = "") Экспорт
     
     Параметры_         = ПолучитьСтандартныеПараметры(Параметры);
@@ -590,11 +791,24 @@
     
 КонецФункции
 
-// Получить статистику постов.
+// Получить статистику по постам
+// Получает статистику в разрезе постов
 // 
+// Структура данных авторизации:
+// {
+//      "access_token": "",
+//      "from_group"  : "1",
+//      "owner_id"    : "",
+//      "v"           : "5.131",
+//      "app_id"      : "",
+//      "group_id"    : ""
+// }
+// 
+// Пример строки массива постов:
+// --posts ""['1111111','2222222']""
 // Параметры:
-//  МассивИДПостов - Массив из Строка,Число - Массив ID постов
+//  МассивИДПостов - Массив из Строка,Число - Массив ID постов - posts - Массив
-//  Параметры - Структура из Строка -  См.ПолучитьСтандартныеПараметры
+//  Параметры - Структура из Строка - См.ПолучитьСтандартныеПараметры - auth - JSON - JSON авторизации или путь к .json
 // 
 // Возвращаемое значение:
 //  Массив из Произвольный -  Массив данных статистики по постам