WEB-приложение Сведение отчетности   (14.07.2012)
Загрузка данных из внешних источников

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

  1. xml-документ, выгруженный для центра учета из (другого либо того же самого) центра учета. Для загрузки архивов этого типа никаких дополнительных действий предпринимать не нужно.
  2. pra-архив, выгруженный для центра учета из (другого либо того же самого) центра учета. Для загрузки архивов этого типа никаких дополнительных действий предпринимать не нужно.
  3. pra-архив, выгруженный для центра учета из абонентского пункта Excel. Для загрузки архивов этого типа никаких дополнительных действий предпринимать не нужно.
  4. xml-документ с преобразованием на проходе. Для этого необходимо разработать схему для валидации документа (файл с расширением xsd) и xslt-преобразование (файл с расширением xsl), соответственно для валидации и преобразования на проходе файлов различной структуры. Для использования загрузки документов с преобразованием на проходе в значении параметра(cсылка потеряна) "Загрузчики xml-документов" необходимо перечислить через точку с зяпятой соответствия файла схемы файлам преобразований (Например, без кавычек "c:\scripts\inbox_schema.xsd=c:\scripts\inbox.xsl;c:\scripts\outbox_schema.xsd=c:\scripts\outbox.xsl"). Тогда, если файл проходит валидацию по схеме, то произойдет преобразование на проходе по соответствующему сценарию и дальнейшая загрузка результата преобразования, как xml-документа из пункта 1. Схемы перебираются последовательно.
  5. текствоый файл. Для этого необходимо разработать скрипт загрузки текстового файла на языке прграммирования VBScript. Пример скрипта загрузки здесь(cсылка потеряна). Внутри скрипта доступны следующие объекты:
    • StringCount - функция без параметров, возвращает количество строк в переданном текстовом файле.
    • Strings(Index as Integer) - функция возвращает текст строки с номером Index из переданного текстового файла. Строки нумеруются с 0. При выходе за границу диапазона функция вернет пустую строкую.
    • InvalidData - предопределенная переменная, по умолчанию имеет значение False. В случае, если текстовый файл не распознан алгоритмом разбора как файл правильной структуры, присвойте этой переменной значение True.
    • xml - объект xml-документа с результирующими данными.
    • DebugString - процедура принимает строковый аргумент и передает его в отладочный монитор (может использоваться для отладки)
    • SessionValue - функция принимает строковый аргумент и возвращает значение параметра сессии с именем, равным аргументу.
    • Message - процедура принимает строковый аргумент. Переданная строка будет показана пользователю в протоколе загрузки архива, если значение InvalidData будет равно False.
    Для использования механизма загрузки текстовых файлов в значении параметра(cсылка потеряна) "Загрузчики текстовых файлов" необходимо перечислить через точку с зяпятой имена файлов скриптов загрузки с полным путем (например, без кавычек "c:\scripts\sample.vbs;c:\scripts\loadform127.vbs;c:\scripts\loadform128.vbs"). Тогда, если файл проходит преобразование (переменная InvalidData после завершения очередного скрипта равна False), то произойдет дальнейшая загрузка результата разбора, как xml-документа из пункта 1. Скрипты загрузки перебираются последовательно.
  6. рабочая книга Microsoft Excel. Для этого необходимо разработать скрипт загрузки рабочей книги Excel на языке прграммирования VBScript. Пример скрипта можно посмотреть здесь(cсылка потеряна). Внутри скрипта доступны следующие объекты:
    • WorkBook объект-рабочая книга. Сведения об интерфейсе объекта можно подчерпнуть в справочнике по Microsoft Excel VBA.
    • InvalidData - предопределенная переменная, по умолчанию имеет значение False. В случае, если текстовый файл не распознан алгоритмом разбора как файл правильной структуры, присвойте этой переменной значение True.
    • xml - объект xml-документа с результирующими данными.
    • DebugString - процедура принимает строковый аргумент и передает его в отладочный монитор (может использоваться для отладки)
    • SessionValue - функция принимает строковый аргумент и возвращает значение параметра сессии с именем, равным аргументу.
    • Message - процедура принимает строковый аргумент. Переданная строка будет показана пользователю в протоколе загрузки архива, если значение InvalidData будет равно False.
    Для использования механизма загрузки рабочих книг Excel в значении параметра(cсылка потеряна) "Загрузчики рабочих книг Excel" необходимо перечислить через точку с зяпятой имена файлов скриптов загрузки с полным путем (например, без кавычек "c:\scripts\sample.vbs;c:\scripts\loadform127.vbs;c:\scripts\loadform128.vbs"). Тогда, если файл проходит преобразование (переменная InvalidData после завершения очередного скрипта равна False), то произойдет дальнейшая загрузка результата разбора, как xml-документа из пункта 1. Скрипты загрузки перебираются последовательно.

    Для корректной работы механизма загрузки рабочих книг Microsoft Excel необходимо установить на web-сервере Microsoft Office версии, совместимой с загружаемыми рабочими книгами, но не ниже 2000.