Advanced field support
An ALM integration is pre-configured to map SD Elements fields to certain fields by default. Supported integrations allow users to change or override this mapping by using the Custom Fields Mapping within the section Advanced ALM Options.
For example, the placeholders, such as $task_title and $project allow users
to use a task’s title and the SD Elements project name in a field mapping.
Refer to the list of placeholders below for a complete list.
List of placeholders/macros
Use placeholders with the Custom Fields Mapping configuration to fine-tune an integration. The table below lists available placeholders and their meaning.
| Placeholder | Description | Example |
|---|---|---|
business_unit |
Name of the business unit associated with the SD Elements project |
General |
application |
Name of the application associated with the SD Elements project |
Web application |
application_custom_attr_X |
Placeholder for application custom attribute having slug X |
Depends on application custom attribute values |
project |
Project name |
Release Q1 2016 |
project_custom_attr_X |
Placeholder for project custom attribute having slug X |
Depends on project custom attribute values |
context |
User-defined value assigned when creating project connections |
Some project context |
alm_user |
The username used to authenticate to a server. Not available if the integration uses tokens to authenticate |
jira_user |
id |
SD Elements project task identifier |
1-T21 |
task_id |
SD Elements task identifier |
T21 |
task_title |
SD Elements task title |
Ensure confidential data is sent over an encrypted channel |
task_url |
Application link to the SD Elements project task |
|
task_content |
SD Elements task description (format: Markdown) |
Confidential data *must always be sent over an encrypted channel* for a *security-sensitive* application. Use TLS …. |
task_richcontent |
SD Elements task description formatted, for the ALM tool |
Confidential data must always be sent over an encrypted channel for a security-sensitive application. Use TLS …. (formatted for the ALM) |
task_phase |
Phase associated with the SD Elements task |
Requirements |
task_status |
SD Elements task status |
TODO |
task_priority |
SD Elements task status |
10 |
task_priority_translated |
ALM priority corresponding to the SD Elements task priority. The value is based on the configured priority mapping Custom Priority Mapping. |
Blocker |
task_tags |
List of tags assigned to the SD Elements task |
SD-Elements, task-tag1, task-tag2, task-tag3 |
problem_content |
Description of the problem associated with the SD Elements task |
Many communication channels can *be "sniffed"* by attackers during data transmission…. |
problem_richcontent |
Description of the problem associated with the SD Elements task, formatted for the ALM tool |
Many communication channels can be "sniffed" by attackers during data transmission…. (formatted for the ALM) |
problem_id |
SD Elements problem identifier |
P216 |
problem_title |
SD Elements problem title |
Cleartext Transmission of Sensitive Information |
Example
Consider the default Atlassian JIRA field mapping:
| JIRA Field | Value |
|---|---|
Summary |
${task_id}: ${task_title} |
Description |
${task_richcontent} |
Labels |
${task_tags} |
Priority |
${task_priority_translated} |
Reporter |
${alm_user} |
To modify this configuration, you can enter the following into "Custom Field Mapping":
| JIRA Field | Value |
|---|---|
Description |
${task_richcontent} ${problem_richcontent} |
Custom Severity Field |
${task_priority_translated} |
Custom Field2 |
My Own Text |
Labels |
["L1", "${task_tags}", "L2"] |
The settings above achieve the following results:
-
The new setting overrides the default "Description" field mapping.
-
The "Priority" settings are left intact.
-
Adds a new mapping to field "Custom Severity Field" with a task’s priority value.
-
Adds a new mapping to field "CustomField2" with the value "My Own Text".
-
Updates the "Labels" field configuration to include two extra labels: "L1" and "L2".