---
sourceDocument: Australia Sales and Order Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/order-management

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Sales and Order Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Use partial sync

# Use partial sync {#ariaid-title1}

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Partial Sync enables callers to specify only the portions of the structure that matter.
The system
then populates only the requested child types, maintains the full structure (skeleton remains intact), and preserves empty arrays for omitted types to prevent downstream errors.

Partial Sync applies recursive filtering, which means the filter is applied at every level of
the hierarchy, not just at the top level.

## AllowContextType {#use-partial-sync__section_nc1_p3x_xhc}

`AllowContextType` is an array of string identifiers that tells the system which child types to populate.  
Example:

    AllowContextType = ["Header", "LineItems"]

{#use-partial-sync__table_asc_53x_xhc__entry__2}

| AllowContextType | Behavior |
|-|-|
| \[\] (empty) | No filtering, full object returned |
| Contains valid types | Only specified types are populated |
| Missing required types | Error if required by business rule |
| Contains invalid types | Ignored, object still returned with empty children |
| Parent matches, child doesn't | Child remains empty, structure preserved |
[Tabelle : 1. Filtering Rules]

{#use-partial-sync__table_asc_53x_xhc}

## Scenarios {#use-partial-sync__section_ayh_kjx_xhc}

1. No Filtering  
   If `AllowContextType` is empty:
   * All child types are fully populated.
   * Output matches legacy behavior This scenario serves as the baseline.
   {#use-partial-sync__ul_ck1_sjx_xhc}
2. Header Only (or Any Valid Subset)

   If `AllowContextType` contains only some child types:  
   Example:

       AllowContextType = ["Header", "LineItems"]

   * Only Header and LineItems are populated
   * Other child arrays (for example, RAM, RelatedParties) exist but stay empty
   * Structure remains intact, no missing arrays
   {#use-partial-sync__ul_yfn_ckx_xhc}
3. Invalid or unrecognized types

   If the array
   contains a mix like:

       AllowContextType = ["Header", "XYZ"]

   * System does not crash
   * Only Header is populated
   * Other child areas remain empty
   * Filtering gracefully falls back
   {#use-partial-sync__ul_rgt_kkx_xhc}
4. Recursive filtering  
   Filtering applies recursively:
   * Parent can be included
   * Sub-children are evaluated independently
   * If a parent is allowed but a sub-child type isn't, that sub-child stays empty
   * Empty arrays are explicitly preserved to maintain consistency
   {#use-partial-sync__ul_s1h_pkx_xhc}
5. Mandatory context rules

   Header required:  
   For scenarios involving header data:
   * Header must be present in `AllowContextType`
   * If not, the system throws a validation error:

   {#use-partial-sync__ul_pmt_jlx_xhc}

       Cannot process without header in AllowContextType

   LineItems required for no Header:  
   If the use case excludes header entirely:
   * LineItems is mandatory
   * Missing it produces:

         Cannot process without line items in AllowContextType

   {#use-partial-sync__ul_hw3_dlx_xhc}
{#use-partial-sync__ol_rgn_mjx_xhc}