Свойства конфигурации 1с как открыть. Работа с конфигурацией. Основные приемы работы в конфигураторе

Каждый объект конфигурации обладает уникальным набором свойств. Этот набор описан на уровне системы и не может быть изменен в процессе настройки конфигурации задачи. Набор свойств объекта конфигурации определяется, в основном, его назначением в системе 1С: Предприятие.

Главным свойством любого объекта конфигурации является имя - краткое наименование объекта конфигурации. При создании нового объекта конфигурации ему автоматически присваивается условное имя. состоящее из слова, определяемого по виду объекта, и цифры (например, при создании реквизита создается реквизит с именем «Реквизит1», при создании документа - «Документ1», и т.д.). Это имя можно изменить в процессе редактирования свойств объекта конфигурации, при этом система отслеживает уникальность имен. Имя объекта конфигурации не может пустым.

Некоторые свойства из всего набора свойств, присущих объекту конфигурации, доступны для редактирования и могут быть так или иначе изменены в процессе конфигурирования системы 1С: Предприятие. Характер изменений и их пределы также задаются на уровне системы. Целенаправленным изменением свойств объекта конфигурации специалист, осуществляющий конфигурирование системы, может добиться требуемого поведения объекта при работе системы. Однако такие изменения не затрагивают сущности объекта и не позволяют добиться от него действий, не свойственных объектам данного типа.

Приведем такой пример. Объект конфигурации «Константа» в системе 1С: Предприятие предназначен для хранения информации, которая не изменяется во времени или изменяется очень редко. Простым примером константы может служить название предприятия: оно, как правило, не меняется в процессе деятельности предприятия.

Константа обладает следующим набором редактируемых свойств:

Имя константы;

Синоним;

Комментарий;

Подсистемы;

Тип данных.

В наиболее общем случае, значение в константу вводится один раз (как, например, название предприятия). С точки зрения использования константы, неважно, что именно храниться в константе, главным является то, что константа сохранила записанное в нее значение.

Способность сохранять введенные в нее значение - неотъемлемая особенность константы в системе 1С: Предприятие. Редактирование свойств константы на эту способность не влияет.

3 Краткое описание объектов конфигурации

    Базовые объекты Константы

Для работы с постоянной и условно постоянной информацией в системе используются объекты типа «Константа». Информация, хранящаяся в константах, редко изменяется, но, как правило, часто используется в работе. Например, в константах может храниться наименование предприятия, его РНН, фамилии директора и главного бухгалтера и другая подобная информация.

В системе может быть описано неограниченное количество констант.

    Справочники

Для работы с постоянной и условно постоянной информацией с некоторым множеством значений в системе используются объекты типа «Справочник».

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

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

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

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

Для описания соподчиненных сущностей можно использовать подчиненные справочники. В этом случае в подчиненном справочнике каждый элемент «принадлежит» к определенному элементу справочника-владельца.

В конкретной конфигурации создается необходимое количество справочников, для хранения данных об объектах, используемых при автоматизации данной предметной области. Например, это могут быть справочники - «Организации», «Товары», «Сотрудники» и т.д.

    Перечисления

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

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

Типичными примерами перечислений являются виды оплаты (наличная, безналичная, бартер), статус клиента (постоянный, разовый) и т.д.

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

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

    Документы

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

В процессе конфигурирования настраивается произвольное количество видов документов. Типичными примерами видов документов являются такие документы, как «Платежное поручение», «Счет», «Приходная накладная», «Расходная накладная», «Накладная на внутреннее перемещение», «Приходный кассовый ордер» и другие. Каждый вид документа предназначен для отражения своего типа событий. Это определяет его структуру и свойства, которые описываются в конфигурации.

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

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

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

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

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

Например, в торговом предприятии выписка клиенту счета на оплату не изменяет состояния товарных или денежных средств предприятия, так как счет в данном случае - это только выражение намерения клиента приобрести товар. В этом случае в конфигурации для учета торговых операций документ «Счет» может быть не проводимым.

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

    Журналы документов

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

Например, может быть создан журнал «Складские документы», в котором будут отображаться все приходные и расходные накладные и накладные на внутреннее перемещение.

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

Журнал может иметь несколько форм визуального представления.

    Отчеты и обработки

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

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

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

7. Регистры

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

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

В системе 1С: Предприятие существует 2 вида регистров: регистры сведений ирегистры накопления .

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

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

Регистры накопления в системе 1С: Предприятие используются для учета информации о наличии и движении каких-либо величин - материальных, денежных и др. Вся информация о хозяйственных операциях, которая вводится с использованием документов, должна быть отражена в регистрах. Тогда эту информацию можно будет извлечь, проанализировать и представить пользователю в виде отчетных форм.

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

8. Специализированные объекты конфигурации

Помимо базовых объектов, описывающих предметную область учета, конфигурация содержит ряд вспомогательных объектов, не относящихся непосредственно к деятельности предприятия, однако, тесно связанных с функционированием самой системы. Это механизмы взаимодействия пользователей с системой 1С: Предприятие (интерфейсы, критерии отбора, права доступа различных групп пользователей к различной информации), вспомогательные объекты оформительского назначения, позволяющие производить конфигурирование на основе сформированных стилей, библиотеки картинок, с учетом национального языка. Глобальный и общие модули, в которых располагаются процедуры и функции, доступные из прочих модулей конфигурации, общие макеты печатных форм и много другое.

9. Типы данных, используемые системой

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

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

Булево («истина» или «ложь»).

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

Как было отмечено во Введении, мы будем строить свою учебную конфигурацию "с нуля". Давайте запустим систему. Мы будем считать, что у нас установлена только программная часть системы и нет ни одной ИБ.

Поэтому мы запустим систему в режиме " Конфигуратор ". Для этого воспользуемся классическим способом запуска программ в MS Windows - через кнопку "Пуск" ("Start"): "Пуск - Программы - 1C Предприятие 8.0 - Конфигуратор ".

После чего на экран будет выведен диалог " Запуск 1С:Предприятия".

В этом диалоге список "Информационные базы" содержит список зарегистрированных на данном компьютере Информационных Баз. По правилам работы системы каждая ИБ должна быть зарегистрирована. И не важно существует ли реально ИБ или нет.

Каждая ИБ для файлового режима хранения данных характеризуется названием и каталогом, в котором она расположена.

Процесс регистрации новой ИБ в 1С:Предприятии версии 8.0 серьезно переработан по сравнению с версией 7.7, поэтому мы подробно его рассмотрим.


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

Новой возможностью, которая появилась при создании новой информационной базы, является возможность создавать ИБ из шаблонов.

О том, как создать новый шаблон , написано в книге "1С:Предприятие 8.0. Руководство по установке и запуску".



О том, как создавать ИБ расположенные на сервере "1С:Предприятия", можно прочитать в документации к программе. В этом курсе мы не будем рассматривать этот тип расположения ИБ.


После регистрации необходимо запустить " Конфигуратор ", используя одноименную кнопку.

Окно "Конфигурация"

Окно программы " Конфигуратор " похоже на многие другие программы MS Windows . Здесь есть меню , панели инструментов, рабочая область и строка состояния.


Основным окном, с которым Вам придется иметь дело на протяжении всего сеанса работы с Конфигуратором - это окно " Конфигурация ". (Его можно открыть, используя пункт меню " Конфигурация - Открыть конфигурацию", или нажав на кнопку панели инструментов, которая выполняет те же функции, что и пункт меню .


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

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

Учитывая ограниченный объем данного пособия, мы более-менее подробно рассмотрим следующие типы прикладных объектов: Константы , Справочники, Документы, Отчеты, Регистры сведений и некоторые другие.

Свойства объекта Конфигурации

Каждый из объектов в этом дереве имеет свой набор свойств. Для того чтобы его увидеть, необходимо сначала выделить какой-либо из объектов в дереве, а затем нажать правую кнопку мыши. В открывшемся контекстном

Эта статья является логическим продолжением цикла статей «Первые шаги в разработке на 1С». В ней описывается среда разработки на платформе 1С, которая получила название “Конфигуратор”. Изучив данный материал, вы узнаете:

  • Что такое дерево объектов, для чего оно нужно и как с ним работать?
  • Для чего нужна палитра свойств, как её открыть, как в ней что-то отыскать?
  • Когда нужно настраивать различные параметры конфигуратора и как это сделать?
  • Что нужно сделать, чтобы можно было внести изменения в типовую конфигурацию?
  • Как запустить конфигурацию в режиме отладки?
  • Как подключиться к клиентской сессии в режиме отладки и посмотреть, что там происходит?

Применимость

В статье рассматривается платформа «1С:Предприятие» версии 8.3, поэтому вся информация актуальна для текущих релизов.

Основные приемы работы в конфигураторе

Дерево объектов – это первое, с чем Вы сталкиваетесь при запуске конфигуратора.

После запуска конфигурации для разработки, чтобы увидеть дерево объектов, необходимо выбрать один из двух пунктов меню Конфигурация (Открыть конфигурацию , если конфигурация еще не открыта, или Окно конфигурации , если закрыто просто само окно конфигурации).

Также можно использовать соответствующие кнопки.

Дерево объектов конфигурации отображает: какие сущности есть в конфигурации.

С помощью дерева объектов можно создавать новые элементы, редактировать, добавлять новые реквизиты и свойства.

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

Возможен поиск нужного объекта по первым буквам. Курсор автоматически позиционируется на нужном объекте.

Иногда дерево объектов называют метаданными. Во встроенном языке есть специальное свойство, которое так и называется Метаданные (т.е. данные о данных).

Одна из функций конфигуратора – это выгрузка/загрузка информационной базы. При выгрузке информационной базы получается упакованный файл с расширением dt.

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

  • для переноса базы данных из одного места в другое;
  • как один из вариантов выполнения архивирования;
  • для перевода файлового режима работы базы в клиент-серверный.

Для редактирования свойств объектов конфигурации существует три метода. Первый из них – вызов окна редактирования объекта (двойным кликом мыши).

Удобен для объектов с большим количеством свойств. Окно редактирования объекта «Документ1» представлено на рисунке.

Данный метод существует не для всех объектов. Например, исключением являются константы.

Следующий метод редактирования свойств объектов – с помощью палитры свойств, которая есть у всех объектов (и у простых, и у сложных). Соответственно, ее можно вызвать для любого объекта.

Вызов осуществляется через контекстное меню, пункт Свойства объекта (комбинация клавиш Alt+Enter ).

В палитре все свойства представлены в виде списка. Можно выбирать соответствующие свойства и редактировать.

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

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

Возможно отображение только важных свойств. Переход в данный режим осуществляется нажатием на кнопку в виде воронки.

Если Вы не можете найти какое-то свойство, то, скорее всего, у Вас нажата данная кнопка.

Для каждого свойства существует описание (отображается внизу окна). Описание может быть скопировано в буфер и использовано для поиска по справке.

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

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

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

В этом окне можно проставлять различные свойства данного объекта, которые, в основном, представлены в виде различных галочек.

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

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

Откроется окно с достаточно большим количеством настроек и закладок.

На закладке Запуск 1С:Предприятия можно указать, какое приложение автоматически будет использоваться при запуске из конфигуратора (тонкий клиент, толстый клиент (управляемое приложение) и т.д.).

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

Внимание! Данная настройка влияет только на запуск из конфигуратора.

Здесь же можно настроить использование низкой скорости соединения (т.е. использование группировки данных, передаваемых на сервер, в пакеты).

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

На закладке Запуск 1С:Предприятие есть также подзакладка Дополнительные , где с помощью галочек можно установить ряд дополнительных параметров, которые влияют на запуск приложения из конфигуратора (будут ли отображаться показатели производительности, будет ли отображаться команда Все функции и т.д.).

На закладке Общие указывается: нужно ли только создавать объекты управляемого приложения или следует создавать объекты, которые есть и в обычном приложении.

На закладке Тексты можно настроить принципы редактирования и отображения текста (указываются шрифт, ширина табуляции и другие параметры).

На закладке Модули существует ряд подзакладок. Здесь настраивается, каким образом будет отображаться текст в модулях.

Каким образом будет выполняться Проверка , Группировка и Контекстная подсказка .

На закладке Справка указывается, каким образом будет выводиться справка.

Галочками можно указать те разделы, которые интересуют.

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

Появится форма «Настройка поддержки». В данной форме следует нажать на кнопку Включить возможность изменения .

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

Если мы все же намерены вносить изменения, требуется нажать на кнопку Да . Появится окно «Настройка правил поддержки».

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

После этого нужно будет настроить правило поддержки для всей конфигурации в целом.

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

В появившейся форме необходимо выбрать правило Объект поставщика редактируется с сохранением поддержки и нажать на кнопку ОК .

Фому «Настройка поддержки следует закрыть». В результате произведенных действий у нас появится возможность добавления новых объектов. В окне конфигурации активизируется кнопка Добавить .

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

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

Если в основную конфигурацию были внесены какие-либо изменения, то в заголовке окна конфигурация появится маленькая звездочка (*).

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

Для обновления конфигурации базы данных в соответствии с произведенными программистом изменениями нужно вызвать пункт из меню Конфигурация , использовать клавишу F7 или соответствующую кнопку.

Чтобы запустить конфигурацию в пользовательском режиме можно выбрать пункт 1С:Предприятие из меню Сервис или использовать сочетание клавиш Ctrl+F5 .

Можно запустить конфигурацию в режиме отладки (пункт Начать отладку из меню Отладка , клавиша F5 или соответствующая кнопка командной панели).

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

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

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

Сначала для заданного сеанса в режиме 1С:Предприятие через главное меню Сервис/Параметры нужно открыть окно «Параметры» и установить галочку Отладка в текущем режиме разрешена .

На будущее можно поставить галочку Устанавливать режим разрешения отладки при запуске .

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

При этом появится окно «Предметы отладки» со списком процессов, которые можно отлаживать. В этом списке необходимо выбрать требуемый предмет отладки (сеанс пользователя) и осуществить к нему подключение нажатием на кнопку Подключить .

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

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

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

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

Идентификатор. В отличие от идентификатора объекта метаданных, о котором говорилось в п. «Свойства объекта метаданных» на стр. Ошибка! Закладка не определена., на идентификатор конфигурации не накладывается практически никаких ограничений: это может быть произвольная строка символов, включающая пробелы и специальные символы. Единственное назначение идентификатора конфигурации - в режиме запуска «1С:Предприятис» он выдается в заголовке окна системы .

Синоним. Для конфигурации, помимо идентификатора, можно указать также синоним идентификатора. Если существует синоним то при работе с системой 1С:Предприятие он будет выдаваться вместо идентификатора в заголовке окна.

Как и идентификатор конфигурации, синоним не имеет ограничений на использование символов.

Комментарий. Комментарий - также произвольная строка символов. Кроме палитры свойств, нигде больше не отображается.

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

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

Например, во встроенном языке системы 1С:Предприятие существует функция ТипЗначенияСтр(), которая возвращает тип выражения, указанного в качестве параметра этой функции, в виде строки символов. Например, если параметром является значение типа «дата», функция ТипЗначенияСтр() возвратит слово «Дата», если установлен русский язык, и слово «Date» - если английский.

«Сменить пароль». Назначает пароль, который пользователь должен указать при открытии окна «Конфигурация».

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

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

После ввода пароля нажмите кнопку «ОК». Для надежности программа запрашивает пароль еще раз. Повторите ввод пароля и для подтверждения нажмите кнопку «ОК». Запрос для ввода пароля будет закрыт, и будет назначен новый пароль. Если пароль на конфигурацию уже существовал, старый пароль будет удален и заменен новым.

Если вы передумали устанавливать пароль, нажмите кнопку «Отмена».

Внимание! Присвоенный пароль нельзя посмотреть, поэтому будьте внимательны при установке пароля и твердо запомните его.

Для снятия пароля с конфигурации нажмите кнопку «Сменить пароль» и, не указывая нового пароля, дважды нажмите кнопку «ОК» в запросе ввода пароля.

Округление. Устанавливает правила округления результатов числовых выражений.

Если выбрана установка «Округлять 1,5 до 1», то при округлении, например, денежных сумм до целых рублей, суммы до 50 копеек включительно будут отбрасываться, а свыше 50 копеек - округляться до целого рубля.

При такой установке сумма 1 рубль 50 копеек будет округлена до 1 рубля, а сумма 1 рубль 51 копейка - до 2 рублей.

Если выбрана установка «Округлять 1,5 до 2», то суммы до 50 копеек будут отбрасываться, а свыше 50 копеек включительно - округляться до целого рубля.

Соответственно, сумма 1 рубль 49 копеек будет округлена до 1 рубля, а сумма 1 рубль 50 копеек - до 2 рублей.

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

Разрешить непосредственное удаление объектов. Данная опция включает или отключает механизм контроля ссылочной целостности.

Если опция отключена, в системе 1С:Предприятие задействуется механизм контроля ссылочной целостности. В этом случае непосредственное удаления объектов данных заменяется пометкой их на удаление, а удаление помеченных объектов выполняется в специальном режиме.

Внимание! Средства встроенного языка позволяют выполнять непосредственное удаление объектов данных, независимо от установок в конфигурации. Поэтому элементы конкретной конфигурации могут выполнять непосредственное удаление в обход механизма контроля ссылочной целостности. В этом случае ответственность за целостность данных лежит на специалисте, выполнявшем конфигурирование системы.

Если опция «Разрешить непосредственное удаление объектов» включена, механизм контроля ссылочной целостности в системе 1С:Предприятие отключен. В этом случае, если это необходимо, возможность непосредственного удаления объектов может быть ограничена определенным категориям пользователей с помощью настройки прав доступа к конкретным видам объектов метаданных.

Кроме того, если признак «Разрешить непосредственное удаление объектов» включен, и у пользователя установлены права на непосредственное удаление объектов, то он может выбрать режим удаления в режиме настройки параметров (закладка «Общие» меню «Сервис» главного меню системы 1С:Прсдприятие). Для этого переключатель «Режим удаления объектов» должен быть установлен соответственно в состояние «Непосредственное удаление». Если переключатель установлен в состояние «Пометка на удаление», то также будет задействован механизм контроля ссылочной целостности.

Подробнее о механизме контроля ссылочной целостности смотри в Руководстве пользователя по системе 1С:Прсдприятие.

В следующих разделах описано, как задавать различные свойства компоновки, используемые в определении компоновки. Каждый раздел описывает элемент, который можно указать в элементе createBuildDefinition или updateBuildDefinition. Не все элементы применимы к конкретному типу компоновки.

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

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

Атрибут Обязательный Описание
Имя свойства компоновки. Допустимые имена описаны в каждом из следующих разделов.

Значение свойства компоновки. Допустимые значения и ограничения описаны в каждом из следующих разделов. Ограничения допустимых значений указаны в столбце значения. Действуют следующие ограничения:

asis

Этот атрибут игнорируется.

описание

Этот атрибут игнорируется.

genericEditAllowed

Этот атрибут игнорируется.

Этот атрибут игнорируется.

Этот атрибут игнорируется.

override

Этот атрибут игнорируется.

Этот атрибут игнорируется.

scheduleOverride

Этот атрибут игнорируется.

Этот атрибут игнорируется.

Элемент antBuildProperty

В элементах antBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки Ant. Элемент antBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента antBuildProperty:

Имя Значение Описание

com.ibm.team.build.ant.antArgs

Аргументы Ant:

com.ibm.team.build.ant.antHome

Домашний каталог Ant:

com.ibm.team.build.ant.buildFile

Файл компоновки:* путь к файлу компоновки Ant в системе компоновки. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

com.ibm.team.build.ant.includeToolkit

Набор компоновки Jazz: включить задачи набора компоновки Jazz в путь к библиотекам Ant. Добавляет аргумент Ant -lib с путем каталога "buildtoolkit" Jazz.

com.ibm.team.build.ant.javaHome

Домашний каталог Java:

com.ibm.team.build.ant.javaVMArgs

Аргументы VM Java:

com.ibm.team.build.ant.propertiesFile

Файл свойств:

com.ibm.team.build.ant.targets

Целевые объекты компоновки:

com.ibm.team.build.ant.workingDir

Рабочий каталог:

Элемент antzBuildProperty

В элементах antzBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки Ant с Enterprise Extensions. Элемент antzBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента antzBuildProperty:

Имя Значение Описание

teamz.build.ant.antArgs

Аргументы Ant: эти аргументы будут переданы в вызов Ant.

teamz.build.ant.antHome

Домашний каталог Ant: по умолчанию будет использоваться Ant с модулем компоновки Jazz. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

teamz.build.ant.buildFile

Файл компоновки:* Каталог загрузки можно указать с помощью встроенного свойства компоновки ${teamz.scm.fetchDestination} .

Пример: ${teamz.scm.fetchDestination}/buildProject/build.xml

teamz.build.ant.buildOrder

Порядок компоновки:

teamz.build.ant.createBuildMaps

Создать схемы компоновки: создает схемы компоновки для результатов компоновки.

teamz.build.ant.generateReports

Создать файл компоновки: teamz.build.ant.useGeneratedBuildFile присвоено значение true .

teamz.build.ant.javaHome

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

teamz.build.ant.javaVMArgs

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Ant.

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

teamz.build.ant.targets

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

teamz.build.ant.useGeneratedBuildFile

Создать файл компоновки: teamz.build.ant.buildOrder .

teamz.build.ant.buildFile .

teamz.build.ant.workingDir

Рабочий каталог: рабочий каталог, используемый вызванным процессом Ant. По умолчанию используется текущий каталог процесса модуля компоновки.

Прим.:

    • teamz.build.ant.buildAllItems
    • teamz.build.ant.conditionalBuild
    • teamz.build.ant.buildableSubset

Элемент cmdBuildProperty

Элементы cmdBuildProperty позволяют указать сведения о конфигурации для компоновки командной строки. Элемент cmdBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента cmdBuildProperty:

Имя Значение Описание

com.ibm.team.build.cmdline.arguments

Аргументы: аргументы команды.

com.ibm.team.build.cmdline.command

Команда:* вызываемая команда.

com.ibm.team.build.cmdline.environmentVariablePolicy

Переменные среды (стратегия): выберите способ настройки переменных среды. Ниже перечислены допустимые значения и их описания:

  • ADD - указывает, что переменные среды будут добавлены, но не будут переопределять существующие переменные среды.
  • NONE - указывает, что переменные среды не будут добавляться.
  • OVERRIDE - указывает, что переменные среды будут добавлены и смогут переопределять существующие переменные среды.
  • REPLACE - указывает, что вся встроенная среда будет заменена свойствами компоновки.

com.ibm.team.build.cmdline.environmentVariablePrefix

Переменные среды (префикс): префикс для добавления к имени каждой новой переменной среды.

com.ibm.team.build.cmdline.propertiesFile

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

com.ibm.team.build.cmdline.workingDir

Рабочий каталог: По умолчанию используется текущий каталог процесса модуля компоновки.

Элемент dpndBuildProperty

В элементах dpndBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки зависимостей z/OS. Элемент dpndBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента dpndBuildProperty:

Имя Значение Описание

Аргументы Ant: эти аргументы будут переданы в вызов Ant.

Домашний каталог Ant: по умолчанию будет использоваться Ant с модулем компоновки Jazz. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

Рабочая область компоновки: компоновка всех элементов рабочей области. Если этому свойству присвоено значение false , то необходимо определить свойство team.enterprise.build.ant.buildableSubset (см. раздел Свойства компоновки коллектива

Файл компоновки:*

Порядок компоновки: настройте порядок компоновки элементов. Укажите список языков в порядке компоновки; в качестве разделителя применяется запятая.

Условная компоновка:
Создать файл компоновки: укажите значение true, если атрибуту присвоено значение true .

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Ant.

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

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

team.enterprise.build.ant.useGeneratedBuildFile

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

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

Рабочий каталог: рабочий каталог, используемый вызванным процессом Ant. По умолчанию используется текущий каталог процесса модуля компоновки.

Область видимости свойств:

Пример: verifyBuildOutputs=t,conditionalBuild=,antArgs=, customBuildFile=,customBuildTargets=,trustOutputs=, prebuildScript=,postbuildScript=,alwaysRunPostbuild=, changedItemsOnly=tp,impactsInRepo=,impactsNotRepo=, impactsAlwaysBuild=,mandatorySubset=,deleteDirectory=, fullMinLoad=p,previewBuild=t,simulationBuild=t

Значение свойства Описание
verifyBuildOutputs
conditionalBuild Условная компоновка
antArgs Аргументы Ant
customBuildFile Файл компоновки
customBuildTargets Целевые объекты компоновки
trustOutputs Доверять выводам компоновки
prebuildScript
postbuildScript
alwaysRunPostbuild
changedItemsOnly
impactsInRepo
impactsNotRepo
impactsAlwaysBuild
mandatorySubset Обязательное подмножество
deleteDirectory
fullMinLoad
previewBuild Подготовка к компоновке
simulationBuild Имитация компоновки

Прим.:

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

Элемент hdsnBuildProperty

В элементах hdsnBuildProperty указывается задание Hudson/Jenkins для выполнения. Элемент hdsnBuildProperty содержит два обязательных атрибута, name и value . В следующей таблице описаны допустимые значения атрибутов элемента hdsnBuildProperty:

Элемент icmdBuildProperty

В элементах icmdBuildProperty указывается требуемая среда для команд компоновки и команда для запуска компоновки. Можно указать необязательные команды для выполнения перед компоновкой и после компоновки. Элемент icmdBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента icmdBuildProperty:

Имя Значение Описание

com.ibm.teami.build.qcmd.buildAllMembers

Выполнить команду компоновки для всех артефактов в рабочей области: buildAllMembers или buildEachChangedMember .

com.ibm.teami.build.qcmd.buildEachChangedMember

Выполнить команду компоновки для всех измененных артефактов: с этой опцией команда компоновки поддерживают переменные подстановки &A, &F, &L, &N, &T и &S. Значение true одновременно может быть указано только для одного из параметров компоновки buildAllMembers или buildEachChangedMember .

com.ibm.teami.build.qcmd.command

Команда компоновки: вызываемая команда. Если не включен ни один из переключателей buildAllMembers или buildEachChangedMember , то команда будет вызвана один раз.

com.ibm.teami.build.qcmd.currentlibrary

Текущая библиотека: библиотека, которую требуется назначить "текущей" во время соединения с IBM i.

com.ibm.teami.build.qcmd.librarylist

Список библиотек: имена библиотек, которые необходимо добавить в пользовательскую часть списка библиотек. Укажите список имен библиотек через запятую.

com.ibm.teami.build.qcmd.postbuild

Команда для выполнения после компоновки: команда, вызываемая после команды компоновки.

com.ibm.teami.build.qcmd.prebuild

Команда для выполнения перед компоновкой: команда, вызываемая до команды компоновки.

Элемент idpnBuildProperty

В элементах idpnBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки зависимостей IBM i. Элемент idpnBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента idpnBuildProperty:

Имя Значение Описание

team.enterprise.build.ant.antArgs

Аргументы Ant: эти аргументы будут переданы в вызов Ant.

team.enterprise.build.ant.antHome

Домашний каталог Ant: по умолчанию будет использоваться Ant с модулем компоновки Jazz. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

team.enterprise.build.ant.buildAllItems

Рабочая область компоновки: компоновка всех элементов рабочей области. Если этому свойству присвоено значение false , то необходимо определить свойство team.enterprise.build.ant.buildableSubset (см. раздел Свойства компоновки коллектива). Если для этого свойства указано значение true , то значение свойства подмножества компоновки игнорируется.

team.enterprise.build.ant.buildFile

Файл компоновки:* путь к файлу компоновки Ant с Enterprise Extensions в системе компоновки. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки. Каталог загрузки можно указать с помощью встроенного свойства компоновки ${team.enterprise.scm.fetchDestination} .

Пример: ${team.enterprise.scm.fetchDestination}/buildProject/build.xml

team.enterprise.build.ant.buildOrder

Порядок компоновки: настройте порядок компоновки элементов. Укажите список языков в порядке компоновки; в качестве разделителя применяется запятая.

team.enterprise.build.ant.conditionalBuild

Условная компоновка: прерывать компоновку в случае ошибки. Если указано значение true , то компоновка прерывается разу после обнаружения первой ошибки. Если указано значение false и возникает ошибка, то компоновка завершает обработку языка и прерывается.

team.enterprise.build.ant.generateReports

Создать файл компоновки: укажите значение true , если атрибуту присвоено значение true .

team.enterprise.build.ant.javaHome

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

team.enterprise.build.ant.javaVMArgs

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Ant.

team.enterprise.build.ant.propertiesFile

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

team.enterprise.build.ant.targets

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

team.enterprise.build.ant.useGeneratedBuildFile

Создать файл компоновки: укажите значение true , чтобы автоматически создавать файл компоновки на основе доступных определений. Если для этого свойства указано значение true, то должно быть задано свойство team.enterprise.build.ant.buildOrder .

Создать файл компоновки: укажите значение true , чтобы автоматически создавать файл компоновки на основе доступных определений. Если для этого свойства указано значение true , то должно быть задано свойство team.enterprise.build.ant.buildOrder . Использовать существующий файл компоновки: укажите значение false , чтобы указать пользовательский файл компоновки и целевые объекты для вызова. Если для этого свойства указано значение false , то должно быть задано свойство team.enterprise.build.ant.buildFile .

team.enterprise.build.ant.workingDir

Рабочий каталог: рабочий каталог, используемый вызванным процессом Ant. По умолчанию используется текущий каталог процесса модуля компоновки.

team.enterprise.build.excludedComponents

Выберите компоненты для исключения из компоновки: укажите список имен компонентов для исключения из компоновки; в качестве разделителя применяется запятая.

team.enterprise.build.ui.requestOptionVisibility

Область видимости свойств: укажите, какие свойства будут доступны при запросе компоновки. Укажите одну непрерывную строку со списком значений свойства; в качестве разделителя применяется запятая. Укажите =t , чтобы сделать свойство доступным для компоновки коллектива. Укажите =p , чтобы сделать свойство доступным для личной компоновки. Укажите =tp , чтобы сделать свойство доступным для обоих типов компоновки. Укажите = , чтобы сделать свойство недоступным для обоих типов компоновки.

Например:

VerifyBuildOutputs=t,conditionalBuild=,antArgs=, customBuildFile=,customBuildTargets=,trustOutputs=, prebuildScript=,postbuildScript=,alwaysRunPostbuild=, changedItemsOnly=tp,impactsInRepo=,impactsNotRepo=, impactsAlwaysBuild=,mandatorySubset=,deleteDirectory=, fullMinLoad=p,previewBuild=t,simulationBuild=t

Ниже приведен список значений свойства:

Значение свойства Описание
verifyBuildOutputs Проверить выводы компоновки во время имитации компоновки
conditionalBuild Условная компоновка
antArgs Аргументы Ant
customBuildFile Файл компоновки
customBuildTargets Целевые объекты компоновки
trustOutputs Доверять выводам компоновки
prebuildScript Запустить сценарий подготовки к компоновке
postbuildScript Запустить сценарий завершения компоновки
alwaysRunPostbuild Всегда запускать сценарий для выполнения после компоновки
changedItemsOnly Компоновать только измененные элементы
impactsInRepo Рассчитать затронутые зависимости, сохраненные в хранилище
impactsNotRepo Рассчитать затронутые зависимости, не находящиеся в хранилище
impactsAlwaysBuild Рассчитать влияние файлов, скомпонованных принудительно
mandatorySubset Обязательное подмножество
deleteDirectory Удалить каталог перед загрузкой
fullMinLoad Выполнить полную минимальную загрузку
previewBuild Подготовка к компоновке
simulationBuild Имитация компоновки

Прим.:

  • В следующем списке перечислены зарезервированные имена свойств, которые можно указать только после переопределения:
    • team.enterprise.build.buildmaps.needMigrateComponent
  • В следующем списке перечислены зарезервированные имена свойств, которые нельзя указать:
    • team.enterprise.build.ant.createBuildMaps

Элемент iprmBuildProperty

В элементах iprmBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки перемещения IBM i. Элемент iprmBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента iprmBuildProperty:

Имя Значение Описание

team.enterprise.promotion.ant.antArgs

Аргументы Ant: эти аргументы будут переданы в вызов Ant.

team.enterprise.promotion.ant.antHome

Домашний каталог Ant: по умолчанию будет использоваться Ant с модулем компоновки Jazz. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

team.enterprise.promotion.ant.buildFile

Файл компоновки:* путь к файлу компоновки Ant с Enterprise Extensions в системе компоновки. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

team.enterprise.promotion.ant.buildTarget

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

team.enterprise.promotion.ant.javaHome

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

team.enterprise.promotion.ant.javaVMArgs

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Ant.

team.enterprise.promotion.ant.propertiesFile

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

team.enterprise.promotion.ant.workingDir

Рабочий каталог: рабочий каталог, используемый вызванным процессом Ant. По умолчанию используется текущий каталог процесса модуля компоновки.

Список компонентов:

Целевой каталог:*

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

и
и должны быть заданы как false .

com.ibm.team.enterprise.promotion.type.wi

com.ibm.team.enterprise.promotion.type.both и com.ibm.team.enterprise.promotion.type.comp должны быть заданы как false .
com.ibm.team.enterprise.promotion.workitem.decide.include.children укажите значение true , чтобы сделать выбор в процессе перемещения.
com.ibm.team.enterprise.promotion.workitem.decide.include.impacted Включить затронутый вывод: укажите значение true , чтобы сделать выбор в процессе перемещения.
com.ibm.team.enterprise.promotion.workitem.decide.in.promotion
Рекомендуется проигнорировать изменения:
Добавить дочерние элементы выбранных заданий:
Включить затронутый вывод:

team.promotion.ibmi.pfRestoreMethod

Правила для перемещения физических файлов: указывает, как обрабатывать объекты физических файлов (*FILE:PF-DTA) при перемещении.

  • REPLACE - заменять объекты физических файлов на исходные объекты.
  • MIGRATE - сохранять имеющиеся данные в физических файлах.
  • USRCMD - сохранять имеющиеся данные в физических файлах с помощью команды, указанной в pfRestoreCommand .

team.promotion.ibmi.pfRestoreCommand

USRCMD: сохраняет имеющиеся данные в физических файлах с помощью этой команды.

Прим.:

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

Элемент jdtBuildProperty

В элементе jdtBuildProperty указывается расположение файла протокола ECJ (компилятор Eclipse для Java) или каталог файлов протокола. Элемент jdtBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента jdtBuildProperty:

Элемент jntBuildProperty

В элементе jntBuildProperty указывается расположение файла протокола XML JUnit или каталог файлов протокола. Можно создать файлы протокола XML JUnit, указав тип верстальщика "xml" при вызове JUnit. Элемент jntBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента jntBuildProperty:

Элемент msbBuildProperty

В элементах msbBuildProperty указывается конфигурация для компоновки Microsoft Visual Studio Solution. Элемент msbBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента msbBuildProperty:

Имя Значение Описание

com.ibm.team.build.msbuild.buildCmd

Команда компоновки: выполняемая команда компоновки (devenv или msbuild).

  • Devenv - devenv.exe
  • MSbuild - msbuild.exe

com.ibm.team.build.msbuild.buildCmdPath

Путь к команде компоновки: необязательное расположение команды компоновки (это расположение необходимо указывать, если команда компоновки отсутствует в пути).

com.ibm.team.build.msbuild.buildItem

Не разрешено

Заменитель для спецификации элементов .

com.ibm.team.build.msbuild.continueBuild

Продолжить компоновку: продолжить компоновку оставшихся элементов при сбое компоновки.

com.ibm.team.build.msbuild.propertiesFile

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

Элемент msbBuildItem

В элементах msbBuildItem, входящих в элемент msbBuildProperty, задается список решений или файлов проектов для компоновки. Для определения элементов msbBuildItem в элементе msbBuildProperty укажите атрибут namr со значением com.ibm.team.build.msbuild.buildItem и включите в него элементы msbBuildItem. Например:

Элементы будут скомпонованы в указанном порядке. Необходимо указать по крайней мере один элемент msbBuildItem. В следующей таблице описаны допустимые значения атрибутов элемента msbBuildProperty:

Атрибут Значение Описание

Дополнительные параметры: укажите дополнительные параметры команды компоновки.

Конфигурация компоновки: конфигурация для компоновки. Элемент configuration является обязательным.

Рабочий каталог:

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

Имя файла решения или проекта: имя файла решения или проекта для компоновки. Элемент solution является обязательным.

Тип компоновки: тип выполняемой компоновки (например, компоновка или перекомпоновка).

Элемент msbBuildText

В элементах msbBuildText, входящих в элемент msbBuildProperty, задается значение вложенного текстового свойства. Например:

Devenv

Прим.:

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

  • com.ibm.team.build.msbuild.additionalArg
  • com.ibm.team.build.msbuild.buildOutput
  • com.ibm.team.build.msbuild.buildType
  • com.ibm.team.build.msbuild.buildConfiguration
  • com.ibm.team.build.msbuild.solutionFile
  • com.ibm.team.build.msbuild.workingDir

Элемент mstBuildProperty

В элементах mstBuildProperty указывается спецификация для полнофункциональных тестов MSTest. Полнофункциональные тесты будут выполняться после успешной компиляции. Элемент mstBuildProperty содержит два обязательных атрибута, name и value . В следующей таблице описаны допустимые значения атрибутов элемента mstBuildProperty:

Имя Значение Описание

com.ibm.team.build.mstest.additionalArg

Дополнительные параметры: укажите дополнительные параметры команды MSTest.

com.ibm.team.build.mstest.mstestFile

Файл спецификации MSTest (vsmdi)*: файл спецификации MSTest (vsdmi), который будет применяться.

com.ibm.team.build.mstest.msTestPath

Путь:* путь к программе MSTest.exe.

com.ibm.team.build.mstest.mstestResultFile

Файл результатов MSTest: файл результатов MSTest (*.trx), который будет создаваться.

com.ibm.team.build.mstest.workingDir

Рабочий каталог: рабочий каталог, используемый процессом MSTest. По умолчанию используется текущий каталог процесса модуля компоновки.

Элемент mvnBuildProperty

В элементах mvnBuildProperty указывается путь к проекту Maven и цели компоновки. Элемент mvnBuildProperty содержит два обязательных атрибута, name и value . В следующей таблице описаны допустимые значения атрибутов элемента mvnBuildProperty:

Имя Значение Описание

com.ibm.team.build.maven.javaHome

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

com.ibm.team.build.maven.javaVMArgs

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Maven.

com.ibm.team.build.maven.mavenGoals

Цели:* укажите цели, этапы и аргументы. Например: "install". Они будут переданы в вызов Maven.

com.ibm.team.build.maven.mavenHome

Домашний каталог Maven:*

com.ibm.team.build.maven.projectLocation

Расположение проекта:* можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

com.ibm.team.build.maven.propertiesFile

Файл свойств можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

Элемент nutBuildProperty

В элементах nutBuildProperty указывается спецификация для полнофункциональных тестов NUnit. Полнофункциональные тесты будут выполняться после успешной компиляции. Элемент nutBuildProperty содержит два обязательных атрибута, name и value . В следующей таблице описаны допустимые значения атрибутов элемента nutBuildProperty:

Имя Значение Описание

com.ibm.team.build.nunit.additionalArg

Дополнительные параметры: укажите дополнительные параметры команды NUnit.

com.ibm.team.build.nunit.nunitFile

Файл конфигурации тестов NUnit:* файл конфигурации тестов NUnit, который будет использоваться.

com.ibm.team.build.nunit.nUnitPath

Путь:* путь к программе NUnit.exe.

com.ibm.team.build.nunit.nunitResultFile

Файл результатов NUnit: файл результатов NUnit (*.xml), который будет создаваться.

com.ibm.team.build.nunit.workingDir

Рабочий каталог: рабочий каталог, используемый процессом NUnit. По умолчанию используется текущий каталог процесса модуля компоновки.

Элемент prmtBuildProperty

В элементах prmtBuildProperty указываются сведения о конфигурации, файл компоновки и целевые объекты для компоновки перемещения z/OS. Элемент prmtBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента prmtBuildProperty:

Имя Значение Описание

teamz.build.ant.antArgs

Аргументы Ant: эти аргументы будут переданы в вызов Ant.

teamz.build.ant.antHome

Домашний каталог Ant: по умолчанию будет использоваться Ant с модулем компоновки Jazz. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

teamz.build.ant.buildFile

Файл компоновки:* путь к файлу компоновки Ant с Enterprise Extensions в системе компоновки. Можно указать полный путь в системе компоновки или путь относительно текущего каталога процесса модуля компоновки.

teamz.build.ant.buildTarget

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

teamz.build.ant.javaHome

Домашний каталог Java: Если значение не задано, то по умолчанию будет использован экземпляр Java, выполняющий модуль компоновки.

teamz.build.ant.javaVMArgs

Аргументы VM Java: эти аргументы будут переданы в виртуальную машину, используемую для вызова Ant.

teamz.build.ant.propertiesFile

Файл свойств: файл вывода, который будет содержать все определения компоновки, модули компоновки и встроенные свойства, используемые в компоновке.

teamz.build.ant.workingDir

Рабочий каталог: рабочий каталог, используемый вызванным процессом Ant. По умолчанию используется текущий каталог процесса модуля компоновки.

team.enterprise.promotion.componentList

Список компонентов: выберите компоненты из исходного определения компоновки для перемещения. Укажите список имен компонентов; в качестве разделителя применяется запятая.

team.enterprise.promotion.destinationPath

Целевой каталог:* целевой каталог задает расположение в системе компоновки, применяемое для хранения промежуточных файлов компоновки.

team.enterprise.promotion.sourceDefinition

Определение исходной компоновки:* необходимо указать исходное определение компоновки.

team.enterprise.promotion.targetDefinition

Определение целевой компоновки:* необходимо указать целевое определение компоновки.

com.ibm.team.enterprise.promotion.createSnapshot

Создать моментальную копию целевого потока перед перемещением исходных данных.

com.ibm.team.enterprise.promotion.type.both

Включить перемещение компонентов и заданий: значение true позволяет включить оба типа перемещения. Если задано значение true , то com.ibm.team.enterprise.promotion.type.comp и com.ibm.team.enterprise.promotion.type.wi

com.ibm.team.enterprise.promotion.type.comp

Включить только перемещение компонентов: укажите значение true , чтобы включить только перемещение компонентов. Если задано значение true , то com.ibm.team.enterprise.promotion.type.both и com.ibm.team.enterprise.promotion.type.wi должны быть заданы как false.

com.ibm.team.enterprise.promotion.type.wi

Включить только перемещение заданий: укажите значение true , чтобы включить только перемещение заданий. Если задано значение true , то com.ibm.team.enterprise.promotion.type.both и com.ibm.team.enterprise.promotion.type.comp должны быть заданы как false.

com.ibm.team.enterprise.promotion.workitem.decide.ignore.changes

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

com.ibm.team.enterprise.promotion.workitem.decide.include.children

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

com.ibm.team.enterprise.promotion.workitem.decide.include.impacted

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

com.ibm.team.enterprise.promotion.workitem.decide.in.promotion

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

com.ibm.team.enterprise.promotion.workitem.ignore.changes

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

com.ibm.team.enterprise.promotion.workitem.include.children

Добавить дочерние элементы выбранных заданий: укажите значение true , чтобы включить.

com.ibm.team.enterprise.promotion.workitem.include.impacted

Включить затронутый вывод: укажите значение true , чтобы включить.

com.ibm.team.enterprise.promotion.workitem.sourceonly

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

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

Прим.:

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

  • team.enterprise.promotion.sourceBuildResult

Элемент rbfBuildProperty

В элементах rbfBuildProperty задаются свойства конфигурации Build Forge. Элемент rbfBuildProperty содержит два обязательных атрибута, name и value . В следующей таблице описаны допустимые значения атрибутов элемента rbfBuildProperty:

Имя Значение Описание

com.ibm.rational.connector.buildforge.logs.all

Включить полный протокол шагов.

com.ibm.rational.connector.buildforge.logs.all.not.passed.or. skipped

Не пройденные или пропущенные шаги.

com.ibm.rational.connector.buildforge.bom.custom

Включить пользовательские данные из BOM.

com.ibm.rational.connector.buildforge.logs.first

Включить шаги протокола для первых n шагов.

com.ibm.rational.connector.buildforge.logs.first.enabled

Разрешить включение шагов протокола для первых n шагов.

com.ibm.rational.connector.buildforge.logs.last

Включить шаги протокола для последних n шагов.

com.ibm.rational.connector.buildforge.logs.last.enabled

Разрешить включение шагов протокола для последних n шагов.

com.ibm.rational.connector.buildforge.project

Проект Build Forge: укажите имя проекта Build Forge.

Прим.:

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

  • com.ibm.rational.connector.buildforge.project.uuid

Элемент ucdpBuildProperty

В элементах ucdpBuildProperty указывается конфигурация развертывания после компоновки. Элемент ucdpBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента ucdpBuildProperty:

Имя Значение Описание

team.udeploy.abortOnIncompleteActivityEnabled

Незавершенные операции: прервать развертывание после компоновки, если есть незавершенные операции компоновки.

team.udeploy.application

Приложение:* приложение для развертывания.

team.udeploy.baseDirectory

Базовый каталог: базовый каталог, из которого необходимо опубликовать файлы. Значение по умолчанию ".", оно задает текущий каталог модуля компоновки. Можно использовать свойства компоновки. Например: "snapshotUUID=${team.scm.fetchDestination}", если выбрано управление исходным кодом Jazz.

team.udeploy.component

Компонент:* компонент, который получит новую версию.

team.udeploy.deployEnabled

Включить: запустить процесс приложения.

team.udeploy.enabled

Включить: включить развертывание после компоновки.

team.udeploy.environment

Среда:* среда, в которой выполняется развертывание.

team.udeploy.excludeFiles

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

team.udeploy.includeFiles

Включаемые файлы: список фильтров для отбора файлов для публикации, разделенных символом новой строки. По умолчанию список пустой, то есть не выбрано не одного файла. Для выбора всех файлов укажите фильтр "**/*". Используйте вложенный текст для элементов "с переносом строк".

team.udeploy.links

Ссылки: список ссылок, разделенных символом новой строки. Каждая ссылка должна быть задана в формате имя=URI. Можно использовать свойства компоновки. Пример: "Build Result = ${repositoryAddress}resource/itemOid/com.ibm.team.build.BuildResult/ ${buildResultUUID}". Поддержка ссылок добавлена в UrbanCode Deploy 6.0. Используйте вложенный текст для элементов "с переносом строк".

team.udeploy.password

Пароль:* пароль пользователя. Пароль не защищен. Он хранится и передается на сервер в открытом виде.

team.udeploy.passwordFile

Файл пароля:* файл, содержащий пароль пользователя. Файл пароля можно создать с помощью "jbe -createPasswordFile".

team.udeploy.passwordType

PASSWORD PASSWORD_FILE

Тип пароля:* тип пароля, PASSWORD или PASSWORD_FILE.

team.udeploy.process

Процесс:* запускаемый процесс.

team.udeploy.properties

Свойства: список свойств, разделенных символом новой строки. Каждое свойство должно быть задано в формате имя=значение. Можно использовать свойства компоновки. Например: "snapshotUUID=${team.scm.snapshotUUID}", если выбрано управление исходным кодом Jazz. Используйте вложенный текст для элементов "с переносом строк".

team.udeploy.serverURI

URI сервера:* URI, по которому доступен сервер. (например, https://localhost:8443/)

team.udeploy.triggerPolicy

Стратегия активации: стратегия активации используется для определения момента развертывания.

  • ALWAYS - всегда развертывать
  • NO_ERRORS - развертывать при отсутствии ошибок компоновки (предупреждения допустимы)
  • NO_WARNINGS - развертывать при отсутствии ошибок и предупреждений компоновки.

team.udeploy.userName

Имя пользователя:* Имя пользователя для входа в систему.

team.udeploy.version

Версия:* имя новой версии. Можно использовать свойства компоновки. Например: "${buildLabel}".

Прим.:

Ниже приведен пример вложенного текста для элементов "с переносом строк".

file.name.01 file.name.02 file.name.03

Элемент zcmdBuildProperty

Элементы zcmdBuildProperty позволяют указать сведения о конфигурации для компоновки командной строки z/OS. Элемент zcmdBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента zcmdBuildProperty:

Имя Значение Описание

com.ibm.rational.buildforge.buildagent.cmdline.command

Команда:* вызываемая команда.

com.ibm.rational.buildforge.buildagent.cmdline.timeout

Тайм-аут соединения:

com.ibm.rational.buildforge.buildagent.cmdline.workingDir

Рабочий каталог:* рабочий каталог, используемый процессом вызванной команды.

Элемент zpreBuildProperty

Элементы zpreBuildProperty позволяют указать сведения о конфигурации для команды перед компоновкой z/OS. Элемент zpreBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента zpreBuildProperty:

Имя Значение Описание

com.ibm.rational.buildforge.buildagent.precmdline.command

Команда:* вызываемая команда.

com.ibm.rational.buildforge.buildagent.precmdline.timeout

Тайм-аут соединения: тайм-аут соединения в секундах.

com.ibm.rational.buildforge.buildagent.precmdline.workingDir

Рабочий каталог:* рабочий каталог, используемый процессом вызванной команды.

Элемент zpstBuildProperty

Элементы zpstBuildProperty позволяют указать сведения о конфигурации для команды после компоновки z/OS. Элемент zpstBuildProperty содержит два обязательных атрибута, name и value . Ссылки на другие свойства компоновки допустимы, если значение указано в формате ${propertyName} . В следующей таблице описаны допустимые значения атрибутов элемента zcmdBuildProperty:

Имя Значение Описание

com.ibm.rational.buildforge.buildagent.postcmdline.command

Команда:* вызываемая команда.

com.ibm.rational.buildforge.buildagent.postcmdline.timeout

Тайм-аут соединения: тайм-аут соединения в секундах.

com.ibm.rational.buildforge.buildagent.postcmdline.workingDir

Рабочий каталог:* рабочий каталог, используемый процессом вызванной команды.