7.5.2.7 PrepareProduct

This method is used to prepare a product so that it can be used for starting a job on the vision system.

Signature

	PrepareProduct ([in]	ProductIdDataType	productId[out]	RecipeIdInternalDataType	internalId[out]	Int32	error);
	
Table 43 – PrepareProduct Method Arguments
Argument Description
productIdIdentification of a product, which can be used in a Start method.
internalIdInternal identification of the recipe which is actually being used to work on the product.
error

0 – OK

Values > 0 are reserved for errors defined by this and future standards.

Values < 0 shall be used for application-specific errors.

Table 44 – PrepareProduct Method AddressSpace Definition
Attribute Value
BrowseNamePrepareProduct
References NodeClass BrowseName DataType TypeDefinition ModellingRule
HasPropertyVariableInputArgumentsArgument[]PropertyTypeMandatory
HasPropertyVariableOutputArgumentsArgument[]PropertyTypeMandatory

In effect, the vision system will use a recipe to work on the product. Therefore, the vision system is expected to select a recipe linked to the given ProductId. If more than one recipe is linked to the product, the resolution of this ambiguity is implementation defined.

The vision system shall return the internal identification of the recipe selected. If there is more than one recipe linked to the given ProductId, it is implementation-defined how this ambiguity will be handled. It is expected that the resolution of the ambiguity will be implemented in a systematic manner throughout the vision system.

Since preparing a product is in effect the same as preparing a recipe which has been selected by the vision system on the basis of the ProductId, state handling is identical to the PrepareRecipe method.