retrieve/reconnect

Reconnect data loaded from a disconnected record set (XML, JSON, or Struct) with the occurrences in a database or component.

retrieve/reconnect  {EntityName}

Example: retrieve/reconnect CUSTOMER.SALES

Parameters

Parameters
Parameter Data Type Description
EntityName String Entity included in the component structure of a component.

Return Values

Values returned in $status
Value Meaning
0 Occurrence was successfully reconnected.
>0 Number of errors encountered.

In this context, an error is defined as the number of times an error trigger returned a negative value.

Use

Allowed in all component types.

Description

Used after the xmlload, webload, structToComponent statements, the retrieve/reconnect command resolves the modification state information stored in the occurrence metadata. The procedure followed for each occurrence depends on the value of the occurrence modification state. For more information, see Occurrence Metadata for Reconnect and Reconnect Process.

The behavior of retrieve/reconnect is the same as reconnect. For more information, see reconnect.

Receiving an XML Stream

The following code shows an operation that receives an XML stream, and loads the data from the XML into the component’s data structure.

operation XMLIN
; This operation receives and
; reconnects an XML stream.

params
   xmlstream [DTD:ABCDTD.ABC] MYSTREAM : IN
endparams

clear
xmlload MYSTREAM, "DTD:ABCDTD.ABC"
retrieve/reconnect
...

Related Topics