InfoTrimmed
The
INFOTRIMMED
execute retrieves the information necessary for the formatting of a Batch execute that would be used to instantiate a batch.The format and return for this execute includes:
Execute Format | A FactoryTalk Batch Server supports an execute with this format:[INFOTRIMMED( <Item>,<UserID>,<RecipeID><PhaseMaterialData> )] | ||
where: | Item | Name of the response item as specified by the client. | |
UserID | User identification associated with this event. | ||
RecipeID | File name of the recipe. | ||
<PhaseMaterialData> | Optional list of Phase-Material pair data. | ||
where: | |||
<PhaseMaterialData> | is | <NULLLIST> |, <PhaseMaterialList> | |
<PhaseMaterialList> | is | <PhaseMaterialRecord> | <PhaseMaterialRecord> , <PhaseMaterialList> | |
<PhaseMaterialRecord> | is | <PhasePathName> , <MaterialName> | |
where: | |||
Field | Format | Description | |
PhasePathName | ASCII - String | Full recipe pathname to the phase. (for example, PROC_1\UNITPROC_1:1\OPER_1:3\ADD:4) | |
MaterialName | ASCII – String | Name of a material configured in the Material Server (for example, Milk). | |
Action | A successful INFOTRIMMED execute places the recipe information into the item field. | ||
Return Format | The response item populates with this data: <RecList> | FAIL: <FailData> | ||
where: | |||
<RecList> | is | <StepList> PARMS \crlf <ParmList> | |
<StepList> | is | <Step> | <Step> <StepList> | |
<Step> | is | <Alias> \t <UnitBindList> \t <BindFlag> \crlf | |
<UnitBindList> | is | $UNITLIST \t <UnitList> \t $END | |
<UnitList> | <UnitName> | <UnitName> \t <UnitList> | ||
<ParmList> | is | <ParmInfo> | <ParmInfo> <ParmList> | |
<ParmInfo> | is | <Parameter> \t <ResponseType> \t <ParmEdit> \t <EngUnits> \t <High> \t <Low> \t <Default> \crlf | |
<FailData> | is | <message> | <ZeroTargets> | |
<ZeroTargets> | is | <ZeroTargsMarker> \crlf <ZeroTargsList> | |
<ZeroTargsList> | is | <ZeroTargs> | <ZeroTargs> \crlf <ZeroTargsList> | |
<ZeroTargs> | is | <ZeroTargsText> ' :' <Alias> \crlf
<UnitErrList> \crlf
<EndUnitErrList> \crlf
<BindReqList> \crlf
<EndBindReqList> \crlf
<ExprDataList> \crlf
<EndZeroTargsData> | |
<UnitErrList> | is | <UnitErr> | <UnitErr> /crlf <UnitErrList> | |
<UnitErr> | is | <UnitIdLabel> ':' <UnitID> \t <UnitNameLabel> ':' <UnitName> \t <ReasonData> | |
<ReasonData> | is | <LegalReason> | <FPathReason> | <FPathRqmReason> | FPathMatReason> | <BindReqReason> | <MaterialReason> | <NotRecordedReason> | <InvalidReason> | |
<LegalReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ':' <ReasonText> | |
<FPathReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ':' <ReasonText> | |
<FPathRqmReason> | is | <ReasonCodeLabel> ' :' <ReasonCode> \t <ReasonTextLabel> ' :' <ReasonText> | |
<FPathMatReason> | is | <ReasonCodeLabel> ' :' <ReasonCode> \t <ReasonTextLabel> ' :' <ReasonText> | |
<BindReqReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ':' <ReasonText>' :' <BindRqmtID> | |
<MaterialReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ' :' <ReasonText> \t <MaterialLabel> ' :' <Material> \t <LotLabel> ':' <Lot> \t <LabelLabel> ':' <Label> \t <UseCodeLabel> ':' <UseCode> \t <UseTextlabel> ':' <UseText> \t <StepLabel> ':' <StepPath> | |
<NotRecordedReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ':' <ReasonText> | |
<InvalidReason> | is | <ReasonCodeLabel> ':' <ReasonCode> \t <ReasonTextLabel> ':' <ReasonText> | |
<BindReqList> | is | <BindReq> | <BindReq> /crlf <BindReqList> | |
<BindReq> | is | <BindReqID> ':' <BindReqText> | |
<ExprDataList> | is | <ExprData> | <ExprData> /crlf <ExprDataList> | |
<ExprData> | is | <ExprDataUnitIDLabel> ':' <ExprDataUnitID> /t <ExprDataUnitNameLabel> ':' <ExprDataUnitName> /t <ExprBindSpecIDLabel> ':' <ExprBindSpecID> /t <ExpressionValues> | |
<ExpressionValues> | is | <ExpressionValue> <LeafValuePairs> | |
<LeafValuePairs> | is | <NullList> | /t <LeafValueList> | |
<LeafValueList> | is | <LeafPair> | <LeafPair> /t <LeafValueList> | |
<LeafPair> | is | <LeafName> /t <LeafValue> | |
where: | |||
Field Name | Format | Description | |
FAIL: | ASCII - String | Keyword to indicate the InfoTrimmed execute encountered an error. | |
ASCII - String | Error message formatted appropriately for operator display. | ||
PARMS | ASCII - String | Keyword to separate the Steps from the parameters in the return result. | |
<Alias> | ASCII - String | Unit alias which requires binding. | |
<BindFlag> | ASCII - Integer | Integer value containing bits indicating what types of late binding are permitted:
Bit1 = PROMPT
Bit2 = FIRST AVAILABLE | |
$UNITLIST | ASCII - String | Indicates the beginning of the list of unit names that contain references to material-based phases. | |
$END | ASCII - String | Indicates the end of the list of unit names that contain references to material-based phases. | |
<UnitName> | ASCII - String | Name of the unit. | |
<Parameter> | ASCII - String | Parameter name required to create the batch. | |
<Response Type> | ASCII - Integer | Data type for the response:
| |
<ParmEdit> | ASCII - Integer | 1 = obsolete field used to mark recipe parameters as having values that could be edited or not. It always returns the value "1". | |
<EngUnits> | ASCII - String | Engineering units for the recipe parameter. | |
<Max> | ASCII - String | High range for the recipe parameter. For parameters of type String and Enumeration, this field contains no data. | |
<Min> | ASCII - String | Low range for the recipe parameter. For parameters of type String and Enumeration, this field contains no data. | |
<Default> | ASCII - String | Default value for the recipe parameter. | |
ZeroTargsMarker | ASCII - String | String constant "$ZEROLEGALBINDTARGSDATA" used to indicate that the response item contains data elaborating the reasons why there are zero legal bind targets for one or more Unit Requirements. | |
ZeroTargsText | ASCII - String | Localized displayable error message, indicating that the specified unit requirement (following the ':' character) has zero legal bind targets. | |
EndUnitErrList | ASCII - String | String constant "$ENDUNITDATA" marks the end of the set of Unit Instance legality records. | |
EndBindReqList | ASCII - String | String constant "$ENDBINDREQDATA" marks the end of the set of Binding Requirement records. | |
EndZeroTargsData | ASCII - String | String constant "$ENDUNITRQMTDATA" marks the end of a Unit Requirements expression data records (and the end of the Unit Requirement's data). | |
UnitIdLabel | ASCII - String | Non-localized English string label for the Unit ID that follows. | |
UnitId | ASCII - Integer | Integer value identifier of the Unit for which bind illegality describes. | |
UnitNameLabel | ASCII - String | Non-localized English string label for the Unit name that follows. | |
UnitName | ASCII - String | Name of the unit or which bind illegality describes. | |
ReasonCodeLabel | ASCII - String | Non-localized English string label for the Reason Code field that follows. | |
ReasonCode | ASCII - Integer | Integer field describing the legality of the Unit Instance for binding. Possible values are: 0 - Unit is a legal binding target 1 - Unit invalid due to material requirement 2 - Unit invalid due to binding requirement 3 - Unit invalid due to material requirement on flowpath 4 - Unit Invalid due to static binding requirement on flowpath 5 - Unit Invalid due to flowpath analysis 6 - Invalid reason code 7 - Unit invalidity reason not recorded | |
ReasonTextLabel | ASCII - String | Non-localized English string label for the Reason Text field that follows. | |
ReasonText | ASCII - String | Non-localized English string that describes the reason the unit is an illegal bind target. | |
MaterialLabel | ASCII - String | Non-localized English string label for material name field that follows. | |
Material | ASCII - String | Name of the material associated with the material requirement that made the unit instance an illegal bind target. | |
LotLabel | ASCII - String | Non-localized English string label for the Lot field that follows. | |
Lot | ASCII - String | LOT specifier associated with the material requirement that made the unit instance an illegal bind target. | |
LabelLabel | ASCII - String | Non-localized English string label for the Label field that follows. | |
UseCodeLabel | ASCII - String | Non-localized English string label for the Use Code field that follows. | |
UseCode | ASCII - Integer | Integer value indicating the usage type defined by the material requirement that made the unit instance an illegal bind target. Possible values are: 0 - Distribution 1 - Addition | |
UseTextLabel | ASCII - String | Non-localized English string label for the Use Text field that follows. | |
UseText | ASCII - String | Localized string describing the usage type defined by the material requirement that made the unit instance an illegal bind target. | |
StepLabel | ASCII - String | Non-localized English string label for the Step Path field that follows. | |
StepPath | ASCII - String | Full path to the step associated with the material requirement that made the unit instance an illegal bind target. | |
BindReqID | ASCII - Integer | Integer value identifier of the Binding Requirement exposed in this record. | |
BindReqText | ASCII - String | Non-localized string that is a "readable" description of the binding requirement. Note, this may contain the ':' character. | |
ExprDataUnitIDLabel | ASCII - String | Non-localized English string label for the Unit ID field that follows. | |
ExprDataUnitID | ASCII - Integer | Integer value identifier of the Unit Resource associated with this data record. | |
ExprDataUnitNameLabel | ASCII - String | Non-localized English string label for the Unit Name field that follows. | |
ExprDataUnitName | ASCII - String | Name of the Unit Resource associated with this data record. | |
ExprBindSpecIDLabel | ASCII - String | Non-localized English string label for the Bind Specifier ID field that follows. | |
ExprBindSpecID | ASCII - Integer | Integer value identifier of the Binding Specifier associated with this data record. | |
ExpressionValue | ASCII - Variable | Evaluated value of the expression. | |
LeafName | ASCII - String | Name of the leaf from the expression. | |
LeafValue | ASCII - Variable | Value of the leaf from the expression. |
The following table shows an example of the return on this execute.
Example: | An execute string consisting of: INFOTRIMMED(Item,Station2/View,MAKE_SOUP.BPC) Could return: FREEZER \t FREEZER_CLS \t 0 \ r \ n MIXER \ t MIXER_CLS \t 0 \ crlf PARMS \crlf MILK_AMOUNT \ t 1 \ t 1 \ t KG \ t 5000 \ t 0 \ t 1999 \ crlf SUGAR_AMOUNT \ t 1 \ t 1 \ t KG \ t 1500 \ t 0 \ t 750 \ crlf CREAM_AMOUNT \ t 1 \ t 1 \ t K G \ t 5000 \ t 0 \ t 2001 \ crlf EGG_AMOUNT \ t 1 \ t 1 \ t KG \ t 500 \ t 0 \ t 200 \ crlf FLAVOR_AMOUNT \ t 1 \ t 1 \ t KG \ t 100 \ t 0 \ t 50 \ crlf |
Provide Feedback