Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции,...

103
1 Функции, методы, свойства и объекты Паруса-7 используемые в шаблонах печатных форм Справочник 2008

Transcript of Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции,...

Page 1: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

1

Функции, методы, свойства и объекты Паруса­7 

используемые в шаблонах печатных форм

Справочник

2008

Page 2: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

2

Содержание

Askdate.................................................................................................................................................5Calcmonthes.........................................................................................................................................5ClearRange..........................................................................................................................................5CMonthR.............................................................................................................................................5Dox......................................................................................................................................................6Fget......................................................................................................................................................6FgetDict...............................................................................................................................................6FgetRNDict.........................................................................................................................................7GetAnkfio............................................................................................................................................7Getourorgrn.........................................................................................................................................7GetOutSum..........................................................................................................................................8GetRank................................................................................................................................................8GetRankName.......................................................................................................................................8IHIST...................................................................................................................................................9InSpis_LastRN...................................................................................................................................11Inv_OutPrim.......................................................................................................................................11IsCyr...................................................................................................................................................11Nm_month.........................................................................................................................................12oSystem..............................................................................................................................................12Person_PAD.......................................................................................................................................12Print0s................................................................................................................................................13RPC....................................................................................................................................................13Rp_NDS_TaxRate..............................................................................................................................14Rtrim_Acc..........................................................................................................................................14setAlignment.......................................................................................................................................14setBorder.............................................................................................................................................15setFont.................................................................................................................................................15This.__AnAccount..............................................................................................................................15This.__Dig2Text..................................................................................................................................16This.__GetAccDic...............................................................................................................................16This.__GetBankRek............................................................................................................................17This.__GetINum..................................................................................................................................17This.__GetMeasure.............................................................................................................................18This.__GetOrgAddressShort...............................................................................................................18This.__GetOrgBaseAddress................................................................................................................18This.__GetOrgName...........................................................................................................................19This.__GetRate...................................................................................................................................19This.__GetSub....................................................................................................................................20This.__GetTaxSum.............................................................................................................................20

Page 3: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

3

This.__KillWhiteSpace.......................................................................................................................21This.ListName.....................................................................................................................................21This.__MakeAcc.................................................................................................................................21This.Month2Text.................................................................................................................................21This.SaveClipBoard............................................................................................................................22This.SavePageSetup............................................................................................................................22This.Seek_TableFields........................................................................................................................22This.__Srok.........................................................................................................................................23This.__StrRound.................................................................................................................................23This.__SumExpression.......................................................................................................................23This.__UPrice.....................................................................................................................................24WordLine............................................................................................................................................24Функции и методы Formula OneDeleteSheets .......................................................................................................................................25InsertSheets.........................................................................................................................................25SetRowHidden....................................................................................................................................25SheetName..........................................................................................................................................26Методы печати Настраиваемых форм пользователейThisForm.ThisFormData.NU()..........................................................................................................27ThisForm.ThisFormData.SPI_NU()...................................................................................................33ThisForm.ThisFormData.TAXSUM()...............................................................................................39ThisForm.ThisFormData.Tarif()........................................................................................................43ThisForm.ThisFormData.TarifDol()..................................................................................................46ThisForm.ThisFormData.TarifP()......................................................................................................48ThisForm.ThisFormData.SSC().........................................................................................................51ThisForm.ThisFormData.Workh().....................................................................................................53ThisForm.ThisFormData.NewDol()...................................................................................................54ThisForm.ThisFormData.DolSta().....................................................................................................54ThisForm.ThisFormData.CheckFunc()..............................................................................................55ThisForm.ThisFormData.TarifOrder()...............................................................................................56ThisForm.ThisFormData.TarifDolOrder().........................................................................................58ThisForm.ThisFormData.Seek_TableField().....................................................................................58ThisForm.ThisFormData.Locate_TableField()..................................................................................59ThisForm.ThisFormData.StatObr()....................................................................................................59ThisForm.ThisFormData.WTD().......................................................................................................62ThisForm.ThisFormData.WTH().......................................................................................................63Полезные свойства объекта доступа к данным для печати ThisForm.ThisFormData..............64ThisForm.ThisFormData.ObSolver....................................................................................................65ThisForm.ThisFormData.MakeColNU()...........................................................................................65ThisForm.ThisFormData.PodrNames()..............................................................................................68ThisFormData.Spi_…()......................................................................................................................68

Page 4: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

4

ThisForm.ThisFormData.Ord_Osn()..................................................................................................71ThisForm.ThisFormData.WTDP().....................................................................................................71ThisForm.ThisFormData.WTHP().....................................................................................................72ThisForm.ThisFormData.WTDN()....................................................................................................73ThisForm.ThisFormData.WTHN()....................................................................................................74ThisForm.ThisFormData.SPI_WTD()...............................................................................................75ThisForm.ThisFormData.SPI_WTH()...............................................................................................76ThisForm.ThisFormData.Stazh().......................................................................................................77ThisForm.ThisFormData.TarifLst()...................................................................................................78ThisForm.ThisFormData.EducPrint()................................................................................................79ThisForm.ThisFormData.KvKat()......................................................................................................81ThisForm.ThisFormData.SVNU().....................................................................................................82ThisForm.ThisFormData.MakeColSVNU()......................................................................................84ThisForm.ThisFormData.SVSPI_NU()..............................................................................................87ThisForm.ThisFormData.PersNumb()...............................................................................................90ThisForm.ThisFormData.BankRecvPrint()........................................................................................91ThisForm.ThisFormData.AnkChInfo()..............................................................................................92ThisForm.ThisFormData.DopInf().....................................................................................................92ThisForm.ThisFormData.StoGet().....................................................................................................93ThisForm.ThisFormData.MakeColTarif().........................................................................................94ThisForm.ThisFormData.MakeColTarifDol()...................................................................................96ThisForm.ThisFormData.GetTrDog()................................................................................................98ThisForm.ThisFormData.AddressPrint()...........................................................................................98ThisForm.ThisFormData.ContrAgentPrint()....................................................................................100ThisForm.ThisFormData.Count_Table()..........................................................................................102ThisForm.ThisFormData.Month2Text()...........................................................................................103ThisForm.ThisFormData.Rp_Str()...................................................................................................103ThisForm.ThisFormData.GetOrdLeav()..........................................................................................103

Page 5: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

5

Askdate

Функция выводит на экран стандартную форму Паруса установки даты и  возвращает заданную на этой форме дату.Синтаксисaskdate (clbltext, cformtext, ddefdate, lnotempty)  где clbltext  текст на форме, слева от датыcformtext  заголовок формыddefdate  инициализирующее выражениеlnotempty  признак обязательности параметраПримерaskdate("Задайте дату аттестата","Дата аттестата",oSystem.Date,.T.)

Calcmonthes

Выводит количество месяцев между двумя указанными датами.Синтаксисcalcmonthes(ddate1, ddate2, lround)гдеddate1, ddate2 – даты между которыми расчитывается количество месяцевlround – логический параметр, указывающий стоит ли округлять количество месяцев, если значение параметра ИСТИНА то округление происходит. Если параметр опущен то его значение принимается за ЛОЖЬ. Примерыcalcmonthes(date(2008,1,1),date(2008,2,20),.T.)возвращает 2calcmonthes(date(2008,1,1),date(2008,2,20))возвращает 1

ClearRangeФункция ClearRange обеспечивает очистку области.Синтаксис:This.ClearRange(CRangeName, nType)Где:CRangeName – имя области, которую нужно очистить.nType – параметр, указывающий что нужно очистить в области. Возможные значения: 1 – все; 2 – форматирование; 3 – значения и формулы.

CMonthR

Возвращает месяц пропись. Полностью аналогична функции This.Month2Text.СинтаксисCMonthR(nMonth, nPadez)гдеnMonth – номер месяца, число от 1 до 12nPadez – падеж в котором надо выводить месяц. Может принимать 2 значения: 1 – именительный, 2 – родительлный. Пример:CMonthR(3,1)

Page 6: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

6

возвращает Март  

DoxФункция возвращает различные даты относительно указанной даты.СинтаксисDox (ddate, ntype)где ddate – искомая датаntype – возвращаемое значение 

Возвращаемое значение Описание123456

Первое число года.Последнее число года.Первое число месяца.Последнее число месяца.Первое число квартала.Последнее число квартала.

Примерыdox(date(2008,5,5),6)30.06.2008dox(date(2008,5,5),5)01.04.2008dox(date(2008,5,5),4)31.05.2008dox(date(2008,5,5),3)01.05.2008dox(date(2008,5,5),2)31.12.2008dox(date(2008,5,5),1)01.01.2008

FGet

Fget(Имя)– возвращает значение поля таблицы базы данных.Где:Имя ­ символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой, например:Fget("EOPBASE.DATE_DOC")

FgetDict

FGetDict(Имя1; Имя2; Имя3) ­ возвращает значение поля таблицы словаря.

Где:

Имя1, Имя2 и Имя3 ­ символьные выражения, состоящие из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой. Имя3 задавать необязательно.

Page 7: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

7

По указанному в Имя1 адресу функция получает значение индексного выражения, по которому производится позиционирование в таблице, указанной в Имя2. Если Имя3 не задано, то возвращается значение поля, указанного в Имя2. Если задано, то полученное значение используется в качестве индексного для позиционирования во вторичном словаре, указанном в Имя3. В этом случае функция возвращает значение поля, указанного в Имя3. Пример:FGetDict("EOPSPEC.RN_CURR";"CURRBASE.ISO")

FGetRNDict

FGetRNDict(RN;Имя) ­ Возвращает значение поля таблицы словаря.Где:RN ­ символьное выражение, используемое функцией в качестве индексного выражения для позиционирования в словаре, указанном в параметре Имя.

Имя ­ символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой.

Используя в качестве индексного выражение, заданное параметром RN, функция производит позиционирование в словаре (таблице базы данных), указанном в параметре Имя и возвращает значение указанного там же поля. Пример:

FGetRNDict(Fget("EOPSPEC.RN_CURR"); "CURRBASE.ISO")

Примечание. Для использования функций FGET, FGETDICT, FGETRNDICT в шаблонах отчетов и документов, к шаблону необходимо подключить библиотеку Formula.xls. Данная библиотека входит в поставку Системы. О том, как ее подключить к шаблону, смотрите в книге "Специальные средства Системы" (глава 6, раздел "Ошибка! Источник ссылки не найден.").

GetAnkfio

Функция возвращает полное ФИО сотрудникаСинтаксисGetAnkfio(cAnk_rn)где cAnk_rn – ссылка на rn сотрудника в таблице zAnkПримерgetankfio(zank.ank_rn)

Getourorgrn

Функция возвращает мнемокод или Rn контрагента МЫСинтаксис Getourorgrn (lmnemo)гдеlmnemo – логический параметр, если его значение ИСТИНА, то функция возвращает мнемокод контрагента, если ЛОЖЬ – его Rn. Если параметр опущен его значение равно ЛОЖЬ.

Page 8: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

8

GetOutSum

Функция возвращает цену списания инвентарного объекта при его списании (или выбытии) из состава групповой карточки.Синтаксис:GetOutSum (cRN)где: cRN – ссылка на объект в составе групповой инвентарной карточки.Пример использования:В шаблоне "Инвентарная карточка ОС­9" параметр cRN имеет значение crInSpis. Нулевое значение цены вызывает сообщение Системы об ошибке.

GetRank

Функция  возвращает признак наличия звания у сотр и позиционируется на соответствующей записи.Синтаксис:GetRank (<RN сотрудника>, <дата>)Функция содержит два параметра:1). RN сотрудника (например ORGBASE_RN).2).  Дата. Функция  будет  искать  звание,  действующее  на  указанную  дату.  По  умолчанию  параметр  принимает значение текущей даты.Пример:GetPostName(ZANK.ORGBASE_RN)   –   возвращает   логическое   значение   наличия   на   текущую  дату   звания  у указанного   сотрудника.   Если   звание   есть,   то   получить   информацию   о   его   параметрах   можно   из   базы ZANKRANK, в которой функция позиционируется.

GetRankName

Возвращает параметры звания сотрудника.

Синтаксис:

GetRankName (<RN контрагента>, <возвращаемое значение>, <дата>, <признак успешного поиска>)

Функция содержит четыре параметра:

1). RN контрагента (например, ORGBASE_RN).

2). Возвращаемое значение. По умолчанию параметр принимает значение “и”.

Возвращаемое значение Описание“и”“р”“д”“в”“т”“п”“ис”“рс”

Полное наименование в именительном падежеПолное наименование в родительном падежеПолное наименование в дательном падежеПолное наименование в винительном падежеПолное наименование в творительном падежеПолное наименование в предложном падежеСокращенное наименование в именительном падежеСокращенное наименование в родительном падеже

Page 9: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

9

“дс”“вс”“тс”“пс”“ст”“кз”“кр”

Сокращенное наименование в дательном падежеСокращенное наименование в винительном падежеСокращенное наименование в творительном падежеСокращенное наименование в предложном падежеСтавкаЗначение коэффициентаРазмерность коэффициента

3). Дата. На указанную дату будет определяться хроникальное звание сотрудника.

4). Признак успешного поиска.  Устанавливается при наличии хроникального звания на указанную дату.

Пример:

GetRankName(ZANK.ORGBASE_RN, "и", oSystem.Date) – возвращает на текущую дату наименование звания указанного сотрудника в именительном падеже.

IHIST

Функция возвращает суммы из истории операций инвентарных карточек. Какие суммы и из каких карточек определяется заданными параметрами функции. Все параметры функции, кроме первого, необязательные. Если параметр не задан, подставляется его значение по умолчанию. Параметры, код которых начинается с символа "C" – символьные; с символа "N" – числовые.В качестве параметров могут быть использованы предопределенные константы, которые указываются в формулах в окне условий выполнения дополнительной функции "Перенос сведений о налоговом учете" инвентарной картотеки.

Синтаксис:

IHIST (nTypeOper; nBuhgNalog; dDateS; dDatePo; cAcc; cTypeKart; cMOL; cGruppa; cInvNomer; cNomerKart; cBudgOrg; cArtikul; cNalogGrup; nObjSost; nTaxSost; nTypeSum; nDoPosle; cMes), 

Где:

nTypeOper – Тип операции по инвентарной карточке (обязательный параметр);nBuhgNalog – Суммы из истории операций по бухгалтерскому учету или по налоговому учету: 0 ­ по бухгалтерскому учету (значение по умолчанию); 1 ­ по налоговому учету;dDateS – Дата с:...;dDatePo – Дата по:...;cAcc – Счет учета инвентарного объекта;cTypeKart – Тип инвентарной карточки;cMOL – МОЛ;

cGruppa – Номер группы;cInvNomer – Инвентарный номер;cNomerKart – Номер карточки;cBudgOrg – Бюджетное учреждение;cArtikul – Артикул ТМЦ;cNalogGrup – Налоговая группа;

Page 10: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

10

nObjSost – Состояние объекта;nTaxSost – Состояние объекта по налоговому учету;nTypeSum – Тип возвращаемой суммы. Само значение представляет собой итоговую сумму по всем отобранным операциям в истории карточки.

nDoPosle – Возвращаемые значения брать по состоянию до (или после) операции: 0 ­ до операции (по умолчанию); 1 ­ после операции;cMes – Выдавать сообщение (имеет значение "!").

Параметр nTypeOper используется при отборе операций и имеет значения:

ИСТОРИЯ ОПЕРАЦИЙ ПО БУХГАЛТЕРСКОМУ УЧЕТУ1 ­ Ввод в эксплуатацию;2 ­ Списание;3 ­ Амортизация;4 ­ Переоценка;5 ­ Внутреннее перемещение;6 ­ Перевод в консервацию;7 ­ Вывод из консервации;8 ­ Реконструкция, дооценка, порча;9 ­ Капитальный ремонт;10 ­ Уменьшение стоимости объекта;11 ­ Выбытие из состава групповой карточки;12 ­ Списание из состава групповой карточки;13 ­ Поступление из состава групповой карточки;14 ­ Внутреннее перемещение из состава групповой карточки;15 ­ Поступление из состава групповой карточки в связи с внутренним перемещением;16 ­ Исправительная операция.ИСТОРИЯ ОПЕРАЦИЙ ПО НАЛОГОВОМУ УЧЕТУ2 ­ Списание;3 ­ Амортизация;12 ­ Выбытие из состава групповой карточки;13 ­ Списание из состава групповой карточки;14 ­ Внутреннее перемещение из состава групповой карточки.

Параметр nObjSost используется при отборе карточек и имеет значения:

1 ­ Все (по умолчанию);2 ­ Введен в эксплуатацию;3 ­ Находится в эксплуатации;4 ­ Не введен в эксплуатацию;5 ­ Выбыл из эксплуатации;6 ­ Все, кроме выбывших из эксплуатации.

Параметр nTaxSost используется при отборе карточек, и имеет значения:

1 ­ Все (по умолчанию);2 ­ Списан;3 ­ Не списан.

Page 11: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

11

Параметр nTypeSum ­ числовой. По умолчанию 0.

0 ­ Сумма операции (по умолчанию);1 ­ Начальная стоимость;2 ­ Начальный износ;3 ­ Начисленная амортизация (износ);4 ­ Остаточная стоимость;9 ­ Расчетная остаточная стоимость;31 ­ Сумма амортизации на восстановление;32 ­ Сумма амортизации на пробег (объем продукции);33 ­ Сумма амортизации (дополнительные начисления).

Параметр "Счет" можно задавать с использованием маски счетов. (символа *). Расчет при этом будет произведен по группе счетов.

InSpis_LastRN

Функция возвращает RN определенного инвентарного объекта из состава групповой инвентарной карточки: этот объект не должен быть выбывшем и дата его регистрации должна быть наиболее близка к дате совершения операции по инвентарной карточке (из предшествующих дат).Синтаксис:InSpis_LastRN (cAlias)где: cAlias – имя курсора, в котором находится информация по групповому составу инвентарной карточки;Пример использования:В шаблоне "Инвентарная карточка ОС­9" параметр cAlias имеет значение "crInSpis". Значение RN можно использовать в качестве аргумента функции GetOutSum.

Inv_OutPrim

Функция возвращает причину списания (или выбытия) инвентарного объекта.Синтаксис:Inv_OutPrim (vInBase.RN)где: vInBase.RN – ссылка на инвентарную карточку, по которой объект зарегистрирован.Пример использования:Inv_OutPrim (vInBase.RN)

IsCyr

Функция проверяет есть ли в заданном символьном выражении символы кириллицы. Если есть хотя бы один некириллический символ (латинский, цифра) функция возвращает ЛОЖЬСинтаксисIsCyr(cStr)гдеcStr – проверяемое символное выражениеПримерыIsCyr(«Б»)    Функция возвращает ИСТИНУIsCyr(«Б1»)    

Page 12: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

12

Функция возвращает ЛОЖЬ

Nm_month

Функция возвращает название месяца на русском языке в именительном падеже.Синтаксис:nm_month(Дата)где: Дата – календарная дата, название месяца которой возвращается.Пример использования функции:nm_month(m.dDateTo). Например, значение переменной m.dDateTo равно 01/06/99. Функция возвращает значение июнь.

Глобальный объект oSystem

Это универсальная переменная (ее имя oSystem), которая может быть использована как в шаблонах документов, так и в шаблонах отчетов. Использование глобального объекта производится через его свойства. Имя конкретного свойства записывается после имени глобального объекта, через точку.

oSystem.Date – возвращает текущую календарную дату Системы.oSystem.CurrISO – возвращает международный код базовой валюты Системы в стандарте ISO.oSystem.CurrRN – ссылка на базовую валюту.oSystem.OwnerOrgRN – ссылка на контрагента "Мы" – контрагента, в качестве которого в документах фигурирует организация ­ владелец базы данных.oSystem.LICORGINN – ИНН контрагента указанного в лицензииoSystem.LICORGNAME – наименование контрагента указанного в лицензииoSystem.MAXUSERS – максимальное количество пользователей по лицензии для текущего модуляoSystem.SYSTEMCAPTION – наименование текущего модуляoSystem.FOXPATH – путь к папке Fox текущего модуляoSystem.HELPPATH ­ путь к папке Help текущего модуляoSystem.MEMPATH ­ путь к папке Mem текущего модуляoSystem.TMPLTPATH ­ путь к папке Template текущего модуляoSystem.DBFPATH – путь к текущей базе данных

Person_PAD

Функция обеспечивает склонение имен и фамилий контрагентов ­ физических лиц (например, при формировании печатной формы документа в Microsoft Excel).

Функция используется в шаблонах документов.

Синтаксис:Person_PAD (cRN, cPadeg, cFIO)где: cRN – Ссылка на запись в таблице PERSON (таблица базы данных, содержащая записи о контрагентах ­ физических лицах).cPadeg – Падеж ("и", "р", "д", "в", "т", "п"). Текстовый параметр, необязательный. По умолчанию используется именительный падеж ("и").cFIO – Информация, возвращаемая функцией: "ф" ­ фамилия, "и" ­ имя, "о" ­ отчество и комбинации "фио", "ио", "иоф" и т.п. Текстовый параметр, необязательный. По умолчанию используется "фио".

Page 13: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

13

Примечания. 

Значения параметров cPadeg, cFIO вводятся русскими буквами и заключаются в кавычки.Если запись о контрагенте не найдена в таблице PERSON, будет осуществлен поиск в таблице ORG (таблица базы данных, содержащая записи о контрагентах ­ юридических лицах). Если в этой таблице будет найдена соответствующая запись, то функция возвратит название контрагента без склонения. Если и в таблице ORG запись не будет найдена, то будет возвращена пустая строка.

Пример использования:

Выражение __p_orgname = person_pad (vCash.RN_ORG_FR,"р") возвращает ФИО контрагента в родительном падеже.

Print0s

Управляющее свойство. Определяет будут ли в отчете выводиться нулевые значения сумм. Если задать значение .F., то нулевые значения сумм не будут выведены в отчет, если значение .T. (значение по умолчанию) – то в отчет будут выведены и нулевые значения.Действие свойства с определенным значением распространяется на все области отчета, следующие за той областью, в которой свойство введено (включая и эту область) и до тех пор пока не введено свойство с противоположным значением.

Действие свойства распространяется только на данные типа Numeric (Числовой). Синтаксис:This.print0sПример использования:This.print0s = .F.Примечание. В имени свойства стоит цифра ноль, а не буква О.

RPC

Функция значение реквизита отчета из словаря «Реквизиты отчетов».

Синтаксис:

RPC (<мнемокод>, <дата>)

Функция содержит два параметра:

1). Мнемокод.  Мнемокод реквизита отчета из словаря.

2). Дата. Дата для определения хроникального значения реквизита. Не обязательный параметр.

Алгоритм:

Функция по заданному мнемокоду осуществляет поиск реквизита в словаре. Если запись не найдена, функция возвращает   пустую   строку.  В   противном   случае,   если   задана   дата,   осуществляется   поиск   хроникального интервала, соответствуюещего этой дате. Если запись найдена, обрабатывается значение реквизита, заданное в хроникальных свойствах. Если запись не найдена или дата не была задана, обрабатывается значение реквизита, заданное в основных свойствах.

Page 14: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

14

Примечание:

Алгоритм работы с параметрами реквизита не изменился, но при работе с функцией  RPC(), параметры должны быть заключены в круглые скобки сразу за мнемокодом, как это указано в нижеследующем примере.

Пример:

RPC(“ФИО кассира”,  oSystem.Date) – осуществит поиск реквизита с мнемокодом “ФИО кассира” и поиск его хроникального   значения  на  текущую  дату.  Если  поиск  будет  удачным,  вернет  обработанное   значение  этого реквизита.

RPC(“ФИО  кассира(р)”)   –  осуществит  поиск   реквизита   с  мнемокодом   “ФИО   кассира”.  Если   поиск   будет удачным, вернет обработанное значение этого реквизита с учетом переданного параметра «р».

Rp_NDS_TaxRate

Cлужебная переменная, возвращает значение ставки НДС по позиции спецификации счета­фактуры, на дату регистрации счета­фактуры.Пример:В шаблоне входящего счета­фактуры, в выражении для поля "Ставка НДС" вместо выражения:Allt(Transform(vsfispec.sfiS_NDS_TAX,__p_Mask))можно записать выражение:Allt(Transform(rp_NDS_TaxRate,__p_Mask)).Примечание. В данном примере Allt и Transform стандартные функции Foxpro, __p_Mask – переменная, содержащая значение маски.

Rtrim_Acc

Функция обрезает пробелы и точки в текстовой переменной (справа).Синтаксис:Rtrim_Acc(cStr)где: cStr – текстовая переменная.Пример использования:Выражение __p_analit = Rtrim_Acc ( Make_Acc ("1", crDKOst.Acc1, crDKOst.Acc2, crDKOst.Acc3, crDKOst.Acc4, crDKOst.Acc5)) возвращает номер счета и его аналитических счетов без концевых точек, например: для счета 19.12... будет возвращено 19.12

setAlignment

Функция setAlignment обеспечивает выравнивание данных в ячейке (ячейках) отчета.Синтаксис:This.setAlignment(nHAlign, IWordWrap, nVAlign, [cRangeName])Где:nHAlign – выравнивание по горизонтали: 1­по значению, 2­по левому краю, 3­по центру, 4­по правому краю, 5­с заполнением, 6­по ширине, 7­по центру выделения.LWordWrap – перенос по словам. Если значение параметра .T. – то перенос по словам будет работать, если значение параметра .F. – то не будет.NVAlign – выравнивание по вертикали: 1­по верхнему краю, 2­по центру, 3­по нижнему краю.

Page 15: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

15

СRangeName – имя области, для которой производится выравнивание. Параметр необязательный. Если имя области не задано, то операция выполняется для всей области отчета, в которой вызван метод.Пример выражения.This.SetAlignment(3, .T., 1, "ИтогХО_Всего"). Данные в области отчета с именем "ИтогХО_Всего" по горизонтали будут выравнены по центру, по вертикали – по верхнему краю. При выводе данных в эту область будет осуществляться (при необходимости) перенос по словам.

setBorder

Функция setBorder обеспечивает обрамление ячейки (группы ячеек) отчета.Синтаксис:This.setBorder(nOutLine, nLeft, nRight, nTop, nBottom, [cRangeName])Где:nOutLine ­ тип линии рамки вокруг области.NLeft, nRight, nTop, nBottom ­ тип линии границы для стороны выбранной области.Указанные параметры могут иметь следующие значения: ­1­без изменений, 0­нет линии, 1­тонкая линия, 2­средняя линия, 3­штриховая линия, 4­пунктирная линия, 5­толстая линия, 6­двойная линия, 7­очень тонкая линия. Примечание. Рекомендуем при использовании параметра nOutLine значения четырех других параметров задавать равными ­1, и наоборот при использовании параметров nLeft, nRight, nTop, nBottom, значение параметра nOutLine задавать ­1.

CRangeName ­ имя области, для которой производится обрамление. Параметр необязательный. Если имя области не задано, то операция выполняется для всей области отчета, в которой вызван метод.Пример выражения.This.SetBorder( ­1, ­1, ­1, 1, ­1, "ИтогХО_Всего"). Обрамление области отчета с именем "ИтогХО_Всего" будет оставлено исходным, кроме границы сверху. Эта граница будет отображена тонкой линией.

setFontФункция setFont обеспечивает установку атрибутов шрифта.Синтаксис:This.setFont(cFontName, nSize, Ibold, Iitalic, Iunderline, Istrikeout, [cRangeName])Где:сFontName – наименование шрифта.NSize – размер шрифта (число).LBold, lItalic, lUnderline, lStrikeout – параметры, определяющие начертание шрифта. Если значения этих параметров .T., то шрифт полужирный, курсив, подчеркнутый, зачеркнутый. Соответственно значения параметров .F. – обратное начертание шрифта.CRangeName – имя области, для которой производится выбор атрибутов шрифта. Параметр необязательный. Если имя области не задано, то операция выполняется для всей области отчета, в которой вызван метод.

Пример выражения.This.SetFont("Arial", 10, .T., .F.,.F., .F., "ИтогХО_Всего"). Данные в области шаблона с именем "ИтогХО_Всего" будут выведены полужирным шрифтом Arial размером 10.

This.__AnAccount

Page 16: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

16

Функция возвращает номер счета и наименование используемых аналитических счетов этого счета.Синтаксис:This.__AnAccount(Параметр1,Параметр2)Где: Параметр1 – строка символов, содержащая имя таблицы базы данных.Параметр2 – строка символов, содержащая имя поля таблицы базы данных, в котором содержится номер счета.Пример использования функции:При выводе в Microsoft Excel акта на перемещение основных средств, функция This.__AnAccount("InBase","RN_DB") возвращает номер дебетового счета, на который отнесена начисленная амортизация. Например 20. Если в инвентарной карточке указаны также аналитические счета дебетового счета (например Ан1, Ан2, Ан3), то в печатной форме, в соответствующей графе будет стоять 20 Ан1 Ан2 Ан3.

This.__Dig2Text

Возвращает прописью значение числового выражения.Синтаксис:This.__Dig2Text(Число, Признак, Код валюты, Род, Знаки).Где:

Число ­ число (или числовое выражение). Например, сумма по документу.

Признак ­ признак необходимости выводить наименование валюты, в которой выражена сумма. Значение признака .F. – наименование валюты необходимо вывести, значение признака .T. – наименование валюты не выводить.

Код валюты ­ ссылка на цифровой код валюты, в которой выражены суммы по документу.Род ­ род считаемого предмета: 0 ­ мужской, 1 ­ женский, 2 ­ средний.Знаки ­ число знаков выводимой дробной части.

В наименовании функции, после идентификатора This. два знака "_".Пример:__p_Imfp = Iif(m.lFullFact, This.__Dig2Text (crLowItog.Kol_Fact&__p_ss, .T., , 0, 3), ""), возвращает (прописью) фактическое значение массы драгметаллов, содержащихся в инвентарном объекте. На документе это будет выглядеть, например, так:

ноль целых семь тысячныхВнимание! При округлении до целых функция корректно работает с числами, у которых количество десятичных знаков после запятой не больше 2. Следовательно в этом случае вызов функции должен быть, например, следующим This.__Dig2Text(1.99,.F.,vInvoiceHead.cur_rn) или This.__Dig2Text(Round(1.995,2),.F.,vInvoiceHead.cur_rn)

This.__GetAccDic

Возвращает RN словаря или содержимое поля словаря, связанного с заданным счетом Плана счетов или его аналитическим счетом.Функция используется только в бюджетной версии Системы.Синтаксис:This.__GetAccDic(Счет, Словарь, Анал1, Анал2, Анал3, Анал4, Анал5, Поле)Где:

Счет – cимвольное выражение, содержащее код счета Плана счетов. Может состоять из имени таблицы базы данных и имени поля этой таблицы. Задание счета обязательно. 

Page 17: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

17

Анал1, ..., Анал5 – cимвольные выражения, содержащие коды аналитических счетов пяти порядков счета Счет. В зависимости от значения параметра Словарь, может использоваться только один аналитический счет.

Словарь – число, указывающее на словарь, данные которого требуются. Возможные значения: 1 – Контрагенты; 2 – Номенклатор; 3 – Классификатор аналитических статей; 4 – Классификация доходов; 5 – Шаблон финансирования; 6 – Статья шаблона сметы; 7 – Шаблон сметы финансирования.

Напомним, что связь порядков аналитики с первыми четырьмя словарями можно установить в свойствах синтетического счета Плана счетов (см. вкладку "Порядок обработки"). К шаблону финансирования можно привязать или синтетический счет (см. вкладку "Параметры"), или аналитический счет одного из порядков. Шаблон счеты можно задать в свойствах синтетического счета. Статью расходов этого шаблона сметы можно связать с аналитическим счетом одного из порядков.

Поле – cимвольное выражение, содержащее имя поля искомого словаря. Если поле не задано, то функция возвратит RN записи словаря.

Примечание. После идентификатора This. два знака "_".

Пример:

This.__GetAccDic(curTmp.RN_DB, 1, curTmp.RN_DB_A1, curTmp.RN_DB_A2, curTmp.RN_DB_A3, curTmp.RN_DB_A4, curTmp.RN_DB_A5, "RMNEMO_ORG") возвращает содержимое поля RMNEMO_ORG записи словаря "Контрагенты", связанного со счетом, заданным переменной curTmp.RN_DB и имеющим заданную аналитику.

This.__GetBankRek

Функция возвращает банковские реквизиты контрагента.Синтаксис:This.__GetBankRek(rnAgent, rnBankAcc, @cBankName, @cBankBIC, @cBankINN)Где:rnAgent – ссылка на контрагента.rnBankAcc – ссылка на банковские реквизиты контрагента.@cBankName – наименование банка.@cBankBIC – БИК банка.@cBankINN – ИНН банка.Пример использования функции:

При выводе в Microsoft Excel платежного поручения функция This.__getBankRek(vBank.rn_org_fr,vBank.rn_rek_fr,@__p_BankName,@__p_BankBIC,@__p_BankINN) возвращает банковские реквизиты контрагента­плательщика.

This.__GetINum

Функция возвращает номер инвентарного объекта для печатной формы.Синтаксис:This.__GetINum (П1, П2, П3)Где:

П1 – счет учета инвентарного объекта;П2 – номер группы инвентарного объекта;П3 – порядковый номер внутри группы.

Page 18: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

18

Возвращаемый функцией "обобщенный" номер состоит:

• из объединения значений П2 и П3 (для печатной формы хозрасчетной версии Системы);• из объединения значений П1, П2, П3 (для печатной формы бюджетной версии Системы).

Пример. Номер счета учета 01. Номер группы 4. Порядковый номер внутри группы – 2. В печатной форме бюджетной версии Системы, в графе "Номер инвентарный" будет выведено 0140002. Выражение, формирующее этот номер, выглядит, например, следующим образом: Iif(!Empty(crInvOp.Name_Nom), This.__GetINum(crInvOp.Account, crInvOp.Group_Inv, crInvOp.InvNum), "")

This.__GetMeasure

Функция возвращает мнемокод или наименование единицы измерения номенклатуры товара.Синтаксис:This.__GetMeasure(П1, П2)Где:П1 – ссылка на позицию номенклатора.П2 – параметр логического типа: если его значение .F., то функция возвращает мнемокод единицы измерения; если значение параметра .T., то функция возвращает наименование единицы измерения. Параметр П2 необязательный. Если он не задан, то будет возвращен мнемокод единицы измерения.

Пример использования функции:

Выражение Allt(This.__GETMEASURE(curtmp_MBP.RN_Nomcl, .F.)) возвращает мнемокод единицы измерения товара.

This.__GetOrgAddressShort

Возвращает короткий адрес контрагента (название населенного пункта, улицы, номер дома и номер корпуса). Функция используется в шаблонах MS Excel ряда документов (например, счетов­фактур).Синтаксис: This.__GetOrgAddressShort (Имя, ТипРез).Где:

Имя – ссылка на контрагента: символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой.

ТипРез – символьный признак, указывающий на тип возвращаемого функцией результата (тип адреса). Этот параметр необязателен. Возможные значения: "1" – фактический адрес; "2" (значение по умолчанию) – юридический адрес; "3" – адрес для перечислений.

Примечание. После идентификатора This. два знака "_".

Пример:

This.__GetOrgAddressShort (vsfohead.orb_agto), возвращает "короткий" юридический адрес контрагента­ покупателя в исходящем счете­фактуре.

This.__GetOrgBaseAddress

Функция возвращает полный адрес контрагента (включая почтовый индекс, название страны, региона и т.д.) при печати документа. Функция используется в шаблонах Microsoft Excel ряда документов (например, счетов­

Page 19: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

19

фактур).Синтаксис: This.__GetOrgBaseAddress (Параметр1, Параметр2, Параметр3, ТипРез)Где:

Параметр1 – ссылка на контрагента: символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой;

Параметр2 – логический признак: если его значение .T., то в адрес будет включен почтовый индекс контрагента (если конечно в реквизитах данного контрагента указан индекс); если значение признака .F. или не задано, то почтовый индекс не будет включен в адрес;

Параметр3 – логический признак: если его значение .T., то в адрес будет включено полное наименование страны контрагента (если конечно в реквизитах данного контрагента указана страна); если значение признака .F. или не задано, то наименование страны не будет включено в адрес.Признаки Параметр2 и Параметр3 необязательные. По умолчанию Система использует значения признаков .F.

ТипРез – символьный признак, указывающий на тип возвращаемого функцией результата (тип адреса). Этот параметр необязателен. Возможные значения: "1" – фактический адрес; "2" (значение по умолчанию) – юридический адрес; "3" – адрес для перечислений.

Примеры:

This.__GetOrgBaseAddress(vsfohead.orb_agfr,.T.,.T.,"1"), возвращает полный фактический адрес контрагента­ поставщика в исходящем счете­фактуре. Адрес включает в себя полное наименование страны, почтовый индекс, область, город и т.д.This.__GetOrgBaseAddress(vsfohead.orb_agfr,.T.), возвращает юридический адрес контрагента­ поставщика в исходящем счете­фактуре без наименования страны. Адрес включает в себя почтовый индекс, область, город и т.д.

Примечание. В названии функции, после идентификатора This., ставятся два знака "_".

This.__GetOrgName

Возвращает наименование контрагента. Функция используется в шаблонах Microsoft Excel ряда документов (например: счетов­фактур; внутренних требований, ордеров, накладных).Синтаксис:This.__GetOrgName(Имя).Где:

Имя ­ cимвольное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой.Примечание. После идентификатора This. два знака "_".

Пример:

This.__GetOrgName(vsfohead.orb_agto), возвращает наименование контрагента­ покупателя в исходящем счете­фактуре.

This.__GetRate

Функция возвращает курс одной валюты относительно другой валюты на указанную дату.Синтаксис:This.__GetRate(П1,П2,П3)Где: 

Page 20: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

20

П1 – ссылка на валюту, для которой возвращается курс;П2 – ссылка на валюту, относительно которой возвращается курс; П3 – дата, на которую рассчитывается курс валюты. Расчет курса производится на основе данных словаря "Наименования и курсы валют". При расчете используются курсы обеих валют относительно базовой. Если на заданную дату какой­либо курс отсутствует, берется значение курсов на ближайшую предшествующую дату.

Примеры:ФункцияThis.__GetRate(Bank.RN_Curr,This.seek_tablefields("CurrBase","CODE_ISO","USD","RN"),Bank.date_doc)возвращает курс валюты платежа по банковскому документу относительно доллара США. Курс рассчитывается на дату регистрации банковского документа. Если сумма документа выражена в немецких марках (курс относительно рубля, например, 12), а курс доллара США относительно рубля, например, 25, то будет возвращено значение 0.48 (12/25).ФункцияThis.__GetRate(Bank.RN_Curr,oSystem.CurrRN,Bank.date_doc)

возвращает курс валюты платежа по банковскому документу относительно базовой валюты. Курс рассчитывается на дату регистрации банковского документа. Глобальный объект oSystem.CurrRN обеспечивает ссылку на базовую валюту Системы.

This.__GetSub

Функция "сцепляет" отдельные значения символьного типа в одну строку, разделяя их точками. Данную функцию удобно использовать для вывода единой строкой номера счета и номеров его аналитических счетов различных порядков.Синтаксис:This.__GetSub(П1,П2, П3, П4, П5, П6)Где: параметры П1 – П6 представляют собой символьные выражения. Эти параметры необязательные. В функции они могут присутствовать в произвольном количестве (от 0 до 6) и сочетании. Вместо отсутствующих параметров в середине списка ставятся запятые, вместо отсутствующих параметров в конце списка не ставятся никакие символы.

Примеры использования функции:Функция This.__GetSub("50","1","аренда","ремонт","5","6") возвращает строку 50.1.аренда.ремонт.5.6Функция This.__GetSub("50","1",,,"5","6") возвращает строку 50.1...5.6Функция This.__GetSub("50","1","аренда") возвращает строку 50.1.аренда

This.__GetTaxSum

Функция возвращает сумму налога, указанного Вами вида. Используется в шаблонах Microsoft Excel.Синтаксис:This.__GetTaxSum(Сумма, Признак, Дата, Вид, Налоговая группа)Где:Сумма – задаваемое Вами значение суммы, налог с которой требуется получить.Признак – параметр логического типа: если его значение .Т. ("истина"), то считается, что все налоги включены в Сумму; если значение параметра .F. ("ложь") – то в значение Сумма налоги не входят.

Page 21: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

21

Дата – календарная дата, на которую берутся значения налоговых ставок при расчете налога.Вид – вид налога, значение которого Вы хотите получить: 2 – налог на ГСМ, 3 – НДС, 4 – налог с продаж.Налоговая группа – идентификатор налоговой группы, ставки налогов которой используются при расчете.Пример использования функции:При выводе в Microsoft Excel входящего счета­фактуры, функция This.__GetTaxSum(__p_Summa, .F., vsfihead.SFIH_PAY_DATE, "3", vsfispec.TAXGRP_RN) возвращает значение НДС от значения суммы позиции спецификации. Значение суммы определяется переменной __p_Summa. НДС не входит в значение суммы.

В этом примере: vsfihead.SFIH_PAY_DATE – дата оплаты входящего счета­фактуры;vsfispec.TAXGRP_RN – идентификатор налоговой группы, фигурирующей в позиции спецификации входящего счета­фактуры.

This.__KillWhiteSpace

Функция заменяет в строке непечатаемые символы пробелами, а потом убрирает двойные пробелы. Коды символов: 0 ­ 31

Синтаксис This.__KillWhiteSpace (cSting)где cString – произволье текстовое выражение(спаибо за помощь г­ну Шибанову)

This.ListName

Используется в шаблонах документов инвентарной картотеки. Если значение переменной равно "Spis", то печать документа производится из состава групповой карточки. Если переменная имеет другое значение, то печать документа производится из главного окна раздела "Инвентарная картотека".Пример:__p_inum=IIF(This.ListName == "Spis", vInSpis.Inum, vInBase.Num_Inv).Переменная позволяет, в зависимости от того откуда печатается документ, выводить в него или номер инвентарной карточки или номер объекта из состава групповой карточки.

This.__MakeAcc

Функция возвращает номер счета и номера его аналитических счетов, разделенные точками.Синтаксис:This.__MakeAcc (cAlias, cAccName, cAnName, nAnLevel)где: cAlias – имя таблицы базы данных;cAccName – имя поля таблицы, содержащего RN счета;cAnName – имя поля таблицы, содержащего RN аналитики без цифры на конце (по умолчанию считается, что названия полей­ссылок на аналитику, заканчивается на 1..5);nAnLevel – до какого уровня выводить аналитические счета (по умолчанию параметр равен 5).

Пример использования:This.__MakeAcc("vInBase", "RN_DB", "RN_DB_", 4)

This.Month2Text

Page 22: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

22

Возвращает месяц прописьюСинтаксисThis.Month2Text(nMonth, cPadez)гдеnMonth – номер месяца, число от 1 до 12cPadez – падеж в котором надо выводить месяц. Может принимать 2 значения: И – именительный, Р – родительлный. По умолчанию месяц выводится в именительном падежеПример:This.Month2Text(2,"Р")возвращает февраля  

This.SaveClipBoard

Управляющее свойство объекта печати. Определяет сохранять при печати (или нет) содержимое буфера обмена Windows.Если значение свойства равно .Т. – содержимое буфера обмена будет сохранено при печати и Вы сможете им воспользоваться по окончании печати. Если значение свойства не определено или оно равно .F. (значение по умолчанию), то содержимое буфера обмена при печати сохранено не будет.Определение значения свойства производится в столбце "В" листа "Настройка". В столбце "С" ему должно соответствовать значение ~Options. Соответствующая ячейка столбца "А" должна быть не заполнена. Расположение строки инструкции, в которой определяется значение свойства объекта печати, произвольно (рекомендуем, для наглядности, располагать ее в начале инструкции).

This.SavePageSetup

Управляющее свойство объекта печати. Определяет как будут учитываться настройки параметров страницы шаблона. Если значение свойства равно .Т. – то при печати будут учтены все настройки (т.е. все параметры, указанные в окне "Параметры страницы" листа Excel). Если значение свойства не определено или оно равно .F. (значение по умолчанию), то при печати будут учтены только настройки, касающиеся вывода в печатную форму сквозных строк и столбцов.Определение значения свойства производится в столбце "В" листа "Настройка". В столбце "С" ему должно соответствовать значение ~Options. Соответствующая ячейка столбца "А" должна быть не заполнена. Расположение строки инструкции, в которой определяется значение свойства объекта печати, произвольно (рекомендуем, для наглядности, располагать ее в начале инструкции). 

Примечание. Если свойству присвоено значение .Т., то время вывода на печать документа или отчета увеличивается на некоторую фиксированную величину. Эта величина зависит от конфигурации рабочего места и программного обеспечения.

This.Seek_TableFields

Возвращает значение поля из таблицы, на которую ссылается текущая таблица. Функция используется в шаблонах MS Excel ряда документов (например: счетов­фактур; внутренних требований, ордеров, накладных).

Синтаксис:

This.SEEK_TABLEFIELDS(Парам1, Парам2, Парам3, Парам4).

Где:Парам1 ­ символьное выражение, состоящее из имени текущей таблицы базы;

Page 23: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

23

Парам2 ­ символьное выражение, используемое функцией в качестве индексного выражения для позиционирования в словаре, указанном в параметре Парам1.

Парам3 ­ символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой. Это текущая таблица, из которой производится ссылка.

Парам4 ­ символьное выражение, состоящее из имени таблицы базы данных и имени поля этой таблицы, разделенных точкой. Это таблица, на которую производится ссылка.Пример использования функции: This.Seek_TableFields("measure","Rn","measure.MNEMO_MES",nobase.RN_MES),возвращает единицу измерения товара. Товар зарегистрирован в словаре "Номенклатор", единица его измерения ­ в словаре "Единицы измерения".

This.__Srok

Функция возвращает календарный срок в виде количества лет и месяцев. Исходной информацией является количество месяцев.Синтаксис:This.__Srok(Параметр)Где: Параметр –числовое выражение, интерпретируемое Системой как количество месяцев.Пример использования функции:

При выводе в Microsoft Excel инвентарной карточки, функция This.__Srok(inbase.srok) возвращает срок полезного использования инвентарного объекта в виде 8 л. 4 мес.

This.__StrRound

Возвращает число как строку с округлением и удалением незначащих дробных нулейСинтаксисThis.__StrRound(eExpression, cFormatCodes)гдеeExpression  ­ числовое выражениеcFormatCodes ­ форматная строка как в TRANSFORMОба параметра являются обязательными. Функция возвращает строкуПримерThis.__StrRound(025.590,"999,999,999,999.99")возвращает строку вида 25,59

This.__SumExpression

Функция суммирует значения выражения по таблице базы данных или по представлению. Для числовых значений возвращается их сумма, для строковых значений – строка, объединяющая эти значения.Синтаксис:

This.__SumExpression (pLocalAlias, pFilter, pExpression, pFieldList, pResInit)Где:

pLocalAlias – имя таблицы или представления (обязательный параметр);pFilter – условие отбора;pExpression – выражение для суммирования;

pFieldList – список полей отбора;

Page 24: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

24

pResInit – начальное значение.Пример. Выражение This.__SumExpression('vCashSpec','Master_RN=['+vCash.RN+']','Allt(MAKE_ACC(DB,DBA1,DBA2,DBA3,DBA4,DBA5))+ " – " + Allt(STR(Sum_Base,20,2))+ " руб.; " ', '*' , ' Проводки: дебетуемый счет – сумма') выводит в печатную форму кассового ордера строку с номерами дебетуемых счетов и значениями сумм проводок, указанных в кассовом документе (на вкладке "Проводки"). В печатной форме это будет выглядеть, например, так: 

Проводки, дебетуемый счет ­ сумма:  55 ­ 3420,00 руб.; 51 ­ 2110,00 руб.;

This.__UPrice

Функция возвращает учетную цену ТМЦ. Учетная цена "берется" из словаря "Номенклатор" на дату, заданную в параметрах функции. Если на эту дату цена в словаре не задана, то "берется" цена на ближайшую предшествующую дату.Синтаксис:

This.__UPrice (rnTMC, dDate, rnCurr, @nSum_Equal, @nSum_Val, @dUPrice)

где: 

rnTMC – RN номенклатуры;dDate – Дата, на которую необходимо узнать учетную цену ТМЦ;rnCurr – Валюта учетной цены;@nSum_Equal – Значение цены в базовой валюте;@nSum_Val – Значение цены в валюте;@dUPrice – Дата, на которую зарегистрирована учетная цена ТМЦ в номенклаторе.

Пример использования:

This.__UPrice (vIdocSpec.RN_Numcl, vIdocBase.Date_Doc, vIdocBase.RN_Curr, @__pSum_Eq, @__pSum_Val, @__pdUPrice)

WordLine

Функция возвращает фразу необходимого размера из длинной строки.Синтаксис:WordLine (<исходная строка>, <номер фразы>, <размер фразы>)Функция содержит три параметра:1). Исходная строка. Любое текстовое выражение, из которого по пробелам будет выделяться фраза.2). Номер фразы. Определяет порядковый номер выделяемой фразы. По умолчанию – 1.3). Размер фразы. Задает максимальный размер фразы. По умолчанию – 8.Пример:WordLine(“Нам необходимо выделить небольшую фразу!”, 1, 20) – вернет строку: “Нам необходимо”.WordLine(“Нам необходимо выделить небольшую фразу!”, 2, 20) – вернет строку: “выделить небольшую”.WordLine(“Нам необходимо выделить небольшую фразу!”, 3, 20) – вернет строку: “фразу!”.

Formula ONE

Page 25: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

25

Метод DeleteSheets

ОписаниеУдаляет один или несколько листов из книги.

СинтаксисF1Book1.DeleteSheets nSheet, nSheets 

Параметр Тип Описание

nSheet Long Показывает номер первого листа, который вы хотите удалить. Листы нумеруются слево направо, начиная с 1. Не путайте номер листа с его именем. 

nSheets Long Показывает сколько листов надо удалить. Например, если значение аргумента равно 3, Formula One удалит лист с номером заданным nSheet  и  еще два листа справа.

Пример

This.Book.DeleteSheets(This.GetSheetNum("Настройка"), 1)Удаляет в шаблоне лист Настройка. Для того чтобы определить номер листа Настройка используется функция This.GetSheetNum.

Метод InsertSheets ОписаниеВставляет один или несколько листов в определенное место.

СинтаксисF1Book1.InsertSheets nSheet, nSheets 

Параметр Тип Описание

nSheet Long Номер листа, перед которым вы хотите вставить новый лист. Листы нумеруются слева направо начиная с 1. Не путайте номер листа с его именем. 

nSheets Long Сколько листов будет вставлено. 

ПримечаниеВставленные листы будут называться Sheet1, Sheet2 и т.д. Чтобы переименовать их используйте свойство SheetName.

Пример

This.Book.InsertSheets (3,1)

Вставляет 1 лист, котрый будет располагаться третьим слева.

Метод SetRowHidden

Page 26: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

26

ОписаниеСкрывает или показывает одну или несколько строк.

СинтаксисF1Book1.SetRowHidden nRow1, nRow2, bRowHidden 

Параметр Тип Описание

nRow1 Long Начальная строка.nRow2 Long Конечная строка.bRowHidden Boolean Устанавливает значение флага Скрытый для всех строк входящих в 

диапазон от nRow1 до nRow2. Если значение флага Истина, выбранные строки не отображаются. Если значение флага Ложь, строки отображаются.

Пример

Iif(__pNadbGub=0,This.Book.SetRowHidden(43,45,.T.),.F.)

Если переменная __pNadbGub равна 0, скрываются строки 43, 44, 45.

Свойство SheetName

ОписаниеПереименовывает лист либо возвращает его текущее наименование.

СинтаксисF1Book1.SheetName ( nSheet ) [ = sheetName ]

Параметр Тип Описание

nSheet Long Номер листа. Листы нумеруются слева направо начиная с 1. Не путайте номер листа с его именем. 

sheetName String Имя листа.

ПримечаниеЕсли вы переимновываете лист все формулы где есть ссылка на него будут обновлены и будут ссылаться уже на новое наимнование.

Пример

This.Book.SheetName (This.GetSheetNum("Настройка")) = "Моя настройка"Переименовывает лист Настройка в Моя настройка.

Методы печати Настраиваемых форм пользователей

Page 27: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

27

Метод определения различных сумм по выплатам/удержаниям ThisForm.ThisFormData.NU()

Определяет значение сумм, часов, дней, облагаемых сумм и т.д., для определенных в параметрах метода, выплат или удержаний.

Синтаксис:

  ThisForm.ThisFormData.NU(<Массив строк  заданий  или  строка  задания>, <период>, <считать по  месяцу  ЗА>) 

Метод содержит два обязательных параметра и один необязательный:

1). Массив строк заданий или строка задания. 

Метод определяет одно или более значение (сумм) по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks,2), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1)  –  строка,  содержащая  описание   задания.  При  выполнении   i­того   задания  методом  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис: aTaskList(i,1) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов” ,”Возвращаемое значение”,”Признак учитывать конфиденциальные выплаты”,”Признак учитывать отрицательную налоговую базу”‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Тип Тип   выплаты/удержания. Определяет,   какой   тип выплаты   или   удержания рассматривать при подсчете искомой величины

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

“Зачтено”

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Начисления + авансы –

удержания

Список групп выплат

Определяет,   какие   группы выплат,   удержаний 

Мнемокоды   групп   по словарю   “Группы   выплат  и 

Мнемокоды   групп разделяются   запятыми. 

Page 28: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

28

Параметр Описание Допустимые значения Описание

рассматривать при подсчете искомой величины

удержаний” Мнемокоды   групп указываются  полностью   в соответствии со словарем (15 символов)

Список расчетных алгоритмов

При   подсчете   искомой величины   будут рассматриваться   только   те выплаты  и   удержания, которые  рассчитываются  по заданному  списку алгоритмов

Мнемокоды   расчетных алгоритмов   по   списку алгоритмов,   установленных в системе

Мнемокоды   алгоритмов разделяются   запятыми. Мнемокоды   алгоритмов указываются   полностью   в соответствии со списком (15 символов)

Список видов выплат, удержаний

Определяет,   какие   виды выплат,   удержаний рассматривать при подсчете искомой величины

Мнемокоды   видов   выплат, удержаний   по   словарю “Выплаты и удержания” 

Те же требования

Список расчетов Определяет,   какие   расчеты рассматривать при подсчете искомой величины

Мнемокоды  видов  расчетов по словарю “Виды расчетов”

“ТЕК”

Те же требования

Рассматривается   только текущий   расчет(в   разделах “Печать  лицевых   счетов”  и “Печать   отпускных   и больничных”)

Возвращаемое  значение

Определяет,   какую величину подсчитать

“И”

“КФ”

“МЗ”

“ГЗ”

“СВ”

“НС”

“ОС”

“НСНФЛ”

“ОСНФЛ”

“НСЕСН”

Итоговая сумма

Количество  ФОВ   (без  учета единиц измерения)

Номер   месяца,   за   который выплата, удержание

Номер   года,   за   который выплата, удержание

Сумма вычетов

Необлагаемая сумма (расч.метод ПОМ)

Облагаемая сумма (расч.методы ПОМ, ВЗН, НАЛ)

Необлагаемая сумма по базе НФЛ (расч.метод Мп2)

Облагаемая   сумма   по   базе НФЛ (расч.метод Мп2)

Необлагаемая сумма по базе ЕСН (расч.метод Мп2)

Page 29: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

29

Параметр Описание Допустимые значения Описание

“ОСЕСН”

“Е”+код единицы измерения

“ПФ”

“НОР”

“СТ”

“КС”

“КВ”

“СЗР”

“МИН”

“МАКС”

“ДС”

“ДП”

“П”

“НД”

“ДД”“ТД”

“КД”

“БД”

“СД”

“ПД”

Облагаемая   сумма   по   базе ЕСН (расч.метод Мп2)

Количество  ФОВ   (с  учетом единицы   измерения:   ЕД   – количество дней, ЕЧ – количество часов).Для   обозначений используются   русские буквы в любом регистре.

Отработано(педнагрузка)

Норма

Ставка

Количество ставок

Курс валюты

Средний заработок

Мин.сумма оплаты б/л

Макс.сумма оплаты б/л

день   С…   выплаты, удержания

день   По…   выплаты, удержания

Процент

Номер документа (основания)

Дата документа (основания)

Тип документа (основания)

Кому перечислено (RN контрагента)

Банк для перечисления (RN банка)

Дата   С…   действия основания

Дата   По…   действия основания

Page 30: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

30

Параметр Описание Допустимые значения Описание

“ЕФ”

“МВ”

“ГВ”

“ТС”

“ТП”

“ПС”

“ПП”

“ВД”

“В”

“К”

"НОМ"

“ДВ”

"ОПН"

"ОПК"

“ИДН”

“ИДО”

Единица измерения ФОВ

Месяц,   в   котором   была выплата, удержания

Год,   в   котором   была выплата, удержание

Дата   начала   действия больничного, отпуска

Дата   окончания   действия больничного отпуска

Дата   начала   периода,   в котором   была   выплата, удержание

Дата  окончания  периода,   в котором   была   выплата, удержание

Ведомость (RN ведомости)

Полное   наименование выплаты, удержания.

Мнемокод   выплаты, удержания

Номер выплаты, удержания 

Мнемокод   вида деятельности

Дата   начала   периода,   за который   предоставляется отпуск,   берется   из основания

Дата   конца   периода,   за который   предоставляется отпуск,   берется   из основания

RN –начисления

RN –основания

Признак учитывать конфиденциальные  выплаты

Определяет   учитывать  или нет   конфиденциальные выплаты   при   подсчете искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

Признак  Определяет   учитывать  или  “.T.” Учитывать

Page 31: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

31

Параметр Описание Допустимые значения Описание

учитывать отрицательную  налоговую  базу

нет   отрицательные   значения начислений  при   подсчете облагаемых  и  необлагаемых сумм 

“” (пусто)

Не учитывать

(расч.методы   ПОМ,   ВЗН, НАЛ, МП2)

удовлетворяющих условиям отбора, заданных параметрами. Т.е. для номера месяца МЗ и года ГЗ, за который производится выплата, будет определено значение последней выплаты/удержания, удовлетворяющей условиям отбора.

Значения параметров, выделенные синим цветом имеют смысл только при отборе отдельных начислений.

Примечания:-Если   значение  параметра   “”   (пусто),  то  соответствующее  ему  условие  отбора  не  участвует  при  обработке выплат/удержаний (т.е. берутся все). 

-Для   Типа   “Зачтено”   возвращаемое   значение   ­   итоговая   сумма   ­   независимо   от   значения   параметра “Возвращаемое значение”

2). Период. Определяет период, в котором рассматривать выплаты/удержания.

Допустимые значения Описание

“Период”

“Год”

“Год + Период”

“D1= <дата С…>, D2= <дата по…>”

“” (Пусто)

В текущем расчетном периоде

В текущем году (соответствующем текущему расчетному периоду), не включая текущий расчетный период

Тоже, включая текущий расчетный период

Задает период датами С…, По…, которые могут быть константами или  переменными  (между  D1 и  =, между  D2 и = не  должно  быть пробелов)

Период не рассматривается

Примечания.1)  Метод  ThisForm.ThisFormData.NU()  может  применяться  в  настраиваемых  формах  ведомостей,  лицевых счетов,   сводов   ведомостей,   расчетов   отпусков   и   больничных,   формах   налоговой   отчетности,   денежных аттестатах.2) При печати ведомостей текущим расчетным периодом является период ведомости.3)  Метод   всегда   возвращает   тип   –   "число".   (для   выделенных  синим   цветом  значений   параметров  могут возвращаться другие типы)4) Метод собирает информацию в зависимости от значения свойства ThisForm.ThisFormData.AnkGroup. Если ThisForm.ThisFormData.AnkGroup  = 1, то  будут  обработаны  все  выплаты/удержания  текущего  сотрудника, если 2 ­ все выплаты/удержания текущего лицевого счета, если 3 ­ все выплаты/удержания текущей ведомости, если 4 ­ все выплаты/удержания текущего контрагента.

Page 32: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

32

3.) Считать  по  месяцу  ЗА.  Логический  параметр,  при  установке  которого  будут  рассматриваться только  те выплаты, месяц и год ЗА которых совпадает с Периодом (второй параметр).

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива.

Синтаксис:

NValue = ThisForm.ThisFormData.NU(<строка задания>,<период>,<считать по месяцу ЗА>)

Найденное значение будет присвоено переменной Nvalue.

Примеры

Пример формирования списка заданий:

Dimension __pNUTaskList(7,2)

__pNUTaskList(1,1) = '"Начислено","","","Оклад ,Надбавка ","","и",""'

Задание 1: Найти итоговую сумму начислений "оклад" и "надбавка". 

__pNUTaskList(2,1) = '"Начислено","","Бос ","","","кф",""'

Задание 2: Найти сумму дней (часов) начислений, рассчитанных по алгоритму “Бос”. 

__pNUTaskList(3,1) = '"Начислено","","","Помощь ","","нс",""'

Задание 3: Найти необлагаемую сумму начислений “Помощь”. 

__pNUTaskList(4,1) = '"Авансировано","","","","","и",""'

Задание 4: Найти итоговую сумму всех авансов.

__pNUTaskList(5,1) = '"Удержано","","","Налог ","","и",""'

Задание 5: Найти итоговую сумму удержания “Налог”.

__pNUTaskList(6,1) = '"Удержано","","Нал ","","","св",""'

Задание 6: Найти сумму вычетов всех удержаний, рассчитанных по алгоритму “Нал”.

__pNUTaskList(7,1) = '"Начислено","Для ведомости ","","","","и",""'

Задание 7: Найти итоговую сумму начислений, входящих в группу “Для ведомости”. 

Пример использования метода:

ThisForm.ThisFormData.NU(@__pNUTaskList,"Период")

Выполняет выше описанные задания за текущий расчетный период и заполняет результатами вторые элементы строк массива __pNUTaskList.

ThisForm.ThisFormData.NU(@__pNUTaskList,"Год")

Выполняет выше описанные задания  за  текущий год и заполняет результатами вторые  элементы  строк  массива __pNUTaskList.

Page 33: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

33

__pDateFrom = date(2001,1,1)

__pDateTo = date(2001,3,31)

ThisForm.ThisFormData.NU(@__pNUTaskList,"D1=__pDateFrom,D2 =__pDateTo",.T.)

Выполняет  выше  описанные  задания  за  период  с  01.01.2001 по  01.03.2001 (с  учетом  по  месяцу  и  году  ЗА) и заполняет результатами вторые элементы строк массива __pNUTaskList.

Метод определения различной информации по выплатам/удержаниям ThisForm.ThisFormData.SPI_NU()

Определяет  различную  информацию  о  выплатах/удержаниях,  определенных  в  параметрах  метода,  и  сохраняет информацию во временной таблице, удобной для печати.

Метод используется для получения информации о выплатах/удержаниях в виде таблицы

Пример:

Начисления

вид начисления период начисления сумма начисления размер начисления

с по руб., коп. руб., коп.

или процент

доплаты  01.01.01 31.01.01 100 619,05

оклад  01.01.01 31.01.01 3095,24

Персональная надбавка  01.01.01 31.01.01 1547,62

доплаты  01.02.01 28.02.01 100 1000

оклад  01.02.01 28.02.01 5000

персональная надбавка  01.02.01 28.02.01 2500

доплаты  01.03.01 31.03.01 100 904,76

оклад  01.03.01 31.03.01 4523,81

Синтаксис:ThisForm.ThisFormData.SPI_NU(<Массив строк заданий или строка задания>, <период>, [<считать по месяцу ЗА>])

Метод содержит два обязательных параметра и один необязательный:

1). Массив строк заданий или строка задания. 

Метод  определяет  один  или  более  блоков  информации  по  числу  заданий.  Задания  описываются  в  элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание. При выполнении i­того задания методом результирующая таблица данных  заносится в i­ый раздел служебной таблицы DOPLSPEC. Таким образом, метод 

Page 34: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

34

не  возвращает  в  отчет  никаких  значений.  Печать  полученной  информации  осуществляется  путем  обращения  к соответствующим полям таблицы DOPLSPEC.

Описание структуры элемента массива (строки):

Синтаксис: aTaskList(i) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов” ,”Список пунктов данных”,”Признак учитывать конфиденциальные выплаты”,”Префикс блока данных”,”Признак учитывать отрицательную налоговую базу”‘.

Каждый параметр структуры задания заключается в двойные кавычки, и отделяются друг от друга запятыми. Вся   строка   задания   заключается   в  одинарные  кавычки.  Если  параметр  не  используется,   то  проставляются соответствующие ему пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Тип Тип   выплаты   удержания. Определяет,   какой   тип выплаты   или   удержания рассматривать

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Список групп выплат

Определяет,   какие   группы выплат/удержаний 

Мнемокоды   групп   по словарю   “Группы   выплат  и удержаний”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются  полностью   в соответствии со словарем (15 символов)

Список расчетных алгоритмов

Будут   рассматриваться только   те   выплаты   и удержания,   которые рассчитываются   по заданному  списку алгоритмов

Мнемокоды   расчетных алгоритмов   по   списку алгоритмов,   установленных в системе

Мнемокоды   алгоритмов разделяются   запятыми. Мнемокоды   алгоритмов указываются   полностью   в соответствии со списком (15 символов)

Список видов выплат/удержаний

Определяет,   какие   виды выплат/удержаний рассматривать 

Мнемокоды   видов выплат/удержаний по словарю “Выплаты и удержания” 

Те же требования

Список расчетов Определяет,   какие   расчеты рассматривать 

Мнемокоды  видов  расчетов по словарю “Виды расчетов”

“ТЕК”

Те же требования

Рассматривается   только текущий   расчет(в   разделах “Печать  лицевых   счетов”  и “Печать   отпускных   и больничных”)

Page 35: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

35

Параметр Описание Допустимые значения Описание

Список пунктов данных

Определяет   список   данных по   выплатам/удержаниям, которые   необходимо получить

“В”

“К”

"НОМ"

“И”

“КФ”

“МЗ”

“ГЗ”

“СВ”

“НС”

“ОС”

“НСНФЛ”

“ОСНФЛ”

“НСЕСН”

“ОСЕСН”

“ДС”

“ДП”

“П”

“НД”

“ДД”“ТД”

“КД”

“БД”

Полное   наименование выплаты, удержания.

Мнемокод   выплаты, удержания

Номер выплаты, удержания

Итоговая сумма

Количество  ФОВ   (без  учета единиц измерения)

Номер  месяца,   за   который выплата, удержание

Номер   года,   за   который выплата, удержание

Сумма вычетов

Необлагаемая сумма (расч.метод ПОМ)

Облагаемая сумма (расч.методы ПОМ, ВЗН, НАЛ)

Необлагаемая сумма по базе НФЛ (расч.метод Мп2)

Облагаемая   сумма   по   базе НФЛ (расч.метод Мп2)

Необлагаемая сумма по базе ЕСН (расч.метод Мп2)

Облагаемая   сумма   по   базе ЕСН (расч.метод Мп2)

день   С…   выплаты, удержания

день   По…   выплаты, удержания

Процент

Номер документа (основания)

Дата документа (основания)

Тип документа (основания)

Кому перечислено (RN контрагента)

Банк для перечисления (RN банка)

Page 36: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

36

Параметр Описание Допустимые значения Описание

“СД”

“ПД”

“ЕФ”

“МВ”

“ГВ”

“ТС”

“ТП”

“ПС”

“ПП”

“ВД”

“ПФ”

“НОР”

“СТ”

“КС”

“КВ”

“СЗР”

“МИН”

“МАКС”

"ОПН"

"ОПК"

“ИДН”

“ИДО”

Дата   С…   действия основания

Дата   По…   действия основания

Единица измерения ФОВ

Месяц,   в   котором   была выплата, удержания

Год,   в   котором   была выплата, удержание

Дата   начала   действия больничного, отпуска

Дата   окончания   действия больничного отпуска

Дата   начала   периода,   в котором   была   выплата, удержание

Дата  окончания  периода,   в котором   была   выплата, удержание

Ведомость (RN ведомости)

Отработано(педнагрузка)

Норма

Ставка

Количество ставок

Курс валюты

Средний заработок

Мин.сумма оплаты б/л

Макс.сумма оплаты б/л

Дата   начала   периода,   за который   предоставляется отпуск,   берется   из основания

Дата   конца   периода,   за который   предоставляется отпуск,   берется   из основания

RN –начисления

RN –основания

Page 37: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

37

Параметр Описание Допустимые значения Описание

Для   обозначений используются   русские буквы   в   любом   регистре. Обозначения   в   списке разделяются запятыми.

Признак учитывать конфиденциальные  выплаты

Определяет   учитывать   или нет   конфиденциальные выплаты

“.T.”

“” (пусто)

Учитывать

Не учитывать

Префикс блока данных

Определяет первые символы в   названии   полей   таблицы DOPLSPEC,   которые относятся   к   блоку   данных задания

Любые  символы,  допустимые в именах полей таблиц.

Признак учитывать отрицательную  налогвую базу

Определяет   учитывать  или нет   отрицательные   значения начислений  при   подсчете облагаемых  и  необлагаемых сумм

“.T.”

“” (пусто)

Учитывать

Не учитывать

(расч.методы   ПОМ,   ВЗН, НАЛ, МП2)

видов   выплат,   удержаний,   удовлетворяющих   условиям   отбора,   заданных   параметрами   отбора.  При   этом найденные данные будут записаны в служебную таблицу DOPLSPEC.

Структура таблицы DOPLSPEC:

Каждая запись таблицы DOPLSPEC , соответствует одной записи выплаты/удержания, обработанной методом .SPI_NU(),   удовлетворяющей   условиям   отбора.   Общее   количество   записей   равно   количеству   записей выплат/удержаний, удовлетворяющих условиям отбора.

Метод .SPI_NU() автоматически формирует поля таблицы DOPLSPEC  и присваивает им названия по принципу: Префикс блока данных + ”_” (символ подчеркивания) + обозначение из Списка пунктов данных.   Во   время   работы   метода   искомые   данные   будут   заполняться   в   строки,  соответствующие   виду выплаты/удержания, и в поля, соответствующие обозначению вида данных. 

Примечание. Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке выплат/удержаний (т.е. берутся все).

2). Период. Определяет период, в котором рассматривать выплаты/удержания.

Допустимые значения Описание

“Период”

“Год”

“Год + Период”

“D1= <дата С…>, D2= <дата по…>”

В текущем расчетном периоде

В текущем году (соответствующем текущему расчетному периоду), не включая текущий расчетный период

Тоже, включая текущий расчетный период

Задает период датами С…, По…, которые могут быть константами 

Page 38: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

38

“” (Пусто)

или  переменными  (между  D1 и  =, между  D2 и = не  должно  быть пробелов)

Период не рассматривается

3.) Считать  по  месяцу  ЗА.  Логический  параметр,  при  установке  которого  будут  рассматриваться только  те выплаты, месяц и год ЗА которых совпадает с Периодом (второй параметр).

Дополнительная обработка полученных данных:

1) Сортировка. Данные, полученные методом, можно отсортировать в необходимом для отображения порядке. Для этого в параметре  “Список пунктов данных” перед каждым обозначением, по которому необходимо сортировать,   необходимо   поставить   символ  “^“  (крышка).   При   этом   порядок   сортировки     будет определяться   порядком   следования   обозначений   с   “крышкой”.  Например,   “^ПС,И,^В”   ,   данные   будут отсортированы по дате периода С…, по наименованию вида выплаты, удержания.

2) Группировка.  Данные,  полученные  методом,  можно  сгруппировать  в  необходимом  порядке.  Для  этого  в параметре  “Список пунктов данных” перед каждым обозначением, по которому необходимо группировать, необходимо поставить символ “*“ (звезда). Например, “^*ПС,И,^*В”, будут отсортированы по дате периода С…, по наименованию вида  выплаты  и сгруппированы по наименованиям выплат/удержаний. Если за один расчетный период встретятся несколько одинаковых выплат/удержаний, то они “свернутся” в одну строчку, а итоговая  сумма  (обозначение  “И”) будет  равняться  суммарной  величине  всех  итоговых  сумм  “свернутых” оплат, удержаний.

Примечания.1) Метод ThisForm.ThisFormData.SPI_NU() может применяться в настраиваемых формах ведомостей, лицевых счетов,   сводов   ведомостей,   расчетов   отпусков   и   больничных,   формах   налоговой   отчетности,   денежных аттестатах.2) При печати ведомостей текущим расчетным периодом является период ведомости.

3) Метод собирает информацию в зависимости от значения свойства ThisForm.ThisFormData.AnkGroup. Если ThisForm.ThisFormData.AnkGroup  = 1, то  будут  обработаны  все  выплаты/удержания  текущего  сотрудника, если 2 ­ все выплаты/удержания текущего лицевого счета, если 3 ­ все выплаты/удержания текущей ведомости, если 4 ­ все выплаты/удержания текущего контрагента.

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива.

Синтаксис:

ThisForm.ThisFormData.SPI_NU(<строка задания>,<период>,[<считать по месяцу ЗА>])

Примеры

Пример формирования списка заданий:Dimension __pTaskLIst (2)

__pTaskLIst(1) = '"Начислено","","","","","^ПС,ПП,П,И,^В","","N"'

Получить дату  С… периода,  в котором было начисление, дату По…периода, значение процента, сумму и полное наименование начисления для всех начислений. Использовать символ “N” в качестве префикса в названии полей 

Page 39: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

39

служебной таблицы DOPLSPEC.

Отсортировать по дате С… периода начисления и наименованию начисления.

__pTaskLIst(2) = '"Удержано","","","","","^ПС,ПП,П,И,^В","","U"'

Получить дату  С… периода,  в котором было удержание, дату По…периода, значение процента, сумму и полное наименование удержания для всех удержаний. Использовать символ “U” в качестве префикса в названии полей служебной таблицы DOPLSPEC.

Отсортировать по дате С… периода начисления и наименованию начисления.

Пример использования метода:

ThisForm.ThisFormData.SPI_NU(@__pTaskList, "Период")

Выполняет выше описанные задания за текущий расчетный период и заполняет результатами служебную таблицу DOPLSPEC.

Таблица DOPLSPEC примет следующую структуру:

Поле Тип Описание

DOPLSPEC.N_ПС D Дата начала периода, в котором было начисление

DOPLSPEC.N_ПО D Дата окончания периода, в котором было начисление

DOPLSPEC.N_П N Процент начисления

DOPLSPEC.N_И N Сумма начисления

DOPLSPEC.N_В C Полное наименование вида начисления

DOPLSPEC.U_ПС D Дата начала периода, в котором было удержание

DOPLSPEC.U_ПО D Дата окончания периода, в котором было удержание

DOPLSPEC.U_П N Процент удержания

DOPLSPEC.U_И N Сумма удержания

DOPLSPEC.U_В C Полное наименование вида удержания

Пример заполнения:

Поле N_В N_ПС N_ПО N_П N_И U_В U_ПС U_ПО U_П U_И

оклад  01.01.01 31.01.01 100 619,05 налог 2001  01.01.01 31.01.01 13 282

надбавка  01.01.01 31.01.01 1547,62 взнос  01.01.01 31.01.01 2 43

Метод определения различных сумм по налоговой карточке сотрудника ThisForm.ThisFormData.TAXSUM()

Определяет значение сумм по месяцам, для определенных в параметрах метода видов дохода, налога, вычета, расхода, налоговой базы и т.д., и  сохраняет информацию в элементах заранее созданного массива, который и 

Page 40: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

40

будет использован для печати.

Синтаксис:

ThisForm.ThisFormData.TAXSUM (<Уникальный  номер  анкеты>,<Массив   строк   заданий  или   строка  задания>)

Метод содержит два обязательных параметра:

1). Уникальный  номер  анкеты.  Метод  определяет  анкету   (сотрудника)  и  соответствующую  ей  налоговую карточку.

2) Массив строк  заданий  или  строка  задания. Метод  определяет  одно  или  более  значение  сумм  по  числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка, содержащая описание задания. При выполнении  методом  i–того задания результаты заносятся   в   элементы   массива   результатов,   специально   созданного   для  i–того   задания,   и   переданного   в параметре   i–тому   заданию.  Элементу  aTaskList(i,2) присвоено  целое  число   –  количество  строк  в  массиве результатов.

Описание структуры первого элемента массива задания (строки):

Синтаксис:

aTaskList(i,1) = ‘”Вид” , “Код дохода (вычета, расхода)”, ”Налоговая база”, ”Код скидки (для дохода)”, ”Признак субъекта федерации” ,”Искомые значения”,”Имя массива результатов”,”Тип”‘

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки,  параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения

Примечание

Вид Определяет,   какой   вид   по строке   налоговой отчетности   рассматривать при   подсчете   искомой величины

“Доход”

“Вычет”

“Налог”

“Расход“

Только доходы

Только вычеты

Только налоги

Только расходы

Код дохода  (вычета, расхода)

Определяет,   какие   коды строки   налоговой отчетности   рассматривать при   подсчете   искомой величины

Коды   по   словарю “Настройка   налоговой отчетности”

Можно  указывать   не   все   4 символа   кода,   а   только   не пустые.

Налоговая база Определяет,   какие  “13%”

Page 41: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

41

Параметр Описание Допустимые значения

Примечание

налоговые   базы   учитывать при   подсчете   искомой величины 

“35%”

“30%”

“ПРОЧИЕ”

“ПФР”

“ФФОМС”

“ТФОМС”

“ФСС”

“ПФР1”

“ПФР2”

Код скидки  (для  дохода)

Определяет,   какие   коды скидки    рассматривать  при подсчете искомой величины

Коды   скидки   по   словарю “Настройка   налоговой отчетности ” 

Можно  указывать   не   все   3 символа   кода,   а   только   не пустые

Признак   субъекта  федерации

Определяет,   как   учитывать признак    субъекта  федерации  при   подсчете искомой величины

“.T.”

“.F.”

“” (пусто)

Учитывать   те   строки,   для которых   стоит   признак субъекта федерации

Учитывать   те   строки,   для которых   не   стоит   признак субъекта федерации

Не учитывать

Искомые значения Определяет,   какую величину подсчитать

"SUM"

"DISC_SUM"

"SUM,DISC_SUM"

Общая сумма

Необлагаемая сумма

Общая   сумма   и необлагаемая сумма

Имя массива  результатов

Определяет   массив,   в который   помещаются результаты подсчета.

Любое   допустимое   в FOXPRO    название   для массива,   начинающееся   с __p

Массив   должен   быть   задан заранее до запуска метода

Тип Определяет,   какой   тип   по строке   налоговой отчетности   рассматривать при   подсчете   искомой величины

“НОБЛ”

“ПОБЛ”

“СОБЛ”

“ИВЫЧ”

“НВЫЧ”

“1ВЫЧ”

не включается в облагаемый доход

включается   в   облагаемый доход полностью

включается   в   облагаемый доход с учетом скидки

имущественный вычет

вычет на налогоплательщика

вычет на ребенка

Page 42: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

42

Параметр Описание Допустимые значения

Примечание

“2ВЫЧ”

“СВЫЧ”

“ЛЕСН”

“СНАЛ”

“ЛНАЛ”

вычет на ребенка в двойном размере

социальный вычет

льгота ЕСН

включается в сумму налога

включается  в  сумму  налога по льготе

Примечания.При  задании  значений  параметров   “Вид”,  “Код  дохода”,  “Налоговая  база”,  “Код  скидки” можно  указать  по  каждому  из перtчисленных параметров условия: 

1) сортировки   “^”

2) сворачивания  “*”

Пример формирования списка заданий:

Dimension __pTaskList (3,2), __pInc13Code(1,30), __pTaxFssMonth(1,15), __pDeductPFrMonth(1,15) ), __pTaxLgPFRMonth(1,15)

__pTaskList (1,1) = '"Доход","^*","*13%","","","SUM,DISC_SUM","__pInc13Code"'

Задание  1:  Получить  по  налоговой  базе  13% список  доходов  с  сортировкой  и  сворачиванием  по  кодам доходов.В результате получаем массив __pInc13Code, каждая строка которого соответствует одному коду дохода:__pInc13Code(i,1)   ­ код дохода__pInc13Code(i,2)   ­ сумма дохода за прошлые периоды__pInc13Code(i,3)   ­ __pInc13Code(i,14) – суммы дохода по по месяцам__pInc13Code(i,15) ­  итоговая  за период  сумма дохода__pInc13Code(i,16) ­  код скидки__pInc13Code(i,17) ­  сумма скидки за прошлые периоды__pInc13Code(i,18) ­  __pInc13Code(i,29) – суммы скидки по месяцам__pInc13Code(i,30) ­  итоговая за период сумма скидки__pTaskList (2,1) = '"Налог","","*ФСС","","","SUM","__pTaxFSSMonth"'

Задание 2: Получить суммы отчислений по ФСС за отчетный период.

__pTaskList (3,1) = '"Вычет","","*ПФР","","","SUM","__pDeductPFrMonth"'

Задание 3: Получить суммы вычетов по ПФР за отчетный период

__pTaskList (4,1) = '"Налог","","*ПФР","","","SUM","__pTaxLgPFRMonth","ЛНАЛ"'

Задание 4: Получить суммы налога по льготе по ПФР за отчетный период

Page 43: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

43

Метод определения различных сумм по фонду оплаты труда ThisForm.ThisFormData.Tarif()

Определяет значение сумм, процентов и разрядов для, определенных в параметрах метода, категорий состава ФОТ.

Синтаксис:

ThisForm.ThisFormData.Tarif(<Массив   строк   заданий   или   строка   задания>, <дата>, <ссылка   на  лицевой счет>)

Метод содержит три параметра:

1).  Массив строк заданий или строка задания. Метод определяет одно или более значение (сумм) по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

2).  Дата. Метод определяет значения на указанную дату. Если дата не указана, метод определяет значения на текущую системную дату.

3). Ссылка на лицевой счет. Необязательный параметр, указывающий ссылку на лицевой счет.

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка,  содержащая  описание  задания.  При  выполнении  i–того  задания  методом,  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис:

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды   групп   по словарю “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в соответствии   со словарем (15 символов)

Список   категорий ФОТ

Определяет,   какие виды  категорий  ФОТ 

Мнемокоды   видов категорий  ФОТ  по  словарю 

Те же требования

Page 44: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

44

Параметр Описание Допустимые значения Описание

рассматривать   при подсчете   искомой величины

“Состав ФОТ” 

Возвращаемое значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

“ДН”

“ДО”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Дата начала

Дата окончания

Для   обозначений используются   русские буквы в любом регистре.

Признак   учитывать   в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

При  обработке  задания  будут  определены  суммарные  значения  искомой  величины  для  всех  категорий  ФОТ, удовлетворяющих заданным параметрами метода условиям отбора.

Примечания.1) Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке категорий ФОТ (т.е. берутся категории ФОТ с любым значением этого параметра).2) Метод ThisForm.ThisFormData.Tarif() может применяться в настраиваемых формах лицевых счетов и штата.3) Метод всегда возвращает тип – число. 

4) При вызове метода из отчета «Расчет. Лицевые счета. Печать настраиваемых форм. Печать лицевых счетов…» метод  собирает информацию  в следующих режимах: а) Если в метод передан параметр  <ссылка на лицевой  счет>, то по указанному лицевому счету б) Если в метод  НЕ передан параметр <ссылка на лицевой счет>, то зависимости   от   значения   свойства  ThisForm.ThisFormData.AnkGroup.   Если ThisForm.ThisFormData.AnkGroup = 1, то будут обработаны все категории ФОТ текущего сотрудника, если 2 ­ все категории ФОТ текущего лицевого счета, если 4 ­ все категории ФОТ текущего контрагента.

Page 45: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

45

Частный случай. Задание одно. В этом случае приемлем синтаксис без использования массива:

Синтаксис:

NValue = ThisForm.ThisFormData.Tarif(<строка задания>)

Найденное значение будет присвоено переменной Nvalue.

Пример формирования списка заданий:

Dimension __pTaskList(3,2)

__pTaskList(1,1) = '"","Оклад          ,Надбавка       ","и",""'

Задание 1: Найти итоговую сумму категорий ФОТ оклад и надбавка.

__pTaskList(2,1) = '"","Оклад          ","р",""'

Задание 2: Найти разряд по категории ФОТ “Оклад”.

__pTaskList(3,1) = '"Доплаты        ","","и",""'

Задание 3: Найти итоговую сумму категорий ФОТ, входящих в группу “Доплаты”.

Пример использования метода:

ThisForm.ThisFormData.Tarif(@__pTaskList)

Выполняет выше описанные задания на текущую системную дату и заполняет результатами вторые элементы строк массива __pTaskList.

Page 46: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

46

Метод определения различных сумм по фонду оплаты труда должности ThisForm.ThisFormData.TarifDol()

Определяет значение сумм, процентов и разрядов для, определенных в параметрах метода, категорий состава ФОТ.

Синтаксис:

ThisForm.ThisFormData.TarifDol(<Массив  строк  заданий  или  строка задания>, <дата>, <ссылка на  штатную должность>)

Метод содержит три параметра:

1).  Массив строк заданий или строка задания. Метод определяет одно или  более значение сумм по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

2).  Дата. Метод определяет значения на указанную дату. Если дата не указана, метод определяет значения на текущую системную дату.

3).  Ссылка на штатную должность. Необязательный параметр, указывающий ссылку на конкретную штатную должность.

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка,  содержащая  описание  задания.  При  выполнении  i–того  задания  методом,  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис:

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп  категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды   групп   по словарю  “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в соответствии   со словарем (15 символов)

Page 47: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

47

Параметр Описание Допустимые значения Описание

Список   категорий  ФОТ

Определяет,   какие виды  категорий  ФОТ рассматривать   при подсчете   искомой величины

Мнемокоды   видов категорий  ФОТ  по  словарю “Состав ФОТ”

Те же требования

Возвращаемое  значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

“ДН”

“ДО”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Дата начала

Дата окончания

Для   обозначений используются   русские буквы в любом регистре.

Признак   учитывать  в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

При  обработке  задания  будут  определены  суммарные  значения  искомой  величины  для  всех  категорий  ФОТ, удовлетворяющих условиям отбора, которые определены параметрами.

Примечания.1) Если  значение  параметра  “” (пусто), то  соответствующее ему,  условие  отбора  не  участвует при  обработке  категорий ФОТ.2) Метод ThisForm.ThisFormData.TarifDol() может применяться в настраиваемых формах штатного расписания.3) Метод всегда возвращает тип – число.

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива:

Page 48: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

48

Синтаксис:

NValue = ThisForm.ThisFormData.TarifDol(<строка задания>)

Найденное значение будет присвоено переменной Nvalue.

Пример формирования списка заданий:

Dimension __pTaskList(3,2)

__pTaskList(1,1) = '"","Оклад          ,Надбавка       ","и",""'

Задание 1: Найти итоговую сумму категорий ФОТ оклад и надбавка. 

__pTaskList(2,1) = '"","Оклад          ","р",""'

Задание 2: Найти разряд по категории ФОТ “Оклад”.

__pTaskList(3,1) = '"Доплаты        ","","и",""'

Задание 3: Найти итоговую сумму категорий ФОТ, входящих в группу “Доплаты”.

Пример использования метода:

ThisForm.ThisFormData.TarifDol(@__pTaskList)

Выполняет выше описанные задания на текущую системную дату и заполняет результатами вторые элементы строк массива __pTaskList.

Метод определения различных сумм по прогнозируемому фонду оплаты труда ThisForm.ThisFormData.TarifP()

Определяет  прогнозируемое   значение  сумм,  процентов  и  разрядов  для,  определенных  в  параметрах  метода, категорий состава ФОТ при срабатывании функции контроля.

Синтаксис:

ThisForm.ThisFormData.TarifP(<Массив   строк   заданий   или   строка   задания>, <дата>, <функция  контроля>)

Метод содержит три параметра:

1).  Массив строк заданий или строка задания. Метод определяет одно или  более значение сумм по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

2).  Дата. Метод   определяет   прогнозируемые   значения   на   указанную   дату.  Если   дата   не   указана,  метод определяет значения на текущую системную дату.

3). Функция контроля. Наименование функции смыслового контроля, при срабатывании которой на указанную дату изменятся параметры категорий ФОТ.

Page 49: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

49

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка,  содержащая  описание  задания.  При  выполнении  i–того  задания  методом,  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис:

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп  категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды   групп   по словарю  “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в соответствии   со словарем (15 символов)

Список   категорий  ФОТ

Определяет,   какие виды  категорий  ФОТ рассматривать   при подсчете   искомой величины

Мнемокоды   видов категорий  ФОТ  по  словарю “Состав ФОТ”

Те же требования

Возвращаемое  значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

“ДН”

“ДО”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Дата начала

Дата окончания

Page 50: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

50

Для   обозначений используются   русские буквы в любом регистре.

Признак   учитывать  в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

При  обработке  задания  будут  определены  суммарные  значения  искомой  величины  для  всех  категорий  ФОТ, удовлетворяющих условиям отбора, заданных параметрами.

Примечания.1) Если  значение  параметра  “” (пусто), то  соответствующее ему,  условие  отбора  не  участвует при  обработке  категорий ФОТ.2) Метод ThisForm.ThisFormData.TarifP() может применяться в настраиваемых формах по оплате труда.3) Метод всегда возвращает тип – число.

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива:

Синтаксис:

NValue = ThisForm.ThisFormData.TarifP(<строка задания>,<дата>,<функция контроля>)

Найденное значение будет присвоено переменной Nvalue.

Пример формирования списка заданий:

Dimension __pTaskList(3,2)

__pTaskList(1,1) = '"","Оклад          ,Надбавка       ","и",""'

Задание 1: Найти итоговую сумму категорий ФОТ оклад и надбавка.

__pTaskList(2,1) = '"","Оклад          ","р",""'

Задание 2: Найти разряд по категории ФОТ “Оклад”.

__pTaskList(3,1) = '"Доплаты        ","","и",""'

Задание 3: Найти итоговую сумму категорий ФОТ, входящих в группу “Доплаты”.

Пример использования метода:

ThisForm.ThisFormData.TarifP(@__pTaskList,’’,’Стаж’)

Page 51: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

51

Выполняет выше описанные задания и, при срабатывании функции контроля “Стаж”, на текущую системную дату прогнозирует изменение ФОТ, и заполняет результатами вторые элементы строк массива __pTaskList.

Метод определения среднесписочной численности лицевого счета ThisForm.ThisFormData.SSC()

Определяет среднесписочную численность по лицевому счету за отчетный период.

Синтаксис:

ThisForm.ThisFormData.SSC(<дата начала>, <дата окончания>, <режим работы>, <дополнительный  режим>, <дополнительная информация>,<весь расчетный период>) 

Метод содержит пять параметров:

1). Дата начала. Метод определяет среднесписочную численность с этой даты.

2). Дата окончания. Метод определяет среднесписочную численность по эту дату.

3). Режим работы. Метод определяет среднесписочную численность в зависимости от этого режима.

4). Дополнительный режим. Алгоритм подсчета среднесписочной численности зависит от этого режима.

5). Дополнительная информация. Используется при работе дополнительного режима.

6).  Весь  расчетный  период.  Логический  параметр,  при  установке  которого   среднесписочная   численность рассчитывается без учета срока действия лицевого счета на расчетном периоде.

Режимы работы функции:

“1” – подсчет среднесписочной численности для работающих полное время, по календарным дням;

“2” – подсчет  среднесписочной численности  для  работающих  полное  время,  пропорционально  отработанному времени, без учета ФОВ;

“2Т” – подсчет среднесписочной численности для работающих полное время, пропорционально отработанному времени, с учетом ФОВ;

“3Т” – подсчет среднесписочной численности для работающих полное время, пропорционально отработанному времени, с учетом ФОВ, но только за дни, которые по графику работы являются рабочими днями;

“4” ­ подсчет среднесписочной численности для работающих неполное рабочее время, без учета ФОВ;

“4Т” ­ подсчет среднесписочной численности для работающих неполное рабочее время, с учетом ФОВ.

Примечание.

В режимах “1” и “2” параметр “дополнительный режим работы” определяет алгоритм получения информации об отпусках и может принимать следующие значения:

• “1”   ­   информация   об   отпусках   определяется   через   регистр   “Состояния”,   при   этом   в   параметре   “дополнительная информация” должны быть перечислены мнемокоды отпусков;

Page 52: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

52

• “2” ­ информация об отпусках определяется через регистр “Положены выплаты”, при этом в параметре “дополнительная информация” должна быть указана соответствующая группа выплат.

В  режиме  “4” параметр  “дополнительный  режим  работы” определяет  алгоритм  получения  информации  о  днях  неявок  и может принимать следующие значения:

• “1”   ­  информация  о  днях  неявок  определяется  через  регистр   “Состояния”,  при  этом  в  параметре   “дополнительная информация” должны быть перечислены мнемокоды состояний, соответствующих неявкам;

• “2”   ­   информация   о   днях   неявок   определяется   через   регистр   “Положены   выплаты”,   при   этом   в   параметре “дополнительная информация” должна быть указана соответствующая группа выплат.

В режиме “4Т” в параметре “дополнительная информация” можно указать перечень кодов неявок, используемый в алгоритме при получении информации о днях неявок.

Алгоритмы режимов работы функции:

Режим   “1”.  Среднесписочная   численность   работника   за   месяц   вычисляется   путем   суммирования   его среднесписочной численности за каждый день, которая в свою очередь вычисляется как списочная численность за каждый календарный день месяца, т.е. с 1 по 30 или 31 число (для февраля ­ по 28 или 29 число), включая праздничные (нерабочие) и выходные дни, деленная на число календарных дней месяца. При этом из подсчета исключаются дни, на которые приходятся отпуска, указанные через параметры “дополнительный режим работы” и “дополнительная информация”. Списочная численность работника за день принимается равной единице, если его лицевой счет действует на этот день, или нулю в обратном случае.

Режим “2”. Среднесписочная численность работника за месяц вычисляется как в режиме “1”, за исключением того, что списочная численность за каждый календарный день определяется как факт, равный норме из рабочего календаря графика работы лицевого счета за этот день, поделенный на норму за этот же день. Если для графика работы  установлен  флаг   “Учет  количества  ставок”,   то  факт  будет  дополнительно  умножен  на  количество ставок, занимаемых работником при условии, что количество ставок меньше 1. Причем численность работника за выходной   или   праздничный   (нерабочий)   день   по   рабочему   календарю   принимается   равной   списочной численности  работника  за  предшествующий  рабочий  день.  Если  лицевой  счет  имеет  несколько  хроникальных графиков  работ  в  расчетном  периоде,  то  списочная  численность   за  каждый  день  определяется  по  графику работы, соответствующему этому дню.

Режим “2Т”. Среднесписочная численность работника за месяц вычисляется как в режиме “2”, за исключением того, что количество отработанных часов берется не из рабочего календаря графика работы лицевого счета за этот  день,   а  из  ФОВ.  Причем  кол­во  часов   за   выходной  или  праздничный   (нерабочий)  день  по  календарю принимается  равным  количеству  часов  работника  за  предшествующий  рабочий  день,  если  нерабочий  день  по графику работы имеет нулевое значение кол­ва часов в ФОВ, или берется значение кол­ва часов нерабочего дня в ФОВ,   если  оно  ненулевое.  В   этом  режиме  не  учитываются  параметры  “дополнительный  режим  работы”  и “дополнительная информация”.

Режим “3Т”. Среднесписочная численность работника за месяц вычисляется как в режиме “2Т”, за исключением того, что подсчет отработанных часов ведется только за дни, которые по графику работы являются рабочими днями.

Режим “4”. Нерабочие дни по календарю не рассматриваются. Списочная численность за каждый календарный день  берется  как  факт,  равный  норме  из  рабочего  календаря  графика  работы  лицевого  счета   за  этот  день, поделенный на норму за этот же день. Если для графика работы установлен флаг “Учет количества ставок”, то факт будет дополнительно умножен на количество ставок, занимаемых работником при условии, что количество ставок  меньше  1.  За  дни  неявок  (приходящиеся на  рабочие дни  по календарю), определяемые по параметрам “дополнительный  режим  работы” и  “дополнительная  информация”,  в  число  отработанных  часов  включаются часы   по   предыдущему   рабочему   дню.  Среднесписочная   численность   не   полностью   занятых   работников   за 

Page 53: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

53

каждый  день  определяется  путем  деления  списочной численности  за  каждый  день  на  число  рабочих  дней  по календарю в отчетном месяце.  Если лицевой счет имеет несколько хроникальных графиков работ в расчетном периоде, то списочная численность за каждый день определяется по графику работы, соответствующему этому дню.

Режим “4Т”. Нерабочие дни по календарю не рассматриваются. Списочная численность за каждый рабочий день по календарю берется как значение в ФОВ лицевого счета за этот день, поделенное на норму за тот же день. За  дни неявок, определяемые по параметрам “дополнительный режим работы” и “дополнительная информация” (по умолчанию берутся все неявки), в число отработанных часов включаются часы по предыдущему рабочему дню. Среднесписочная численность за месяц – как в режиме “4”.

Примечание. В случае, если перед днем неявки нет рабочих дней по календарю, то значение часов берется из календаря за этот день неявки (считается, что день неявки был рабочим днем по календарю). Если же перед нерабочим днем по календарю нет рабочих дней, то берется значение часов из заголовка Графика работ по формуле: “кол­во часов за день” = “минимальное кол­во часов” / “минимальное кол­во дней”.

Метод определения количества отработанных и неотработанных часов лицевого счета ThisForm.ThisFormData.Workh()

Определяет количество отработанных и неотработанных часов по лицевому счету за отчетный период.

Синтаксис:

ThisForm.ThisFormData.Workh(<дата   начала>,   <дата   окончания>,   <режим   работы>,   < дополнительная информация >) 

Метод содержит четыре параметра:

1). Дата начала. Метод определяет количество часов с этой даты.

2). Дата окончания. Метод определяет количество часов по эту дату.

3). Режим работы. Метод определяет количество часов в зависимости от этого режима.

4). Дополнительная информация. Используется в алгоритме подсчета.

Режимы работы функции:

“1” ­ выполняется подсчет количества неотработанных часов по следующему алгоритму:

• За   каждый   день   отчетного   периода,   по   графику   работы   на   соответствующий   день,   определяется количество отработанного времени (НОРМАВДЕНЬ).

• Определяется неотработанное время на каждый день отчетного периода по формуле  НОРМАВДЕНЬ * (1­MIN(СТАВОК,1)) (по хронике).

• Подсчитывается суммарное число неотработанных часов за отчетный период.

“2” ­ выполняется подсчет количества отработанных часов за период по выплатам, входящим в группу выплат, 

Page 54: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

54

заданную в параметре “дополнительная информация”.

“2Т” ­ выполняется подсчет количества отработанных часов из ФОВ.

Метод определения количества сотрудников, принятых на дополнительно введенные рабочие места

ThisForm.ThisFormData.NewDol()

Определяет количество сотрудников, принятых на дополнительно введенные рабочие места за отчетный период.

Синтаксис:

ThisForm.ThisFormData.NewDol(<дата начала>, <дата окончания>) 

Метод содержит два параметра:

1). Дата начала. Метод определяет количество сотрудников с этой даты.

2). Дата окончания. Метод определяет количество сотрудников по эту дату.

Алгоритм работы функции:

Функция ориентируется на штатную должность, для которой количество дополнительно введенных рабочих мест определяется по следующему алгоритму:

• если должность создана в отчетном периоде, берется количество ставок на конец отчетного периода;

• если   должность   создана   до   отчетного   периода,   берется   разница  между   количеством   ставок   на   конец отчетного периода и количеством ставок на начало отчетного периода.

Далее определяется количество сотрудников, принятых на эту должность в отчетном периоде. Таким образом, возвращаемое значение функции следующее:

MIN(количество дополнительно введенных рабочих мест; количество принятых сотрудников)

Метод определения информации о ставках штатной должности ThisForm.ThisFormData.DolSta()

Определяет  количество вакантных ставок,  занятых ставок  и  общее  количество  ставок  штатной  должности  на конкретную дату.

Синтаксис:

ThisForm.ThisFormData.DolSta(<режим работы>, <дата>, <RN штатной должности>)

Метод содержит три параметра:

1).  Режим   работы. Метод   определяет   количество   вакантных,   занятых   или   общее   количество   ставок   в 

Page 55: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

55

зависимости от режима работы.

2). Дата. Метод определяет количество ставок на эту дату. По умолчанию берется текущая системная дата.

3). RN штатной должности. Необязательный параметр – ссылка на штатную должность, по умолчанию берется ZPOST.POST_RN.

Режимы работы функции:

1 – определяется общее количество ставок штатной должности на указанную дату;

2 – определяется количество занятых ставок штатной должности на указанную дату;

3 – определяется количество вакантных ставок штатной должности на указанную дату.

Пример использования метода:

ThisForm.ThisFormData.DolSta(3)

Метод возвратит количество вакантных ставок текущей штатной должности на текущую системную дату.

Метод определения информации о прогнозируемом изменении категории ФОТ, к которой привязаны функции смыслового

контроля ThisForm.ThisFormData.CheckFunc()

Определяет дату срабатывания функции смыслового контроля и параметры, влияющие на изменение категории ФОТ.

Синтаксис:

ThisForm.ThisFormData.CheckFunc(<режим   работы>,   <категория   ФОТ>,   <функция   смыслового  контроля>, <дата начала периода>, <дата окончания периода>) 

Метод содержит пять параметров:

1). Режим работы. Определяет характер возвращаемой информации.

2). Категория ФОТ. Категория ФОТ лицевого счета.

3). Функция смыслового контроля. Функция смыслового контроля, срабатывание которой будет проверяться.

4). Дата начала периода. Метод проверяет срабатывание функции смыслового контроля начиная с этой даты. По умолчанию – текущая системная дата.

5).  Дата окончания периода. Метод проверяет срабатывание функции смыслового контроля по эту дату. По умолчанию – конец года, в котором находится текущая системная дата.

Режимы работы функции:

1 – определяется  дата срабатывания  функции  смыслового  контроля,  условие  срабатывания,  новое  значение 

Page 56: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

56

категории  ФОТ.  Все  эти  данные  возвращаются  функцией  в  строке,  в  перечисленном  порядке,  разделенные символом “/”.

Пример использования метода:

ThisForm.ThisFormData.CheckFunc(1,’Надбавка ­ стаж’,’Стаж’)

При срабатывании функции смыслового контроля “Стаж”, привязанной к категории ФОТ “Надбавка ­ стаж”, на периоде с текущей системной даты по конец текущего года, возвращает строку, содержащую дату срабатывания функции смыслового контроля, условие ее срабатывания, новое значение категории ФОТ.

Метод определения различных сумм по проекту фонда оплаты труда лицевых счетов пункта приказа

ThisForm.ThisFormData.TarifOrder()

Определяет   значение  сумм,  процентов,  разрядов  и  т.д.  для,  определенных  в  параметрах  метода,  категорий состава ФОТ.

Синтаксис:

ThisForm.ThisFormData.TarifOrder(<Массив строк заданий или строка задания>, <дата>, <ссылка на  проект лицевого счета>)

Метод содержит три параметра:

1). Массив строк заданий или строка задания. Метод определяет одно или более значение (сумм) по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

2).  Дата. Метод определяет значения на указанную дату. Если дата не указана, метод определяет значения на дату в зависимости от типа приказа. Например, для типа “основная работа” и действия “изменить” дата будет равна дате начала действия проекта  ЛС. Для  того, чтобы бралась дата приказа необходимо указать ее явный вызов в параметрах вызова функции, как zOrdBs.Doc_Date.  

3). Ссылка на проект лицевой счет. Необязательный параметр, указывающий ссылку на проект лицевого счета.

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка,  содержащая  описание  задания.  При  выполнении  i–того  задания  методом,  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис:

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга 

Page 57: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

57

запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп  категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды групп по словарю “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в   соответствии   со словарем (15 символов)

Список   категорий  ФОТ

Определяет,   какие виды  категорий  ФОТ рассматривать   при подсчете   искомой величины

Мнемокоды   видов  категорий ФОТ   по   словарю  “Состав ФОТ”

Те же требования

Возвращаемое  значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

“ДН”

“ДО”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Дата начала

Дата окончания

Для   обозначений используются   русские буквы   в   любом регистре.

Признак   учитывать  в ФОТ

Определяет учитывать   или   нет категории  ФОТ   с   не установленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

Page 58: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

58

При  обработке  задания  будут  определены  суммарные  значения  искомой  величины  для  всех  категорий  ФОТ, удовлетворяющих условиям отбора, заданных параметрами.

Примечания.1) Если значение параметра “” (пусто), то соответствующее ему, условие отбора не участвует при обработке категорий ФОТ (т.е. отбираются категории ФОТ с любым значением этого параметра).2) Метод ThisForm.ThisFormData.TarifOrder() может применяться в настраиваемых формах приказов.3) Метод всегда возвращает тип – число.

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива:

Синтаксис:

NValue = ThisForm.ThisFormData.TarifOrder(<строка задания>)

Найденное значение будет присвоено переменной Nvalue.

Пример формирования списка заданий:Dimension __pTaskList(3,2)

__pTaskList(1,1) = '"","Оклад          ,Надбавка       ","и",""'

Задание 1: Найти итоговую сумму категорий ФОТ оклад и надбавка.

__pTaskList(2,1) = '"","Оклад          ","р",""'

Задание 2: Найти разряд по категории ФОТ “Оклад”.

__pTaskList(3,1) = '"Доплаты        ","","и",""'

Задание 3: Найти итоговую сумму категорий ФОТ, входящих в группу “Доплаты”.

Пример использования метода:ThisForm.ThisFormData.TarifOrder(@__pTaskList)

Выполняет выше описанные задания на текущую системную дату и заполняет результатами вторые элементы строк массива __pTaskList.

Метод определения различных сумм по проекту фонда оплаты труда штатных должностей пункта приказа

ThisForm.ThisFormData.TarifDolOrder()

Метод аналогичен по действию и по набору параметров методам Tarif   O   rder    и TarifD   ol   , которые описаны выше.

Главным   отличием   является   то,   что  метод   работает   с   регистром   проекта  фонда   оплаты   труда   проекта должностей приказов. Метод используется для настройки печати пунктов приказов.

Метод доступа по индексному ключу к связанным таблицам ThisForm.ThisFormData.Seek_TableField()

Метод отыскивает запись по индексному выражению и возвращает значение поля.

Синтаксис:

Page 59: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

59

ThisForm.ThisFormData.Seek_TableField  (<Имя  таблицы,   в   которой   искать>,   <Имя   индекса   для  поиска>, <Имя поля записи, значение которого вернуть>,<выражение для поиска>)

Пример использования метода:

ThisForm.ThisFormData.Seek_TableField(“ZVIDISP”,”RN”,”CODE”,ZFCAC.VIDISP_RN)

Вернет значение мнемокода вида лицевого счета из словаря “Виды лицевых счетов” (таблица ZVIDISP).

Метод поиска записи в таблице ThisForm.ThisFormData.Locate_TableField()

Метод отыскивает запись и возвращает значение поля.

Синтаксис:

ThisForm.ThisFormData.Locate_TableField  (<Имя  таблицы,  в  которой  искать>,  <Имя  поля   записи,  значение которого вернуть>, <выражение для поиска>)

Пример использования метода:

ThisForm.ThisFormData.Locate_TableField(“ZVIDISP”,”CODE”, “MAIN = .T.”)

Вернет значение мнемокода первого основного вида лицевого счета из словаря “Виды лицевых счетов” (таблица ZVIDISP).

Метод обработки информации при формировании статистического отчета ThisForm.ThisFormData.StatObr()

Формирует базу данных DoplStat со статистической информацией.

Синтаксис:

ThisForm.ThisFormData.StatObr(<Массив разделов>, <Массив строк>, <Массив колонок>)

Метод содержит три параметра:

1). Массив разделов. Разделы описываются в элементах массива по строго формализованным правилам.

2). Массив строк. Строки описываются в элементах массива по строго формализованным правилам.

3). Массив колонок. Колонки описываются в элементах массива по строго формализованным правилам.

Структура массива разделов: Каждая строка массива описывает один раздел.

Описание структуры элемента массива разделов:

Синтаксис:

Page 60: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

60

aRazd(i) = ‘номер родительского раздела, логическое выражение условия раздела‘.

Описание параметров строки раздела:

Параметр Описание Допустимые значения Описание

Номер  родительского  раздела

Определяет,  является ли   данный   раздел потомком   другого раздела

От   нуля   до   максимального номера раздела

Указание   номера родительского   раздела необходимо   для правильного   учета информации   в   строках типа “прочие в разделе”

Логическое  выражение   условия  раздела

Определяет   условие принадлежности   к данному разделу

Логическое  FoxPro­выражение 

Условие принадлежности   к разделу   необходимо для   правильного   учета информации   в   строках типа “всего по разделу”

Пример формирования массива разделов:

Dimension __pRazd(3)

__pRazd(1) = '0,zFcAc.IsMainIsp'

__pRazd(2) = '1,zKatPer.Code=”Руководство”'

__pRazd(3) = '1,zKatPer.Code=”Рабочие”'

Структура массива строк: Каждая строка массива описывает одну строку.

Описание структуры элемента массива строк:

Синтаксис:

aStrok(i) = ‘номер раздела, заголовок строки, логическое выражение условия строки или тип строки‘.

Описание параметров строки строк:

Параметр Описание Допустимые значения Описание

Номер раздела Определяет принадлежность данной   строки   к определнному разделу

От   минимального   до максимального   номера раздела

Указание   номера раздела   необходимо для   правильного   учета информации   в   строках типа “всего по разделу” и “прочие в разделе”

Заголовок строки Текст   заголовка строки

Текст   длиной   до   250 символов

Заголовок   строки помещается   в отдельное   поле 

Page 61: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

61

Параметр Описание Допустимые значения Описание

формируемой базы

Логическое  выражение   условия  строки   или   тип  строки

Определяет   условие принадлежности   к данной   строки,   либо тип строки

Логическое  FoxPro­выражение,   либо   “всего   по разделу”   или   “прочие   в разделе” 

Условие принадлежности   к строке  необходимо  для правильного   учета информации в строках

Пример формирования массива строк:

Dimension __pStrok(3)

__pStrok(1) = '2, Заместителей директора, zTipDol.Code=”Зам.директора”'

__pStrok(2) = '3, Фрезировщиков, zTipDol.Code=”Фрезировщик”'

__pStrok(3) = '1, Всего работников, всего по разделу'

Структура массива колонок: Каждая строка массива описывает одну колонку.

Описание структуры элемента массива колонок:

Синтаксис:

aKol(i) = ‘выражение для суммирования, логическое выражение условия колонки‘.

Описание параметров строки колонок:

Параметр Описание Допустимые значения Описание

Выражение   для  суммирование

Определяет  число,  на которое   будет увеличиваться значение колонки

Числовое   выражение   или ссылка на числовое поле

Прибавляется   к   сумме колонки

Логическое  выражение   условия  колонки

Определяет   условие принадлежности   к данной колонке

Логическое  FoxPro­выражение 

Условие принадлежности   к колонке   необходимо для   правильного   учета информации в колонках

Пример формирования массива разделов:

Dimension __pKol(3)

__pKol(1) = '1, betw(person.birthday,gomo(oSystem.Date,­12*31)+1,gomo(oSystem.Date,­12*21))'

__pKol(2) = '1, betw(person.birthday,gomo(oSystem.Date,­12*41)+1,gomo(oSystem.Date,­12*31))'

__pKol(3) = '1, betw(person.birthday,gomo(oSystem.Date,­12*51)+1,gomo(oSystem.Date,­12*41))'

Page 62: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

62

Пример использования метода:ThisForm.ThisFormData.StatObr(@__pRazd, @__pStrok, @__pKol)

Формирует базу данных DOPLSTAT с полями:

- Nstr – порядковый номер строки

- Namestr – заголовок строки

- Kol1 – суммы первой колонки

- Kol2 – суммы второй колонки

- Kol3 – суммы третей колонки

Каждая запись базы соответствует массиву строк, т.е. записей ровно столько, сколько элементов в массиве строк.

Метод определения количества дней из фонда отработанного времени лицевого счета ThisForm.ThisFormData.WTD()

Определяет количество дней из фонда отработанного времени по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.WTD(<условие отбора>, <год>, <месяц>, <день С>, <день По>) 

Метод содержит пять параметров:

1). Условие отбора. Метод определяет количество дней, соответствующих условию отбора.

2). Год. Метод определяет количество дней в периоде, ограниченном указанным годом.

3). Месяц. Метод определяет количество дней в периоде, ограниченном указанным месяцом.

4). День С. Метод определяет количество дней в периоде, ограниченном указанным днем С.

5). День По. Метод определяет количество дней в периоде, ограниченном указанным днем По.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

- ЧО() – проверяет наличие в определенном дне основных часов;

- ТД(<типы дней>) – проверяет соответствие типа дня типам, приведенным в списке;

- ДН – проверяет соответствие дня дню неявки;

- & ­ логический оператор “И”;

Page 63: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

63

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все записи.

Период отбора формируется следующим образом:

• Начало периода – дата (День С, Месяц, Год).

• Конец периода – дата (День По, Месяц, Год).

• В случае отсутствия параметров Год, Месяц, День С, День По в качестве периода будет взят период из формы настройки отчета.

Метод определения количества часов из фонда отработанного времени лицевого счета ThisForm.ThisFormData.WTH()

Определяет количество часов из фонда отработанного времени по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.WTH(<условие отбора>, <год>, <месяц>, <день С>, <день По>) 

Метод содержит пять параметров:

1). Условие отбора. Метод определяет количество дней, соответствующих условию отбора.

2). Год. Метод определяет количество дней в периоде, ограниченном указанным годом.

3). Месяц. Метод определяет количество дней в периоде, ограниченном указанным месяцом.

4). День С. Метод определяет количество дней в периоде, ограниченном указанным днем С.

5). День По. Метод определяет количество дней в периоде, ограниченном указанным днем По.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

- ЧО() – проверяет наличие в определенном дне основных часов;

- ТД(<типы дней>) – проверяет соответствие типа дня типам, приведенным в списке;

- ДН – проверяет соответствие дня дню неявки;

- & ­ логический оператор “И”;

Page 64: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

64

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все записи.

Период отбора формируется следующим образом:

• Начало периода – дата (День С, Месяц, Год).

• Конец периода – дата (День По, Месяц, Год).

• В случае отсутствия параметров Год, Месяц, День С, День По в качестве периода будет взят период из формы настройки отчета.

Полезные свойства объекта доступа к данным для печати ThisForm.ThisFormData

Свойство Описание

ThisForm.ThisFormData.Rep_cChief Содержит   ФИО   руководителя   из контрагента “МЫ”

ThisForm.ThisFormData.Rep_cChiefDol Содержит   должность   руководителя   из контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmGlavBuh Содержит   ФИО   главного   бухгалтера   из контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmInn Содержит ИНН контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmMnemo Содержит мнемокод контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmName Содержит название контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmNationalName Содержит   национальное   наименование контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmOKFS Содержит ОКФС контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmOKONX Содержит ОКОНХ контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmOKPO Содержит ОКПО контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmOrigenalName  Содержит   оригинальное   название контрагента “МЫ”

ThisForm.ThisFormData.Rep_cFirmTel Содержит телефон контрагента “МЫ”

ThisForm.ThisFormData.Rep_lLow Содержит   признак   юридического   лица контрагента “МЫ” .T. – юридическое лицо, 

Page 65: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

65

Свойство Описание

.F. – физическое лицо

ThisForm.ThisFormData.Rep_cChiefOrgRn RN   контрагента   –   руководителя   из настроек системы

ThisForm.ThisFormData.Rep_cFirmGlavBuhOrgRn RN контрагента   –   главного  бухгалтера  из настроек системы

ThisForm.ThisFormData.Rep_cFirmPersonMngRn RN   контрагента   –   начальника   отдела кадров из настроек системы

Использование методов объекта ThisForm.ThisFormData.ObSolver

Объект  предосталяет методы  доступа к данным модуля  “Бухгалтерия” и содержит  функции, используемые в расчетных таблицах такие как:

OBDB()  ­ оборот по дебету

OBCR() – оборот по кредиту

OSDB() – остаток по дебету

OSCR() – остаток по кркдиту

PRICE() ­ цена

RATE() ­ курс

SMETA() ­ смета

ISUM() – подсчет сумм в инвентарной картотеке

IHIST() – подсчет сумм в истории операций по инвентарной картотеке

Описание параметры функций и примеры использования приводятся в поставляемых расчетных таблицах

Пример использования в шаблоне отчета: 

ThisForm.ThisFormData.ObSolver.OBDB("001[048,,002],DataFrom, DataEnd)

 Метод формирования списка выплат/удержаний ThisForm.ThisFormData.MakeColNU()

Формирует массив выплат или удержаний, соответствующих параметрам метода.

Page 66: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

66

Синтаксис: ThisForm.ThisFormData.MakeColNU(<Массив строк заданий>, <период>, <считать по месяцу ЗА>)

Метод содержит два обязательных параметра и один необязательный:

1). Массив строк заданий 

Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание.

Описание структуры массива:

Синтаксис: aTaskList(i) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов”, ”Признак учитывать конфиденциальные выплаты”‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (“”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения

Описание

Тип Тип   выплаты/удержания. Определяет,   какой   тип выплаты   или   удержания рассматривать   при формировании списка

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Список групп выплат

Определяет,   какие   группы выплат,   удержаний рассматривать   при формировании списка

Мнемокоды   групп   по словарю   “Группы   выплат  и удержаний”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются  полностью   в соответствии со словарем (15 символов)

Список расчетных алгоритмов

При   формировании   списка будут рассматриваться только те   выплаты  и   удержания, которые  рассчитываются  по заданному  списку алгоритмов

Мнемокоды   расчетных алгоритмов   по   списку алгоритмов,   установленных в системе

Мнемокоды   алгоритмов разделяются   запятыми. Мнемокоды   алгоритмов указываются   полностью   в соответствии со списком (15 символов)

Список видов выплат, 

Определяет,   какие   виды выплат,   удержаний 

Мнемокоды   видов   выплат, удержаний   по   словарю 

Те же требования

Page 67: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

67

Параметр Описание Допустимые значения

Описание

удержаний рассматривать   при формировании списка

“Выплаты и удержания” 

Список расчетов Определяет,   какие   расчеты рассматривать   при формировании списка

Мнемокоды  видов  расчетов по словарю “Виды расчетов”

Те же требования

Признак учитывать конфиденциальные  выплаты

Определяет   учитывать  или нет   конфиденциальные выплаты  при  формировании списка

“.T.”

“” (пусто)

Учитывать

Не учитывать

Примечание.  Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке выплат/удержаний (т.е. берутся все).

2). Период. Определяет период, в котором рассматривать выплаты/удержания.

Допустимые значения Описание

“Период”

“Год”

“Год + Период”

“D1 = <дата С…>, D2 = <дата по…>”

“” (Пусто)

В текущем расчетном периоде

В текущем году (соответствующем текущему расчетному периоду), не включая текущий расчетный период

Тоже, включая текущий расчетный период

Задает период датами С…, По…, которые могут быть константами или переменными

Период не рассматриватеся

Примечания.1)  Метод  ThisForm.ThisFormData.MakeColNU()  может  применяться  в  настраиваемых  формах  ведомостей, лицевых счетов, сводов ведомостей, расчетов отпусков и больничных, формах налоговой отчетности, денежных аттестатах. В версиях Паруса 7.69 – 7.70 в лицевых счетах функция работает некорректно.2) При печати ведомостей текущим расчетным периодом является период ведомости.

3.) Считать  по  месяцу  ЗА.  Логический  параметр,  при  установке  которого  будут  рассматриваться только  те выплаты, месяц и год ЗА которых совпадает с Периодом (второй параметр).

Возвращаемое значение:

Метод   переформировывает   массив   строк   заданий  aTaskList(nTask)  в   массив   выплат/удержаний aTaskList(nCol,3), где nCol – количество выплат/удержаний, удовлетворяющих заданиям.

В элемент aTaskList(nCol,1) заносится мнемокод выплаты/удержания.

В элемент aTaskList(nCol,2) заносится наименование выплаты/удержания.

В элемент aTaskList(nCol,3) заносится порядковый номер выплаты/удержания.

Page 68: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

68

Метод формирования строки наименований вышестоящих подразделений ThisForm.ThisFormData.PodrNames()

Метод возвращает наименования вышестоящих подразделений, являющихся родительскими для указанного.

Синтаксис:

ThisForm.ThisFormData.PodrNames  (<RN  подразделения>,   <Уровень   вложенности>,   <падеж>, <символ разделения>, <одно подразделение>)

Метод содержит пять параметров:

1). RN подразделения. Задает RN подразделения для поиска в БД zSUBDIV.

2).  Уровень   вложенности.   Числовое   значение,   указывающее   ­   на   сколько   уровней   вверх   будут   браться родительские  подразделения.  Если  число  превышает  количество  существующих  родительских  подразделений, будут взяты только имеющиеся. Если число положительное, список подразделений будет строиться снизу вверх, т.е. сначала родитель переданного подразделения, потом его родитель и т.д. Если число отрицательное, список будет строиться сверху вниз, т.е. сначала главное подразделение, потом его потомок и т.д. вплоть до родителя переданного подразделения или до окончания количества уровней вложенности.

3).  Падеж. Определяет в каком падеже вернуть значение. Может принимать одно из перечисленных значений: "и",   "р",   "д",   "в",   "т",   которые   соответствуют   именительному,   родительному,   дательному,   винительному, творительному     падежам.   По   умолчанию   ставится   "и".   Значения   берутся   из   соответствующих   полей “Подразделения”.

4). Символ разделения. Задает символ, которым будут разделены наименования подразделений. По умолчанию параметр принимает значение " ".

5). Одно подразделение. Логический признак, указывающий что необходимо вернуть наименование лишь одного подразделения, отстоящего от переданного на указанное количество уровней вложенности.

Пример:

ThisForm.ThisFormData.PodrNames(zFCAC.SUBDIV_RN,2,"Р",";") – для подразделения текущего лицевого счета возвращает   наименования  двух  родительских  подразделений   в  родительном  падеже,  разделенных   точкой   с запятой.

 Методы определения различной информации из БД ThisForm.ThisFormData.Spi_…()

Методы  SPI_ANK,   SPI_LIC,   SPI_TAR,   SPI_NAR,   SPI_ORG  определяют  различную  информацию  из  БД  и сохраняют эту информацию во временной таблице, удобной для печати. Различия в работе этих методов описаны в   примечании,   в   остальном   алгоритм   их   функционирования   идентичен,   поэтому   для   описания   будет использоваться метод SPI_ANK.

Синтаксис:

ThisForm.ThisFormData.Spi_Ank(<Массив строк заданий или строка задания>)

Page 69: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

69

Метод содержит один параметр:

1). Массив строк заданий или строка задания. Метод формирует одну или более временных таблиц по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание.

Описание структуры элемента массива (строки):

Синтаксис:

aTaskList(i) = ‘ “База  данных ”, ”Список   возвращаемых  полей”, ”Дополнительное   условие  отбора”, ”Префикс блока данных”, “Список дополнительных баз данных” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

База данных Определяет,   из   какой   БД   будет производиться выборка информации

Список возвращаемых полей

Определяет,   какие   поля   из   Базы данных   и   из   дополнительных   баз данных попадут во временную таблицу

Имя   поля   из   базы   данных   или   имя поля из доп. базы данных с указанием ее имени 

Имена   полей разделяются запятыми. 

Доп.  условие отбора

Определяет   дополнительное   условие отбора записей из Базы данных

FoxPro­выражение

Префикс блока данных

Определяет   первые   символы   в названии   полей   таблицы   DOPLSPEC, которые   относятся   к   блоку   данных задания

Любые  символы,  допустимые  в  именах полей таблиц.

Список дополнительных   баз данных

Список   баз   данных,   связанных   с основной БД.

Перед   именем   каждой   базы необходимо   указать   условие   связи: знак “=” соответствует привязке через “Inner  Join”,   знак   “?”   ­   через   “Left Join”.   После   имени   БД   в   скобках необходимо   указать   условие   связи между БД.

Имена   баз данных разделяются запятыми.

При обработке задания все найденные данные будут записаны в служебную таблицу DOPLSPEC.

Структура таблицы DOPLSPEC:

Page 70: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

70

Каждая   запись   таблицы   DOPLSPEC,   соответствует   одной   записи  Базы   данных,   обработанной   методом .SPI_ANK().

Метод .SPI_ANK() автоматически формирует поля таблицы DOPLSPEC  и присваивает им названия по принципу: Префикс блока данных + ”_” (символ подчеркивания) + имя поля из Списка возвращаемых полей. При этом данное название будет усекаться до 10 символов.

Дополнительная обработка полученных данных:

1) Сортировка. Данные, полученные методом, можно отсортировать в необходимом для отображения порядке. Для   этого   в   параметре  “Список   возвращаемых   полей”  перед   каждым   обозначением,   по   которому необходимо сортировать, необходимо поставить символ “^“ (крышка). При этом порядок сортировки  будет определяться  порядком  следования  обозначений  с  “крышкой”. Если  вместо  символа  “^“  указать  символы “^!“ сортировка будет производиться по убыванию

2) Группировка.  Данные,  полученные  методом,  можно  сгруппировать  в  необходимом  порядке.  Для  этого  в параметре  “Список   возвращаемых   полей”  перед   каждым   обозначением,   по   которому  необходимо группировать, необходимо поставить символ “*“ (звезда).

Примечания.1) Метод  ThisForm.ThisFormData.SPI_ANK() формирует  условие  отбора  из  “Базы  данных” через  привязку  к  полю  БД 

“ZANK.ANK_RN” или к полю “ZANK.ORGBASE_RN” в зависимости от того, есть ли аналогичные поля в исходной БД. Таким образом, перед запуском метода необходимо позиционироваться в базе “ZANK”. Аналогичным образом работают методы SPI_LIC(), SPI_ORG(), SPI_NAR() и SPI_TAR(), которые привязываются к следующим полям: ZFCAC.FCAC_RN, ORGBASE.RN, DDUTY.DUTY_RN и TFCAC.TFCAC_RN соответственно.

Частный случай. Задание одно. В этом случае приемлем синтаксис без использования массива:

Синтаксис:

ThisForm.ThisFormData.Spi_Ank(<строка задания>)

Пример использования метода:

ThisForm.ThisFormData.SPI_ANK(‘”zEmpAtt”, ”Date,Docnumber,Rating,^zPost.Code”, ”Date<=oSystem.Date”, ”R”, ”=zPost(Post_RN=zEmpAtt.Post_RN)”’)

Извлекает   аттестации   сотрудника  до   текущей   даты   с   заполненной  штатной   должностью,   сортирует  их   по мнемокоду штатной должности и заполняет результатами служебную таблицу DOPLSPEC.

Таблица DOPLSPEC примет следующую структуру:

Поле Тип Описание

DOPLSPEC.R_DATE D Дата аттестации

DOPLSPEC.R_DOCNUMBE C Номер документа

DOPLSPEC.R_RATING C Оценка

DOPLSPEC.R_CODE C Мнемокод штатной должности

Page 71: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

71

Метод определения информации о параметрах оснований приказов ThisForm.ThisFormData.Ord_Osn()

Определяет значения параметров оснований, привязанных к приказу.

Синтаксис:

ThisForm.ThisFormData.Ord_Osn(<мнемокод выплаты>, <код параметра>)

Метод содержит два параметра:

1). Мнемокод выплаты. Метод определяет параметры основания по указанной выплате.

2).  Код параметра. Метод возвращает значение параметра в соответствии с указанным кодом. Список кодов параметров оснований приведен в файле “параметры алгоритмов.xls”

Пример использования метода:

ThisForm.ThisFormData.Ord_Osn(“Надб. за стаж”,’PRC’)

Метод   возвратит   значение   процента   основания   по   выплате   “Надбавка   за   стаж”.  Поиск   основания   будет осуществляться по текущему приказу (ссылка на  ZORDSP.ORDSP_RN).

Метод определения количества дней отработанного времени лицевого счета за период ThisForm.ThisFormData.WTDP()

Определяет количество дней из фонда отработанного времени по лицевому счету за период.

Синтаксис:

ThisForm.ThisFormData.WTDP(<условие отбора>, <дата С>, <дата По>) 

Метод содержит три параметра:

1). Условие отбора. Метод определяет количество дней, соответствующих условию отбора.

2). Дата С. Метод определяет количество дней в периоде, ограниченном указанной датой С.

3). Дата По. Метод определяет количество дней в периоде, ограниченном указанной датой По.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

Page 72: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

72

- ЧО() – проверяет наличие в определенном дне основных часов;

- ТД(<типы дней>) – проверяет соответствие типа дня типам, приведенным в списке;

- ДН – проверяет соответствие дня дню неявки;

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все записи.

В случае отсутствия параметров Дата С, Дата По в качестве периода будет взят период из формы настройки отчета.

Примеры использования метода:

1) ThisForm.ThisFormData.WTDP(“ТЧ(’Д’)“)

Метод возвратит количество дней, в которых есть тип часа Д (дневные) за период, указанный в форме настройки отчета.

2) ThisForm.ThisFormData.WTDP(“ЧО()”, DATE(2007,01,01), DATE(2007,01,31))

Метод возвратит количество дней, в которых есть часы  основного типа за январь 2007 года.

Метод определения количества часов отработанного времени лицевого счета за период ThisForm.ThisFormData.WTHP()

Определяет количество часов из фонда отработанного времени по лицевому счету за период.

Синтаксис:

ThisForm.ThisFormData.WTHP(<условие отбора>, <дата С>, <дата По>) 

Метод содержит три параметра:

1). Условие отбора. Метод определяет количество часов, соответствующих условию отбора.

2). Дата С. Метод определяет количество часов в периоде, ограниченном указанной датой С.

3). Дата По. Метод определяет количество часов в периоде, ограниченном указанной датой По.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

Page 73: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

73

- ЧО() – проверяет наличие в определенном дне основных часов;

- ТД(<типы дней>) – проверяет соответствие типа дня типам, приведенным в списке;

- ДН – проверяет соответствие дня дню неявки;

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все записи.

В случае отсутствия параметров Дата С, Дата По в качестве периода будет взят период из формы настройки отчета.

Метод определения количества рабочих дней из графика работ лицевого счета ThisForm.ThisFormData.WTDN()

Определяет количество рабочих дней из графика работ по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.WTDN(<условие   отбора>,   <год>,   <месяц>,   <день   С>,   <день   По>,<график  работы>) 

Метод содержит шесть параметров:

1). Условие отбора. Метод определяет количество рабочих дней, соответствующих условию отбора.

2). Год. Метод определяет количество рабочих дней в периоде, ограниченном указанным годом.

3). Месяц. Метод определяет количество рабочих дней в периоде, ограниченном указанным месяцом.

4). День С. Метод определяет количество рабочих дней в периоде, ограниченном указанным днем С.

5). День По. Метод определяет количество рабочих дней в периоде, ограниченном указанным днем По.

5).  График  работы. Метод  определяет  количество  рабочих  дней  по  указанному  графику  работы  (ссылка  на zGRRbDc.GrRbDc_RN). Если не задана,  то по графику работ лицевого счета

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарем типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

- ЧО() – проверяет наличие в определенном дне основных часов;

Page 74: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

74

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все рабочие дни.

Период отбора формируется следующим образом:

• Начало периода – дата (День С, Месяц, Год).

• Конец периода – дата (День По, Месяц, Год).

• В случае отсутствия параметров Год, Месяц, День С, День По в качестве периода будет взят период из формы настройки отчета.

Примечание:

Так  как  График  работ  является  хроникальным  атрибутом  лицевого  счета,  расчет  количества  рабочих  дней будет  производится  в  соответствии  с  хроникальными  изменениями  графика  работ  лицевого  счета  в  периоде отбора.

Метод определения количества рабочих часов из графика работ лицевого счета ThisForm.ThisFormData.WTHN()

Определяет количество рабочих часов из графика работ по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.WTHN(<условие   отбора>,   <год>,   <месяц>,   <день  С>,   <день  По>,<график  работы>) 

Метод содержит шесть параметров:

1). Условие отбора. Метод определяет количество рабочих часов, соответствующих условию отбора.

2). Год. Метод определяет количество рабочих часов в периоде, ограниченном указанным годом.

3). Месяц. Метод определяет количество рабочих часов в периоде, ограниченном указанным месяцом.

4). День С. Метод определяет количество рабочих часов в периоде, ограниченном указанным днем С.

5). День По. Метод определяет количество рабочих часов в периоде, ограниченном указанным днем По.

График  работы. Метод  определяет  количество  рабочих  часов  по  указанному   графику  работы   (ссылка  на zGRRbDc.GrRbDc_RN). Если не задана,  то по графику работ лицевого счета

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарем типов часов.

Page 75: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

75

• Логическое выражение, составленное из следующих операторов:

- ТЧ(<типы часов>) – проверяет наличие в определенном дне типа часов из приведенного списка;

- ЧО() – проверяет наличие в определенном дне основных часов;

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора отбираются все рабочие часы.

Период отбора формируется следующим образом:

• Начало периода – дата (День С, Месяц, Год).

• Конец периода – дата (День По, Месяц, Год).

• В случае отсутствия параметров Год, Месяц, День С, День По в качестве периода будет взят период из формы настройки отчета.

Примечание:

Так  как  График  работ  является  хроникальным  атрибутом  лицевого  счета,  расчет  количества  рабочих  часов будет  производится  в  соответствии  с  хроникальными  изменениями  графика  работ  лицевого  счета  в  периоде отбора.

Метод определения количества дней различных типов из фонда отработанного времени лицевого счета

ThisForm.ThisFormData.SPI_WTD()

Определяет количество дней различных типов из фонда отработанного времени по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.SPI_WTD(<условие отбора>,<отбирать без учета количества часов>) 

Метод содержит один параметр:

1). Условие отбора. Метод определяет количество дней различных типов, соответствующих условию отбора.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

- ТД(<типы дней>) – проверяет соответствие типа дня типам, приведенным в списке;

Page 76: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

76

- ДН() – проверяет соответствие дня дню неявки;

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора метод прекращает работу.

2).  Отбирать   без   учета   количества   часов.  Логический   параметр,   при   установке   которого   будут рассматриваться только дни, соответствующие заданным типам дней без учета количества часов по этим дням.

Период отбора формируется следующим образом:

• В качестве периода берется период из формы настройки отчета.

Метод создает курсор “SPECDAY”, строки которого соответсвуют типам дней, указанным в условии отбора. У курсора есть три поля:  TYPE – сокращенное наименование типа дня,  NUM – порядковый номер типа дня,  D – количество отработанных дней данного типа. Если количество дней равно нулю – данная строка удаляется из курсора.

Примеры использования метода:

1) ThisForm.ThisFormData.SPI_WTD(“ТД(’Б’)“)

Метод сформирует курсор по типу дней Б (больничные).

2) ThisForm.ThisFormData.SPI_WTD(“ДН()“,.T.)

Метод сформирует курсор для типов дней, соответствующих неявке без учета кол­ва часов по этим дням.

Метод определения количества часов различных типов из фонда отработанного времени лицевого счета

ThisForm.ThisFormData.SPI_WTH()

Определяет количество часов различных типов из фонда отработанного времени по лицевому счету за период в пределах месяца.

Синтаксис:

ThisForm.ThisFormData.SPI_WTH(<условие отбора>) 

Метод содержит один параметр:

1). Условие отбора. Метод определяет количество часов различных типов, соответствующих условию отбора.

Условие отбора формируется следующим образом:

• FoxPro­выражение, которое может быть связано со словарями типов дней или типов часов.

• Логическое выражение, составленное из следующих операторов:

Page 77: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

77

- ТЧ(<типы часов>) – проверяет наличие типа часов из приведенного списка;

- ЧО() – проверяет наличие основных часов;

- & ­ логический оператор “И”;

- | ­ логический оператор “ИЛИ”.

• В случае отсутствия условия отбора метод прекращает работу.

Период отбора формируется следующим образом:

• В качестве периода берется период из формы настройки отчета.

Метод создает курсор “SPECDAY”, строки которого соответсвуют типам часов, указанным в условии отбора. У курсора есть тридцать четыре поля:  TYPE – сокращенное наименование типа часа,  NUM – порядковый номер типа   часа,  SUMHR  –   количество   отработанных   часов   данного   типа   за   период,  D1…D31   ­   количество отработанных часов данного типа за конкретный день месяца. Если количество часов за период равно нулю – данная строка удаляется из курсора.

Метод определения параметров стажа сотрудника ThisForm.ThisFormData.Stazh()

Определяет параметры определенного стажа сотрудника.

Синтаксис:

ThisForm.ThisFormData.Stazh(<тип   задания>,   <мнемокод   стажа>,   <дата>,   <лет>,   <месяцев>,  <дней>) 

Метод содержит шесть параметров:

1). Тип задания. Метод определяет параметры стажа, соответствующих указанному типу задания. 

2). Мнемокод стажа. Метод определяет параметры стажа, соответствующего указанному мнемокоду.

3).  Дата. Метод определяет параметры стажа на указанную дату. Если дата не указана, будет использоваться дата окончания расчетного периода.

4­6).  Лет,   Месяцев,   Дней  –   параметры,   которые   можно   использовать   для   получения   по   ссылке продолжительности стажа. В общем случае – могут быть равны нулю.

На данный момент реализован только один тип задания – “1”, по которому метод возвращает продолжительность указанного стажа в виде строки следующих форматов:

- “10л11м12д”, что соответствует десяти годам одиннадцати месяцам двенадцати дням;

- “22г   23д”, что соответствует двадцатидвум годам двадцатитрем дням.

Наличие   в   типе   задания   буквы   “п”   (например,   “1п”)   позволяет   получить   в   возвращаемой   строке   полное 

Page 78: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

78

наименование хроникальных интервалов: “10 лет 11 месяцев 12 дней”.

Метод определения различных сумм по фонду оплаты труда тарификационного списка ThisForm.ThisFormData.TarifLst()

Определяет значение различных параметров категорий ФОТ тарификационного списка.

Синтаксис:

ThisForm.ThisFormData.TarifLst(<Массив строк заданий или строка задания>, <дата>)

Метод содержит два параметра:

1).  Массив  строк  заданий  или  строка  задания. Метод  определяет  информацию  по  числу  заданий. Задания описываются в элементах массива по строго формализованным правилам.

2).  Дата. Метод определяет значения на указанную дату. Если дата не указана, метод определяет значения на дату текущего учебного плана.

Размерность массива заданий: aTaskList(nTasks,2) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1) – строка,  содержащая  описание  задания.  При  выполнении  i–того  задания  методом,  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис:

aTaskList(i,1)   =   ‘   “Список   групп  категорий  ФОТ”,   ”Список  категорий  ФОТ”,   ”Возвращаемое   значение”,  ”Признак  учитывать  в  ФОТ”,  “Список  RN­ссылок  классов  категорий  ФОТ”,  ”RN­ссылка  на  компонент  категории ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются, соответствующие ему, пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды   групп   по словарю “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в соответствии   со словарем (15 символов)

Список   категорий ФОТ

Определяет,   какие виды  категорий  ФОТ 

Мнемокоды   видов категорий  ФОТ  по  словарю 

Те же требования

Page 79: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

79

Параметр Описание Допустимые значения Описание

рассматривать   при подсчете   искомой величины

“Состав ФОТ” 

Возвращаемое значение

Определяет   какую величину подсчитать

“И”“П”“Р”“К”“С”“Ф”“Н”“У”

Итоговая суммаПроцентРазрядКоэффициентСтавкаЧасы – фактЧасы – нормаСписок предметовДля   обозначений используются   русские буквы в любом регистре.

Признак   учитывать   в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

Список  RN­ссылок классов   категорий ФОТ

Определяет,   какие категории   ФОТ рассматривать   при подсчете   искомой величины

RN­ссылки   на   словарь “Классы”

Ссылки   разделяются запятыми.

RN­ссылка   на компонент   категории ФОТ

Определяет,   какие категории   ФОТ рассматривать   при подсчете   искомой величины

RN­ссылки   на   словарь “Компоненты   учебного плана”

Ссылки   разделяются запятыми.

При  обработке  задания  будут  определены  суммарные  значения  искомой  величины  для  всех  категорий  ФОТ, удовлетворяющих заданным параметрами метода условиям отбора.

Примечания.1) Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке категорий ФОТ (т.е. берутся категории ФОТ с любым значением этого параметра).2) Метод ThisForm.ThisFormData.TarifLst() может применяться в настраиваемых формах тарификационного списка.3) Метод всегда возвращает тип – число.

Метод определения параметров образования ThisForm.ThisFormData.EducPrint()

Page 80: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

80

Определяет различную информацию по образованию сотрудника.

Синтаксис:

ThisForm.ThisFormData.EducPrint(<Ссылка на контрагента>, <Массив строк заданий или строка задания>, <Дополнительное условие>, <Сортировать по убыванию>) 

Метод содержит четыре параметра:

1). Ссылка на контрагента. Метод определяет информацию по определенному сотруднику, используя ссылку на контрагента.

2). Массив строк заданий или строка задания. Метод определяет информацию по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

3). Дополнительное условие. Метод определяет информацию по образованиям, соответствующим дополнительному условию.

4). Сортировать по убыванию. Логический параметр, при установке в .T. метод определяет информацию по образованиям, в порядке убывания даты окончания образования.

Размерность массива заданий: aTaskList(nTasks,1+nEduc) где nTasks – общее количество заданий, а nEduc – общее количество записей об образовании, которое необходимо получить.

Структура массива: Каждая строка массива описывает одно задание. Первый элемент aTaskList(i,1) – строка, содержащая описание задания. При выполнении i–того задания методом, результат (информация о j­том образовании) заносится в элемент массива aTaskList(i,1+j).

Описание структуры первого элемента массива (строки):

Синтаксис: 

aTaskList(i,1) = ‘Возвращаемое значение‘.

Описание параметра строки задания:

Параметр Описание Допустимые значения Описание

Возвращаемое значение

Определяет значение   какого поля   необходимо вернуть

STARTDATEENDDATEPASSPORT_RNDOCNUMBER DOCSERIALDOCDATEDOCDEALEREDUORG_RNFACULTETEDUTYPE

Дата поступленияДата окончанияСсылка на тип документаНомер документаСерия документаДата документаДокумент выданСсылка на учебное заведениеФакультетТип образования:

“1” – Образование“2” – Послевузовское образование“3” – Профессия“4” – Повышение квалификации“5” – Профессиональная переподготовка“6” – Ученая степень“7” – Ученое звание

Page 81: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

81

EDUKIND_RNEDUFORMOKSO_RNEDUDEGREE_RNEDURANK_RNSPEC_RN

“8” – Стажировка (только в Кадрах Госслужбы)

Ссылка на вид образованияФорма образованияСсылка на специальность по дипломуСсылка на ученую степеньСслыка на ученое званиеСсылка на профессию

Примечание.1)   Если   у   сотрудника   есть   несколько   образований,   информация   о   них   будет   помещена   в   массив   в хронологическом  порядке  по  дате  окончания   (четвертый  параметр  влияет  на  сортировку  хронологического порядка).

Метод определения информации о квалификационной категории сотрудника ThisForm.ThisFormData.KvKat()

Определяет параметры последней по хронике квалификационной категории сотрудника.

Синтаксис:

ThisForm.ThisFormData.KvKat(<возвращаемая   информация>,   <количество   лет   периода   истечения>, <признак печати по истеченной категории>) 

Метод содержит три параметра:

1). Возвращаемая информация. Метод возвращает параметры квалификационной категории, указанные в этом параметре.

2).  Количество  лет  периода  истечения. Метод  определяет  срок  истечения  квалификационной  категории  в зависимости от этого параметра и текущей даты.

3). Признак печати по истеченной категории. Необязательный параметр – признак возврата информации по истекшей квалификационной категории.

Возвращаемая информация:

КВ/КТ – мнемокод квалификационной категории;

ДАТА – дата присвоения квалификационной категории;

СПЕЦИАЛЬНОСТЬ – специальность должности;

ПРИКАЗ – номер приказа о присвоении квалификационной категории;

ИСТЕЧЕНИЕ – информация об истечении квалификационной категории.

Пример использования метода:

Page 82: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

82

ThisForm.ThisFormData.KvKat(“КВ/КТ;ДАТА;ИСТЕЧЕНИЕ”, 5.5)

Метод возвратит мнемокод, дату присвоения и информацию об истечении (период истечения будет равняться 5 годам 6 месяцам) последней квалификационной категории сотрудника.

Метод определения различных сумм по выплатам/удержаниям из итогов ведомостей ThisForm.ThisFormData.SVNU()

Определяет значение сумм и часов для определенных в параметрах метода выплат или удержаний.

Синтаксис: ThisForm.ThisFormData.SVNU(<Массив строк заданий или строка задания>)

Метод содержит один обязательных параметр:

1). Массив строк заданий или строка задания. 

Метод определяет одно или более значение (сумм) по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks,2), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание и содержит два элемента. Первый элемент aTaskList(i,1)  –  строка,  содержащая  описание   задания.  При  выполнении   i­того   задания  методом  результат (искомое значение) заносится во второй элемент массива aTaskList(i,2).

Описание структуры первого элемента массива (строки):

Синтаксис: aTaskList(i,1) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов” ,”Возвращаемое значение”,”Признак учитывать конфиденциальные выплаты”,”Список видов лицевых счетов”‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения

Описание

Тип Тип выплаты/удержания. Определяет, какой тип выплаты или удержания рассматривать при подсчете искомой величины

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Page 83: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

83

Параметр Описание Допустимые значения

Описание

Список групп выплат

Определяет, какие группы выплат, удержаний рассматривать при подсчете искомой величины

Мнемокоды групп по словарю “Группы выплат и удержаний”

Мнемокоды групп разделяются запятыми. Мнемокоды групп указываются полностью в соответствии со словарем (15 символов)

Список расчетных алгоритмов

При подсчете искомой величины будут рассматриваться только те выплаты и удержания, которые рассчитываются по заданному списку алгоритмов

Мнемокоды расчетных алгоритмов по списку алгоритмов, установленных в системе

Мнемокоды алгоритмов разделяются запятыми. Мнемокоды алгоритмов указываются полностью в соответствии со списком (15 символов)

Список видов выплат, удержаний

Определяет, какие виды выплат, удержаний рассматривать при подсчете искомой величины

Мнемокоды видов выплат, удержаний по словарю “Выплаты и удержания”

Те же требования

Список расчетов

Определяет, какие расчеты рассматривать при подсчете искомой величины

Мнемокоды видов расчетов по словарю “Виды расчетов”

Те же требования

Возвращаемое значение

Определяет, какую величину подсчитать

“И”

“КФ”

Итоговая сумма

Количество ФОВ (без учета единиц измерения)

Признак учитывать конфиденциальные выплаты

Определяет учитывать или нет конфиденциальные выплаты при подсчете искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

Список видов лицевых счетов

Определяет, какие виды лицевых счетов рассматривать при подсчете искомой величины

Мнемокоды видов по словарю “Виды лицевых счетов”

Мнемокоды видов разделяются запятыми. Мнемокоды видов указываются полностью в соответствии со словарем (15 символов)

При   обработке   задания   будут   определены   суммарные   значения   искомой   величины   для   всех   видов выплат/удержаний, удовлетворяющих условиям отбора, заданных параметрами.

Примечание.  Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке выплат/удержаний (т.е. берутся все).

Page 84: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

84

Примечания.1) Метод ThisForm.ThisFormData.SVNU() может применяться в настраиваемых формах сводов ведомостей

2) Метод всегда возвращает тип – "число".

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива.

Синтаксис:

NValue = ThisForm.ThisFormData.SVNU(<строка задания>)

Найденное значение будет присвоено переменной Nvalue.

Примеры

Пример формирования списка заданий:

Dimension __pSVNUTaskList(5,2)

__pSVNUTaskList(1,1) = '"Начислено","","","Оклад ,Надбавка ","","и",""'

Задание 1: Найти итоговую сумму начислений "оклад" и "надбавка". 

__pSVNUTaskList(2,1) = '"Начислено","","Бос ","","","кф",""'

Задание 2: Найти сумму дней (часов) начислений, рассчитанных по алгоритму “Бос”. 

__pSVNUTaskList(4,1) = '"Авансировано","","","","","и",""'

Задание 3: Найти итоговую сумму всех авансов.

__pSVNUTaskList(5,1) = '"Удержано","","","Налог ","","и",""'

Задание 4: Найти итоговую сумму удержания “Налог”.

__pSVNUTaskList(7,1) = '"Начислено","Для ведомости ","","","","и","",”Внештаный ”'

Задание 5: Найти итоговую сумму начислений, входящих в группу “Для ведомости” по внештатным лицевым счетам. 

Пример использования метода:

ThisForm.ThisFormData.SVNU(@__pSVNUTaskList)

Выполняет   выше   описанные   задания   и   заполняет   результатами   вторые   элементы   строк   массива __pSVNUTaskList.

Метод формирования списка выплат/удержаний из итогов ведомостей ThisForm.ThisFormData.MakeColSVNU()

Формирует массив выплат или удержаний, соответствующих параметрам метода.

Синтаксис:

Page 85: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

85

ThisForm.ThisFormData.MakeColSVNU(<Массив строк заданий>)

Метод содержит один обязательный параметр:

1). Массив строк заданий 

Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание.

Описание структуры массива:

Синтаксис: aTaskList(i) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов”, ”Признак учитывать конфиденциальные выплаты”, ”Список видов лицевых счетов”‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (“”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения

Описание

Тип Тип выплаты/удержания. Определяет, какой тип выплаты или удержания рассматривать при формировании списка

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Список групп выплат

Определяет, какие группы выплат, удержаний рассматривать при формировании списка

Мнемокоды групп по словарю “Группы выплат и удержаний”

Мнемокоды групп разделяются запятыми. Мнемокоды групп указываются полностью в соответствии со словарем (15 символов)

Список расчетных алгоритмов

При формировании списка будут рассматриваться только те выплаты и удержания, которые рассчитываются по заданному списку алгоритмов

Мнемокоды расчетных алгоритмов по списку алгоритмов, установленных в системе

Мнемокоды алгоритмов разделяются запятыми. Мнемокоды алгоритмов указываются полностью в соответствии со списком (15 символов)

Список видов выплат, удержаний

Определяет, какие виды выплат, удержаний рассматривать при

Мнемокоды видов выплат, удержаний по словарю “Выплаты и удержания”

Те же требования

Page 86: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

86

Параметр Описание Допустимые значения

Описание

формировании списка

Список расчетов

Определяет, какие расчеты рассматривать при формировании списка

Мнемокоды видов расчетов по словарю “Виды расчетов”

Те же требования

Признак учитывать конфиденциальные выплаты

Определяет учитывать или нет конфиденциальные выплаты при формировании списка

“.T.”

“” (пусто)

Учитывать

Не учитывать

Список видов лицевых счетов

Определяет, какие виды лицевых счетов рассматривать при подсчете искомой величины

Мнемокоды видов по словарю “Виды лицевых счетов”

Мнемокоды видов разделяются запятыми. Мнемокоды видов указываются полностью в соответствии со словарем (15 символов)

Примечание.  Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке выплат/удержаний (т.е. берутся все).

Примечания.1)  Метод  ThisForm.ThisFormData.MakeColSVNU()  может   применяться   в   настраиваемых  формах   сводов ведомостей.

Возвращаемое значение:

Метод   переформировывает   массив   строк   заданий  aTaskList(nTask)  в   массив   выплат/удержаний aTaskList(nCol,3), где nCol – количество выплат/удержаний, удовлетворяющих заданиям.

В элемент aTaskList(nCol,1) заносится мнемокод выплаты/удержания.

В элемент aTaskList(nCol,2) заносится наименование выплаты/удержания.

В элемент aTaskList(nCol,3) заносится порядковый номер выплаты/удержания.

Page 87: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

87

Метод определения различной информации по выплатам/удержаниям из итогов ведомостей

ThisForm.ThisFormData.SVSPI_NU()

Определяет  различную  информацию  о выплатах/удержаниях из  итогов  ведомостей,  определенных  в параметрах метода, и сохраняет информацию во временной таблице, удобной для печати.

Метод используется для получения информации о выплатах/удержаниях в виде таблицы

Синтаксис:ThisForm.ThisFormData.SVSPI_NU(<Массив строк заданий или строка задания>)

Метод содержит один обязательный параметр:

1). Массив строк заданий или строка задания. 

Метод  определяет  один  или  более  блоков  информации  по  числу  заданий.  Задания  описываются  в  элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание. При выполнении i­того задания методом результирующая таблица данных  заносится в i­ый раздел служебной таблицы DOPLSPEC. Таким образом, метод не  возвращает  в  отчет  никаких  значений.  Печать  полученной  информации  осуществляется  путем  обращения  к соответствующим полям таблицы DOPLSPEC.

Описание структуры элемента массива (строки):

Синтаксис: aTaskList(i) = ‘”Тип” , “Список групп выплат”, ”Список расчетных алгоритмов”, ”Список видов выплат, удержаний”, ”Список расчетов” ,”Список пунктов данных”,”Признак учитывать конфиденциальные выплаты”,”Префикс блока данных”, ”Список видов лицевых счетов”‘.

Каждый параметр структуры задания заключается в двойные кавычки, и отделяются друг от друга запятыми. Вся   строка   задания   заключается   в  одинарные  кавычки.  Если  параметр  не  используется,   то  проставляются соответствующие ему пустые двойные кавычки (, “”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Тип Тип выплаты удержания. Определяет, какой тип выплаты или удержания рассматривать

“Начисление”

“Аванс”

“Удержание”

“Переплата“

“Отчисление“

Только начисления

Только авансы

Только удержания

Только переплаты

Только отчисления

Список групп выплат

Определяет, какие группы выплат/удержаний

Мнемокоды групп по словарю “Группы выплат и удержаний”

Мнемокоды групп разделяются запятыми. Мнемокоды

Page 88: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

88

Параметр Описание Допустимые значения Описание

групп указываются полностью в соответствии со словарем (15 символов)

Список расчетных алгоритмов

Будут рассматриваться только те выплаты и удержания, которые рассчитываются по заданному списку алгоритмов

Мнемокоды расчетных алгоритмов по списку алгоритмов, установленных в системе

Мнемокоды алгоритмов разделяются запятыми. Мнемокоды алгоритмов указываются полностью в соответствии со списком (15 символов)

Список видов выплат/удержаний

Определяет, какие виды выплат/удержаний рассматривать

Мнемокоды видов выплат/удержаний по словарю “Выплаты и удержания”

Те же требования

Список расчетов

Определяет, какие расчеты рассматривать

Мнемокоды видов расчетов по словарю “Виды расчетов”

Те же требования

Список пунктов данных

Определяет список данных по выплатам/удержаниям, которые необходимо получить

“В”

“К”

“И”

“КП”

Полное наименование выплаты, удержания.

Мнемокод выплаты, удержания

Итоговая сумма

Категория персонала (RN)

Признак учитывать конфиденциальные выплаты

Определяет учитывать или нет конфиденциальные выплаты

“.T.”

“” (пусто)

Учитывать

Не учитывать

Префикс блока данных

Определяет первые символы в названии полей таблицы DOPLSPEC, которые относятся к блоку данных задания

Любые символы, допустимые в именах полей таблиц.

Список видов лицевых счетов

Определяет, какие виды лицевых счетов рассматривать при подсчете искомой величины

Мнемокоды видов по словарю “Виды лицевых счетов”

Мнемокоды видов разделяются запятыми. Мнемокоды видов указываются полностью в соответствии со словарем (15 символов)

При обработке задания будут определены величины, настроенные в параметре  “Список пунктов данных”  для всех  видов  выплат,  удержаний, удовлетворяющих  условиям  отбора,  заданных  параметрами  отбора.  При  этом найденные данные будут записаны в служебную таблицу DOPLSPEC.

Структура таблицы DOPLSPEC:

Page 89: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

89

Каждая запись таблицы DOPLSPEC , соответствует одной записи выплаты/удержания, обработанной методом .SVSPI_NU(),   удовлетворяющей   условиям   отбора.  Общее   количество   записей   равно   количеству   записей выплат/удержаний, удовлетворяющих условиям отбора.

Метод   .SVSPI_NU()   автоматически  формирует   поля   таблицы   DOPLSPEC     и   присваивает   им   названия  по принципу:  Префикс блока данных + ”_” (символ подчеркивания) + обозначение из Списка пунктов данных. Во время работы метода искомые данные будут заполняться в строки, соответствующие виду выплаты/удержания, и в поля, соответствующие обозначению вида данных. 

Примечание. Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке выплат/удержаний (т.е. берутся все).

Дополнительная обработка полученных данных:

1) Сортировка. Данные, полученные методом, можно отсортировать в необходимом для отображения порядке. Для этого в параметре  “Список пунктов данных” перед каждым обозначением, по которому необходимо сортировать,   необходимо   поставить   символ  “^“  (крышка).   При   этом   порядок   сортировки     будет определяться   порядком   следования   обозначений   с   “крышкой”.   Например,   “И,^В”   ,   данные   будут отсортированы по наименованию вида выплаты, удержания.

2) Группировка.  Данные,  полученные  методом,  можно  сгруппировать  в  необходимом  порядке.  Для  этого  в параметре  “Список пунктов данных” перед каждым обозначением, по которому необходимо группировать, необходимо поставить символ “*“ (звезда). Например, “И,^*В”, будут отсортированы по наименованию вида выплаты и сгруппированы по наименованиям выплат/удержаний.

Примечания.1)   Метод  ThisForm.ThisFormData.SVSPI_NU()  может   применяться   в   настраиваемых   формах   сводов ведомостей.

Частный случай: Задание одно. В этом случае приемлем синтаксис без использования массива.

Синтаксис:

ThisForm.ThisFormData.SVSPI_NU(<строка задания>)

Пример формирования списка заданий:Dimension __pTaskLIst (2)

__pTaskLIst(1) = '"Начислено","","","","","И,^В","","N"'

Получить сумму и полное наименование начисления для всех начислений. Использовать символ “N” в качестве префикса в названии полей служебной таблицы DOPLSPEC.Отсортировать по наименованию начисления.

__pTaskLIst(2) = '"Удержано","","","","","И,^В","","U"'

Получить  сумму и полное наименование удержания для всех удержаний. Использовать символ “U” в качестве префикса в названии полей служебной таблицы DOPLSPEC.Отсортировать по наименованию удержания.

Page 90: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

90

Пример использования метода:

ThisForm.ThisFormData.SVSPI_NU(@__pTaskList)

Выполняет выше описанные задания за текущий расчетный период и заполняет результатами служебную таблицу DOPLSPEC.

Таблица DOPLSPEC примет следующую структуру:

Поле Тип Описание

DOPLSPEC.N_И N Сумма начисления

DOPLSPEC.N_В C Полное наименование вида начисления

DOPLSPEC.U_И N Сумма удержания

DOPLSPEC.U_В C Полное наименование вида удержания

Метод определения информации о движении кадров ThisForm.ThisFormData.PersNumb()

Определяет информацию о движении кадров в подразделении.

Синтаксис:

ThisForm.ThisFormData.PersNumb(<тип задания>, <список дней>, <дата начала>, <дата окончания>) 

Метод содержит четыре параметра:

1). Тип задания. Метод определяет информацию, соответствующую указанному типу задания. 

2).Список дней. Метод определяет информацию, использую список сокращенных наименований типов дней.

3­4).  Датаначала,  Дата  окончания. Метод определяет информацию, соответсвующую указанному диапазону дат. Если даты не указаны, будут использоваться даты из формы настройки отчета.

Ниже приведен перечень типов заданий:

“Р”   –  метод   возвратит  количество   сотрудников,  работающих   в  подразделении,   т.е.  имеющих  действующий лицевой счет в заданном интервале дат;

“Н” – метод  возвратит количество  сотрудников,  принятых  на  работу в  подразделение, т.е.  имеющих лицевой счет в данном подразделении (дата приема в анкете попадает в заданный интервал дат);

“У”  –  метод  возвратит  количество  уволенных  из  подразделения  сотрудников  т.е.  имеющих  лицевой  счет  в данном  подразделении   (дата  увольнения  в  анкете  попадает  в  заданный  интервал  дат  и  есть  запись  об увольнении в трудовой деятельности);

“П” – метод возвратит количество пришедших в подразделение сотрудников, т.е. имеющих новые лицевые счета в заданном интервале дат;

“В” – метод  возвратит количество вышедших из подразделения сотрудников, т.е. имеющих закрытый лицевой 

Page 91: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

91

счет в заданном интервале дат;

“О”   –  метод   возвратит   количесто   сотрудников  подразделения,   имеющих   прогулы   (для   определения   этого значения используется информация из табеля по заданному интервалу дат и параметр “Список дней”, в котором должны быть перечислены сокращенные наименования дней, соответствующих прогулам).

Примечание: ссылка на подразделение, по которому работает метод находится в курсоре FORMPRINT в поле SUBDIV_RN.

Примечание: в отборе участвуют только основные лицевые счета.

Метод определения банковских реквизитов ThisForm.ThisFormData.BankRecvPrint()

Определяет значение банковских реквизитов для заданных в параметрах мнемокодов.

Синтаксис:

ThisForm.ThisFormData.BankRecvPrint (<ссылка на банковский счет>, <список реквизитов>)

Метод содержит два параметра:

1). Ссылка на баковский счет. Метод позиционируется на  нужной строке таблицы “Банковский счет”. 

2).Список реквизитов. Метод определяет значения реквизитов, используя список мнемокодов..

Ниже приведен перечень возможных мнемокодов:

“МНЕ” – мнемокод счета;

“БРС” –  расчетный счет;

“БКС” – корреспондирующий счет;

“ВЛТ” – валюта;

“БНМ” – наименование банка;

“ББК” – БИК;

“БРН” – RN банка (контрагент);

“ККС” – Счет;

“КНМ” – Наименование банка­корр.;

“КБК” – БИК­корр.;

“КРН” – RN банка­корр. (контрагент)

Page 92: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

92

Примечание:  ссылка   на   строку   Банковского   счета,   по   которому   работает   метод   находится   в   курсоре FORMPRINT  в   полях  ORGTO_RN    и  BANKTO_RN: FORMPRINT.ORGTO_RN+FORMPRINT.BANKTO_RN.

Пример1

ThisForm.ThisFormData.BankRecvPrint(FORMPRINT.ORGTO_RN+FORMPRINT.BANKTO_RN, “ БРС ”)

Метод возвращает значение расчетного счета.

Пример2

Dimension __pTaskList(3,2)

__pTaskList(1,1) =" МНЕ"__pTaskList(2,1) = “ БРС"__pTaskList(3,1) = “ БКС"

ThisForm.ThisFormData.BankRecvPrint(FORMPRINT.ORGTO_RN+FORMPRINT.BANKTO_RN,@__pTaskList)

Метод возвращает в массиве __pTaskList значения мнемокода, расчетного счета, корреспондирующего счета (колонка 2)

Метод определения хроникального реквизита сотрудника ThisForm.ThisFormData.AnkChInfo()

Определяет значение хроникального реквизита для заданного в параметрах сотрудника на заданную дату.

Синтаксис:

ThisForm.ThisFormData.AnkChInfo (<наименование БД>, < реквизит>, <дата>)

Метод содержит три параметра:

1). Наименование БД. Хроникальный реквизит будет браться из указанной БД. 

2). Реквизит. Метод определяет значение указанного хроникального реквизита (наименование поля БД).

3). Дата. Метод определяет значение указанного хроникального реквизита на указанную дату.

Примечание:  ссылка   на   сотрудника,   по   которому   работает   метод   находится   в   БД  ZANK  в   полях ORGBASE_RN и ANK_RN.

Пример1

ThisForm.ThisFormData.AnkChInfo(“zAnkRank”, “zAnkRank.StartDate”, oSystem.Date)

Метод возвращает дату присвоения текущего звания/чина сотрудника.

Метод определения параметров дополнительной информации о сотруднике ThisForm.ThisFormData.DopInf()

Определяет различную информацию по дополнительной информации о сотруднике.

Page 93: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

93

Синтаксис:

ThisForm.ThisFormData.DopInf(<Ссылка на сотрудника>, <Массив строк заданий или строка задания>, <Дата По>, <Дата С>) 

Метод содержит четыре параметра:

1). Ссылка на сотрудника. Метод определяет информацию по определенному сотруднику, используя ссылку на сотрудника.

2). Массив строк заданий или строка задания. Метод определяет информацию по числу заданий. Задания описываются в элементах массива по строго формализованным правилам.

3). Дата По. Метод определяет информацию по записям, начинающим действие до даты По. Необязательный параметр, по умолчанию заполняется текущей датой.

4). Дата С. Метод определяет информацию по записям, начинающим действие после даты С. Необязательный параметр, по умолчанию заполняется первым января года даты По.

Размерность массива заданий: aTaskList(nTasks,4) где nTasks – общее количество заданий.

Структура массива: Каждая строка массива описывает одно задание. Первый элемент aTaskList(i,1) – строка, содержащая мнемокод особой отметки.

Описание структуры первого элемента массива (строки):

Синтаксис: 

aTaskList(i,1) = ‘Мнемокод особой отметки‘.

Возвращаемое значение:

В элемент aTaskList(i,2) заносится примечание из дополнительной информации.

В элемент aTaskList(i,3) заносится дата начала действия особой отметки.

В элемент aTaskList(i,4) заносится дата окончания действия особой отметки.

Примечание.Если у сотрудника есть несколько особых отметок  с одинаковым мнемокодом, информация будет браться из последней по хронике.

Метод определения информации о состояниях лицевого счета сотрудника ThisForm.ThisFormData.StoGet()

Определяет параметры состояний лицевого счета сотрудника.

Синтаксис:

ThisForm.ThisFormData.StoGet(<возвращаемая информация>, <дата>) 

Метод содержит два параметра:

Page 94: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

94

1). Возвращаемая информация. Метод возвращает параметры состояний, указанные в этом параметре.

2).  Дата. Необязательный  параметр – дата,  на которую  будут  отобраны состояния. По умолчанию  ­ текущая дата.

Возвращаемая информация:

СОСТОЯНИЕ – мнемокод состояния;

ДАТА С – дата начала состояния;

ДАТА ПО – дата окончания состояния;

ПРИМЕЧАНИЕ – примечание состояния.

Примечание: для корректной работы метода  БД “Лицевые счета” (zFcAc) должна быть  спозиционирована на нужном  лицевом  счете.  Метод  отбирает  состояния  этого  лицевого  счета,  не  имеющие  признака  “Сторно”.  В возвращаемой  строке  параметры  одной  записи  разделяются  пробелами,  а  сами  записи  разделяются  точкой  с запятой.

Пример использования метода:

ThisForm.ThisFormData.StoGet(“СОСТОЯНИЕ;ДАТА С;ДАТА ПО”)

Метод   возвратит  мнемокоды,   даты   начала   и   даты   окончания   всех   состояний   лицевого   счета   сотрудника, действующих на текущую дату.

Метод формирования списка по фонду оплаты труда ThisForm.ThisFormData.MakeColTarif()

Формирует массив по фонду оплаты труда, соответствующий параметрам метода.

Синтаксис: ThisForm.ThisFormData.MakeColTarif(<Массив строк заданий>, <дата>)

Метод содержит один обязательный параметр и один необязательный:

1). Массив строк заданий 

Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание.

Описание структуры массива:

Синтаксис: 

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Page 95: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

95

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (“”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой величины

Мнемокоды   групп   по словарю “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в соответствии   со словарем (15 символов)

Список   категорий ФОТ

Определяет,   какие виды  категорий  ФОТ рассматривать   при подсчете   искомой величины

Мнемокоды   видов категорий  ФОТ  по  словарю “Состав ФОТ” 

Те же требования

Возвращаемое значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Для   обозначений используются   русские буквы в любом регистре.

Признак   учитывать   в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

2).  Дата.  Определяет  дату,  на  которою  будут  рассматриваться  категории  ФОТ.  Если  не  дата  не   задана,  то берется первое число месяца текущего расчетного периода.

Примечания.1) Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке категорий ФОТ (т.е. берутся категории ФОТ с любым значением этого параметра).

Page 96: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

96

2) Метод  ThisForm.ThisFormData.MakeColTarif() может  применяться   в  настраиваемых  формах  лицевых   счетов  и штата.

Возвращаемое значение:

Метод   переформировывает   массив   строк   заданий  aTaskList(nTask)  в   массив   выплат/удержаний aTaskList(nCol,3), где nCol – количество категорий ФОТ, удовлетворяющих заданиям.

В элемент aTaskList(nCol,1) заносится мнемокод категории ФОТ.

В элемент aTaskList(nCol,2) заносится наименование категории ФОТ.

В элемент aTaskList(nCol,3) заносится порядковый номер категории ФОТ.

Метод формирования списка по фонду оплаты труда должности ThisForm.ThisFormData.MakeColTarifDol()

Формирует массив по фонду оплаты труда должности, соответствующий параметрам метода.

Синтаксис: ThisForm.ThisFormData.MakeColTarifDol(<Массив строк заданий>, <дата>)

Метод содержит один обязательный параметр и один необязательный:

1). Массив строк заданий 

Задания описываются в элементах массива по строго формализованным правилам.

Размерность массива заданий: aTaskList(nTasks), где nTasks – общее количество заданий. 

Структура массива: Каждая строка массива описывает одно задание.

Описание структуры массива:

Синтаксис: 

aTaskList(i,1) = ‘ “Список групп  категорий ФОТ”, ”Список  категорий  ФОТ”, ”Возвращаемое  значение”, ”Признак учитывать в ФОТ” ‘.

Каждый  параметр  структуры  задания  заключается  в  двойные  кавычки.  Параметры  отделяются  друг  от  друга запятыми.   Вся   строка   задания   заключается   в   одинарные   кавычки.   Если   параметр   не   используется,   то проставляются соответствующие ему пустые двойные кавычки (“”,””).

Описание параметров строки задания:

Параметр Описание Допустимые значения Описание

Список   групп категорий ФОТ

Определяет,   какие группы   категорий ФОТ   рассматривать при подсчете искомой 

Мнемокоды   групп   по словарю “Группы категорий ФОТ”

Мнемокоды   групп разделяются   запятыми. Мнемокоды   групп указываются полностью в 

Page 97: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

97

Параметр Описание Допустимые значения Описание

величины соответствии   со словарем (15 символов)

Список   категорий ФОТ

Определяет,   какие виды  категорий  ФОТ рассматривать   при подсчете   искомой величины

Мнемокоды   видов категорий  ФОТ  по  словарю “Состав ФОТ” 

Те же требования

Возвращаемое значение

Определяет   какую величину подсчитать

“И”

“П”

“Р”

“К”

“С”

“Ф”

“Н”

Итоговая сумма

Процент

Разряд

Коэффициент

Ставка

Часы – факт

Часы – норма

Для   обозначений используются   русские буквы в любом регистре.

Признак   учитывать   в ФОТ

Определяет учитывать   или   нет категории   ФОТ   с неустановленным флажком “Включать в сумму   по  ФОТ”   при подсчете   искомой величины

“.T.”

“” (пусто)

Учитывать

Не учитывать

2).  Дата.  Определяет  дату,  на  которою  будут  рассматриваться  категории  ФОТ.  Если  не  дата  не   задана,  то берется первое число месяца текущего расчетного периода.

Примечания.1) Если значение параметра “” (пусто), то соответствующее ему условие отбора не участвует при обработке категорий ФОТ (т.е. берутся категории ФОТ с любым значением этого параметра).2) Метод  ThisForm.ThisFormData.MakeColTarifDol() может   применяться   в   настраиваемых   формах   штатного расписания.

Возвращаемое значение:

Метод   переформировывает   массив   строк   заданий  aTaskList(nTask)  в   массив   выплат/удержаний aTaskList(nCol,3), где nCol – количество категорий ФОТ, удовлетворяющих заданиям.

В элемент aTaskList(nCol,1) заносится мнемокод категории ФОТ.

Page 98: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

98

В элемент aTaskList(nCol,2) заносится наименование категории ФОТ.

В элемент aTaskList(nCol,3) заносится порядковый номер категории ФОТ.

Функция определения трудового договора сотрудника ThisForm.ThisFormData.GetTrDog()

Определяет ссылку на запись о трудовом договоре сотрудника.

Синтаксис:

ThisForm.ThisFormData.GetTrDog (<RN контрагента>, <Вид договора>, <Дата>) 

Функция содержит три параметра:

1). RN контрагента. Функция определяет информацию по определенному контрагенту, используя ссылку на него.

2). Вид договора. ‘1’ – для контрактов, ‘2’ – для трудовых договоров.

2). Дата. Функция определяет последний по хронике договор, действующий на указанную дату. По умолчанию параметр принимает значение текущей даты.

Пример:

ThisForm.ThisFormData.GetTrDog (ZANK.ORGBASE_RN) – возвращает ссылку на запись о последнем по хронике трудовом договоре служащего, действующего на текущую дату (EMPKONT_RN). Используя эту ссылку, можно извлечь информацию из спецификации “Контракты и трудовые договора”. Например, номер трудового договора:ThisForm.ThisFormData.Seek_TableField(“SEMPKONT”,”RN”,”KONT_NUM”,ThisForm.ThisFormData.GetTrDog(ZANK.ORGBASE_RN))

Метод определения реквизитов адреса ThisForm.ThisFormData.AddressPrint()

Определяет значение реквизитов адреса контрагента.

Синтаксис:

ThisForm.ThisFormData.AddressPrint (<ссылка на контрагента>, <список реквизитов>, <режим>)

Метод содержит три параметра:

1).  Ссылка  на  контрагента. Метод  определяет  реквизиты  адреса  указанного  контрагента.  Необязательный параметр, по умолчанию – ZANK.ORGBASE_RN

2). Список реквизитов. Метод определяет значения реквизитов, используя список мнемокодов.

Ниже приведен перечень возможных мнемокодов:

“СТР” – RN страны;

Page 99: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

99

“РГР” –  RN региона;

“РЙН” – наименование района;

“РЙТ” – тип района;

“ГРН” – наименование города;

“ГРТ” – тип города;

“НПН” – наименование населенного пункта;

“НПТ” – тип населенного пункта;

“УЛН” – наименование улицы;

“УЛТ” – тип улицы;

“ДОМ” – дом;

“КОР” – корпус;

“СТН” – строение;

“КВА” – квартира;

“ОФС” – офис;

“ИНД” – индекс;

“РЕГ ” – дата регистрации.

3). Режим. Метод определяет значения реквизитов, используя указанный режим. Необязательный параметр.

Ниже приведен перечень возможных режимов:

“Ю” – юридический адрес;

“Ф” – фактический адрес;

“ФР” – фактический адрес, включенный в Реестр;

“П” – адрес для перечислений;

“Р” – адрес места рождения (в этом режиме возможно использование только следующих мнемокодов: “СТР”, “РГР”, “РЙН”, “ГРН”)

Примечание:  если   параметр   “Режим”   не   задан,   метод   вернет   реквизиты   первого   попавшегося   адреса контрагента.

Пример1

ThisForm.ThisFormData.AddressPrint(FORMPRINT.ORGBASE_RN, “РЕГ”, “Ф”)

Page 100: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

100

Метод возвращает дату регистрации по фактическому адресу.

Пример2

Dimension __pTaskList(3,2)

__pTaskList(1,1) = "УЛН"__pTaskList(2,1) = “ДОМ"__pTaskList(3,1) = “КВА“

ThisForm.ThisFormData.AddressPrint(FORMPRINT.ORGBASE_RN,@__pTaskList, “Ю”)

Метод возвращает в массиве __pTaskList значения наименования улицы, номера дома и номера квартиры юридического адреса (колонка 2).

Метод определения реквизитов контрагента ThisForm.ThisFormData.ContrAgentPrint()

Определяет значение реквизитов контрагента.

Синтаксис:

ThisForm.ThisFormData.ContrAgentPrint (<ссылка на контрагента>, <список реквизитов>)

Метод содержит два параметра:

1).  Ссылка на контрагента. Метод определяет реквизиты указанного контрагента. Необязательный параметр, по умолчанию – ZANK.ORGBASE_RN

2). Список реквизитов. Метод определяет значения реквизитов, используя список мнемокодов.

Ниже приведен перечень возможных мнемокодов:

“МНЕ” – мнемокод контрагента;

“ИНН” –  ИНН контрагента;

“ФАМ” – фамилия контрагента;

“ИМЯ” – имя контрагента;

“ОТЧ” – отчество контрагента;

“ПОЛ ” – пол контрагента;

“ДРД ” – дата рождения контрагента;

“ПРЗ” – признак «резидент»;

“ПСТ” – признак «сотрудник»;

“ПМЛ” – признак «МОЛ»;

Page 101: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

101

“ДТП” – код ГНИ документа, удостоверяющего личность;

“ДТН” – наименование документа, удостоверяющего личность;

“ДСР” – серия документа, удостоверяющего личность;

“ДНМ” – номер документа, удостоверяющего личность;

“ДДВ” –дата выдачи документа, удостоверяющего личность;

“ДВД” – кем выдан документ, удостоверяющий личность;

“ОС1” – особая отметка №1;

“ОС2” – особая отметка №2;

“ОС3” – особая отметка №3;

“ОС4” – особая отметка №4;

“ОС5” – особая отметка №5;

“ОКП” – ОКПО;

“ОКФ” – ОКФС;

“ОКО” – ОКОНХ;

“БИК” – БИК;

“НАМ” – наименование;

“ННМ” – национальное наименование;

“ОНМ” – оригинальное наименование;

“ПБН” – признак «Банк»;

“ИРК” – ФИО руководителя;

“ДРК” – должность руководителя;

“ИГБ” – ФИО главного бухгалтера;

“ТЕЛ” – телефон;

“ФКС” – факс;

“ЕМЛ” – e­mail;

“ДТФ” – код ПФР документа, удостоверяющего личность.

Пример1

Page 102: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

102

ThisForm.ThisFormData.ContrAgentPrint(FORMPRINT.ORGBASE_RN, “ФАМ”)

Метод возвращает фамилию контрагента.

Пример2

Dimension __pTaskList(2,2)

__pTaskList(1,1) = "ИРК"__pTaskList(2,1) = “ДРК"

ThisForm.ThisFormData.ContrAgentPrint(FORMPRINT.ORGBASE_RN,@__pTaskList)

Метод возвращает в массиве __pTaskList значения ФИО руководителя и должность руководителя (колонка 2).

Метод суммирования информации по БД ThisForm.ThisFormData.Count_Table()

Определяет количество записей либо сумму конкретного поля по списку записей.

Синтаксис:

ThisForm.ThisFormData.Count_Table (<имя БД>, <имя индекса>, <имя поля>, <значение по индексу>, <условие работы>, <условие отбора>)

Метод содержит шесть параметров:

1). Имя БД. Метод работает с указанной БД.

2).  Имя индекса. Метод позиционируется в БД, используя указанный индекс.  Необязательный параметр, при отсутствии, будут обработаны все записи БД.

3).  Имя   поля. Метод   суммирует   значение   указанного   поля   по   записям  БД.  Если   в   качестве   параметра использовать «*», метод будет суммировать количество записей.

4).  Значение   по   индексу. Метод   позиционируется   в   БД   поиском   указанного   значения   по   индексу. Необязательный параметр, при отсутствии, будут обработаны все записи БД.

5).  Условие   работы. Метод   продолжает   обработку   записей   БД,   пока   выполняется   указанное   условие. Необязательный параметр, при отсутствии, будут обработаны записи до конца БД.

6). Условие отбора. Метод обрабатывает записи, удовлетворяющие указанному условию.

Пример

ThisForm.ThisFormData.Count_Table(“ZFCAC”,”F_ZANK”,”*”, ZANK.ANK_RN)

Метод подсчитает количество лицевых счетов по текущему сотруднику.

Page 103: Справочник - narod.rumalax302.narod.ru/olderfiles/1/Functions.pdf · 1 Функции, методы, свойства и объекты Паруса7 используемые

103

Метод вывод месяца прописью ThisForm.ThisFormData.Month2Text()

Метод полностью аналогичен функции This.Month2Text

Метод преобразования числа в строку

ThisForm.ThisFormData.Rp_Str()

Возвращает символьный эквивалент заданного числового выражения. В целом, аналогична стандартной функции str, но имеет ряд дополнительных параметровСинтаксисThisForm.ThisFormData.Rp_Str (nvalue, nall, ndec, ldelnull, csymbol, cempty)где nvalue – исходное числовое выражение nall ­ Задает длину символьной строки, возвращаемой функциейndec ­ Задает число десятичных знаков в символьной строке, возвращаемой функциейldelnull – логический параметр, указывающий нужно ли выводить нулевую дробную часть. Если параметр ИСТИНА, то нулевая дробная чать не выводитсяcsymbol – срабатывает лишь при ldelnull = .T. Добавляет к вводимой строке доплнительные символыcempty – если nvalue = 0, то всместо него выводится строка задаваемая этим параметромПримерThisForm.ThisFormData.Rp_Str(__p_per,18,3,.T.,"%","­­­­") Если __p_per = 0  Функия возвращает ­­­­Если __p_per = 200Функия возвращает 200%Если __p_per = 200.05Функия возвращает 200.050

Метод определения списка пунктов приказов на предоставление дополнительных отпусков ThisForm.ThisFormData.GetOrdLeav()

Определяет список ссылок на записи пунктов приказов.

Синтаксис:

ThisForm.ThisFormData.GetOrdLeav (<RN приказа>, <RN пункта приказа>) 

Функция содержит два параметра:

1). RN приказа. Функция определяет список пунктов по определенному приказу, используя ссылку на него.

2). RN пункта приказа. Функция определяет список пунктов на предоставление дополнительных отпусков, непрерывных с основным отпуском, указанным в определенном пункте приказа.

Пример:

GetOrdLeav (ZORDSP.ORDBS_RN, ZORDSP.ORDSP_RN) – возвращает список ссылок на записи о предоставлении дополнительных отпусков, непрерывных с основным отпуском, указанным в параметрах функции (список ORDSP_RN, разделенных точкой с запятой).