Shared Fields
Shared fields are globally-defined field types that you can use to group different fields from different trackers. Shared fields can be used to refer to all those fields in a report. To know more about administering the shared fields, see Shared Fields.
When creating or editing a field, you can add one or more shared fields to it. You can only select shared fields that match the type of the field itself.
However, one type of shared field can only be used once within a tracker that is only for one tracker field.
 |
Shared fields are only supported for custom fields. They do not have any connection with built-in fields and custom field business logic.
|
In the field list, you can easily check the fields that have shared fields by hovering over Shared Fields.
You can use shared fields in report criteria. You can add a shared field just like any normal field. For example:
This example matches all items for which a field has the textType as shared fields and it is not empty. No need to add the individual trackers to the report filters.
Using Shared Field names in calculated fields
You can use the name of shared fields where unified expression language is used.
• In field configuration of trackers:
◦ Hide if.
◦ Mandatory if.
◦ Computed as.
• In conditions of State Transitions.
To use the names of the shared fields, write the following expression in your calculation: sharedField("shared_field_name", TrackerItem(this, or detectedIn[0])) -
The above expression matches the field of the selected tracker item, for which the name of the shared field is set to "shared_field_name".
Example expressions:
• sharedField("text_shared_field", detectedIn[0])
• sharedField("integer_shared_field", this) > 5
 | If the name of the shared field changes, the expressions referring the field are automatically updated. You can modify the name of the shared field only if it is not used in any tracker. |
Creating Shared Fields Codebeamer X
To create a new shared field you must have the system administrator permissions. Follow the steps given below to create a new shared field:
1. Click System Administration tab on the Codebeamer X home screen. The system administration page opens.
2. Click Shared Fields hyperlink. The Shared Fields page opens where all the existing shared fields are displayed.
3. Click New Shared Field option to create a new shared field. The Create Shared Field window opens.
4. Enter the required details and click Save. A new shared field is created successfully.
The Field Type is automatically populated based on the Type field's value. Once all the relevant details are added and saved, the new Shared Field appears in the Shared Field drop-down list.
See also: Shared Fields
Displaying Shared Fields while filtering on one or more Trackers
In Codebeamer X the filtering drop-down list for Shared Fields on the UI has been refined.
The way Shared Fields are displayed in the filtering drop-down list is different when filtering on a single tracker than filtering on multiple trackers, to make filtering more precise and user-friendly.
1. Filtering on a single Tracker: When filtering on a single tracker, for example in Table View, the Shared Fields are not shown in a separate section of the filtering drop-down list, since those are identical with the fields of the tracker.
The connected Shared Fields are displayed in parenthesis after the name of the relevant fields.
2. Filtering on multiple Trackers: By filtering on multiple Trackers, for example in Reports, the connected Shared Fields are:
◦ Displayed in a separate section of the filtering drop-down list, as before.
◦ Are also shown in parenthesis after the name of the relevant fields.
Parent topic