[Rally] Create and Customize Fields

Create and Customize Fields

CA Agile Central (Rally) 에 Field 를 추가하거나 수정하려면 subscription 이나 workspace administrator permission을 가지고 있어야 한다.

field들은 Visible 혹은 hidden 으로 세팅할 수 있다.

Manage Field

Field Summary page에는 해당 work item 과 연관 된 모든 필드들에 대한 정보를 제공한다. workspace나 project perspective에서 이 Fields summary를 볼 수 있다.
이 페이지에 가면 특정 프로젝트, 프로젝트 그룹 혹은 전체 workspace의 필드들의 상태를 볼 수 있다.

이 Field Summary page는
- single work item type의 모든 필드들을 보여준다.
- name, type, custom 대 standard, required 그리고 visibility 등으로 정렬해 볼 수 있다.
- Custom field들을 생성할 수 있다.
- standard와 custom field들을 수정할 수 있다.

 이 Field summary page로 가려면 Workspaces & Projects summary page에서 workspace hyperlink 나 프로젝트 이름을 클릭한다. 그리고나서 페이지 왼쪽에 있는 sidebar에서 Fields 링크를 선택한다.

Workspace Field Page

Project Field page

View Fields

Field들은 defect, user story, task 등과 같은 work item type에 의해 나눠져 있다. 특정 work item type의 필드들을 보려면 Work Item 드롭다운 메뉴를 사용한다. 그러면 해당 work item 에 속해 있는 모든 필드들이 표시된다.

링크

Fields summary page는 아래 필드들을 보여줄 것이다.

Column	Meaning
Name	The name of the field, as it appears in summary pages, editors, and other locations. Fields have both a system name and display name.
Attribute Type	The type of field. For example, text, string, or boolean.
Custom	A check mark will display if the field is not a CA Agile Central standard field, and has been created by an administrator.
Required	If checked, the field must have a value entered to create or save changes to the work item. Required fields cannot be hidden from specific projects, and are seen by the entire workspace. Note that work items created before a requirement is saved may have other fields edited inline from grid summary pages and apps without entering a value for the required field.
Visible	Displays a check mark if the field is visible in the project that the Fields summary page is being accessed from.
Visible on Child Projects	Present if viewing the Fields summary page of a project that has open child projects. Displays a check mark if the field is visible in all child projects, and displays Mixed if some children can use the field but others cannot.
Shared Across Work Items	Some standard fields, such as Schedule State, are shared across multiple work item types. Changing the settings of a shared field will affect any work item types that use the field.

CA Agile Central 시스템 (Rally)에 의해 내부적으로 사용되는 필드들은 여기에 표시되지 않는다.

필드 변경 이력은 revision history. 특정 프로젝트의 필드의 visibility 변경 이력은 project의 revision history. global changes 는 workspace revision history 등을 보면 알 수 있다.

Delete Fields

필드를 삭제할 수는 없다. 대신에 Visible 드롭다운에서 No를 선택하면 해당 필드가 안 보이도록 하면 된다.

링크

동시에 같은 타입의 또 다른 커스텀 필드가 필요하면 필드를 수정한 후 이름을 바꾸면 새로운 것을 만들 수 있다.

Types of Fields

CA Agile Central 은 여러 용도의 다양한 필드 타입을 제공한다.

Type	Description
Boolean	A checkbox representing a True or False option.
Date	A calendar icon displays in work item editors. When a date is chosen, it displays in text format next to the calendar.
Decimal	A number with a maximum of six digits before and three digits after the decimal point.
Drop Down List	A list of options that contains a series of strings or textual information.
Drop Down (Multi-Value) Open Beta	A list that contains one or more pre-defined fields from which a user can choose multiple items. The valid selections for the list are customizable.
Integer	A number field with a maximum of nine digits.
String	A field that accepts alphanumeric and special characters. Limited to 256 characters.
Text	Provides a field with rich-text formatting options. Text fields may hold up to 32Kb of data.
Web Link	Use this field to embed a web link or reference to an object in an external system.

특정 HTML 태그를 표시하기 위해 String 필드를 사용할 수 있다. 더 자세한 용도는 HTML Whitelist Policy를 보라.

일단 필드가 생성되었다면 해당 필드의 type을 바꿀 수는 없다.

Supported Items

아래 work item들과 objects들에서 custom fields 를 지원한다.


    Defects
    Defect Suites
    Iterations
    Milestones
    Portfolio Items
    Projects
    Releases
    Tasks
    Test Cases
    Test Case Results
    User Stories
    Workspaces


Create Custom Fields

필요한 필드가 있으면 생성할 수 있다. 이 Custom Fields는 subscription이나 workspace administrator에 의해 추가될 수 있고 전체 workspace나 특정 project 혹은 project hierarchy의 section에서 보여지게 할 수도 있다. Custom fields는 editor pages, custom views, Web Services API queries 등에서 사용 가능하고 detail and summary page에서 볼 수 있다.

Note
- 새로운 portfolio item type을 추가할 때 여러분이 추가하는 type이 같은 workspace에 globally scoped 된다는 것을 유념하라. 그렇지 않으면 validation error가 표시 될 것이다.
- project나 workspace administrative page들에서 custom field를 생성하게 될 텐데. 그 custom field는 workspace level의 데이터베이스에 존재하게 될 것이다. 그리고 visibility는 workspace나 project level에서 control 된다.
- custom field를 생성한 곳에서 visibility도 constol 할 수 있다. 만약 새 필드를 몇개의 프로젝트에서만 적용시키려면 특정 프로젝트에서 생성하거나 사용하고자 하는 project hierarchy 의 top 에서 생성한다. 특정 프로젝트들에서만 custom field를 숨기고 싶다면 workspace level에서 생성해서 그 프로젝트들에서 hidden 으로 해당 필드를 세팅하면 된다.
- 같은 field 가 같은 workspace에 복수개 존재할 수 없다. 여러 project들은 한개의 field를 공유할 수 있다. 이 경우 같은 values 와 settings를 사용해야 한다. 다른 프로젝트와 독립적인 field를 생성하려면 반드시 다르게 이름을 지어야 한다.
- custom field의 required value는 workspace level에서 세팅한다. 만약 새로운 custom field를 생성한다면 그것은 required이다. 이것은 모든 open project들에 visible 할 것이고 required 하게 될 것이다.
- CA Agile Central standard field들은 visible/hidden 될 수 있다. 이것은 workspace 레벨에서만 적용된다.
- Custom fields는 defect suites 에는 적용되지 않는다.

새로운 Custom field를 생성하려면

1. Workspace나 Project의 Fields summary page로 간다. (링크)
2. Work Item dropdown을 클릭하고 필드를 생성하고 싶은 work item의 type을 선택한다.
3. New Field 버튼을 클릭한다.
4. name, Display Name, Type 필드에 값을 입력한다. Name과 Display Name에는 unique한 값을 넣어야 한다.
5. 이 필드를 Mandatory로 하려면 Required option을 체크한다.
6. 프로젝트나 workspace 의 필요성에 따라서 필드의 visibility를 세팅한다.
7. Save & Close를 클릭한다.

링크

Edit Fields

1. Workspace나 Project의 Fields summary page로 간다.
2. Work Item dromdown 을 클릭하고 type을 선택한다.
3. field 왼쪽의 gear icon을 클릭하고 Edit을 선택한다.
4. Field value를 업데이트 한다.
5. Save & Close 를 클릭해 수정을 마친다.

링크

Note
- 여러 work items 에 걸쳐 사용되는 Shared field 가 있다. 이 필드를 수정하게 되면 다른 work item들도 영향을 받게 된다. 또한 해당 필드에 notification 룰이나 custom views를 생성한 사용자들도 영향을 받게 된다.
- Type 같은 어떤 standard CA Agile Central fields들은 수정이 불가능 한 것도 있다.
- CA Agile Central system에 의해 사용되는 어떤 필드들은 required 이다. 만약 그렇다면 해당 필드는 수정 할 수 없다.

Editor window fields

Field	Description
Name	This name is used by the CA Agile Central application. For CA Agile Central fields, this name is already populated. This name is not displayed in the Fields summary page, but does display in Create and Edit screens for administering work item fields.
Display Name	This is a textual field allowing you to enter the name that will be displayed to users of the workspace.
Type	The type of field. Cannot be changed after a field is created.
Occurrences	A calculated number that indicates how often a field is being used by work items in the workspace.
Required	Require that the field be populated upon creation or edit. Note: Marking a field Required has implications for inline editing, multi-editing, and importing data. The Add button on some board and grid apps will force a full editor window to display, so the required field may be filled in when creating a new work item. Work items created before the requirement is enforced may have other fields edited inline from grid summary pages and apps without entering a required value. In addition, existing integrations may fail if a field is marked Required after the integration is in place.
Visible	When accessed from the workspace, displays a single drop-down that controls the fields visibility for all projects. If only some projects are set to view the field, it will be set as Mixed. Choosing the Yes or No options will show or hide the field in all open projects after saving. When accessed from a project with child projects, two drop-downs display. The top drop-down controls visibility for the project the editor was accessed from, while the lower drop-down controls visibility to all child projects.

Manage Project Visibility

전체 workspace에 visible 하게 custom field를 세팅할 수 있다. 그리고 특정 프로젝트나 특정 프로젝트 그룹에만 보이도록 할 수도 있다. 프로젝트에 대한 Fields visible을 설정하는 것은 아래에서 가능하다.


    Work item detail pages
    Editor windows
    Summary pages
    Apps
    Custom views
    Notification rules
    Web Services API

Note
- page나 app 안에서 project scoping을 변경하면 visibility setting 에 따라 custom field들의 availability 가 영향을 받는다.
- When viewing the Backlog page scoped to a hierarchy of projects, fields that are visible in some child projects but not others will display.
- Queries from the Web Services API will respect project visibility. Unless specified, queries will use the default project and scoping set in your profile.
- When using a connector with a supported version of the WSAPI, any fields fetched for will be returned, regardless of visibility settings.

해당 필드를 사용할 프로젝트를 설정하려면 field editor 의 Visible 섹션을 사용한다.

특정 프로젝트에 visible 한가 여부를 보려면 Field summary page로 가면 도움이 될 것이다.

- From the workspace, fields available to all projects will display a check mark in the Visible column. Fields available to some projects but not others will display Mixed in the column.
- From a specific project, the Visible column will display a check mark if the field can be used in that project.
- If viewing a project that has children, the Visible on Child Projects column will display. A check mark will be present if the field can be used in all open child projects. Mixed will display if the field can only be used in some of the child projects.

어떻게 필드를 생성하고 visibility 를 조정할 것인가에 댛 아래 추천 방법을 참고하세요.

Set a field to be used by the entire workspace

    Access the Fields summary page from the workspace level.
    Create or edit the field.
    In the field editor window, set the Visible drop-down to Yes.
    All open projects will have access to the field.

Set a field to be used by a single project

    Access the Fields summary page from the project you want to use the field in.
    Create or edit the field.
    In the field editor window, set the Visible In This Project drop-down to Yes.
    Repeat for each unrelated project you want to use the field in.

Set a field to be used by a group of projects in a hierarchy

    Access the Fields summary page from the top-most level of the project hierarchy that you want to use the field in.
    Create or edit the field.
    In the field editor window, set both Visible drop-down menus to Yes.
    The project you accessed the Fields summary page from, and all open child projects will have access to the field.

Drop Down List (Multi-Value) Open Beta

Subscription and workspace administrators 는 이제 multi-value custom fields를 생성할 수 있게 됐다.
Custom fields allows CA Agile Central users to tailor our product to meet their unique needs. Multi-value custom fields extends the value of single-value custom fields and are available across all of the artifact types that support custom fields. These fields are configured in the Field editor pop-up window after you select Drop Down List (Multi Value) as the type of field.

일단 admin에 의해 설정 되면 그 multi-value drop-down 리스트는 이 custom field가 적용되는 모든 곳에 동일하게 고쳐진다.

- New editable detail pages

- Legacy detail pages

- New-stype grids

- Legacy grids

- Boards

- The new advanced search component on the Iteration Status page

Use Web Link Fields

Web Link field type은 external system의 object를 embed reference로 사용할 수 있도록 해 준다. 예를 들어 별도의 web-based case management tool이나 defect tracker를 사용한다면 web link field를 생성해서 CA Agile Central의 해당 story나 defect에 link할 수 있다. 이렇게 되면 external item을 CA Agile Central에서 사용할 수 있게 된다.

새로운 web link field를 생성하려면

1. New Field button을 클릭한다.
2. Name과 Display Name field에 값을 입력한다. 이 값들은 unique 해야 한다.
3. Type drop-down에서 Web Link를 선택한다.
4. 아래 필드들을 complete 한다.
- URL : 외부 시스템의 URL을 넣는다. ${id}는 insert 되어야할 external system의 Object ID를 가리키는데 사용된다. 예를 들어 Salesforce.com을 링크해야 하면 URL: https://na3.salesforce.com/$\{id} 이렇게 한다. CA Agile Central generates a link to your object by combining the URL with the ID you provide in the detail page to produce the full URL to the Salesforce.com case: _https://na3.salesforce.com/a0A30000000xK8D_ .
Display Preference: Click the appropriate radio button to indicate how the external Web Link field will be displayed in CA Agile Central:

    * Display in new window. This option will open a new pop-up window to display the external Web Link object.
    * Display in existing window. This option displays the external Web Link object directly in the CA Agile Central window.
5. Save를 클릭한다.

이 단계까지 완료 되면 Web Link 필드는 work item을 수정하거나 work item detail page를 볼 때 사용할 수 있게 된다.
1. Link Label 같은 것을 사용하기 위해 external object의 Name 을 제공한다.
2. ID field에 링크하기 위해 external object의 ID를 입력하고 entry를 save 한다.

work item의 detail을 보려면 external object의 hyperlinked Name을 클릭한다. 그러면 해당 external page로 가게 된다.

Link Label과 ID 필드를 populate 하기 위한 방법으로 CA Agile Central Web Services API interface 의 사용을 고려해 볼 수 있다. 예를 들어 여러분의 case management tool은 Web Service를 사용해서 defect를 insert 할 수도 있기 때문에 이런 경우 해당 웹 서비스 API를 사용할 수 있다.