ControlRecipe

The object Control recipe contains the information a specific
process control unit needs to carry out a process order.
For this purpose, the process order instructions addressed to a control
recipe destination are collected and edited in a control recipe (or: PI sheet).

Available Methods

• GetList : Read control recipe list [ BAPI_CONTROL_RECIPE_GET_LIST ]
  
• Request : Request and transfer control recipes [ BAPI_CONTROL_RECIPE_REQUEST ]
  

GetList

Using this method, you read the header data of the control recipes available in the R/3 System.

For example, you can call this method from a process control system toobtain information on the control recipes created for this system.
Afterwards, you can use method
ControlRecipe.Request (Request and transfer control recipes) to export the control recipes to the control system.

Notes

Authorizations

You need the following authorization to carry out the method:

Authorization object Field Value

C_CREX_WRK Destination address RFC destination of the
control recipe destination

Activity 03 (Display control recipe)

Plant Plant of the control recipe

Selection Criteria

You can pass on the following data as criteria for control recipe selection:

Control Recipes

The header data of the selected control recipes are returned in parameter CntlRecHeader.

System Messages

System messages issued during method processing are returned in parameter Return
. For information on possible messages and their meaning, see the parameter documentation.

Further Information

For more information on control recipe processing, see the R/3 Library, section PP Production Planning - Process Industries -> Process Management -> Control Recipes.

Request

Using this method, you request and transfer control recipes from the R/3 System.

For example, you can call this method from a process control system toexport control recipes from the R/3 System to the control system.

A control recipe is only transferred if:

After the control recipe has been transferred, its status is set to Downloaded.

Notes

Authorizations

You need the following authorization to carry out the method:

Authorization object Field Value

C_CREX_WRK Destination address RFC destination of the

control recipe destination

Activity 90 (Request control recipe)

Plant Plant of the control recipe

When the method is carried out, the R/3 System does not check whether
the system calling the method and the control recipe destination arethe same. For this reason, make sure to define user authorizations insuch a way that users can only request control recipes created for their own destination address.

Selection Criteria

In parameter ControlRecipe, you specify the control recipes tobe transferred. Before this, you can request the header data of the control recipes available using method ControlRecipe.GetList.

Control Recipe Transfer

The data of the requested control recipes is returned in the parameters CntlRecHeader, CntlRecProcInstr, CntlRecCharac, and CntlRecTextlines.

System Messages

System messages issued during method processing are returned in parameter Return
. For information on possible system messages and their meaning, see the parameter documentation.

Update

When control recipes are transferred, R/3 data is changed (for example,the control recipe status). To update the R/3 System so that these
changes take effect, you have to carry out the standard method for thecommit work after the current method has been completed. You will findthis standard method and its documentation in the R/3 Business Object Repository, section Cross-Application Components
-> Business Framework Architecture.

If the commit work terminates, re-call the method for transferringcontrol recipes using the same selection criteria as before. If thedata has not been updated in the previous call, the same control recipes are returned again.

If one or more control recipes are locked at the time of the second method call, call the method again at a later time.

Further Information

For more information on control recipe processing, see the R/3 Library, section PP Production Planning - Process Industries
-> Process Management -> Control Recipes.