---
sourceDocument: Australia Strategic Portfolio Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/it-business-management

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Create custom mapping configurations

# Custom mapping configuration for SPW Jira Integrations {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 min. de leitura

Learn about creating custom mapping configurations to map Jira issue types, fields, and choices with SPW entities, to match your team's processes.

Custom mapping configurations allow you to control how Jira issue types, fields, and values align with SPW planning items. While default mappings cover common use cases, they may not fit your team's processes or reporting needs. By creating custom mappings, you can:

* Ensure accurate synchronization of work items between Jira and SPW.
* Align data mapping to reflect your team's terminology and workflows.
* Support consistent reporting and visibility across strategy and execution.

{#custom-mapping-configuration-spw-jira__ul_njw_n24_nhc}

This flexibility helps provides a tailored integration experience, so that portfolio managers and delivery teams work with information that matches their context.

## Create custom table mapping for SPW Jira integrations {#ariaid-title2}

Create a custom mapping configuration between tables of Strategic Planning Workspace (SPW) and Jira.

### Antes de Iniciar

[Review default mapping configuration for Jira projects in SPW](https://servicenow-prod.fluidtopics.net/fDVeKYdnLh4frQAYc9hCtQ "Verify that the default mapping configuration between work items in Strategic Planning Workspace (SPW) and Jira aligns with your team's processes.").

Role required: sn_jira_int.user

### Por Que e Quando Desempenhar Esta Tarefa

Choose one table from Jira and one from SPW to create a mapping between them.

For example, if your team uses an issue type like Feature that isn't mapped by default, you can create a new mapping between the Feature issue type in Jira and the Feature \[sn_align_core_feature\] table in SPW.

### Procedimento

1. Navigate to AllStrategic PlanningJira IntegrationJira Projects.
2. Open your Jira project record.
3. From the Table Maps related list, select New.
4. On the Table Map form, fill in the fields.  
   For field information, see [Table Map form](https://servicenow-prod.fluidtopics.net/FqtW8mFZeS4K~j3JtZKfog "Learn about the fields of the Table Map form, which are used while creating a custom table mapping configuration for SPW Jira Integrations.").
5. Select Submit.

### O que Fazer Depois

1. Validate your new table map configuration by clicking Validate and fix mapping from the Jira project form.
2. For this table map, create field mappings. See [Create custom field mapping for SPW Jira integrations](https://servicenow-prod.fluidtopics.net/6vHdgDdNfozeBt8I4AtAbA#custom-field-mapping-jira-spw "Create a custom mapping configuration between fields of Strategic Planning Workspace (SPW) and Jira.").
{#custom-table-mapping-jira-spw__ol_dzc_xzm_pkb}

## Create custom field mapping for SPW Jira integrations {#ariaid-title3}

Create a custom mapping configuration between fields of Strategic Planning Workspace (SPW) and Jira.

### Antes de Iniciar

Role required: sn_jira_int.user

### Por Que e Quando Desempenhar Esta Tarefa

Select a Jira field and map it to a corresponding SPW field in the Table Map record.

For example, a table mapping between the Story entity in Jira and the Story \[rm_story\] table in SPW is available by default. If you need to map additional fields, such as story points, create a custom Field Map record using the steps below.

### Procedimento

1. Navigate to AllStrategic PlanningJira IntegrationJira Projects.
2. Open your Jira project record.
3. From the Table Maps related list, open a table map record for which you want to create field maps.
4. From the Field Map related list, select New.
5. On the form, fill in the fields.  
   For field information, see [Field Map form](https://servicenow-prod.fluidtopics.net/gKEEVDLhEgn5xLiFty1zxA "Learn about the fields of the Field Map form, which are used while creating a custom field mapping configuration for SPW Jira Integrations.").
6. Select Submit.
{#custom-field-mapping-jira-spw__steps_scz_rn4_nhc}

### O que Fazer Depois

1. Validate your new mapping configuration by clicking Validate and fix mapping from the Jira project form.
2. (Optional) If your new field is of the type Choice, create custom choice mapping for it. See [Create custom choice mapping for SPW Jira integrations](https://servicenow-prod.fluidtopics.net/6vHdgDdNfozeBt8I4AtAbA#custom-choice-mapping-jira-spw "Create a custom mapping configuration for field choices between Strategic Planning Workspace (SPW) and Jira.").
{#custom-field-mapping-jira-spw__ol_dzc_xzm_pkb}

## Create custom choice mapping for SPW Jira integrations {#ariaid-title4}

Create a custom mapping configuration for field choices between Strategic Planning Workspace (SPW) and Jira.

### Antes de Iniciar

Role required: sn_jira_int.user

### Por Que e Quando Desempenhar Esta Tarefa

Select a choice value from a Jira entity and map it to a corresponding choice value in an SPW table.

For example, Jira Stories include default states such as To Do, In Progress, and Done. If your team adds a custom state like Testing, you can create a choice mapping to link Testing in Jira to the
Ready for Testing state in the Story \[rm_story\] table in SPW.

### Procedimento

1. Navigate to AllStrategic PlanningJira IntegrationJira Projects.
2. Open your Jira project record.
3. From the Table Maps related list, open your table map record.
4. From the Field Maps related list, open a field map record for which you want to create choice maps.
5. From the Choice Map related list, select New.
6. On the form, fill in the fields.  
   For field information, see [Choice Map form](https://servicenow-prod.fluidtopics.net/u4Yf2PIaApG8eE4xuYewMQ "Learn about the fields of the Choice Map form, which are used while creating a custom choice mapping configuration for SPW Jira Integrations.").
7. Select Submit.

### O que Fazer Depois

1. Validate your new mapping configuration by clicking Validate and fix mapping from the Jira project form.
2. [Enable bidirectional sync of work items between Jira projects and SPW](https://servicenow-prod.fluidtopics.net/8GLXMjzcVICApbe2viX7QA "Enable import and export for a Jira project to ensure data is consistent across for all stakeholders using Strategic Planning Workspace and Jira.").
3. [Import issues from Jira to SPW](https://servicenow-prod.fluidtopics.net/TjfNEoAMIiFfySoxsuxRtQ "Import work items such as epics, features, capabilities, and stories from Jira to Strategic Planning Workspace (SPW) to enable end-to-end visibility in SPW.").
{#custom-choice-mapping-jira-spw__ol_dzc_xzm_pkb}