Difference between revisions of "Extensions.DiagCom.GetParameterAsList"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:OTX '''GetParameterAsList'''}}[[Category:DiagCom]]
 
{{DISPLAYTITLE:OTX '''GetParameterAsList'''}}[[Category:DiagCom]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | GetParameterAsList | List of parameters within a parameter | [[Term]] | [[Extensions.DiagCom|OTX DiagCom extension]] | [[Parameter related terms]] | [[Core.Actions.Throw.Exception.TypeMismatchException|TypeMismatchException]] | - }}
+
{{ClassificationActivity | GetParameterAsList | List of parameters within a parameter | [[Term]] | [[Extensions.DiagCom|OTX DiagCom extension]] | [[Extensions.DiagCom#Terms|Parameter related terms]] | [[Core.DataTypes.ComplexDataType.TypeMismatchException|TypeMismatchException]] | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
ListTerm = DiagCom.GetParameterAsList(ParameterContainer);
+
ListTerm = DiagCom.GetParameterAsList(ParameterContainerTerm);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== Description ==
 
== Description ==
The '''GetParameterAsList''' term is a list of parameters within a parameter back. The prerequisite is that the parameter consists of a set of individual parameters of the same type, such as in an array.
+
The '''GetParameterAsList''' term accepts a '''ParameterContainerTerm''' and returns an '''otx:List''' of [[Extensions.DiagCom.Parameter|Parameter]] handles, corresponding to the contents of the passed in parameter container object. This term is used in case a parameter of a diagnostic service contains a set of parameters. If the parameter supports child parameters, all child parameters should be returned. This list can be empty. If the parameter does not support child parameters, a [[Core.DataTypes.ComplexDataType.TypeMismatchException|TypeMismatchException]] shall be thrown.
  
{{TermReturnValue| [[Core.DataTypes.ComplexDataType.ContainerDataType.List|List]] | List of parameter (Type [[Extensions.DiagCom.Parameter|Parameter]])}}
+
{{TermReturnValue| [[Core.DataTypes.ComplexDataType.List|List]] | List of parameter (Type [[Extensions.DiagCom.Parameter|Parameter]])}}
  
 
== Properties ==
 
== Properties ==
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| ParameterContainer | [[Extensions.DiagCom.ParameterContainer|ParameterContainer]] | [[Term]] | - | [1] | The container of the parameter.}}
+
{{TableRowPropertie1| ParameterContainer | [[Extensions.DiagCom.ParameterContainer|ParameterContainer]] | [[Term]] | - | [1] | The '''ParameterContainer''' whose value shall be returned as an otx:List.}}
 
|}
 
|}
  
Line 25: Line 25:
 
DiagCom.ComChannel ComChannel1;
 
DiagCom.ComChannel ComChannel1;
  
ComChannel1 = DiagCom.GetComChannel("LL_ActuaForStrucBorneSoundUDS", null, false);
+
/// Flow
Request1 = DiagCom.GetRequest(DiagCom.CreateDiagServiceByName(ComChannel1, "DiagnServi_ReadDataByIdentActuaTestStatu"));
+
 
 +
ComChannel1 = DiagCom.GetComChannel("LL_GatewUDS", "", false);
 +
Request1 = DiagCom.GetRequest(DiagCom.CreateDiagServiceByName(ComChannel1, "DiagnServi_RoutiContrCheckMemor"));
 
List1 = DiagCom.GetParameterAsList(Request1);
 
List1 = DiagCom.GetParameterAsList(Request1);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
 
== See also ==
 
== See also ==
[[Extensions.DiagCom.GetParameterName|GetParameterName]] <br/>
+
[[Extensions.DiagCom.GetComChannel|GetComChannel]] <br/>
[[Extensions.DiagCom.GetParameterSemantic|GetParameterSemantic]] <br/>
+
[[Extensions.DiagCom.CreateDiagServiceByName|CreateDiagServiceByName]] <br/>
[[Extensions.DiagCom.GetParameterByPath|GetParameterByPath]]
+
[[Extensions.DiagCom.CreateDiagServiceBySemantic|CreateDiagServiceBySemantic]] <br/>
 +
[[Extensions.DiagCom.GetRequest|GetRequest]] <br/>
 +
[[Extensions.DiagCom.ExecuteDiagService|ExecuteDiagService]] <br/>
 +
[[Extensions.DiagCom.GetFirstResponse|GetFirstResponse]] <br/>
 +
[[Extensions.DiagCom.GetAllResponses|GetAllResponses]] <br/>
 +
[[Extensions.DiagCom.GetParameterBySemantic|GetParameterBySemantic]] <br/>
 +
[[Extensions.DiagCom.GetParameterByPath|GetParameterByPath]] <br/>

Revision as of 03:53, 15 October 2018

Classification

Name GetParameterAsList
Short Description List of parameters within a parameter
Class Term
Extension OTX DiagCom extension
Group Parameter related terms
Exceptions TypeMismatchException
Checker Rules -
Standard Compliant Yes

OTL Syntax

ListTerm = DiagCom.GetParameterAsList(ParameterContainerTerm);

Description

The GetParameterAsList term accepts a ParameterContainerTerm and returns an otx:List of Parameter handles, corresponding to the contents of the passed in parameter container object. This term is used in case a parameter of a diagnostic service contains a set of parameters. If the parameter supports child parameters, all child parameters should be returned. This list can be empty. If the parameter does not support child parameters, a TypeMismatchException shall be thrown.

Return Value

The Term returns the value, see table below.

Icons Note.png In OTX, Terms are categorized according to its return data type!
Data Type Description
List List of parameter (Type Parameter)

Properties

Name Data Type Class Default Cardinality Description
ParameterContainer ParameterContainer Term - [1] The ParameterContainer whose value shall be returned as an otx:List.

OTL Examples

DiagCom.Request Request1;
List<DiagCom.Parameter> List1;
DiagCom.ComChannel ComChannel1;

/// Flow

ComChannel1 = DiagCom.GetComChannel("LL_GatewUDS", "", false);
Request1 = DiagCom.GetRequest(DiagCom.CreateDiagServiceByName(ComChannel1, "DiagnServi_RoutiContrCheckMemor"));
List1 = DiagCom.GetParameterAsList(Request1);

See also

GetComChannel
CreateDiagServiceByName
CreateDiagServiceBySemantic
GetRequest
ExecuteDiagService
GetFirstResponse
GetAllResponses
GetParameterBySemantic
GetParameterByPath