User Tools

Site Tools


share_only_selected_fields

Share only selected fields

v3.13.0


An option that allows you to specify which table fields will be in the outgoing XML of each shared record. This is useful for when you do not want to create and maintain a table view to specify the fields to be shared or when your account does not have permission to create a view.

When checked, the “Share fields” related list will appear allowing you to specify the table fields to share:

Create a new record in this related list for each field you want to share. The Add all table fields button at the top of the related list allows you to quickly add all fields of the table into the related list for cases where you want to share the majority of the table's fields and only want to remove a few fields (in which case you would add all fields and then delete the ones from the related list you do not want to share).

So as to ensure each record has a unique identifier, the sys_id field will always be included in the XML even if you do not specify it in the related list.

In the above example where the state, short_description, active and number fields are selected to be shared for the ticket table, the XML sent out for a record would be as follows:

<?xml version="1.0" encoding="UTF-8"?>
<ticket>
    <short_description>test</short_description>
    <active>1</active>
    <state>1</state>
    <number>TKT0010002</number>
    <sys_id>a05859f80f0d0600276f6d28b1050ea4</sys_id>
</ticket>

The “Share only selected fields” option will be hidden if either the "Table map" option or the "View name" option is selected on the dynamic or bulk share configuration. These options have their own mappings on which fields are used and take precedence over this option.

Display values are supported and will still create <dv> fields in the XML with this option selected. For example:

<?xml version="1.0" encoding="UTF-8"?>
<ticket>
    <state>1</state>
    <dv_state>Open</dv_state>
    <number>TKT0010001</number>
    <sys_id>a05859f80f0d0600276f6d28b1050ea4</sys_id>
</ticket>
share_only_selected_fields.txt · Last modified: 2016/08/09 11:24 by paul