Настройка пользовательского поля

Пользователь JIRA может изменить каждое из пользовательских полей в вашей системе JIRA, выбирая следующие:

  • Имя (Name—  ярлык, который отображается слева от пользовательского поля, когда он отображается пользователю. См. ниже.
  • Описание (Description) — текст справки, который появляется под настраиваемым полем, когда он отображается в столбце «Простой поиск». См. ниже.
  • Шаблон поиска (Search Template) —  механизм создания пользовательского поля для поиска. См. ниже.
  • Значение по умолчанию (Default Value) —  значение по умолчанию для настраиваемого поля, когда оно впервые отображается пользователю. См. ниже.
  • Параметры (Options) (только для полей «Выбрать» (Select) и «Мультивыбор» (Multi-Select)) —  значения, которые пользователь может выбрать. См. ниже.
  • Фильтрация пользователей (User Filtering) (только для полей сортировщик пользователей (User Picker)) —  набор пользователей, из которых пользователь может выбрать. См. ниже.
  • Контекст (Context) —  комбинация проектов и типа (-ов), для которых применяется данное значение по умолчанию (Default Value) и параметры (Options). См. ниже.

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

Просмотр пользовательских полей

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

  1. Войдите в систему как пользователь с глобальным разрешением администраторов JIRA.
  2. Выберите «Задачи» (Issues). Выберите «Поля» (Fields)> «Пользовательские поля» (Custom Fields), чтобы открыть страницу «Пользовательские поля».

Комбинация клавиш: g + g + начало ввода пользовательских полей

Редактирование пользовательского поля

Редактирование пользовательского поля позволяет вам изменить его имя (метку), описание (текст справки) и шаблон поиска.

Для того чтобы изменить пользовательское поле, необходимо выполнить следующие шаги:

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное пользовательское поле и выберите значок шестеренки> Edit:
  • Имя (Name) - это метка, которая отображается слева от пользовательского поля, когда она отображается пользователю.
  • Описание (Description) - это текст справки, который отображается под пользовательским полем, когда он отображается в столбце «Простой поиск».
  • Шаблоны поиска (Search Templates) отвечают за индексирование пользовательского поля, а также за возможность поиска с помощью простого поиска и расширенного поиска (обратите внимание, что пользовательские поля не могут быть найдены с помощью быстрого поиска). Каждый пользовательский тип поля имеет предварительно сконфигурированный шаблон поиска, но вы можете выбрать другой шаблон, используя эту процедуру.
  1. Измените нужные поля и нажмите «Обновить» (Update).

Настройка пользовательского поля

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

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

Каждое настраиваемое поле имеет контекст с именем "Схема конфигурации по умолчанию для.." (Default Configuration Scheme for ...), который создается автоматически при добавлении пользовательского поля.

Контекст

Для того чтобы изменить проект (ы) и тип (ы) задачи, к которым относится данное значение по умолчанию и параметры, необходимо выполнить следующие шаги:

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное пользовательское поле и выберите значок шестеренки> Configure.
  2. Найдите контекст с именем "Схема настройки по умолчанию для..." (Default Configuration Scheme for ...) и нажмите ссылку "Изменить конфигурацию" (Add new context).
  3. В разделе «Выберите применимые типы задач» (Choose applicable issue types) выберите тип (ы) задач, к которым вы хотите применить это значение по умолчанию и параметры.
  4. Вы можете выбрать любые типы задач, если хотите. В разделе «Выберите применимые контексты» (Choose applicable contexts) выберите проект (ы), к которому вы хотите применить это значение по умолчанию и параметры. Обратите внимание, что это относится только к задачам с выбранными типами задач, как указано выше.

Добавление нового контекста

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

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

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное пользовательское поле и выберите значок шестеренки> Configure.
  2. Нажмите ссылку«Добавить новый контекст» (Add new context). Отобразится страница «Добавить контекст схемы конфигурации» (Add configuration scheme context) (см.ниже).
  • В разделе «Добавить контекст схемы конфигурации» (Add configuration scheme context) введите «Метка» (Label) и «Описание» (Description) для вашего нового контекста - они используются только для административных целей и не будут показаны конечным пользователям.
  • В разделе «Выберите применимые типы задач» (Choose applicable issue types) выберите тип (ы) задачи, к которому вы хотите применить это значение по умолчанию и параметры.  Если хотите, вы можете выбрать любые типы задач (Any issue types).
  • В разделе «Выбрать применимые контексты» (Choose applicable contexts)
     выберите проект (ы), к которому вы хотите применить это значение по умолчанию и параметры. Обратите внимание, что это относится только к задачам с выбранными типами задач, как указано выше.

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

Значение по умолчанию

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

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное настраиваемое поле и выберите значок шестеренки> Configure.
  2. Найдите соответствующий контекст (обычно будет только один, с именем «Схема конфигурации по умолчанию для ...» (Default Configuration Scheme for ...)) и нажмите ссылку «Изменить значение по умолчанию» (Edit Default Value) в правом столбце. Отобразится страница «Установить пользовательские поля по умолчанию» (Set Custom Field Defaults) и которая будет полезна для пользовательского типа поля:
  • «Для списка выбора или списка с несколькими выборами» (For a Select List or Multi-Select List). В раскрывающемся списке выберите соответствующее значение по умолчанию.

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

  • «Для каскадного списка выбора» (For a Cascading Select List). Выберите соответствующие значения по умолчанию из раскрывающихся списков (по одному для каждого уровня).
  • «Для поля «Дата» (Date). Укажите дату или отметьте галочку, чтобы сделать текущую дату по умолчанию.
  • «Для других типов полей» (For other types of fields). Введите соответствующие значения по умолчанию из раскрывающихся списков (по одному для каждого уровня).

(информация) Некоторые типы пользовательских полей, например расчетные пользовательские поля, могут не разрешать выбор по умолчанию и не иметь ссылку «Изменить значение по умолчанию» (Edit Default Value).

Опции

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

  • Выбрать списки (Select lists)
  • Мульти - выбор списков
  • Каскадные (Cascading) списки выбора
  • Радио - кнопки
  • Мульти - флажки

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

Эти параметры нечувствительны к регистру, поэтому при использовании списка выбора или множественного выбора для схемы уведомления JIRA-ADMINISTRATORS будут соответствовать группе jira-administrators. Это означает, что вы не можете использовать JIRA-ADMINSITRATORS и jira-администраторы, так как они имеют одинаковое имя.

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

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное настраиваемое поле и выберите значок шестеренки> Configure.
  2. Найдите соответствующий контекст (обычно будет только один, с именем «Схема конфигурации по умолчанию для ...» (Default Configuration Scheme for ...)) и нажмите ссылку «Параметры» (Options) в правом столбце. Отобразится страница «Изменить пользовательские параметры поля» (Edit Custom Field Options) (см. ниже). Здесь вы можете:
  • Выберите в раскрывающемся списке «Изменить родительский список выбора» (Edit parent select list), чтобы выбрать список для редактирования. (Только для каскадного списка выбора)
  • Нажмите «Сортировать по алфавиту» (Sort alphabetically), чтобы автоматически изменить порядок в алфавитном порядке.
  • Нажмите стрелки в столбце «Порядок» (Order) или укажите номер и нажмите кнопку «Переместить» (Move), чтобы вручную изменить параметры.
  • Нажмите «Изменить» (Edit), чтобы изменить текст опции.
  • Нажмите «Отключить» (Disable), чтобы скрыть параметр, чтобы он больше не был доступен для выбора. Параметры, которые были использованы, не могут быть удалены (чтобы сохранить целостность данных), но из-за меняющихся бизнес-требований они со временем могут стать недействительными, и поэтому вы можете сделать их недоступными для новых задач.
  • Нажмите «Удалить» (Delete), чтобы удалить параметр. (Это будет возможно только для опций, которые не были использованы.)

Фильтрация пользователей

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

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

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное пользовательское поле и выберите значок шестеренки> Configure.
  2. Нажмите «Редактировать фильтрацию пользователей» (Edit User Filtering).
  3. Нажмите «Включить фильтрацию роли группы или проекта» (Enable group or project role filtering), затем укажите группы и / или роли, для которых вы хотите ограничить выбор пользователя.

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

  1. Нажмите «Сохранить» (Save).

Выбор экранов

Для того чтобы выбрать «Экраны», на которых появится пользовательское поле, необходимо выполнить следующие шаги:

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное настраиваемое поле и выберите значок шестеренки> «Экран» (Screens).
  2. Установите флажки на экранах, на которых вы хотите отобразить это настраиваемое поле.

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

Перевод пользовательского поля

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

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

  1. Перейдите на страницу «Пользовательские поля» (Custom Fields), найдите нужное настраиваемое поле и выберите значок шестеренки> «Перевод» (Translate).
  2. Выберите языковой пакет, для которого этот перевод пользовательского поля будет принадлежать (например, французский), и введите переведенные строки для имени поля (Field Name) и описания (Description).

Поиск и устранение неполадок пользовательских полей

Использование помощника администратора JIRA

Помощник администратора JIRA может помочь вам диагностировать, почему пользовательское поле не отображается на ваших экранах. Этот инструмент доступен только для администраторов JIRA.

Для того чтобы диагностировать, почему пользовательское поле не отображается на экранах «Просмотр задачи» (View Issue), «Редактирование задачи» (Edit Issue ) или «Создание задачи» (Create Issue), выполните следующие шаги:

  1. Перейдите последовательно к экранам «Просмотр задачи» (View Issue), «Редактирование задачи» (Edit Issue) или «Создание задачи» (Create Issue), в поиске  где поле не отображается.
  2. Если вы просматриваете задачу, нажмите «Дополнительные действия» (More Actions)> «Где мое поле?» (Where is my field?) Если вы создаете или редактируете задачу, нажмите «Настроить поля» (Configure Fields)> «Где мое поле?» (Where is my field?)
  3. Введите имя поля.
  4. Нажмите «Отправить» (Submit).

Совет. Вы также можете получить доступ к разделу «Где мое поле?» (Where is my field)  через  меню диалога шестеренки для каждой задачи в «Навигаторе задач».

Изменение описания пользовательского поля

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

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

Например, если пользовательское поле «Мое поле» (My Field) определено с описанием «Это мое поле» (This is my field), и никаких изменений конфигурации поля не производится, тогда отображаемый текст будет «Это мое поле» (This is my field), как и ожидалось. Если используются конфигурации полей, и для «пользовтельского поля» в описании поля задано описание «Это мое отличное поле» (This is my excellent field), тогда отображаемый текст будет «Это мое отличное поле» (This is my excellent field).

 

По материалам Atlassian JIRA Administrator's Guide: Configuring a Custom Field