Keyed sublists have an indexing line element or internal ID that can be used as a key. Keyed sublists allow you to set the replaceAll attribute to FALSE to update only the lines you are submitting in your SOAP request. When working with keyed sublists, the value of the replaceAll attribute has the following effects:
- replaceAll = TRUE: The existing sublist is replaced with the sublist submitted in the SOAP web services request. The newly submitted sublist should include all values.
- Lines that do not match the newly submitted lines are removed.
- Currently existing lines that match lines in the new sublist submission are updated.
- Newly submitted lines with no matches are added.
- The default value for the replaceAll attribute is TRUE.
- replaceAll = FALSE: Lines in the existing sublist are selectively updated with lines in the sublist submitted in the SOAP web services request. The newly submitted sublist need only include values to be added and updated.
- Lines that do not match the newly submitted lines are preserved.
- Currently existing lines that match lines in the new sublist submission are updated.
- Newly submitted lines with no matches are added.