Advanced field support
An Issue Tracker 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 Issue Tracker 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 |
issue_tracker_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 Issue Tracker tool |
Confidential data must always be sent over an encrypted channel for a security-sensitive application. Use TLS …. (formatted for the Issue Tracker) |
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 |
Issue Tracker 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 Issue Tracker tool |
Many communication channels can be "sniffed" by attackers during data transmission…. (formatted for the Issue Tracker) |
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 |
${issue_tracker_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".
String Replacement
Use string replacement to replace SD Elements Task text with your own when you sync using Issue Tracker Integration. You can define string replacements as you create a new issue tracker connection.
String replacement finds substrings within the Task description (as they are found in the macros "task_content" and "task_richcontent") and replaces them with the provided value. It works with substrings, words, phrases, or sentences as long as the string token matches the value you indicate.
|
Note
|
String matching is case-sensitive. |
String replacements occur as listed without reference to one another. Replacements can also occur in any order, and new strings can be replaced from other configured replacements.
For example, if "vulnerability" is replaced with "weakness", and "weakness" is replaced with "flaw", instances of "vulnerability" can become "flaw" or "weakness" depending on the order of replacements.