АВТОМАТИЗИРОВАННАЯ СИСТЕМА
РАСЧЁТОВ ЗА УСЛУГИ СВЯЗИ
«Fastcom»

версия 12

Руководство программиста

Разработка исходного файла отчёта

Всего страниц - 19

Содержание

Термины        3

Назначение        3

Введение        3

Типы отчётов        3

Параметры отчётов        4

Шаблонные отчёты        4

Неформатированные отчёты в формате HTML        5

Форматированные отчёты        5

Заключение        5


Термины

    АСР - Автоматизированная система расчётов Fastcom 12. Администратор АСР - Лицо, осуществляющее надзор над работой АСР с целью обеспечения ее правильного функционирования, и наделенное правами разграничения доступа пользователей к функциям АСР. Пользователь АСР - Лицо, наделённое определёнными правами доступа к объектам АСР и обеспечивающее с помощью АРС выполнение технологического процесса по предоставлению абонентам услуг связи. Абонент - Потребитель, заключивший договор на услугу связи на определённое время и по фиксированной цене. Клиент - Субъект, с которым предприятие заключило или намерено заключить договор об оказании услуг связи. Отчёт - Документ, формируемый из АСР, и содержащий итоговую информацию, предназначенный для анализа полученных данных или печати. Параметр контента - Параметр, значение которого может изменяться в процессе работы с АСР в зависимости от контекста.

Назначение

Настоящий документ предназначен для сотрудников служб оператора связи, в задачи которых входит разработка отчётных форм, и владеющих программными средствами редактирования текстовых файлов, а также языком SQL-запросов и языком Oracle PL/SQL.

НЕ нашли? Не то? Что вы ищете?

Введение

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

Разработанный отчёт должен быть отнесён к одному из типов, поддерживаемых АСР.

Типы отчётов

В зависимости от метода приведения данных, хранящихся в БД, к формату выходных данных отчёта, отчёты для печати относятся к следующим типам:

    HTM-отчёты относятся к виду  «шаблонных», т. е. отчётов, исходный файл которых имеет формат HTML и представляет собой текстовый шаблон, в отдельных местах которого имеются ссылки на переменные контента, вычисляемые по определённым правилам. Такой отчёт не содержит табличной части, т. к. позволяет отобразить данные только одного объекта, того самого, который передан в отчёт в качестве параметра. RTF-отчёты, относятся к виду  «шаблонных», т. е. отчётов, исходный файл которых имеет формат RTF и представляет собой текстовый шаблон, в отдельных местах которого имеются ссылки на переменные контента, вычисляемые по определённым правилам. Такой отчёт не содержит табличной части, т. к. позволяет отобразить данные только одного объекта, того самого, который передан в отчёт в качестве параметра. SQL-отчёты – отчёт, данные которого могут быть представлены в текстовом формате с разделителями или в формате HTML. Данные сохраняются в кодировке WIN. Такие отчёты содержат данные об одном или нескольких однотипных объектах, отобранных в соответствии с заданными для отчёта условиями. Исходный файл для таких отчётов представляет собой скрипт для выполнения в Oracle SQL*Plus, содержащий набор SQL-команд для отбора,  преобразования и сортировки выводимых данных. Кроме того, скрипт должен содержать команды для создания файла, предназначенного для сохранения полученных данных. Как правило, для таких отчётов не требуется визуальное форматирование данных, в т. ч. разбивка на страницы, поэтому они используются, в первую очередь, для потребления в пределах предприятия. SQLDOS-отчёты похожи на SQL-отчёты, только с той разницей, что готовые данные сохраняются в файле в кодировке DOS. REP-отчёты представляют собой документы, форма которых регламентируется Законами, Положениями, Приказами и пр., и/или требующие специального оформления, в т. ч. разбивку на страницы или особое расположение данных на странице. Такие отчёты могут содержать данные как об одном объекте, так и о нескольких объектах. Исходный файл для отчёта такого типа имеет расширение RDF и обрабатывается с помощью средства разработки отчётов Oracle Report. Готовый отчёт может выводиться на печать сразу по мере его формирования, либо предварительно показан на экране рабочей станции пользователя без возможности изменения полученных данных, а затем выведен на печать или сохранён в одном из возможных форматов: PDF, RTF или HTML. XML-отчёты представляют собой документы, в которых исходные данные сохраняются в формате XML, и далее приводятся к требуемому формату путём применения преобразований XSLT. Отчёты этого типа  подробно описаны в документе «Руководство программиста. Отчёты XML».

Параметры отчётов

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

    Параметры контента, значения которых зависят от состояния АСР в момент формирования отчёта1. Входные параметры отчёта, значение которых пользователь может ввести непосредственно перед вызовом отчёта, либо в отчёт передаётся их значение по умолчанию. Входные параметры влияют на условия отбора данных для отчёта, а также
    передаются некоторые изменяемые значения. Входные параметры могут быть «видимые» и «невидимые».

«Видимые» параметры отображаются непосредственно перед выполнением отчёта. В отображённом списке пользователь АСР может подтвердить предлагаемые значения по умолчанию, либо изменить предлагаемое значение на другое значение. Введённые значения используются в отчёте, но не сохраняются. При повторном выполнении отчёта значения параметров необходимо ввести заново. «Видимыми» пара­метрами, как правило, бывают: дата начала/окончания периода отбора данных для отчёта и др.

«Невидимые» параметры используются для передачи в отчёт значений этих параметров по умолчанию: значений параметров контента, вычисленных в сессии пользователя, значений, для которых в АСР нет соответствующей сущности и др.

Шаблонные отчёты

Шаблон отчёта определяет способ, порядок и форму представления данных в отчёте. Средства и спо­собы разработки шаблонов различаются в зависимости от вида отчёта.

Для разработки «шаблонных» отчётов может применяться приложение Microsoft Word или любой HTML-редактор. Чтобы создать шаблон отчёта, в общем случае необходимо выполнить следу­ющие действия:

Набрать неизменяемый текст отчёта. В нужные места шаблона вставить коды параметров, значения которых будут передаваться в отчёт из АСР или вводиться пользователем. Можно использовать параметры контента или входные параметры отчёта.

Коды входных параметров отчёта изначально определяются в шаблоне. Чтобы они корректно обрабатывались при формировании отчёта, необходимо указать их в настрой­ках параметров отчёта.

При вставке кода параметра необходимо соблюдать следующие правила:

    Коды параметров должны быть набраны в верхнем регистре Шрифт, размер, яркость и другие свойства текста не должны меняться внутри кода
    параметра. Коды параметров должны быть справа и слева окружены группами специальных
    символов. Группы символов, которые будут использоваться в каждом конкретном
    отчёте, необходимо указать в качестве значений входных параметров отчёта R_TAG и L_TAG. Рекомендуется использовать соответственно значения qqq и ppp.
Сохранить шаблон в формате HTML в кодировке «Кириллица» в каталоге %FASTCOM_HOME%/REP. Имя файла рекомендуется вводить в верхнем регистре. В дальнейшем для редактирования шаблона можно использовать Microsoft Word или любой HTML-редактор.

В качестве примера шаблона «плоского» отчёта можно использовать шаблон договора, который хранится в каталоге %FASTCOM_HOME%/REP/CT DOGOV1.htm

Примером «шаблонного» отчёта является текст договора на услуги связи. Он содержит данные об условиях заданного договора, причём некоторые данные, например, наименование абонента,  могут вычисляться  на неизменный текст, в который включены изменяемые параметры: номер договора, наименование клиента и т. д.

Неформатированные отчёты в формате HTML

Шаблоны неформатированных отчётов хранятся в каталоге %FASTCOM_HOME%/REP в виде файлов с расширением SQL.

Форматированные отчёты

Шаблоны форматированных отчётов разрабатываются с помощью средства OracleReport. В шаблонах могут использоваться параметры контента и входные параметры отчёта. Коды входных параметров отчёта изначально определяются в шаблоне отчёта. Чтобы они корректно обрабатывались, необходимо указать их в настройках отчёта (см. 10.1.4.2).

Шаблоны форматированных отчётов хранятся в каталоге %FASTCOM_HOME%/REP в виде файлов с расширением REP.

Примеры: счета, различные акты.

Заключение

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

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

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