---
sourceDocument: Brazil Service Exchange
sourceDocumentLink: https://www.servicenow.com/docs/r/service-exchange

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Service Exchange

ft:clusterId :

    - sebrdg

bundleId :

    - sebrdg

workflow :

    - Customer and Industry


---

# Create a remote task definition

# Create a remote task definition in Service Exchange for Providers {#ariaid-title1}

Release version: Brazil  
Updated September 10, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 9 minutes to read  
As a provider, create remote task definitions (RTD) that trigger the assignment of a remote task.

## Before you begin

Role required: admin

## About this task

Before you can create a remote task, you must first create an RTD. A remote task is generated based on the RTD you define. To learn more about how RTD and remote task works, see [Remote tasks](https://www.servicenow.com/docs/4AnWIlKQ~6rkpGxaJY0s0Q "Learn how you, as a provider, can resolve and fulfill multiple consumer tasks, such as incidents, cases, and service requests, by using remote tasks. Also as a consumer, you can assign the incidents to multiple providers for resolution.").

## Procedure

1. Navigate to AllService Exchange ProviderAdministrationRemote Task Definitions.
2. Select New.
3. On the form, fill in the fields.  
   {#service-bridge-v2-create-remote-tasks-defs__table_r2f_zkw_d5b__entry__2}

   | Field | Description |
   |-|-|
   | Name | Name of the remote task definition record. |
   | Application | This is a read-only field and is set by default based on the application scope. |
   | State | Shows the status of the remote task definition. When you create a remote task definition, this field is set to the Draft state. Note: This field is automatically updated when you Publish, Archive, or Retire a remote task definition. |
   | Provider table | Any task table that you select from the list. For example, you can choose a case table or an incident table. |
   | Consumer table | Any task table that you select from the list. For example, you can choose a case table or an incident table. |
   | Compatibility | This field is populated by default. It shows the Service Exchange version that is being used by the provider. If the consumer is using a compatible Service Exchange version, data can be synced between the provider and consumer instances. But if the consumer isn't using a compatible version, any new remote task definitions can't be activated until the corresponding Service Exchange version is upgraded. |
   | Send attachments | Option to enable sending an attachment added on the parent record to the remote task. Note: When data, such as an attachment or task, is shared with another instance through Service Exchange, it becomes part of that instance's data. Service Exchange does not delete data on remote instances; the receiving instance must handle the deletion if required. |
   | Maintain SysID | Option that enables the system to create the new parent task on the consumer instance with the same sys_id as the parent record on the provider instance. |
   | Short description | Brief information about this remote task definition. |
   | Description | More detailed information about this remote task definition. |
   [Table 1. Remote Task Definition form]

   {#service-bridge-v2-create-remote-tasks-defs__table_r2f_zkw_d5b}
4. Select Submit.
5. Open this new Remote task definition record.
6. On the Inbound fields related list, select New.  
   Starting from Service Exchange version 2.2.x, an inbound field record is created with the source and target fields set as comments. This record enables comment-to-comment mappings for your RTD.
7. On the form, fill in the fields.  
   Inbound fields receive data from the consumer instance when a remote task is created or updated.  
   Note:  
   If the inbound field values are updated, the updated information is shown in a work note on the parent record.
   {#service-bridge-v2-create-remote-tasks-defs__table_lkx_vzd_25b__entry__2}

   | Field | Description |
   |-|-|
   | Field label | Field label that appears on the remote task form. |
   | Field name | Field name that is used in the remote task flow and script. |
   | Max length | Maximum length of the source field name. |
   | Sync when | Enables you to specify when a target field on the remote task's parent record is directly updated. You can select: * Insert: Updates the target field on the remote task's parent record only when the remote task is initially inserted. * Insert or Update: Updates the target field on the remote task's parent record every time the remote task is updated. * Never: The inbound field never updates a target field on the remote task's parent record directly. For example, you can use this field for state mapping where a flow is used to convert the incoming value before updating the target field. {#service-bridge-v2-create-remote-tasks-defs__ul_t5k_3xk_fzb} Note: Irrespective of the option you select here, whenever an inbound field is updated, the changes are reflected in a worknote on parent record. |
   | Application | This is a read-only field and is set by default based on the application scope. |
   | Remote task definition | Name of the remote task definition that this inbound field maps to. |
   | Active | This field is enabled by default. |
   | Virtual | Option to enable virtual inbound field mapping. A virtual field is a field that is present in the target table but does not exist in the source table. When a source table doesn't contain a field that exists on a target table, the field is configured as a virtual field. The values specified for the virtual field are passed from the source instance to the target instance. The consumer can create a remote task to sync data and update the value of the virtual field in the associated target task record. The target field can be updated either by using the Virtual Inbound option described in the [Create a transform in Service Exchange](https://www.servicenow.com/docs/lUqkE7es6PMU9B5Jf_Y0WQ "As a provider or a consumer, create a transform in Service Exchange to integrate tasks between connected instances.") or by using the updateVirtualField API. |
   | Source Mapping | This tab appears only when Virtual check box is selected to define a virtual field mapping. |
   | Source table (read-only) | The Consumer table that you selected while creating the remote task definition. |
   | Source field | Field from the source table that is sent to another ServiceNow instance. Source fields allow for [Dot-walking to data in related tables](https://www.servicenow.com/docs/access?context=c_DotWalking&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US), which is useful when reference data is not available between ServiceNow instances. For example, you can create multiple inbound mappings for change incidents (CIs) to include the name, class, IP address, and asset tag. |
   | Target Mapping | This tab displays only in the following conditions: * Sync when: You select Insert or Insert or update. * Virtual: You select this check box to enable virtual field mapping. {#service-bridge-v2-create-remote-tasks-defs__ul_xps_5tm_fzb} |
   | Target table (read-only) | The Provider table that you selected while creating the remote task definition. |
   | Target field | Field from the target table that is sent to another ServiceNow instance. Note: If you're defining a virtual field mapping, the field you select in the target table is not present in the source table. |
   [Table 2. Inbound field form]

   {#service-bridge-v2-create-remote-tasks-defs__table_lkx_vzd_25b}
8. Select Submit.
9. On the Outbound fields related list, Select New.  
   Starting from Service Exchange version 2.2.x, an outbound field record is created with the source and target fields set as comments. This record enables comment-to-comment mappings for your RTD.
10. On the form, fill in the fields.  
    Outbound fields send data to the consumer instance when a remote task is created or updated.{#service-bridge-v2-create-remote-tasks-defs__table_jfg_wzd_25b__entry__2}

    | Field | Description |
    |-|-|
    | Field label | Name of the field label that appears on the remote task form. |
    | Field name | Field name that is used in the remote task flow and script. |
    | Max length | Maximum length of the field name. |
    | Sync when suggestion | Enables you (the provider) to suggest to the consumer when a target field on the remote task's parent record should be directly updated. The consumer can change this setting before activating the definition * Insert: Updates the target field on the remote task's parent record only when the remote task is initially inserted. * Insert or Update: Updates the target field on the remote task's parent record every time the remote task is updated. * Never: The inbound field never updates a target field on the remote task's parent record directly. For example, you can use this field for state mapping where a flow is used to convert the incoming value before updating the target field. {#service-bridge-v2-create-remote-tasks-defs__ul_jgq_fzm_fzb} |
    | Application | This is a read-only field and is set by default based on the application scope. |
    | Remote task definition | Name of the remote task definition that this outbound field belongs to. |
    | Active | This field is enabled by default. |
    | Virtual | Select this check box to enable virtual inbound field mapping. A virtual field is a field that is present in the target table but does not exist in the source table. When a source table doesn't contain a field that exists on a target table, the field is configured as a virtual field. The values specified for the virtual field are passed from the source instance to the target instance. The target field can be updated either by using the Virtual Outbound option described in the [Create a transform in Service Exchange](https://www.servicenow.com/docs/lUqkE7es6PMU9B5Jf_Y0WQ "As a provider or a consumer, create a transform in Service Exchange to integrate tasks between connected instances.") or by using the updateVirtualField API. |
    | Sync pre-existing entries | Option to enable synchronization of all existing comments to the target task when a connection is established. If enabled, any comments made prior to the connection gets included in the sync process when a remote task is created. Note: This feature is available from Service Exchange version 2.2.x. |
    | Source Mapping | This tab appears only when Virtual check box is selected to define a virtual field mapping. |
    | Source table (read-only) | The Provider table that you selected while creating the remote task definition. |
    | Source field | Field from the source table that is sent to another ServiceNow instance. Source fields allow for [Dot-walking to data in related tables](https://www.servicenow.com/docs/access?context=c_DotWalking&version=brazil&pubname=brazil-platform-user-interface&ft:locale=en-US), which is useful when reference data is not available between ServiceNow instances. For example, you can create multiple inbound mappings for change incidents (CIs) to include the name, class, IP address, and asset tag. Note: From Service Exchange version 2.2.x, you can create |
    | Target Mapping | This tab displays only in the following conditions: * Sync when: You select Insert or Insert or update. * Virtual: You select this check box to enable virtual field mapping. {#service-bridge-v2-create-remote-tasks-defs__ul_v1n_4zm_fzb} |
    | Target table | The Consumer table that you selected while creating the remote task definition. This is a read-only field. |
    | Target field | Field from the target table that is sent to another ServiceNow instance. Note: If you're defining a virtual field mapping, the field you select in the target table is not present in the source table. |
    [Table 3. Outbound field form]

    {#service-bridge-v2-create-remote-tasks-defs__table_jfg_wzd_25b}
11. Select Submit.
12. On the Consumer criteria related list, select New.
13. On the form, fill in the fields.  
    Consumer criteria enable you to manage which consumers can use these remote task definitions.{#service-bridge-v2-create-remote-tasks-defs__table_ymv_g3q_25b__entry__2}

    | Field | Description |
    |-|-|
    | Consumer condition | Customer company or account that you want this remote task definition to be entitled to. |
    | Remote task definition | Name of this remote task definition record. This name is auto-filled. |
    [Table 4. Consumer criteria form]

    {#service-bridge-v2-create-remote-tasks-defs__table_ymv_g3q_25b}

    For more details on consumer criteria, see [Creating entitlements in Service Exchange for Providers](https://www.servicenow.com/docs/gNg87VXnTAIJPZi9JAW9uw "Using consumer criteria associated with record producers and other configurations, Service Exchange automatically generates the entitlement records that are replicated to eligible consumer instances.").
14. On the Transforms related list, select New to add new transform inline.  
    Enables you to manage which transforms are linked to any specific RTD.{#service-bridge-v2-create-remote-tasks-defs__table_b1w_55w_qkc__entry__2}

    | Field | Description |
    |-|-|
    | Transform | Transform record linked to this remote task definition. |
    | Identity | Reference to the RTD's identity record, not its sys_id. Keeps the link valid across RTD revisions, so a republished RTD doesn't need to be re-linked. |
    [Table 5. Associated Transform form]

    {#service-bridge-v2-create-remote-tasks-defs__table_b1w_55w_qkc}
15. Select Publish.  
    Remote task variables are automatically created when you publish a remote task definition. These variables are the data variables for the inbound fields displayed and can be accessed on the remote tasks.

## Result

A remote task definition record is created on your instance. This record is also synchronized with your customer's instance and is now pending activation on your consumer's instance. If the Auto activate remote task definition field has been enabled by the consumer, the remote task definition is automatically activated on your consumer's instance.

## What to do next

You can create multiple configuration revisions of this published remote task definition. For details on how to create a configuration revision, see [Create configuration revisions](https://www.servicenow.com/docs/WF3FR3RT69g5hc~rUWrwBg "As a provider, you can edit and create revisions of entitlements that contain updated functionality that can be developed and deployed to consumers."). You can also perform the following operations:

* Archive a configuration revision: See [Archive a configuration revision](https://www.servicenow.com/docs/WF3FR3RT69g5hc~rUWrwBg#service-bridge-v2-create-config-rev__section_zjw_2qc_sbc)
* Copy a configuration revision: See [Copy a configuration revision](https://www.servicenow.com/docs/WF3FR3RT69g5hc~rUWrwBg#service-bridge-v2-create-config-rev__section_gst_43n_tbc).
* Retire a configuration: [Retire a configuration](https://www.servicenow.com/docs/WF3FR3RT69g5hc~rUWrwBg#service-bridge-v2-create-config-rev__section_x1w_dqc_sbc).
* Delete a configuration: See [Delete a configuration](https://www.servicenow.com/docs/WF3FR3RT69g5hc~rUWrwBg#service-bridge-v2-create-config-rev__section_igy_2jn_tbc).
{#service-bridge-v2-create-remote-tasks-defs__ul_a3w_2gn_tbc}
**Related concepts**   

* [Remote tasks](https://www.servicenow.com/docs/4AnWIlKQ~6rkpGxaJY0s0Q "Learn how you, as a provider, can resolve and fulfill multiple consumer tasks, such as incidents, cases, and service requests, by using remote tasks. Also as a consumer, you can assign the incidents to multiple providers for resolution.")

*[\>]: and then