Библиотека процедур и функций для технологической платформы <1С Предприятие 7.7>.
На текущий момент платформа <1С Предприятие 7.7>, конечно, уже потеряла актуальность. Но конфигурации, разработанные на ней, все же продолжают эксплуатироваться. В текущем году выполнял работы по разработки модуля для конфигурации на платформе <1С Предприятие 7.7> для взаимодействия с корпоративным Http-сервисом. Пришлось вспомнить дела давно минувших дней, в частности, обновить свою библиотеку. В библиотеку собраны различные функции по работе с документами, журналами, типами данных, строками, датой и временем, таблицами значений, Excel, файлами, XML, JSON, Http-сервисами, SMTP серверами и т.п.
Делюсь данной библиотекой как есть. Обсуждать, хорошо ли, плохо ли, сделана реализация процедур и функций - не буду. Если у кого-то возникнут вопросы по использованию, можете писать в комментариях к статье. По возможности отвечу.
В самой статье - перечень процедур и функций входящих в библиотеку с описанием непосредственно из кода реализации. Сама библиотека в прилагаемом архиве. Библиотека применялась на релизе платформы 7.70.027.
Перечень процедур и функций библиотеки <LIB_POMOGATOR_1C77> для технологической платформы <1С Предприятие 7.7>:
| № | Краткое описание |
|---|---|
| Специальные | |
| 1 |
// Функция возвращает строку с типом заданного значения |
| 2 | // Процедура открывает журнал документов и делает текущей строку с заданным документом. // Если документ является новым, то выдается информационное сообщение. // КонтекстДок - контекст документа для поиска. Процедура глОткрытьЖурналИНайти(КонтекстДокИЛИДок) |
| 3 | // Процедура производит удаление докумета физически. // Т.е. восстановить удаленный документ будет невозможно. Процедура глУдалитьДокНавсегдаБезВопросов(ДокНаУдаление) |
| 4 | // Функция определяет имеются ли ссылки на заданный объект. Функция ЕстьСсылкиНаОбъект(Объект, НеУчитыватьОбъект) |
| 5 | // Функция возвращает список значений содержащий виды документов с общим нумератором. // ТекВидДок - строка вида документа по нумератору которого нужно получить результат. Функция глПолучитьВидыДокСОбщимНумератором(ТекВидДок) |
| 6 | // Функция возвращает список значений содержащий виды документов заданного журнала документов. // ИдентификаторЖурналаДок - Строка содержащая идентификатор журнала документов как он задан в конфигураторе. Функция глПолучитьВидыДокЖурналаДокументов(ИдентификаторЖурналаДок) |
| 7 | // Функция возвращает список значений содержащую найденные документы. // НачПериода - Дата начала периода поиска документов. // КонПериода - Дата окончания периода поиска документов. // ВидыДокументов - Список значений содержащий виды документов среди которых необходимо осуществлять поиск. // Если данный параметр оставить пустым, то поиск будет осуществлен среди всех основных видов документов. // стрНомерДок - собственно сама строка поиска номера документа. Функция глНайтиДокументыПоНомеру(НачПериода, КонПериода, ВидыДокументов, стрНомерДок) |
| 8 | // Функция возвращает 1 - если номер указанного документа уже используется, 0 - номер свободен. // Функцию можно использовать для предварительной проверки номера документа до записи Функция глНомерДокУжеИспользуется(ТекДокумент, ВыводитьСообщение = 0) |
| 9 | // В отличии от функции "ТипЗначенияСтр" возвращает также тип псевдо объекта. // Тип возвращается в виде строки содержащей значение типа. Функция глТипЗначенияСтр(ЛюбоеЗначение) |
| 10 | // Функция возвращет внутренний ИД объекта в виде строки. Функция ПолучитьИДОбъекта(Объект) |
| 11 | // Это значение типа: "Число", "Строка", "Дата" Функция глЭтоЗначениеПримитивногоТипа(Значение) |
| 12 | // Это значение типа: "Справочник", "Документ", "Перечисление", "Счет", "ПланСчетов", "Календарь", "ВидРасчета", "ВидСубконто". Функция глЭтоЗначениеСсылка(Значение) |
| 13 | // Если проверяемое значение это объект "<Объект не найден>", то функция возвращает значение 1. // 0 - в противном случае. Функция глЭтоЗначениеОбъектНеНайден(Значение) |
| 14 | Функция глЭтоЗначениеКоллекция(Значение) |
| 15 | Функция глЭтоЗначениеФиксированнаяКоллекция(Значение) |
| 16 | // Функция возвращет внутренний ИД объекта в виде строки. Дополнительно производится проверка // что передано значение типа: "Справочник", "Документ", "Перечисление", "Счет", "ПланСчетов", "Календарь", "ВидРасчета", "ВидСубконто". // Если передано значение любого другого типа, то функция возвращает пустое значение. Функция глПолучитьИДЗначения(Значение) |
| 17 | // ДанныеРезультат - список значений в который добавляются взаимосвязанные данные // Значение - значение ссылочного типа взаимосвязанные данные по которому нужно получить Процедура глПолучитьСвязанныеДанныеДляЗначения(ДанныеРезультат, Значение) |
| 18 | // Функция возвращет строку "DBF" если информационная база работает с DBF. // Функция возвращет строку "SQL" если информационная база работает с SQL. Функция глПолучитьВидИнформационнойБазы() |
| 19 | // Функция возвращает число 1 - если информационная база работает с DBF, 0 - в противном случае. Функция глЭтоИнформационнаяБазаDbf() |
| 20 | // Функция возвращает число 1 - если информационная база работает с SQL, 0 - в противном случае. Функция глЭтоИнформационнаяБазаSQL() |
| 21 | // Функция возвращает строку с расширением заданного имени файла Функция ПолучитьРасширениеИмениФайла(ИмяФайла) |
| 22 | // Функция возвращает строку с именем файла без пути к нему Функция ПолучитьИмяФайла(ИмяФайла) |
| 23 | // Функция возвращает строку заданного имени файла без расширения Функция ПолучитьИмяФайлаБезРасширения(ИмяФайла) |
| 24 | // Функция возвращает строку заданного имени файла с новым расширением Функция ИзменитьРасширениеИмениФайла(ИмяФайла, Расширение) |
| 25 | // Процедура открывает форму заданного элемента справочника для просмотра Процедура глОткрытьЭлементСпрДляПросмотра(ТекЭлемент) |
| 26 | // Можно использовать там где не допустимо использование оператора присвоения. // Например можно использовать в шаблонах отчетов. Функция ПрисвоитьЗначение(ПеремПриемник, ПеремИсточник) |
| 27 | // Данную процедуру нужно вызывать в модуле формы обработки ("ПриОткрытии") для подключения механизма внешнего вызова // процедур и функций находящихся в модуле. Процедура ВыполнитьВнешнийВызовПроцедурыИлиФункцииТекущегоМодуля(КонтекстФормы, НеОткрыватьОкноФормы = 1) |
| 28 | // Для использования данного функционала эту функцию нужно скопировать в глобальный модуль или модуль где она предполагается использоваться. // ИмяОбработки - имя обработки как оно задано в конфигураторе или имя файла внешней обработки без расширения. // Если обработка внешняя то она должна находится в каталоге пользователя или каталоге информационной базы. // ИмяФункции - имя вызываемой функции // Значение1, Значение2 и т.д - параметры вызываемой функции. Функция глВыполнитьФункцию(ИмяОбработки, ИмяФункции, Значение1="Неопределено", Значение2="Неопределено", Значение3="Неопределено", Значение4="Неопределено", Значение5="Неопределено", Значение6="Неопределено", Значение7="Неопределено", Значение8="Неопределено", Значение9="Неопределено", Значение10="Неопределено", Значение11="Неопределено", Значение12="Неопределено", Значение13="Неопределено", Значение14="Неопределено", Значение15="Неопределено", Значение16="Неопределено") |
| 29 | // Для использования данного функционала эту процедуру нужно скопировать в глобальный модуль или модуль где она предполагается использоваться. // ИмяОбработки - имя обработки как оно задано в конфигураторе или имя файла внешней обработки без расширения. // Если обработка внешняя то она должна находится в каталоге пользователя или каталоге информационной базы. // ИмяПроцедуры - имя вызываемой процедуры // Значение1, Значение2 и т.д - параметры вызываемой функции. Процедура глВыполнитьПроцедуру(ИмяОбработки, ИмяПроцедуры, Значение1="Неопределено", Значение2="Неопределено", Значение3="Неопределено", Значение4="Неопределено", Значение5="Неопределено", Значение6="Неопределено", Значение7="Неопределено", Значение8="Неопределено", Значение9="Неопределено", Значение10="Неопределено", Значение11="Неопределено", Значение12="Неопределено", Значение13="Неопределено", Значение14="Неопределено", Значение15="Неопределено", Значение16="Неопределено") |
| 30 | Функция глИспользоватьПодключаемыйМодуль(ИмяМодуля) |
| 31 | Функция глПолучитьИмяПодключаемогоМодуля() |
| 32 | Функция Модуль(ИмяМодуля = "") |
| 33 | Функция Ф(ИмяФункции, Значение1="Неопределено", Значение2="Неопределено", Значение3="Неопределено", Значение4="Неопределено", Значение5="Неопределено", Значение6="Неопределено", Значение7="Неопределено", Значение8="Неопределено", Значение9="Неопределено", Значение10="Неопределено", Значение11="Неопределено", Значение12="Неопределено", Значение13="Неопределено", Значение14="Неопределено", Значение15="Неопределено", Значение16="Неопределено") |
| 34 | Процедура П(ИмяПроцедуры, Значение1="Неопределено", Значение2="Неопределено", Значение3="Неопределено", Значение4="Неопределено", Значение5="Неопределено", Значение6="Неопределено", Значение7="Неопределено", Значение8="Неопределено", Значение9="Неопределено", Значение10="Неопределено", Значение11="Неопределено", Значение12="Неопределено", Значение13="Неопределено", Значение14="Неопределено", Значение15="Неопределено", Значение16="Неопределено") |
| Работа с датой и временем | |
| 35 | // Функция возвращает количество дней пересечения заданного периода с шаблонным периодом. // Если есть дни пересечения, то заданный период обрезается по шаблонному периоду. // ДатаНШаблон, ДатаКШаблон - шаблонный период. // ДатаНДляПроверки, ДатаКДляПроверки - период для проверки. Функция глПолучитьДниПересечения(ДатаНШаблон, ДатаКШаблон, ДатаНДляПроверки, ДатаКДляПроверки) |
| 36 | // Функция переводит время заданное в виде числа (часы.минуты) в десятичное число Функция глВремяВЧисло(Время) |
| 37 | // Функция переводит время заданное в виде десятичного числа в число представляющее собой время (часы.минуты) Функция глЧислоВоВремя(ВремяВВидеЧисла) |
| 38 | // Функция возвращает количество времени в виде (часы.минуты) между двумя значениями времени заданными в виде (часы.минуты) // Если Время окончания(ВремяКон) < Времени начала(ВремяНач), то считается что время окончания находится в следующем дне. // Соответственно в этом случае расчет производится из предположения что время окончания расположено в следующем дне // относительно времени начала. Если Время окончания(ВремяКон) >= Времени начала(ВремяНач), то считаем что оба времени // находятся в нутри одного дня. Функция глРазностьВремениСледующийДень(ВремяНач, ВремяКон) |
| 39 | // Функция возвращает количество времени в виде (часы.минуты) между двумя значениями времени заданными в виде (часы.минуты) // Если Время окончания(ВремяКон) < Времени начала(ВремяНач), то возвращается 0, т.е. время начала и окончания должны быть в пределах одного дня. Функция глРазностьВремени(ВремяНач, ВремяКон) |
| 40 | // Функция возвращает количество времени в виде (часы.минуты) представляющее собой сумму двух значений времени заданных в виде (часы.минуты) Функция глСуммаВремени(Время1, Время2) |
| 41 | // Функция возвращает заданные дату и время в виде строки формата ISO8601 // <ТекДата> (обязательный). Тип: Дата. // Дата которую необходимо преобразовать в строку формата ISO8601. // <ТекЧасМинКакЧисло> (обязательный). Тип: Число. // Время заданное в виде числа. Где целая часть числа это часы, а часть числа после запятой это минуты. // <Возвращаемое значение> Тип: Строка. // Функция возвращает заданные дату и время в виде строки формата ISO8601. // Проверка переданных параметров на допустимые типы не производится. Функция ДатаВремяISO8601(ТекДата, ТекЧасМинКакЧисло) |
| 42 | // Функция возвращает строку текущей даты и времени в формате <День.Месяц.Год Часы:Минуты:Секунды>. Функция СтрокаТекущаяДатаВремя() |
| 43 | // Функция возвращает строку текущего времени в формате <Часы:Минуты:Секунды>. Функция СтрокаТекущееВремя() |
| 44 | // Возвращает текущее время в секундах Функция ТекущееВремяВСекундах() |
| 45 | // Возвращает время в секундах заданное в виде строки формата <Часы:Минуты:Секунды>. Функция ВремяВСекундахИзСтроки(СтрокаВремя) |
| 46 | // Функция возвращает разницу времени в секундах между началом и окончанием заданными в виде дат и времени. Функция ПрошлоСекунд(ДатаНач, ВремяНачВСекундах, ДатаКон, ВремяКонВСекундах) |
| 47 | Процедура Ожидать(Сек) |
| Строковые | |
| 48 | // Функция разбивает заданную строку на подстроки разделенные строкой сепаратором // и возвращает список значений содержащий выделенные подстроки Функция глРазбитьСтроку(СтрокаДляРазбиения, СтрСепаратор) |
| 49 | // Функция производит поиск и замену латинских букв на русские которые выглядят одинаково. Функция глЗаменитьЛатНаРус(ТекСтрока) |
| 50 | // Функция возвращает число 1 - если переданный в качестве параметра символ является цифрой, 0 - в противном случае. Функция глЭтотСимволЦифра(Символ) |
| 51 | // Функция возвращает число 1 - если переданная в качестве параметра строка является цифрой, 0 - в противном случае. Функция глЭтоЧисло(СтрДляПроверки) |
| 52 | // Функция возвращает позицию первого слева вхождения в строку поиска заданной подстроки. // Функция производит проверку переданных параметров на допустимый тип. Тип параметров должен // быть "строка". Если переданные параметры других типов, то функция вернет пустое значение. Функция НайтиПодстрокуЛев(СтрокаВКоторойИщем, ПодстрокаПоиска) |
| 53 | // Функция возвращает позицию первого справа вхождения в строку поиска заданной подстроки. // Функция производит проверку переданных параметров на допустимый тип. Тип параметров должен // быть "строка". Если переданные параметры других типов, то функция вернет пустое значение. Функция НайтиПодстрокуПрав(СтрокаВКоторойИщем, ПодстрокаПоиска) |
| 54 | // Функция дополняет заданную строку слева до требуемой длины заданной подстрокой и // возвращает данную строку в виде результата. Функция ДобавитьСлева(Стр1, Длн, Стр2) |
| 55 | // Функция дополняет заданную строку справа до требуемой длины заданной подстрокой и // возвращает данную строку в виде результата. Функция ДобавитьСправа(Стр1, Длн, Стр2) |
| 56 | // Дополняет передаваемую строку Стр символами Чем до строки длиной Длина слева. Функция глДополнитьСтрокуЛ(Стр,Чем,Длина) |
| 57 | // //infostart.ru/public/18816/?ysclid=lfwf7hzw24613684373 Функция ПреобразоватьСтрокуВУТФ8(Стр) |
| 58 | // //infostart.ru/public/18816/?ysclid=lfwf7hzw24613684373 Функция ПреобразоватьСтрокуИзУТФ8(Стр) |
| Работа с распределенными информационными базами (РБД) | |
| 59 | // Функция возвращает 1 - если текущая информационная база является распределенной информационной базой, 0 - в противном случае. Функция глЭтоРБД() |
| 60 | // Функция возвращает префикс информационной базы Функция глПолучитьПрефиксИБ() |
| Псевдо объект: "ОписаниеКлюча" | |
| 61 | Функция глСоздатьОписаниеКлюча(ИменаЗначений = "") |
| 62 | Функция глОчиститьОписаниеКлюча(ОписаниеКлюча) |
| 63 | Функция глПолучитьКоличествоЭлементовОписанияКлюча(ОписаниеКлюча) |
| 64 | Функция глПолучитьЭлементОписанияКлюча(ОписаниеКлюча, НомерЭлемента) |
| Псевдо объект: "Ключ" | |
| 65 | // Функция создает псевдо объект "Ключ" и возвращает его в качестве результата работы функции // Параметры: // Нет параметров. // Возвращаемое значение: // Псевдо объект "Ключ". Функция глСоздатьКлюч() |
| 66 | // Функция производит удаление внутренней информации о ключе заданного псевдо объекта "Ключ". // Параметры: // Ключ - псевдо объект "Ключ". // Возвращаемое значение: // псевдо объект "Ключ" заданный как параметр. Функция глОчиститьКлюч(Ключ) |
| 67 | Функция глОбновитьКлюч(Ключ) |
| 68 | Функция глУстановитьЗначениеКлюча(Ключ, ИмяЗначения, Значение, ОбновитьКлюч = 1) |
| 69 | Функция глПолучитьИменаЗначенийКлюча(Ключ) |
| 70 | Функция глУстановитьЗначенияКлюча(Ключ, ИменаЗначений, Значение1="", Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| 71 | Функция глСоздатьКлючПоЗначениям(ИменаЗначений, Значение1="", Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| 72 | Функция глПолучитьКоличествоЗначенийКлюча(Ключ) |
| 73 | Функция глПолучитьЗначениеКлюча(Ключ, НомерИлиИмяЗначения) |
| 74 | Функция глПолучитьКлючКакСтроку(Ключ) |
| 75 | Функция глКлючиРавны(Ключ1, Ключ2) |
| Псевдо объект: "КоллекцияКлючей" | |
| 76 | Функция глСоздатьКоллекциюКлючей() |
| 77 | Функция глДобавитьКлючВКоллекцию(КоллекцияКлючей, ИмяКлюча, Ключ) |
| 78 | Функция глУдалитьКлючИзКоллекции(КоллекцияКлючей, ИмяКлюча) |
| 79 | Функция глКоличествоКлючейВКоллекции(КоллекцияКлючей) |
| 80 | Функция глПолучитьКлючИзКоллекции(КоллекцияКлючей, НомерИлиИмяКлюча) |
| 81 | Функция глОчиститьКоллекциюКлючей(КоллекцияКлючей) |
| Псевдо объект: "КоллекцияОписанияКлючей" | |
| 82 | Функция глСоздатьКоллекциюОписанияКлючей() |
| 83 | Функция глДобавитьОписаниеКлючаВКоллекцию(КоллекцияОписанияКлючей, ИмяКлюча, ОписаниеКлюча) |
| 84 | Функция глУдалитьОписаниеКлючаИзКоллекции(КоллекцияОписанияКлючей, ИмяКлюча) |
| 85 | Функция глКоличествоОписанияКлючейВКоллекции(КоллекцияОписанияКлючей) |
| 86 | Функция глПолучитьОписаниеКлючаИзКоллекции(КоллекцияОписанияКлючей, НомерИлиИмяКлюча) |
| 87 | Функция глОчиститьКоллекциюОписанияКлючей(КоллекцияОписанияКлючей) |
| Псевдо объект: "СтрокаТаблицыЗначений" | |
| 88 | Функция глСоздатьСтрокуТаблицыЗначений(ДляТаблицыЗначений) |
| 89 | Функция глПолучитьТаблицуЗначенийИзСтрокиТаблицыЗначений(СтрокаТаблицыЗначений) |
| 90 | Функция глПолучитьКоллекциюКлючейИзСтрокиТаблицыЗначений(СтрокаТаблицыЗначений) |
| Процедуры и функции для работы с таблицей значений | |
| 91 | // Функция возвращает номер колонки по её идентификатору. Если колонка с заданным идентификатором // в заданной таблице значений отсутствует, то функция возвращает 0. // Параметры: // ТаблицаЗначенийИсточник - таблица значений // ИдентификаторКолонки - строка идентификатора колонки // Возвращаемое значение: // целое число предсталяющее собой номер найденной колонки по идентификатору. 0 - если колонка не найдена. Функция глПолучитьНомерКолонкиВТаблицеЗначений(ТаблицаЗначенийИсточник, ИдентификаторКолонки) |
| 92 | // Функция возвращает идентификатор колонки по её номеру. Если колонка с заданным номером // в заданной таблице значений отсутствует, то функция возвращает пустую строку. // Параметры: // ТаблицаЗначенийИсточник - таблица значений // НомерКолонки - номер колонки // Возвращаемое значение: // Строка содержащая идентификатор колонки Функция глПолучитьИдентификаторКолонкиВТаблицеЗначений(ТаблицаЗначенийИсточник, НомерКолонки) |
| 93 | // Функция определяет имеется ли в заданной таблице значений колонка с заданным идентификатором // Параметры: // ТаблицаЗначенийИсточник - таблица значений // ИдентификаторКолонки - строка идентификатора колонки // Возвращаемое значение: // 1 - есть колонка с заданным идентификаторам; 0 - колонка с заданным идентификаторам не найдена. Функция глЕстьКолонкаВТаблицеЗначений(ТаблицаЗначенийИсточник, ИдентификаторКолонки) |
| 94 | // Функция возвращает идентификаторы колонок таблицы значений как строку с разделителями. Можно задать строку идентификаторов колонок // которые необходимо исключить из результата. // ТаблицаЗначенийИсточник - таблица значений // ИсключатьИдентификаторыКолонки - строка с именами колонок через запятую, которые нужно исключить из результата. Функция глПолучитьИдентификаторыКолонокТаблицыЗначенийКакСтроку(ТаблицаЗначенийИсточник, ИсключатьИдентификаторыКолонок) |
| 95 | // Функция возвращает таблицу значений содержащую информацию о параметрах колонок заданной таблицы значений // Параметры: // ТаблицаЗначенийИсточник - таблица значений параметры колонок которой требуется определить. // Возвращаемое значение: // Таблица значений. Количество строк в этой таблице значений соответствует количеству колонок в таблице источнике. // В колонках таблицы значений содержится информация о праметрах колонки таблицы источника. Функция глПолучитьПараметрыКолонокТаблицыЗначений(ТаблицаЗначенийИсточник) |
| 96 | // Функция создает пустую таблицу значений на основе заданной структуры // Параметры: // ПараметрыКолонокТаблицыЗначений - таблица значений содержащая информацию о параметрах колонок. Структуру таблицы значений можно посмотреть в функции "глПолучитьПараметрыКолонокТаблицыЗначений". // Возвращаемое значение: // Пустая таблица значений созданная на основании указанной информации Функция глСоздатьТаблицуЗначенийНаОсновеСтруктуры(ПараметрыКолонокТаблицыЗначений) |
| 97 | // Функция создает пустую таблицу значений с заданными идентификаторами колонок. // Идентификаторы колонок можно не задавать. В этом случае будет создана пустая таблица значений без колонок. // <ИдентификаторыКолонокЧерезЗапятую> (необязательный). Тип: Строка. // Строка содержащая идентификаторы колонок через запятую. // <Возвращаемое значение>. Тип: ТаблицаЗначений. // Созданная пустая таблица значений с заданными колонками или без. Функция глСоздатьТаблицуЗначений(ИдентификаторыКолонокЧерезЗапятую = "") |
| 98 | // Функция устанавливает новые параметры колонок указанной таблицы значений // Параметры: // ДляТаблицыЗначений - таблица значений параметры колонок которой нужно изменить // НовыеПараметрыКолонокТаблицыЗначений - таблица значений содержащая новые параметры колонок. Структуру таблицы значений // можно посмотреть в функции "глПолучитьПараметрыКолонокТаблицыЗначений". Идентификация // колонок производится по идентификатору в параметрах колонок. // ДобавлятьОтсутствующиеКолонки - флаг значение "1" - при отсутствии в таблице значений колонки заданной в новых параметрах // эта колонка будет добавлена. При любом другом значении в этом параметре колонка добавлена не будет. // Возвращаемое значение: // Таблица значений с измененными параметрами колонок. Функция глУстановитьПараметрыКолонокТаблицыЗначений(ДляТаблицыЗначений, НовыеПараметрыКолонокТаблицыЗначений, ДобавлятьОтсутствующиеКолонки = 1) |
| 99 | // Процедура копирует данные из текущей строки таблицы значений источника в текущую строку таблицы значений приемника. // Дополнительно можно указать данные каких колонок необходимо скопировать. // Параметры: // ТаблицаЗначенийПриемник - таблица значений приемник // ТаблицаЗначенийИсточник - таблица значений источник // ИменаКолонокДляКопирования - строка содержащая через запятую идентификаторы колонок данные котррых необходимо скопировать Процедура глСкопироватьЗначенияСтрокиТаблицыЗначений(ТаблицаЗначенийПриемник, ТаблицаЗначенийИсточник, ИменаКолонокДляКопирования = "") |
| 100 | // Функция возвращает таблицу значений полученную путем объединения заданных таблиц значений. Данные из разных таблиц с одинаковыми // идентификаторами колонок будут распорожены в одной колонке результирующей таблицы. // Параметры: // ТаблицыЗначенийИсточники - список значений содержащий таблицы значений для объединения // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс объединения, значение 0 - не показывать. // Возвращаемое значение: // Таблица значений полученная путем объединения таблиц значений источников. Функция глОбъединитьТаблицыЗначений(ТаблицыЗначенийИсточники, ПоказыватьПроцентВыполнения = 0) |
| 101 | // Функция возвращает таблицу значений полученную путем объединения двух заданных таблиц значений. Данные из таблиц значений // источников с одинаковыми идентификаторами колонок будут распорожены в одной колонке результирующей таблицы. // Параметры: // ТаблицаЗначенийИсточник1 - таблица значений источник1 // ТаблицаЗначенийИсточник2 - таблица значений источник2 // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс объединения, значение 0 - не показывать. // Возвращаемое значение: // Таблица значений полученная путем объединения двух таблиц значений источников. Функция глОбъединитьДвеТаблицыЗначений(ТаблицаЗначенийИсточник1, ТаблицаЗначенийИсточник2, ПоказыватьПроцентВыполнения = 0) |
| Процедуры и функции для работы с расширенной таблицей значений | |
| 102 | // Функция инициализирует заданную таблицу значений как расширенную и возвращает её в качестве результата. Расширение таблицы // значений - это дополнение таблицы значений дополнительной служебной информацией (служебными колонками). Для работы с расширенной // таблицой значений предназначены ниже расположенные процедуры и функции. // Параметры: // ТаблицаЗначений - таблица значений // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс обработки, значение 0 - не показывать. // Возвращаемое значение: // Расширенная таблица значений полученная из заданной Функция глТаблицаЗначенийКакРасширенная(ТаблицаЗначений, ПоказыватьПроцентВыполнения = 0) |
| 103 | // Функция проверяет является ли заданная таблица значений расширенной. // Параметры: // ТаблицаЗначений - таблица значений или расширенная таблица значений // Возвращаемое значение: // 1 - заданная таблица значений является расширенной, 0 - заданная таблица значений не является расширенной Функция глЭтоРасширеннаяТаблицаЗначений(ТаблицаЗначений) |
| 104 | // Функция проверяет является ли заданный идентификатор колонки служебным для расширенной таблицы значений // Параметры: // ИмяКолонки - строка содержащая идентификатор колонки // Возвращаемое значение: // 1 - заданный идентификатор колонки является служебным для расширенной таблицы значений, 0 - заданный идентификатор колонки не служебный Функция глЭтоСлужебнаяКолонкаРасширеннойТаблицыЗначений(ИмяКолонки) |
| 105 | // Функция инициализирует текущую строку расширенной таблицы значений. Применяется после добавления новой строки в расширенную // таблицу значений. Функция возвращает псевдо объект "СтрокаТаблицыЗначений". // Параметры: // ТаблицаЗначений - расширенная таблица значений. // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" или пустое значение если указанная таблица значений не расширенная. Функция глИнициализироватьТекущуюСтрокуТаблицыЗначений(ТаблицаЗначений) |
| 106 | // Функция возвращает псевдо объект "СтрокаТаблицыЗначений" текущей строки расширенной таблицы значений. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" или пустое значение если указанная таблица значений не расширенная. Функция глПолучитьТекущуюСтрокуТаблицыЗначений(ТаблицаЗначений) |
| 107 | // Функция возвращает псевдо объект "СтрокаТаблицыЗначений" для указнной строки расширенной таблицы значений. Строка с заданным // номером становится текущей. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // НомерСтроки - номер строки расширенной таблицы значений. // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" или пустое значение если указанная таблица значений не расширенная. Функция глПолучитьСтрокуТаблицыЗначенийПоНомеру(ТаблицаЗначений, НомерСтроки) |
| 108 | // Функция делает текущей строку расширенной таблицы значений которая задана псевдо объектом "СтрокаТаблицыЗначений". Если в // расширенной таблице значений нет заданной строки, то текущая строка не определена. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // СтрокаТаблицыЗначений - псевдо объект "СтрокаТаблицыЗначений". // Возвращаемое значение: // 1 - заданная строка расширенной таблицы значений становится текущей. 0 - заданная строка не найдена в указанной расширенной таблице значений. // Пустое значение - если входные параметры функции не соответствуют допустимым типам. Функция глПерейтиКСтрокеТаблицыЗначений(ТаблицаЗначений, СтрокаТаблицыЗначений) |
| 109 | // Функция обновляет ключи поиска текущей строки расширенной таблицы значений согласно описания ключей заданных посредством // псевдо объекта "КоллекцияОписанияКлючей". Ранее созданные ключи удаляются. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // КоллекцияОписанияКлючей - псевдо объект "КоллекцияОписанияКлючей". Данный объект описывает все ключи поиска которые необходимо создать. // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" текущей строки расширенной таблицы значений. Пустое значение - если входные параметры // функции не соответствуют допустимым типам. Функция глОбновитьКлючиТекущейСтрокиТаблицыЗначений(ТаблицаЗначений, КоллекцияОписанияКлючей) |
| 110 | // Функция обновляет ключи поиска строки расширенной таблицы значений заданной псевдо объектом "СтрокаТаблицыЗначений" согласно // описания ключей заданных посредством псевдо объекта "КоллекцияОписанияКлючей". Ранее созданные ключи удаляются. // Параметры: // СтрокаТаблицыЗначений - псевдо объект "СтрокаТаблицыЗначений". // КоллекцияОписанияКлючей - псевдо объект "КоллекцияОписанияКлючей". Данный объект описывает все ключи поиска которые необходимо создать. // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" текущей строки расширенной таблицы значений. Пустое значение - если входные параметры // функции не соответствуют допустимым типам. Функция глОбновитьКлючиСтрокиТаблицыЗначений(СтрокаТаблицыЗначений, КоллекцияОписанияКлючей) |
| 111 | // Функция обновляет ключи поиска всех строк расширенной таблицы значений согласно описания ключей заданных посредством // псевдо объекта "КоллекцияОписанияКлючей". Ранее созданные ключи удаляются. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // КоллекцияОписанияКлючей - псевдо объект "КоллекцияОписанияКлючей". Данный объект описывает все ключи поиска которые необходимо создать. // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс обновления, значение 0 - не показывать. // Возвращаемое значение: // Расширенная таблица значений заданная как входной параметр. Пустое значение - если входные параметры // функции не соответствуют допустимым типам. Функция глОбновитьКлючиТаблицыЗначений(ТаблицаЗначений, КоллекцияОписанияКлючей, ПоказыватьПроцентВыполнения = 0) |
| 112 | // Функция производит поиск строки расширенной таблицы значений по заданному ключу и возвращает псевдо объект "СтрокаТаблицыЗначений". // Найденная строка становится текущей. Если строка не найдена, то возвращается пустое значение. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // ИмяКлюча - строка содержащая имя ключа. // Ключ - псевдо объект "Ключ". // Возвращаемое значение: // Псевдо объект "СтрокаТаблицыЗначений" найденной строки расширенной таблицы значений. Пустое значение - если входные параметры // функции не соответствуют допустимым типам или строка не найдена. Функция глНайтиСтрокуТаблицыЗначенийПоКлючу(ТаблицаЗначений, ИмяКлюча, Ключ) |
| 113 | // Функция производит поиск строк расширенной таблицы значений по заданному ключу. Функция возвращает список значений содержащий // все найденые строки расширенной таблицы значений в виде псевдо объектов "СтрокаТаблицыЗначений". Функция производит сортировку // расширенной таблицы значений по служебным колонкам. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // ИмяКлюча - строка содержащая имя ключа. // Ключ - псевдо объект "Ключ". // ТаблицаЗначенийУжеОтсортирована - необязательный параметр. Значение 1 - таблица значений уже ранее была отсортирована по ключу // и ее сортировать дополнительно не надо. Значение 0 - по умолчанию. Будет произведена сортировка. // Возвращаемое значение: // Пустое значение - если входные параметры функции не соответствуют допустимым типам. Список значений - найденные строки // расширенной таблицы значений в виде псевдо объектов "СтрокаТаблицыЗначений". Функция глНайтиСтрокиТаблицыЗначенийПоКлючу(ТаблицаЗначений, ИмяКлюча, Ключ, ТаблицаЗначенийУжеОтсортирована = 0) |
| 114 | // Функция производит создание новой таблицы значений по структуре аналогичной передаваемой в качестве параметра и копирует в неё // строки по заданному ключу. Передаваемая в качестве параметра таблица значений должна быть расширенной. Функция производит сортировку // расширенной таблицы значений передаваемой в качестве параметра по служебным колонкам. // Параметры: // ТаблицаЗначений - расширенная таблица значений. // ИмяКлюча - строка содержащая имя ключа. // Ключ - псевдо объект "Ключ". // ТаблицаЗначенийУжеОтсортирована - необязательный параметр. Значение 1 - таблица значений уже ранее была отсортирована по ключу // и ее сортировать дополнительно не надо. Значение 0 - по умолчанию. Будет произведена сортировка. // Возвращаемое значение: // Пустое значение - если входные параметры функции не соответствуют допустимым типам. Таблица значений - таблица значений // по структуре аналогичная передаваемой в качестве параметра. В данную таблицу переносятся только строки с указанным ключем. Функция глВыгрузитьСтрокиТаблицыЗначенийПоКлючу(ТаблицаЗначений, ИмяКлюча, Ключ, ТаблицаЗначенийУжеОтсортирована = 0) |
| 115 | // Для создания списка значений отбора для функции "глВыгрузитьСтрокиТаблицыЗначений" Функция глСоздатьЗначенияОтбора(ИдентификаторыКолонок, Значение1="", Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| 116 | // Функция производит поиск строк расширенной таблицы значений по заданному отбору. Функция возвращает список значений содержащий // все найденые строки расширенной таблицы значений в виде псевдо объектов "СтрокаТаблицыЗначений". // Параметры: // ТаблицаЗначений - Таблица значений должна быть расширенной. // ЗначенияОтбора - СписокЗначений содержащий значения отбора по колонкам. Значение элемента списка значений - это значение // отбора или список значений отбора. Представление элемента списка значений - это идентификатор колонки таблицы значений. // Возвращаемое значение: // Пустое значение - если входные параметры функции не соответствуют допустимым типам. Список значений - найденные строки // расширенной таблицы значений в виде псевдо объектов "СтрокаТаблицыЗначений". Функция глНайтиСтрокиТаблицыЗначений(ТаблицаЗначений, ЗначенияОтбора) |
| 117 | // Функция производит создание новой таблицы значений по структуре аналогичной передаваемой в качестве параметра и копирует в неё // строки соответствующие отбору заданному в параметре. // Параметры: // ТаблицаЗначений - Таблица значений может быть расширенной или обычной. // ЗначенияОтбора - СписокЗначений содержащий значения отбора по колонкам. Значение элемента списка значений - это значение // отбора или список значений отбора. Представление элемента списка значений - это идентификатор колонки таблицы значений. // Возвращаемое значение: // Пустое значение - если входные параметры функции не соответствуют допустимым типам. Таблица значений - таблица значений // по структуре аналогичная передаваемой в качестве параметра. В данную таблицу переносятся только строки соответствующие отбору. Функция глВыгрузитьСтрокиТаблицыЗначений(ТаблицаЗначений, ЗначенияОтбора) |
| 118 | // Функция преобразует заданную расширенную таблицу значений в обычную и возвращает её в качестве результата. Преобразование // заключается в удалении из заданной расширенной таблицы значений служебных колонок. // Параметры: // ТаблицаЗначений - расширенная таблица значений // Возвращаемое значение: // Обычная таблица значений полученная из заданной расширенной Функция глТаблицаЗначенийКакОбычная(ТаблицаЗначений) |
| Процедуры и функции для работы с таблицей значений | |
| 119 | Функция глЛевоеСоединениеТаблицЗначений(ЛеваяТаблицаЗначений, ПраваяТаблицаЗначений, ИменаКолонокКлюч, ПоказыватьПроцентВыполнения = 0) |
| 120 | Функция глПолноеСоединениеТаблицЗначений(ЛеваяТаблицаЗначений, ПраваяТаблицаЗначений, ИменаКолонокКлюч, ПоказыватьПроцентВыполнения = 0) |
| 121 | // Функция сворачивает заданную таблицу значений по значениям группировочных колонок суммируя значения по суммируемым колонкам. // В отличии от метода "свернуть" таблицы значений свертка выполняемая данной функцией может быть многоуровневой. // Уровни в группировчных колонках и суммируемых колонках разделяются знаком "|". // Например: Результат = глСвернутьСтрокиТаблицыЗначений(ТаблицаЗначений, "Заказчик|МестоВыполненияРабот,ВидРаботы|ЕдТехники", "ВаловыйДоходСуммаСумма|ВаловыйДоходСуммаСумма,РаботаЧасыСумма|РаботаЧасыСумма"); // Параметры: // ТаблицаЗначений - таблица значений // ГруппировочныеКолонки - строка идентификаторов колонок по которым будет происходить группировка даных // СуммируемыеКолонки - строка идентификаторов колонок по которым будет выполняться суммирование данных // ОбщийИтог - значение 1 - в результирующую таблицу значений будет добавлена строка (уровень = 0) с итогами по суммируемым колонкам. // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс обработки, значение 0 - не показывать. // СортироватьПоГруппировочнымКолонкам - значение 1 - результирующая таблица значений будет отсортирована по группировочным колонкам. // Расшифровки - значение 1 - в результирующую таблицу значений будет добавлена колонка "Расшифровка". В данную колонку для каждой строки // будет записана информация содержащая таблицу значений с данными исходной таблицы из которых сложилась группировочная строка. // Возвращаемое значение: // Таблица значений свернутая Функция глСвернутьСтрокиТаблицыЗначений(ТаблицаЗначений, ГруппировочныеКолонки, СуммируемыеКолонки = "", ОбщийИтог = 0, ПоказыватьПроцентВыполнения = 0, СортироватьПоГруппировочнымКолонкам = 0, Расшифровки = 0) |
| 122 | // Функция выводит строки таблицы значений источника в заданную таблицу. Имя таблицы шаблона и имена секций задаются параметрами процедуры. // Параметры: // ТаблицаЗначенийИсточник - таблица значений данные строк которой необходимо вывести в заданную таблицу // Таблица - таблица в которую необходимо произвести вывод данных // ИменаКолонокДляВывода - строка с именами колонок таблицы значений источника разделенных запятой, которые необходимо вывести. Среди перечня колонок // могут присутствовать колонки отсутствующие в таблице значений источника. В этом случае такие колонки будут выведены с пустым значением. // ИмяТаблицыШаблона - строка содержащая имя таблицы шаблона в которой расположены секции. // ИменаСекцийКолонок - строка с именами вертикальных секций в таблице шаблона разделенных запятой. Каждая указанная секция по порядку следования соответствует // колонке вывода указанной в параметре "ИменаКолонокДляВывода". Если данный параметр не задан, то имена секций должны соответствовать идентификаторам колонок // указанных в параметре "ИменаКолонокДляВывода". // ИменаСекцийУровней - строка с именами горизонтальных секций в таблице шаблона разделенных запятой. Данные секции используются для вывода строк таблицы источника. // Порядок следования секций соответствует: уровень1, уровень2 и т.д. Если данный параметр не задан, то имена секций для уровней должны быть следующими: "уровень1", "Уровень2" и т.д. // ИменаСекцийШапка - строка с именем горизонтальной секии в таблице шаблона. Данная секция используется для вывода шапки колонок. // Если данный параметр в явном виде не задан, то будет использоваться секция с именем "Шапка". // ИменаСекцийПодвал - строка с именем горизонтальной секции в таблице шаблона. Данная секция используется для вывода подвала колонок. // Если данный параметр в явном виде не задан, то будет использоваться секция с именем "Подвал". // ПоказыватьПроцентВыполнения - значение 1 - показывать в строке состояния процесс вывода, значение 0 - не показывать. // РасшифровкаПоУмолчанию - значение 1 - в качестве расшифровки используется стандартный механизм. Значение 0 - для организации расшифровки нужно использовать // предопределенную функцию таблицы "ОбработкаЯчейкиТаблицы". Пример приведен в комментарии к функции "глПолучитьДанныеРасшифровки". // ВыводитьОбщийИтог - значение 1 - общий итог, присутствующий в таблице значений источнике, будет выведен. При этом для вывода используется горизонтальная // секция заданная в параметре "ИменаСекцийПодвал". Значение 0 - общий итог не будет выведен. // ПоказатьТаблицуПослеВывода - значение 1 - таблица в которую происходит вывод будет показана после окончания процесса вывода. // Возвращаемое значение: // отсутствует Процедура глВывестиСтрокиТаблицыЗначений(ТаблицаЗначенийИсточник, Таблица, ИменаКолонокДляВывода = "", ИмяТаблицыШаблона = "", ИменаСекцийКолонок = "", ИменаСекцийУровней = "", ИменаСекцийШапка = "", ИменаСекцийПодвал = "", ПоказыватьПроцентВыполнения = 0, РасшифровкаПоУмолчанию = 1, ВыводитьОбщийИтог = 1, ПоказатьТаблицуПослеВывода = 1) |
| 123 | // Функция получает данные расшифровки. Данная функция предназначена для использования совместно с процедурой "глВывестиСтрокиТаблицыЗначений" // при значении параметра "РасшифровкаПоУмолчанию" равным нулю. // Параметры: // ПараметрыРасшифровки - значение расшифровки // ТаблицаЗначенийИсточник - таблица значений источник строки которой были выведены в таблицу с помощью процедуры "глВывестиСтрокиТаблицыЗначений". // Возвращаемое значение: // Либо таблица значений содержащая детальную информацию (колонка "Расшифровка" в таблице значений источник). Либо значение объектного типа. // // Пример использования: // // Процедура ОбработкаЯчейкиТаблицы(Значение, ФлагСтандОбраб, Таблица, Адрес) // ТекРасшифровка = глПолучитьДанныеРасшифровки(Значение, ТаблицаЗначений); // Если ТипЗначенияСтр(ТекРасшифровка) = "ТаблицаЗначений" Тогда // Таблица = СоздатьОбъект("Таблица"); // глВывестиСтрокиТаблицыЗначений(ТекРасшифровка, Таблица, "ПутЛист,РасчетВД", "Расшифровка"); // Формируется отчет расшифровки // Таблица.Показать(); // // Иначе // ТекКонтекст = ПолучитьПустоеЗначение(); // ОткрытьФорму(ТекРасшифровка, ТекКонтекст); // // КонецЕсли; // КонецПроцедуры // ОбработкаЯчейкиТаблицы Функция глПолучитьДанныеРасшифровки(ПараметрыРасшифровки, ТаблицаЗначенийИсточник) |
| Процедуры и функции для формирования отчета в формате Excel | |
| 124 | // Инициализация переменных для работы процедур и функций // Параметры: // Нет входных параметров. Функция глИнициализироватьПеременныеExcel() |
| 125 | // Функция предназначена для получения объекта приложения Excel для дальнейшей работы. // Параметры: // Нет входных параметров. // Возвращаемое значение: // Объект (OLE объект) для работы с приложением Excel. Функция глПолучитьПриложениеExcel() |
| 126 | // Функция возвращает объект для работы с таблицей шаблона Excel. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". // ПолноеИмяФайлаШаблона - Имя файла шаблона Excel включая полный путь до него. // ИмяТаблицыШаблона - имя листа в файле шаблона Excel. // Возвращаемое значение: // Объект (OLE объект) для работы с таблицей (листом) шаблона Excel. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глПолучитьТаблицуШаблонаExcel(ПриложениеExcel, ПолноеИмяФайлаШаблона, ИмяТаблицыШаблона) |
| 127 | // Функция возвращает объект для работы с таблицей результата Excel. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". // ПолноеИмяФайлаРезультата - Имя файла результата Excel включая полный путь до него. // ИмяТаблицыРезультата - имя листа в файле результата Excel. // Возвращаемое значение: // Объект (OLE объект) для работы с таблицей (листом) результата Excel. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глПолучитьТаблицуРезультатаExcel(ПриложениеExcel, ПолноеИмяФайлаРезультата, ИмяТаблицыРезультата) |
| 128 | // Функция возвращает область ячеек с заданным именем или адресом из таблицы Excel. // Параметры: // ТаблицаExcel - Объект (OLE объект) для работы с таблицей (листом) Excel. Данный объект можно получить с помощью функции "глПолучитьТаблицуШаблонаExcel" или "глПолучитьТаблицуРезультатаExcel". // ОбластьЯчеекExcel - строка с адресом вида "B2" или "B2:D5" или именем области ячеек. Т.е. в этом параметре задается именованная область или адрес яеек таблицы Excel. // Возвращаемое значение: // Объект (OLE объект) для работы с областью таблицы Excel. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глПолучитьОбластьИзТаблицыExcel(ТаблицаExcel, ОбластьЯчеекExcel) |
| 129 | // Функция возвращает секцию с заданным названием из таблицы шаблона Excel. // Параметры: // ТаблицаШаблонExcel - Объект (OLE объект) для работы с таблицей (листом) шаблона Excel. Данный объект можно получить с помощью функции "глПолучитьТаблицуШаблонаExcel". // ИмяСекции - Строка содержащая имя секции в таблице шаблона Excel. Т.е. в этом параметре задается именованная область таблицы шаблона Excel. // Возвращаемое значение: // Объект (OLE объект) для работы с областью таблицы шаблона Excel. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глПолучитьСекциюИзТаблицыШаблонаExcel(ТаблицаШаблонExcel, ИмяСекции) |
| 130 | // Процедура копирует вниз заданную секцию в таблицу результат Excel. // Процедурой используются глобальные переменные "ТекСтрока", "ТекСтолбец". // Параметры: // СекцияШаблонExcel - Объект (OLE объект) для работы с областью таблицы шаблона Excel. Данный объект можно получить с помощью функции "глПолучитьСекциюИзТаблицыШаблонаExcel". // ТаблицаРезультатаExcel - Объект (OLE объект) для работы с таблицей (листом) результата Excel. Данный объект можно получить с помощью функции "глПолучитьТаблицуРезультатаExcel". // БезУчетаШириныСтолбцов - Значение 1 - копирование происходит без учета ширины столбцов секции шаблона. Значение 0 - с учетом ширины столбцов. Процедура глСкопироватьСекциюВниз(СекцияШаблонExcel, ТаблицаРезультатаExcel, БезУчетаШириныСтолбцов = 0, ИнициализированныеПеременные = "") |
| 131 | // Процедура копирует вправо заданную секцию в таблицу результат Excel. // Процедурой используются глобальные переменные "ТекСтрока", "ТекСтолбец". // Параметры: // СекцияШаблонExcel - Объект (OLE объект) для работы с областью таблицы шаблона Excel. Данный объект можно получить с помощью функции "глПолучитьСекциюИзТаблицыШаблонаExcel". // ТаблицаРезультатаExcel - Объект (OLE объект) для работы с таблицей (листом) результата Excel. Данный объект можно получить с помощью функции "глПолучитьТаблицуРезультатаExcel". // БезУчетаШириныСтолбцов - Значение 1 - копирование происходит без учета ширины столбцов секции шаблона. Значение 0 - с учетом ширины столбцов. Процедура глСкопироватьСекциюВправо(СекцияШаблонExcel, ТаблицаРезультатаExcel, БезУчетаШириныСтолбцов = 0, ИнициализированныеПеременные = "") |
| 132 | // Процедура закрывает заданный файл Excel. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". // ПолноеИмяФайла - Строка содержащая полное имя файла открытого в приложении Excel. Процедура глЗакрытьФайлExcel(ПриложениеExcel, ПолноеИмяФайла) |
| 133 | // Процедура сохраняет изменения открытого ранее файла Excel. // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". // ПолноеИмяФайла - Строка содержащая полное имя файла уже открытого в приложении Excel. Данным параметром нельзя изменить полное имя уже открытого файла Excel или сохрать его под другим именем. Для данной процедуры данный параметр предназначен для идентификации нужного открытого файла Excel среди других открытих. Процедура глСохранитьТаблицуРезультатаExcel(ПриложениеExcel, ПолноеИмяФайлаРезультата) |
| 134 | // Функция устанавливает заданную видимость приложению Excel и возвращает значение визимости до изменения. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". // Видимость - Значение 1 - приложение Excel видимо. Значение 0 - приложение Excel работает в фоне. // Возвращаемое значение: // Значение видимости приложения Excel до установки заданного значения. Функция глУстановитьВидимостьПриложенияExcel(ПриложениеExcel, Видимость) |
| 135 | // Процедура показывает приложение Excel работающее в фоне. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". Процедура глПоказатьПриложениеExcel(ПриложениеExcel) |
| 136 | // Процедура закрывает приложение Excel. Все открытые в нем файлы закрываются. // Параметры: // ПриложениеExcel - Объект (OLE объект) для работы с приложением Excel. Может быть получен с помощью функции "глПолучитьПриложениеExcel". Процедура глЗакрытьПриложениеExcel(ПриложениеExcel) |
| 137 | // Функция устанавливает заданное значение в ячейки Excel и возвращает объект область ячеек. // Параметры: // ТаблицаИЛИОбластьТаблицыExcel - Объект (OLE объект) для работы с областью таблицы или таблицей Excel. Данный объект можно получить с помощью // функций: "глПолучитьТаблицуШаблонаExcel", "глПолучитьТаблицуРезультатаExcel", "глПолучитьСекциюИзТаблицыШаблонаExcel","глПолучитьОбластьИзТаблицыExcel". // ОбластьЯчеекExcel - строка с адресом вида "B2" или "B2:D5" или именем области ячеек. // Значение - значение которое нужно поместить в ячейки Excel. Если значение имеет тип "Строка" и начинается с символа "=", то считается, что задается формула. // Возвращаемое значение: // Функция возвращает объект (OLE объект) область ячеек таблицы результата Excel, заданную во входном параметре в виде строки. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глЗначениеВЯчейкиExcel(ТаблицаИЛИОбластьТаблицыExcel, ОбластьЯчеекExcel, Значение) |
| 138 | // Функция устанавливает заданные значения в ячейки Excel и возвращает список значений содержащий объекты области ячеек. // Параметры: // ТаблицаИЛИОбластьТаблицыExcel - Объект (OLE объект) для работы с областью таблицы или таблицей Excel. Данный объект можно получить с помощью // функций: "глПолучитьТаблицуШаблонаExcel", "глПолучитьТаблицуРезультатаExcel", "глПолучитьСекциюИзТаблицыШаблонаExcel","глПолучитьОбластьИзТаблицыExcel". // ОбластиЯчеекExcel - строка адресов ячеек или имен именованных областей через запятую. // Значение1, Значение2, и т.д. - значения для записи которые нужно поместить в ячейки Excel. Если значение имеет тип "Строка" и начинается с символа "=", то считается, что задается формула. // Возвращаемое значение: // Функция возвращает список значений содержащий объекты (OLE объект) область ячеек таблицы результата Excel, заданные во входном параметре в виде строки. Если входные параметры имеют недопустимый // тип, то функция возвращает пустое значение. Функция глЗначенияВЯчейкиExcel(ТаблицаИЛИОбластьТаблицыExcel, ОбластиЯчеекExcel, Значение1, Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| Функции для чтения данных из Excel | |
| 139 | // Функция возвращает двух мерный псевдо массив содержащий считанные данные из файла формата Excel или Xml // Параметры: // ПолноеИмяФайла - Имя файла формата Excel или Xml включая полный путь до него. // ИмяЛиста - имя листа в файле Excel. Если файл формата Xml, то параметр оставляем пустой. // Возвращаемое значение: // Таблица значений - таблица значений содержащая все данные считанные из указанного файла. Функция глПолучитьДанныеИзExcel(ПолноеИмяФайла, ИмяЛиста = "") |
| Процедуры и функции для работы с прикрепленными файлами | |
| 140 | // Функция прикрепляет указанный файл к заданному объекту. // Функция возвращает 1 - если файл успешно прикреплен. 0 - в противном случае. Функция ПрикрепитьФайлКОбъекту(ТекОбъект, ПолноеИмяФайлаИсточника) |
| 141 | // Функция прикрепляет указанный интерактивно файл к заданному объекту. // Функция возвращает 1 - если файл успешно прикреплен. 0 - в противном случае. Функция ПрикрепитьФайлКОбъектуИнтерактивно(ТекОбъект) |
| 142 | // Функция возвращает список значений содержащий все прикрепленные файлы к заданному объекту. Функция ПолучитьПрикрепленныеФайлыКОбъекту(ТекОбъект) |
| 143 | // Процедура открывает указанный файл. Процедура ОткрытьПрикрепленныйФайл(ПолноеИмяФайла) |
| 144 | // Процедура удаляет указанные прикрепленные файлы у заданного объекта. Процедура УдалитьФайлыПрикрепленныеКОбъекту(ТекОбъект, СписокФайловДляУдаления) |
| 145 | // Процедура удаляет все прикрепленные файлы у заданного объекта. Процедура УдалитьВсеПрикрепленныеФайлыКОбъекту(ТекОбъект) |
| 146 | // Процедура удаляет указанные интерактивно прикрепленные файлы у заданного объекта. Процедура УдалитьФайлыПрикрепленныеКОбъектуИнтерактивно(ТекОбъект) |
| 147 | // Показывает весь функционал по работе с прикрепленными файлами в виде контекстного меню для заданого объекта. Процедура ФункционалПрикрепленныеФайлыКОбъекту(ТекОбъект) |
| Процедуры и функции для сохранения значения в Xml формат | |
| 148 | Функция глПолучитьЗначениеКакXml(хмлУзелРодитель, Значение, ЗначениеКакОбъект = 0) |
| 149 | // Значения - список значений или значение для выгрузки в Xml // Функция возвращает строку - данные в формате Xml // Если задано полное имя файла, то сформированные данные записываются в файл. // ВыгружатьСвязанныеДанные - параметр определяет будут ли выгружены в Xml связанные данные. Функция ВыгрузитьЗначенияВXml(Значения, ПолноеИмяФайла = "", ВыгружатьСвязанныеДанные = 1) |
| 150 | // Данную процедуру будем вызывать из журналов документов. Т.е. будем сохранять текущий документ в журнале документов. Процедура глЭкспортироватьЗначениеВXml(ТекЗначение, ВыгружатьСвязанныеДанные = 1) |
| Процедуры и функции для загрузки данных из Xml формат | |
| 151 | // Считаем что реквизит "КодПорождающейСистемы" уникален в пределах всего справочника. В том числе и если справочник является // подчиненным другому справочнику. Функция глПолучитьЗначениеИзXml(XmlЗначение, тзОбъекты, тзНастройкиИмпорта = "") |
| 152 | Функция ЗагрузитьЗначенияИзXml(ПолноеИмяФайлаXml) |
| 153 | // Данную процедуру будем вызывать из журналов документов или из любого другого места конфигурации Функция глИмпортироватьЗначенияИзXml() |
| Псевдо объект: "Структура | |
| 154 | Функция глСоздатьСтруктуру(Ключи = "", Значение1="", Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| 155 | Процедура глВставитьВСтруктуру(Структура, Ключ, Значение) |
| 156 | Функция глПолучитьПозициюКлючаВСтруктуре(Структура, Ключ) |
| 157 | Процедура глУдалитьИзСтруктуры(Структура, Ключ) |
| 158 | Функция глСвойствоСтруктуры(Структура, Ключ) |
| 159 | Функция глРазмерСтруктуры(Структура) |
| 160 | Процедура глОчиститьСтруктуру(Структура) |
| Псевдо объект: "Массив" | |
| 161 | Функция глСоздатьМассив(Размер = 0) |
| 162 | Функция глРазмерМассива(Массив) |
| 163 | Функция глДобавитьВМассив(Массив, Значение) |
| 164 | Процедура глУдалитьИзМассива(Массив, Позиция, Количество = 1) |
| 165 | Функция глВставитьВМассив(Массив, Позиция, Значение) |
| 166 | Функция глПолучитьИзМассива(Массив, Позиция) |
| Инкремент, декремент | |
| 167 | Процедура Inc(Значение, Дельта = 1) |
| 168 | Процедура Dec(Значение, Дельта = 1) |
| 169 | // Процедура производит сложение или конкатенацию значений передаваемых в качестиве параметров. Вид выполняемой операции зависит от типа значения первого параметра. // Если значение первого параметр имеет тип <Число>, то процедура производит сложение значений переданных параметров. Все значения параметров начиная со второго приводятся к типу <число>. // Если привести значение параметра к типу <число> не удалось, то значение параметра считается равным нулю. Результат сложения записываетсяч в первый параметр. // Если первый параметр имеет тип <Дата>, то процедура производит сдвиг даты на указанное число дней в паратетрах начиная со второго. Все значения параметров начиная со второго приводятся к типу <число>. // Если привести значение параметра к типу <число> не удалось, то значение параметра считается равным нулю. Результат сложения записываетсяч в первый параметр. // Если первый параметр имеет тип "Строка", то процедура производит конкатенацию значений всех параметров. Значения всех зпараметр начиная со второго приводятся к типу <Строка>. // Если в начале строки присутствует символ <|>, то при конкатенации он будет заменен на значение <РазделительСтрок>. Результат сложения записываетсяч в первый параметр. // <Значение1> (обязательный). Тип: Число, Дата, Строка. // Значение для сложения, или дата которую нужно изменить, или одна из подстрок для конкатенации. Также в данный параметр будет записан результат выполнения процедуры. // <Значение2> (обязательный). Тип: Число, Строка. // Значение для сложения, или число дней сдвига даты заданной в первом параметре, или одна из подстрок для конкатенации. Процедура Add(Значение1, Значение2, Значение3 = "", Значение4 = "", Значение5 = "", Значение6 = "", Значение7 = "", Значение8 = "", Значение9 = "", Значение10 = "", Значение11 = "", Значение12 = "", Значение13 = "", Значение14 = "", Значение15 = "", Значение16 = "") |
| Процедуры и функции для сохранения значения в JSON формат | |
| 170 | Функция ВыгрузитьЗначенияВJSON(Значения, ПолноеИмяФайла = "", ВыгружатьСвязанныеДанные = 1) |
| 171 | Функция глПолучитьЗначениеКакСтруктуру(Значение, ЗначениеКакОбъект = 0) |
| 172 | // FSO = СоздатьОбъект("Scripting.FileSystemObject"); // TextStream = FSO.CreateTextFile(ПолноеИмяФайла); Функция глПолучитьЗначениеКакJSON(Значение, ЗначениеКакОбъект = 0, TextStream = "") |
| 173 | // Экспорт в формат Xml или json // Данную процедуру будем вызывать из журналов документов. Т.е. будем сохранять текущий документ в журнале документов. Процедура глЭкспортироватьЗначениеВФайл(ТекЗначение, ВыгружатьСвязанныеДанные = 1) |
| Процедуры и функции для загрузки данных из JSON формата | |
| 174 | // FSO = СоздатьОбъект("Scripting.FileSystemObject"); // File = FSO.GetFile(ПолноеИмяФайла); // TextStream = File.OpenAsTextStream(1); // Это объект типа "OLE.ITextStream". // TextStream - может быть значением с типом "OLE.ITextStream" или "Строка". При использовании строки до вызова данной функции нужно использовать функцию "УстановитьПозициюНаНачалоСтроки". // Возвращает функция значение типа: Структура, Массив, число, строка, пустое значение. Функция глПолучитьЗначениеJSON(TextStream, ПоследнийПолученныйСимволИзПотока, ОшибкаФормата) |
| 175 | Функция ЗагрузитьЗначенияИзJSON(ПолноеИмяФайлаJSON) |
| 176 | // Данную процедуру будем вызывать из журналов документов или из любого другого места конфигурации Функция глИмпортироватьЗначенияИзJSON() |
| 177 | // Импорт из форматов Xml или json // Данную процедуру будем вызывать из журналов документов или из любого другого места конфигурации. Функция глИмпортироватьЗначенияИзФайла() |
| Процедуры и функции для работы с псевдо объектами | |
| 178 | // Псевдо объект - это структура имитирующая некеую сущность с набором свойств и их значений. // Для имитации структуры (псевдо объекта) создается объект "СписокЗначений". В списке значений: Представление элемента списка - это имя свойства, а значение элемента списка - это значение свойства. // Также в списке значений есть служебное свойство "ТипОбъекта", в котором содержится в виде строки тип псевдо объекта. Тип псевдо объекта можно получить функцией "глТипЗначенияСтр(...)". // Примеры псевдо объектов в данном модуле: "Структура" (глСоздатьСтруктуру(...)), "Массив" (глСоздатьМассив(...)), "ПроксиСервер" (глСоздатьПроксиСервер(...)). // Псевдо объект - это структура имитирующая некеую сущность с набором свойств и их значений. // Для имитации структуры (псевдо объекта) создается объект "СписокЗначений". В списке значений: Представление элемента списка - это имя свойства, а значение элемента списка - это значение свойства. // Также в списке значений есть служебное свойство "ТипОбъекта", в котором содержится в виде строки тип псевдо объекта. Тип псевдо объекта можно получить функцией "глТипЗначенияСтр(...)". // Данная функция предназначена для упрощения создания псевдо объекта при написании функий конструкторов. // <ТипОбъекта> (обязательный). Тип: Строка. // Данный параметр задает в виде строки тип псевдо объекта. Значение данного свойства доступно для получения функцией "глТипЗначенияСтр(...)". // <Свойства> (обязательный). Тип: Строка. // Данный параметр задает в виде строки имена свойств псевдо объета через запятую. // <Значение1>, <Значение2>, ..., <Значение1> (необязательный). Тип: Любой. // Значение свойства псевдо объекта. // <Возвращаемое значение> Тип: Список значений (псевдо объект). // Функция возвращает список значений имитирующий псевдо объект. Функция СоздатьСтруктуруОбъекта(ТипОбъекта, Свойства, Значение1="", Значение2="", Значение3="", Значение4="", Значение5="", Значение6="", Значение7="", Значение8="", Значение9="", Значение10="", Значение11="", Значение12="", Значение13="", Значение14="", Значение15="", Значение16="") |
| 179 | // Процедура уничтожает псевдо объект. // <оОбъект> (обязательный). Тип: Список значений (псевдо объект). // Псевдо объект который нужно уничтожить. Т.е. эта процедура типа универсального деструктора для объектов. Процедура глУничтожитьОбъект(оОбъект) |
| 180 | // Функция позволяет получать текущее значений указанного свойства псевдо объекта и устанавливать новое. // <оОбъект> (обязательный). Тип: Список значений (псевдо объект). // Псевдо объект свойство которого нужно получить и/или записать. // <ИмяСвойства> (обязательный). Тип: Строка. // Имя свойства псевдо объекта которое нужно получить и/или записать. // <Значение> (необязательный). Тип: Любой. // Значение которое необходимо записать в указанное свойство псевдо объекта. // <Возвращаемое значение> Тип: Любой. // Функция возвращает значение указанного свойства псевдо объекта. При изменении значения - функция возвращает значение до изменения. // Если типы параметров не соотвествуют укзанным выше, то функция вернет пустое значение. Функция глСвойство(оОбъект, ИмяСвойства, Значение = "") |
| 181 | // Функция создает копию заданного псевдо объекта. // <оОбъект> (обязательный). Тип: Список значений (псевдо объект). // Псевдо объект копию которого нужно создать. // <Возвращаемое значение> Тип: Список значений (псевдо объект), пустое значение. // Псевдо объект созданный из заданного в параметре псевдо объекта. Вложенные значения свойств не примитивных типов не клонируются. // Т.е. у копии значения не примитывных типов будут ссылаться на теже объекты что и у исходного объекта. // Если в функцию передан не псевдо объект (список значений), то функция вернет пустое значение. Функция глКлонироватьОбъект(оОбъект) |
| Процедуры и функции для работы с Http сервисами | |
| 182 | // Функция создает псевдо объект "ПроксиСервер" с заданными параметрами. // <Имя> (обязательный). Тип: Строка. // Имя или IP адрес прокси-сервера. // <Порт> (необязательный). Тип: Строка. // Порт прокси-сервера. По умолчанию значение порта = "8080". // <Пользователь> (необязательный). Тип: Строка. // Логин пользователя для доступа к прокси-серверу. По умолчанию пустая строка. // <Пароль> (необязательный). Тип: Строка. // Пароль пользователя для доступа к прокси-серверу. По умолчанию пустая строка. // <Возвращаемое значение> Тип: Список значений (псевдо объект "ПроксиСервер"), пустое значение. // Функция создает псевдо объект "ПроксиСервер" с заданными параметрами. Функция глСоздатьПроксиСервер(Имя, Порт = "8080", Пользователь = "", Пароль = "") |
| 183 | // Функция создает псевдо объект "Сервер" с заданными параметрами // <Имя> (обязательный). Тип: Строка. // Имя или IP адрес сервера. // <Пользователь> (необязательный). Тип: Строка. // Логин пользователя для доступа к серверу. По умолчанию пустая строка. // <Пароль> (необязательный). Тип: Строка. // Пароль пользователя для доступа к серверу. По умолчанию пустая строка. // <Возвращаемое значение> Тип: Список значений (псевдо объект "Сервер"), пустое значение. // Функция создает псевдо объект "Сервер" с заданными параметрами. Функция глСоздатьСервер(Имя, Пользователь = "", Пароль = "") |
| 184 | // Функция создает псевдо объект "HttpСервис" с заданными параметрами. // <Сервер> (обязательный). Тип: Строка, Псевдо объект "Сервер". // Параметр задает сервер Http сервиса. Может быть задан как строкой с именем или IP адресом сервера, так и псевдо объектом "Сервер" (см. функцию "глСоздатьСервер(...)"). // <ПроксиСервер> (необязательный). Тип: Строка, Псевдо объект "ПроксиСервер". // Параметр задает прокси-сервер через который будет осуществляться доступ к Http сервису. // Может быть задан как строкой с именем или IP адресом прокси-сервера, так и псевдо объектом "ПроксиСервер" (см. функцию "глСоздатьПроксиСервер(...)"). // Параметр необязательный. Если не задан, то считается что прокси-сервер не задан. // <Параметры> (необязательный). Тип: Строка, Псевдо объект "Структура". // Параметр определяет опции Http запроса при отправке. Т.е. оказывает влияние на поведение функции "глПослатьHttpЗапрос". // <Возвращаемое значение> Тип: Список значений (псевдо объект "HttpСервис"), пустое значение. // Функция создает псевдо объект "HttpСервис" с заданными параметрами. Функция глСоздатьHttpСервис(Сервер, ПроксиСервер = "", Параметры = "") |
| 185 | // Функция возвращает текуще значение параметра и/или записывает новое значение. // <Параметры> (обязательный). Тип: Псевдо объект "Структура" или псевдо объект "HttpСервис". // Псевдо объект из которого нужно считать или записать параметр. // <ИмяПараметра> (обязательный). Тип: Строка. // Имя параметра Http запроса. Полный перечень параметров см. внутри функции. // <ЗначениеПараметра> (необязательный). Тип: Любой. // Значение устанавливаемого параметр Http запроса. Если значением параметра являются строки "false" или "true", то такие значения считаются типом булево. // <Возвращаемое значение> Тип: Любой. // Функция возвращает текуще значение параметра (до записи нового значения). Функция глПараметрHttpЗапроса(Параметры, ИмяПараметра, ЗначениеПараметра = "") |
| 186 | // Функция отправляет запрос на Http сервис согласно заданным параметрам. // Функция возвращает результат выполнения запроса в виде кода. // Описание кодов возврата: // https://restfulapi.net/http-status-codes/ // https://restapitutorial.ru/httpstatuscodes.html // <HttpСервис> (обязательный). Тип: Псевдо объект "HttpСервис". // Параметр задает сервер Http сервиса, прокси-сервер через который предполагается доступ к Http сервису, а также параметры запроса. // См. функции "глСоздатьПроксиСервер(...)", "глСоздатьСервер(...)", "глСоздатьHttpСервис(...)". // <Ресурс> (обязательный). Тип: Строка. // Строка содержащая путь к ресурсу Http сервиса. // Например, в полном URL = "https://smabrdportal.gazprom-neft.ru/services/api-token-auth/" часть = "/services/api-token-auth/" является путем к ресурсу. // <Протокол> (необязательный). Тип: Строка. // Протокол работы с Http сервисом. Например: "Https". По умолчанию задается протокол "Https". // Например, в полном URL = "https://smabrdportal.gazprom-neft.ru/services/api-token-auth/" часть = "https" является протоколом. // <Метод> (необязательный). Тип: Строка. // Метод запроса: "GET", "POST", "PUT", "DELETE". Если метод в явном виде не задан, то считается что выполняется "GET" запрос. // <Заголовки> (необязательный). Тип: Псевдо объект "Структура". // Пары "ключ - значение" в структуре задают пары "имя заголовка - значение заголовка" для запроса к Http сервису. // Если параметр не задан, то соответственно никакие заголовки Http запроса не устанавливаются. // <Тело> (необязательный). Тип: Строка. // Запрос к Http сервису в виде строки символов. Если в явном виде не задан, то считается что задана пустая строка. // <Возвращаемое значение> Тип: Число. // Функция возвращает код состояния Http запроса из последнего ответа (см. также функции: "глТекстСостоянияHttpЗапроса(...)", "глТекстОтветаHttpЗапроса(...)"). Функция глПослатьHttpЗапрос(HttpСервис, Ресурс, Протокол = "Https", Метод = "GET", Заголовки = "", Тело = "") |
| 187 | // Функция возвращает текст состояния Http запроса (см. функцию "глПослатьHttpЗапрос(...)") из последнего ответа. // <HttpСервис> (обязательный). Тип: Псевдо объект "HttpСервис". // Параметр задает сервер Http сервиса, прокси-сервер через который предполагается доступ к Http сервису, а также параметры запроса. // См. функции "глСоздатьПроксиСервер(...)", "глСоздатьСервер(...)", "глСоздатьHttpСервис(...)". // <Возвращаемое значение> Тип: Строка. // Функция возвращает текст состояния Http запроса из последнего ответа. Функция глТекстСостоянияHttpЗапроса(HttpСервис) |
| 188 | // Функция возвращает текст ответа на Http запрос (см. функцию "глПослатьHttpЗапрос(...)"). // <HttpСервис> (обязательный). Тип: Псевдо объект "HttpСервис". // Параметр задает сервер Http сервиса, прокси-сервер через который предполагается доступ к Http сервису, а также параметры запроса. // См. функции "глСоздатьПроксиСервер(...)", "глСоздатьСервер(...)", "глСоздатьHttpСервис(...)". // <Возвращаемое значение> Тип: Строка. // Функция возвращает текст ответа на Http запрос. Функция глТекстОтветаHttpЗапроса(HttpСервис) |
| Процедуры и функции для обработки ожидания | |
| 189 | // Процедура устанавливает функцию глобального модуля или обработки которая будет вызываться с заданным интервалом времени в состоянии ожидания. // Вызываемая функция должны вернуть значения <1> - продолжить вызовы, или <0> - прекратить дальнейшие вызовы функции. // <ИмяФункции> (обязательный). Тип: Строка. // Имя функции глобального модуля или обработки, которая будет вызываться периодически с заданным временным интервалом. // <ИнтервалВызова> (необязательный). Тип: Число. // Интервал времени в секундах, с которым периодически будет вызываться функция глобального модуля или обработки. // <ИмяОбработки> (необязательный). Тип: Строка. // Имя обработки функция которой будет вызываться. Если не задана, то считается что задается функция глобального модуля. Процедура глОбработкаОжидания(ИмяФункции, ИнтервалВызова = 0, ИмяОбработки = "") |
| Процедуры и функции для кеширования значений функций | |
| 190 | Функция глНайтиПовторноеИспользованиеОдинПараметр(Буфер, ВремяЖизниВСекундах, Параметр1) |
| 191 | Функция глНайтиПовторноеИспользованиеДваПараметра(Буфер, ВремяЖизниВСекундах, Параметр1, Параметр2) |
| 192 | Функция глНайтиПовторноеИспользованиеТриПараметра(Буфер, ВремяЖизниВСекундах, Параметр1, Параметр2, Параметр3) |
| 193 | Процедура глДобавитьПовторноеИспользованиеОдинПараметр(Буфер, Параметр1, Значение) |
| 194 | Процедура глДобавитьПовторноеИспользованиеДваПараметра(Буфер, Параметр1, Параметр2, Значение) |
| 195 | Процедура глДобавитьПовторноеИспользованиеТриПараметра(Буфер, Параметр1, Параметр2, Параметр3, Значение) |
| Процедуры и функции для отправки почты по SMTP | |
| 196 | // Функция создает псевдо объект "SMTPСервер" с заданными параметрами. // <Имя> (обязательный). Тип: Строка. // Имя или IP адрес SMTP сервера. // <Порт> (необязательный). Тип: Строка. // Порт SMTP сервера. По умолчанию значение порта = "25". // <Пользователь> (необязательный). Тип: Строка. // Логин пользователя для доступа к SMTP серверу. По умолчанию пустая строка. // <Пароль> (необязательный). Тип: Строка. // Пароль пользователя для доступа к SMTP серверу. По умолчанию пустая строка. // <ИспользоватьSSL> (необязательный). Тип: Число. // Допустимы значения <0> или <1>. // При значении параметра <1> будет использоваться протокол безопасности SSL, создающий зашифрованное соединение. // По умолчанию занчение параметра <0>. // <ПроверкаПодлинностиNTLM> (необязательный). Тип: Число // Допустимы значения <0> или <1>. // При значении параметра <1> будет использоваться протокол проверки подлинности NTLM. // NTLM - это протокол проверки подлинности, используемый в сетях, включающих системы под управлением операционной системы Windows. // <Возвращаемое значение> Тип: Список значений (псевдо объект "SMTPСервер"), пустое значение. // Функция создает псевдо объект "SMTPСервер" с заданными параметрами. Функция глСоздатьSMTPСервер(Имя, Порт = "25", Пользователь = "", Пароль = "", ИспользоватьSSL = 0, ПроверкаПодлинностиNTLM = 0) |
| 197 | // Функция производит отправку сообщения по электронной почте. К сообщению можно прикрепить произвольное количество файлов. // <SMTPСервер> (обязательный). Тип: Псевдо объект "SMTPСервер". // Параметр задает сервер SMTP через который предполагается отправка электронного сообщения. // См. функцию "глСоздатьSMTPСервер(...)". // <Отправитель> (обязательный). Тип: Строка. // Адрес электронной почты отправителя. // <ИмяОтправителя> (обязательный). Тип: Строка. // Содержит имя отправителя письма. // <Кому> (обязательный). Тип: Строка. // Адреса электронной почты получателей через запятую. // <Копия> (необязательный). Тип: Строка. // Адреса электронной почты получателей копии через запятую. По умолчанию получатели копии не заданы. // <СкрытаяКопия> (необязательный). Тип: Строка. // Адреса электронной почты получателей скрытой копии через запятую. По умолчанию получатели скрытой копии не заданы. // <ВысокаяВажность> (необязательный). Тип: Строка. // Содержит важность почтового сообщения. Если значение не задано, то используется значение по умолчанию: обычная важность. // <Тема> (обязательный). Тип: Строка. // Тема сообщения. // <ТекстСообщения> (необязательный). Тип: Строка. // Текст сообщения. Если значение не задано, то используется значение по умолчанию: "". // <ФорматСообщения> (необязательный). Тип: Строка. // Параметр задает формат текста сообщения. Строка может принимать два значения: "Textbody" и "HTMLBody". По умолчанию используется значение "Textbody". // <Файлы> (необязательный). Тип: Строка. // Полные имена (включая путь) файлов через запятую. // <Возвращаемое значение> Тип: Число. // Функция возвращает <1> в случае успешной отправки сообщения, и <0> в противном случае. Функция глОтправитьСообщениеПоЭлПочте(SMTPСервер, Отправитель, ИмяОтправителя, Кому, Копия = "", СкрытаяКопия = "", ВысокаяВажность = 0, Тема, ТекстСообщения = "", ФорматСообщения = "Textbody", Файлы = "") |
