Setup Center mit Setup Center Interface.pdf - 第27页
SIPLACE 3 Application program interface (API) description Ausgabe 05/2007 27 Exceptions 3 Exceptions will not be thrown by this interface, as the underlyi ng software doesn’t resolve excep- tions by error co des. In addi…
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
3 Application program interface (API) description SIPLACE
Ausgabe 05/2007
28
Delete 3
Deletes the packaging units with the corresponding UID. 3
3
Parameters 3
packagingUnits 3
The packaging unit with the corresponding UID 3
Remarks 3
If the packaging unit is in use or is not the first piece of a splice chain (reel), the packaging unit
won't be deleted. All errors which occurred during execution can be get MessagesReceived-
event. 3
3
3.1.7 Interface ISetupCenterCallback
3.1.7.1 Public instance methods
3
3.1.8 Public instance events
3
3
Member name Description
SetMessageLevel
Levels to filter messages, which are published via this interface:
Valid values: "Debug", "Error", "Warn", "Info", "Detail"
Member name Description
FeederPlaced
Event will be thrown, if feeders are set up to the line
FeederRemoved
Event will be thrown, if feeders are removed from the line
MessagesReceived
Event will be thrown, if errors/warnings/infos occur within Setup
Center
NewSetupActive
Event will be thrown, if there is a new setup active on a station of
the line. The event will only be thrown, if the machine reports back
a new active setup
PackagingQuantityChanged
Event will be thrown, if quantities of packaging units have changed
SetupChanged
Event will be thrown, if PUs have changed