Setup Center mit Setup Center Interface - 第26页
3 Application progra m interface (API) description SIPLACE Ausgabe 05/2007 26 Te a r D o w n 3 T ear down the specified packag ing un it(s) within the mentioned setup. 3 3 Parameters 3 strSetup 3 The related setup full p…
SIPLACE 3 Application program interface (API) description
Ausgabe 05/2007
25
Refill 3
Refill packaging unit(s) in online verification. 3
Parameters 3
packagingUnitLocations 3
Packaging unit(s) to refill. 3
Remarks 3
The call of “Set” (“Refill” on an empty track) has initializing behavior on the station. This means,
that any existing value (e.g. splice information) is lost after execution. 3
Exceptions 3
Exceptions will not be thrown by this interface, as the underlying software doesn’t resolve excep-
tions by error codes. In addition, it’s yet not designed to throw exception lists of different exception
types. 3
Instead of exceptions, errors, warnings etc. will be published by the event MessagesReceived
(see below). 3
Set 3
Put packaging unit(s) in online verification. 3
3
Parameters 3
packagingUnitLocations 3
Packaging unit(s) to set. 3
Remarks 3
The call of “Set” (“Refill” on an empty track) has initializing behavior on the station. This means,
that any existing value (e.g. splice information) is lost after execution. 3
Exceptions 3
Exceptions will not be thrown by this interface, as the underlying software doesn’t resolve excep-
tions by error codes. In addition, it’s yet not designed to throw exception lists of different exception
types. 3
Instead of exceptions, errors, warnings etc. will be published by the event MessagesReceived
(see below). 3
3
3
3 Application program interface (API) description SIPLACE
Ausgabe 05/2007
26
TearDown 3
Tear down the specified packaging unit(s) within the mentioned setup. 3
3
Parameters 3
strSetup 3
The related setup full path. 3
packagingUnitLocations 3
Packaging unit(s) to tear down. 3
Exceptions 3
Exceptions will not be thrown by this interface, as the underlying software doesn’t resolve excep-
tions by error codes. In addition, it’s yet not designed to throw exception lists of different exception
types. 3
Instead of exceptions, errors, warnings etc. will be published by the event MessagesReceived
(see below). 3
Update 3
Adjust the total quantity of packaging unit(s). 3
3
Parameters 3
packagingUnits 3
Packaging unit(s), which already contain the designated total quantity. 3
Return Value 3
The list of successful updated packaging unit(s) (first packaging unit of the splice chain). Other-
wise null, if operation was aborted because of a null reference. Packaging units, which couldn't be
updated, are not in this list. 3
Remarks 3
If the packaging unit is in use, the packaging unit won't be updated. Only the quantity of the pak-
kaging unit is updated. All other members keep unchanged. All errors which occurred during exe-
cution can be get MessagesReceived-event. 3
3
SIPLACE 3 Application program interface (API) description
Ausgabe 05/2007
27
Exceptions 3
Exceptions will not be thrown by this interface, as the underlying software doesn’t resolve excep-
tions by error codes. In addition, it’s yet not designed to throw exception lists of different exception
types. 3
Instead of exceptions, errors, warnings etc. will be published by the event MessagesReceived
(see below). 3
Create 3
Creates new packaging units. 3
3
Parameters 3
packagingUnits 3
The new packaging unit 3
Return Value 3
The list of successfully created packaging unit(s). Otherwise null, if operation was aborted be-
cause of a null reference. Packaging units which couldn't be created are not in this list. 3
Remarks 3
Check and creates new packaging units in the Setup Center database. This command can be use
to import packaging units before the Set or Refill action. If the packaging unit already exists, the
packaging unit won't be created. All errors which occurred during execution can be get Messages-
Received-event. 3
Get 3
Gets the first packaging unit of the splice chain, which contains the corresponding UID. 3
3
Parameters 3
packagingUnits 3
The first packaging unit of the splice chain. 3
Return Value 3
The packaging units; otherwise null. 3
3