Приложение II. Перечень глобальных функций

Группа OCL содержит глобальные функции, вызываемые в OCL-выражениях.

	Функция	Описание
	•с параметрами
	ocl_child	Функция возвращает строку со значением атрибута дочернего объекта. Функция вызывается в OCL-выражении #child.
	ocl_concat	Функция возвращает результат объединения нескольких строк, отделенных указанным разделителем. Функция вызывается в OCL-выражении #concat.
	ocl_gather	Функция возвращает результат объединения строк со значениями выражений дочерних объектов (потомков), отделенных указанным разделителем. Функция вызывается в OCL-выражении #gather.
	ocl_if	Функция возвращает строку со значением атрибута при выполнении условия. Функция вызывается в OCL-выражении #if.
	ocl_ifnot	Функция возвращает строку со значением атрибута, если условие не выполняется. Функция вызывается в OCL-выражении #ifnot.
	ocl_measure_name	Функция возвращает строку с именем единицы измерения атрибута. Функция вызывается в OCL-выражении #measure_name.
	ocl_parent	Функция возвращает строку со значением атрибута родительского объекта. Функция вызывается в OCL-выражении #parent.
	•без параметров
	ocl_changing_designation	Функция возвращает строку с обозначением извещения. Функция вызывается в OCL-выражении #changing_designation.
	ocl_changing_index	Функция возвращает строку с номером извещения. Функция вызывается в OCL-выражении #changing_index.
	ocl_changing_page_status	Функция возвращает строку со статусом страницы. Функция вызывается в OCL-выражении #changing_page_status.
	ocl_doc_caption	Функция возвращает строку с наименованием шаблона, которое указано в поле Наименование на панели Свойства документа. Функция вызывается в OCL-выражении #doc_caption.
	ocl_doc_type	Функция возвращает строку с типом шаблона, который указан на панели Свойства документа. Функция вызывается в OCL-выражении #doc_type.
	ocl_enterprise	Функция возвращает строку с наименованием предприятия, которое указано в соответствующем поле диалога Параметры формирователя. Функция вызывается в OCL-выражении #enterprise.
	ocl_enterprise_code	Функция возвращает строку с кодом предприятия, который указан в соответствующем поле диалога Параметры формирователя. Функция вызывается в OCL-выражении #enterprise_code.
	ocl_file_name	Функция возвращает имя файла документа — значение ключевого атрибута KeyAttribute объекта типа Документ Комплекта ТД. Функция вызывается в OCL-выражении #file_name.
	ocl_object_name	Функция возвращает строку с именем объекта, который является источником данных для выражения. Если объект был создан на основе объекта технологии, то имя содержит результат вычисления функции формирования заголовка (ToString) объекта технологии. Функция вызывается в OCL-выражении #object_name.
	ocl_version	Функция возвращает версию документа — значение атрибута Version объекта типа Комплект ТД или технологии. Функция вызывается в OCL-выражении #version.

Группа Вспомогательные

Группа Вспомогательные включает в себя глобальные функции, вызываемые при формировании отчета.

Перечисленные функции можно вызывать внутри других функций для выполнения конкретных задач. Для этого необходимо в коде прописать вызов функции, добавив к ней класс Globals (добавляется перед наименованием функции через разделитель в виде точки).

	Функция	Описание
	CombineOperations	Функция комбинирует операции попарно в один объект.
	CreateEqpWorker	В функции создаются временные объекты, содержащие данные по оборудованию и исполнителю.
	CreateOperComments	В функции создаются временные объекты, содержащие комментарии операции. В зависимости от значения параметра шаблона Комментарии операции объекты данного класса будут выведены До или После операции.
	CreatePackages	В функции создаются временные объекты, содержащие данные по объектам, добавленным в состав операции/перехода по связи Комплектующее.
	CreateSumMaterials	Функция осуществляет выборку одинаковых материалов, добавленных в состав операции/перехода и выполняет суммирование значений норм расхода и содержания в процентах. Результатом работы функции является создание объектов класса sum_material, в атрибуты которых будут записаны просуммированные значения.
	CreateSumTools	Функция осуществляет отбор одинаковой оснастки в операциях, для которой выполняется суммирование количества (count). Результатом работы функции является создание объектов класса sum_tool, в атрибуты которых будут записаны просуммированные значения.
	DeleteCodeFromOboznTd	Функция удаления кода предприятия из объектов отчета, в которых содержится обозначение ТД. Код предприятия удаляется из обозначения ТД при наличии маркера obozntd у объекта шаблона. Вызывается в глобальной функции AfterBuildDocument.
	FilterOriginalAttributesSoft	Функция выполняет фильтрацию атрибутов, используя нестрогий алгоритм фильтрации. Вызывается в глобальной функции FilterOriginalObjectsSoft.
	FilterOriginalAttributesStrong	Функция выполняет фильтрацию атрибутов, используя строгий алгоритм фильтрации. Вызывается в глобальной функции FilterOriginalObjectsStrong.
	FilterOriginalObjects	Функция для задания алгоритма фильтрации объектов ЕТП.
	FilterOriginalObjectsSoft	Функция выполняет фильтрацию объектов, используя нестрогий алгоритм фильтрации. При нестрогом алгоритме изменение состава объектов одного типа и одного уровня вложенности приводит к отображению всего состава. Объекты, не отличающиеся от оригинальных, удаляются из ЕТП. Вызывается в глобальной функции FilterOriginalObjects.
	FilterOriginalObjectsStrong	Функция выполняет фильтрацию объектов, используя строгий алгоритм фильтрации. При строгом алгоритме отображаются только объекты, в которых есть изменения. Объекты, не отличающиеся от оригинальных, удаляются из ЕТП. Вызывается в глобальной функции FilterOriginalObjects.
	GetChildrenRecursively	Функция осуществляет рекурсивный поиск дочерних объектов, являющихся экземпляром класса или типа с указанным наименованием.
	GetEI	Функция возвращает ЕИ у атрибута с любым типом Комплексного значения (DoubleValue, DimensionValue, IntegerValue, MeasurandValue).
	GetNextPageIndex_ForMultiformatSketchCard	Функция возвращает индекс следующей страницы для многоформатной карты эскизов (А4/А3).
	GetParentRecursively	Функция осуществляет рекурсивный поиск родительского объекта, являющегося экземпляром класса или типа с указанным наименованием.
	HasDataForBuildingReport	Функция проверяет наличие данных для формирования отчета.
	InsertLineBreakInDocCode	Функция добавляет перенос строки в обозначение документа после кода предприятия.
	InsertPrimaryBlankToOperation	Функция добавляет исходные заготовки из комплекта заготовок под каждую операцию в ТП.
	IsSingleTechProcess	Функция возвращает признак, определяющий, что объект технологии является единичным ТП в составе ТТП/ГТП.
	IsTemplatedTechProcess	Функция возвращает признак, определяющий, что объект технологии является ТТП/ГТП.
	MoveOperationsFromGroupToDse	Функция перемещает операции из состава группы операций и располагает их под технологию. Вызывается в глобальной функции RebuildProcessableTree.
	PrintTools	Функция заполняет указанный текстовый элемент наименованиями объектов оснастки.
	RebuildDocumentObject	Функция формирования объектов дерева вывода для карт ВТД.
	RemoveInstanses	Функция удаляет из дерева построения все объекты ЕТП, оставляя только ТТП.
	RemoveOperations	Функция удаляет все операции, которые подходят под указанные типы.
	RemoveOperationsExcept	Функция удаляет все операции, которые НЕ подходят под типы.
	RemoveTemplateObjects	Функция удаляет из дерева построения все объекты ТТП, оставляя только ЕТП.
	SetPrecision	Устанавливает точность значения до указанного числа знаков после запятой.
	ShowComments	Функция вывода комментария в зависимости от значения атрибута шаблона, а также расположения строки с комментарием в таблице секции модели вывода.
	SortTools	Функция сортировки оснастки. Порядок сортировки технологической оснастки отображается в диалоге Параметры формирователя в разделе Сортировка оснастки. Вызывается в глобальной функции RebuildProcessableTree, если в диалоге Параметры формирователя включена опция Сортировать технологическую оснастку.
	SumPkgMaterials	Функция суммирует нормы расхода комплектующих материалов, у которых совпадают имена и позиции.

Группа Замены

Группа Замены содержит глобальные функции для обработки объектов замен.

	Функция	Описание
	AddReplacementObjects	Функция добавляет объекты классов Or, With, ItCanBeReplacedBy в дерево объектов. К объекту каждого класса добавляется атрибут Value со значением соответствующего параметра формирователя: •Or — Разделитель между основным объектом и объектом замены, •With — Разделитель между объектами замены, •ItCanBeReplacedBy — Разделитель между связанными объектами замены. Указанные объекты (далее — разделители) добавляются между объектами групп замен.
	AddReplacementPrefix	Функция возвращает строку, которая содержит исходную строку и префикс группы замен.
	AddReplacementSections	Функция добавляет секции Or, With, ItCanBeReplacedBy в каждую модель вывода шаблона. Новая секция добавляется в шаблон в том случае, если она отсутствует в нем. Каждая секция служит для вывода объекта соответствующего класса, созданного в глобальной функции AddReplacementObjects.
	GetMainVariantId	Функция возвращает: •0 (ноль) — если объект является основным вариантом замены, •идентификатор основного варианта замены — если объект не является основным вариантом в группе замены.
	GetVariantId	Функция возвращает идентификатор варианта замены.
	IsObjectRelatesWithReplacementVariant	Функция проверяет наличие связи между объектом и вариантом замены (по его ID) и возвращает соответствующий признак.
	IsReplacementsSeparatorActual	Функция проверяет актуальность расположения разделителя и возвращает соответствующий признак.
	IsReplacementsSeparatorObject	Функция проверяет, является ли объект разделителем, и возвращает соответствующий признак.
	IsReplacementsSupported	Функция проверяет, поддерживает ли шаблон функционал замены и возвращает соответствующий признак.
	MoveWorker	Функция перемещает объект типа Профессия в дереве объектов: удаляет его из состава объекта типа Техоперация и добавляет в состав объекта типа Оборудование текущей операции. Функция используется в шаблонах для вывода информации об объектах из группы замен.
	ObjectsToStringsWithReplacements	Функция возвращает массив строк, которые содержат объекты и их замены с разделителями.
	ProvideReplacementSeparators	Функция обеспечивает корректное размещение разделителей: проверяет их позицию в промежуточном слое и при необходимости перемещает к предыдущему объекту, а также расставляет префиксы для объектов замен.
	ReplacementsBeforeBuildDocument	Основная функция обработки групп замен.

Группа Системные

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

	Функция	Описание
	AfterBuild	Функция выполняется после формирования всех единичных отчетов по каждому шаблону. Например, используется для генерации наименования отчета.
	AfterBuildDocument	Функция выполняется после формирования единичного отчета по каждому шаблону.
	BeforeBuild	Функция выполняется до формирования единичных отчетов по каждому шаблону.
	BeforeBuildDocument	Функция выполняется перед формированием единичного отчета по каждому шаблону.
	BuildCanceled	Функция вызывается после принудительной остановки построения отчетов.
	FillPageNumbers	Функция нумерации страниц отчета и сквозной нумерации. Объектам, в которые выводится нумерация, должны быть назначены маркеры page_no (нумерация страниц) и skv_no (сквозная нумерация).
	RebuildProcessableTree	Функция перестроения дерева объектов для всех шаблонов. Например, используется для вызова функции SortTools, если в диалоге Параметры формирователя включена опция Сортировать технологическую оснастку.