XNET Database Merge (LIN Schedule)
- Updated2023-02-17
- 4 minute(s) read
XNET Database Merge (LIN Schedule)
Merges a LIN schedule object with all child objects into the destination cluster.
Inputs/Outputs
wait for complete?
An input used to split the merging process into parts (for example, to display a progress bar).
target cluster in
The I/O name of the cluster where the source cluster is merged.
source LIN schedule
The I/O name of the LIN schedule to be merged into the target cluster.
copy mode
An input that defines the merging behavior if the target cluster already contains elements with the same name.
prefix
An input added to the source cluster name if an element with the same name exists in the target cluster.
error in
Error conditions that occur before this node runs.
The node responds to this input according to standard error behavior.
Default value: No error
percent complete
An output used when wait for complete? is false.
target cluster out
A copy of target cluster in. You can use this output to wire the node to subsequent nodes.
error out
Error information.
The node produces this output according to standard error behavior.
Description
This node merges a LIN schedule with all schedule entries to the target cluster. Frames referenced in the schedule entries should be merged before merging the LIN schedule; otherwise, the reference get lost.
If the source LIN schedule name was not used in the target cluster, this node copies the source LIN schedule with the entries to the target. If a LIN schedule with the same name exists in the target cluster, you can avoid name collisions by specifying the prefix to be added to the name.
If a LIN schedule with the same name exists in the target cluster, the merge behavior depends on the copy mode input:
- Copy using source: The target LIN schedule with entries is removed from the target cluster and replaced by the source objects.
- Copy using destination: The source LIN schedule is ignored (the target cluster schedule with entries remains unchanged).
- Merge using source: This adds schedule entries from the source schedule at the end of the destination schedule table. The copied entries become new names, so all entry names in the schedule are unique. The source schedule properties replace the target schedule properties (comment, priority, run mode).
- Merge using destination: This adds schedule entries from the source schedule at the end of the destination schedule table. The copied entries become new names, so all entry names in the schedule are unique. The target schedule properties (comment, priority, run mode) remain unchanged.
Example
Target LIN schedule LS1(v1) has entries e1, e2. Source LIN schedule LS1(v2) has entries e3, e4.
(v1) and (v2) are two versions of one object with same name but with different properties.
- Result of Copy using source: LS1(v1), e1, e2.
- Result of Copy using destination: LS1(v2), e3, e4.
- Result of Merge using source: LS1(v2),e1, e2, e3, e4.
- Result of Merge using destination: LS1(v1), e1, e2, e3, e4.