Документация iSZN
Параметр отчётной системы (техническая информация)
Формат записи параметра
Формат записи параметра имеет следующий вид:
{parameter.property Aspect="aspect" Format="format" Wrappers="wrappers"}
В выражении связи с первичной выборкой в случае использования произвольного SQL-выражения в первичной выборке выходного документа применяется формат:
{@ Aspect="aspect" Format="format" Wrappers="wrappers" Expression="expression"}
где:
| Наименование | Описание |
|---|---|
| parameter | Уникальное наименование параметра. |
| property | Свойство параметра. Доступные свойства определяются страницами задач-мастеров, с помощью которых задаются значения параметров. |
| aspect | Аспект использования значения параметра. |
| format | Формат вывода значения параметра. |
| wrappers | Список преобразований значения отчётной системы, разделённых запятыми. |
| expression | SQL-выражение, подставляемое в первичную выборку выходного документа. Данное выражение оформляется аналогично выражению столбца отчётной системы. |
Атрибут Aspect
Атрибут Aspect определяет способ преобразования значения параметра.
Допустимые значения:
| Значение | Описание |
|---|---|
Plain | Преобразование значения параметра в строку. |
SQL | Преобразование значения параметра в SQL-выражение. |
Атрибут Format
Атрибут Format определяет формат вывода значения параметра. Допустимые значения атрибута зависят от типа данных параметра.
В качестве значения формата вывода может быть указана строка форматирования.
Тип данных «Список идентификаторов»
Допустимые значения форматов вывода значения свойства параметра отчётной системы для типа TIntegerList (список идентификаторов):
| Значение | Описание |
|---|---|
По умолчанию. Для аспекта SQL эквивалентно IntegerList, для аспекта Plain — CommaList. |
|
CommaList | Список идентификаторов, разделённых запятыми («,»). |
IntegerList | Список идентификаторов в виде uszn.TIntegerList() (конструктора коллекции типа uszn.TIntegerList со списком идентификаторов). |
Пример:
| Значение параметра | Формат вывода | Результат |
|---|---|---|
| 1 | CommaList | 1 |
| Список: 1,2,3 | CommaList | 1,2,3 |
| Список: 1,2,3 | IntegerList | uszn.TIntegerList(1,2,3) |
Тип данных «Региональный ключ»
Допустимые значения форматов вывода значения свойства параметра отчётной системы для типа TRegionalKey (региональный ключ):
| Значение | Описание |
|---|---|
По умолчанию. Для аспекта SQL эквивалентно RgnKey, для аспекта Plain — HyphenKey. |
|
ID | Идентификатор. |
RegionID | Идентификатор района. |
Slurp | Slurp-ключ (RegionID x 1000000 + ID). |
RgnKey | Региональный ключ в виде uszn.TRgnKey() (конструктора объекта типа uszn.TRgnKey с региональным ключом. |
CommaKey | Региональный ключ в виде «(RegionID, ID)». |
CommaKeyRev | Региональный ключ в виде «(ID, RegionID)». |
HyphenKey | Региональный ключ в виде «RegionID-ID», где под RegionID отводится 3 обязательных цифры. |
Пример:
| Значение параметра | Формат вывода | Результат |
|---|---|---|
RegionID=102, ID=1 | ID | 1 |
RegionID=102, ID=1 | RegionID | 102 |
RegionID=102, ID=1 | Slurp | 102000001 |
RegionID=102, ID=1 | RgnKey | uszn.TRgnKey(1,102) |
RegionID=102, ID=1 | CommaKey | (102,1) |
RegionID=102, ID=1 | CommaKeyRev | (1,102) |
RegionID=102, ID=1 | HyphenKey | 102-1 |
Тип данных «Список региональных ключей»
Допустимые значения форматов вывода значения свойства параметра отчётной системы для типа TRegionalKeyList (список региональных ключей):
| Значение | Описание |
|---|---|
По умолчанию. Для аспекта SQL эквивалентно RgnKeyList, для аспекта Plain — HyphenKeyList. |
|
CommaIDList | Список идентификаторов, разделённых запятыми («,»). |
CommaRegionIDList | Список идентификаторов районов, разделённых запятыми («,»). |
CommaSlurpList | Список Slurp-ключей, разделённых запятыми («,»). |
RgnKeyList | Список региональных ключей в виде uszn.TRgnKeyList() (конструктора коллекции типа uszn.TRgnKeyList со списком региональных ключей). |
CommaKeyList | Список региональных ключей в виде «(RegionID1,ID1),(RegionID2,ID2),...». |
CommaKeyListRev | Список региональных ключей в виде «(ID1,RegionID1),(ID2,RegionID2),...». |
HyphenKeyList | Список региональных ключей в виде «RegionID1-ID1,RegionID2-ID2,...», где под RegionID отводится 3 обязательных цифры. |
IDList | Список идентификаторов в виде uszn.TIntegerList() (конструктора коллекции типа uszn.TIntegerList со списком идентификаторов). |
RegionIDList | Список идентификаторов районов в виде uszn.TIntegerList() (конструктора коллекции типа uszn.TIntegerList со списком идентификаторов районов). |
Пример:
| Значение параметра | Формат вывода | Результат |
|---|---|---|
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | CommaIDList | 1,2 |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | CommaRegionIDList | 102,103 |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | CommaSlurpList | 102000001,103000002 |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | RgnKeyList | uszn.TRgnKeyList(uszn.TRgnKey(1,102), uszn.TRgnKey(2,103)) |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | CommaKeyList | (102,1),(103,2) |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | CommaKeyListRev | (1,102),(2,103) |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | HyphenKeyList | 102-1,103-2 |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | IDList | uszn.TIntegerList(1,2) |
Список: RegionID1=102, ID1=1, RegionID2=103, ID2=2 | RegionIDList | uszn.TIntegerList(102,103) |