Difference between revisions of "Extensions.DiagCom.SetParameterValue"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:OTX '''SetParameterValue '''}}[[Category:DiagCom]]
 
{{DISPLAYTITLE:OTX '''SetParameterValue '''}}[[Category:DiagCom]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | SetParameterValue | Sets the value of a request parameter | [[Action]] | [[Extensions.DiagCom|OTX DiagCom extension]] | [[DiagService related actions]] | [[Core.Actions.Throw.Exception.OutOfBoundsException|OutOfBoundsException]] <br/> [[Core.Actions.Throw.Exception.TypeMismatchException|TypeMismatchException]] | - }}
+
{{ClassificationActivity | SetParameterValue | Sets a specific value to a '''Parameter''' element | [[Action]] | [[Extensions.DiagCom|OTX DiagCom extension]] | [[DiagService related actions]] | [[Core.DataTypes.ComplexDataType.OutOfBoundsException|OutOfBoundsException]] <br/> [[Core.DataTypes.ComplexDataType.TypeMismatchException|TypeMismatchException]] | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
Line 9: Line 9:
  
 
== Description ==
 
== Description ==
The OTX [[Extensions.DiagCom.SetParameterValue|SetParameterValue]] activity sets the value of a request parameter "manually" to a specific value, see [[Extensions.DiagCom.ExecuteDiagService|ExecuteDiagService]].
+
The OTX [[Extensions.DiagCom.SetParameterValue|SetParameterValue]] activity sets a specific value to a [[Extensions.DiagCom.Parameter|Parameter]] element. The value to be set is to be provided as an [[Core.DataTypes.SimpleDataType|OTX simple type]], an OTX [[Core.DataTypes.ComplexDataType.List|lists]] or [[Core.DataTypes.ComplexDataType.Map|maps]] or an OTX [[Extensions.Quantities.Quantity|Quantity]]  
  
 
== Properties ==
 
== Properties ==
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| Parameter | [[Extensions.DiagCom.Parameter|Parameter]] | [[Term]] | - | [1] | Request parameter whose value is to be set.}}
+
{{TableRowPropertie1| Parameter | [[Extensions.DiagCom.Parameter|Parameter]] | [[Term]] | - | [1] | This element specifies the parameter which will be set.}}
{{TableRowPropertie2| Value | - | [[Term]] | - | [1] | Value of the corresponding type that is to be placed.}}
+
{{TableRowPropertie2| Value | - | [[Term]] | - | [1] | This element specifies the value that shall be set to the Parameter. Allowed input types are [[Core.DataTypes.SimpleDataType|OTX simple types]], [[Core.DataTypes.ComplexDataType.ByteField|OTX bytefields]], [[Core.DataTypes.ComplexDataType.List|lists]] and [[Core.DataTypes.ComplexDataType.Map|maps]] and [[Extensions.Quantities.Quantity|OTX quantities]].}}
 
|}
 
|}
  
 
== OTL Examples ==
 
== OTL Examples ==
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
DiagCom.ComChannel myComCannel;
+
DiagCom.Request Request1;
DiagCom.DiagService myDiagService;
+
DiagCom.Parameter Parameter1;
DiagCom.Request req;
 
DiagCom.Parameter param;
 
  
myComCannel = DiagCom.GetComChannel("LL_AllEmissRelatUDSSyste", null, false);
+
/// Flow
myDiagService = DiagCom.CreateDiagServiceByName(myComCannel, "DiagnServi_ReadDataByIdentASAMODXFileIdent");
+
 
req = DiagCom.GetRequest(myDiagService);
+
Request1 = DiagCom.GetRequest(DiagCom.CreateDiagServiceByName(DiagCom.GetComChannel("LL_GatewUDS", "", false), "SinglJob_PostDataSet"));
param = DiagCom.GetParameterByPath(req, {"Param_RecorDataIdent"});
+
Parameter1 = DiagCom.GetParameterByPath(Request1, {"IPA_Refer"});
DiagCom.SetParameterValue(param, 123);
+
DiagCom.SetParameterValue(Parameter1, &FFFF);
 
</syntaxhighlight>
 
</syntaxhighlight>
  
Line 35: Line 33:
 
[[Extensions.DiagCom.GetComChannel|GetComChannel]] <br/>
 
[[Extensions.DiagCom.GetComChannel|GetComChannel]] <br/>
 
[[Extensions.DiagCom.CreateDiagServiceByName|CreateDiagServiceByName]] <br/>
 
[[Extensions.DiagCom.CreateDiagServiceByName|CreateDiagServiceByName]] <br/>
[[Extensions.DiagCom.SetParameterValueBySemantic|SetParameterValueBySemantic]]
+
[[Extensions.DiagCom.CreateDiagServiceBySemantic|CreateDiagServiceBySemantic]]<br/>
 +
[[Extensions.DiagCom.GetRequest|GetRequest]]<br/>
 +
[[Extensions.DiagCom.GetParameterByPath|GetParameterByPath]]

Revision as of 07:42, 11 October 2018

Classification

Name SetParameterValue
Short Description Sets a specific value to a Parameter element
Class Action
Extension OTX DiagCom extension
Group DiagService related actions
Exceptions OutOfBoundsException
TypeMismatchException
Checker Rules -
Standard Compliant Yes

OTL Syntax

DiagCom.SetParameterValue(ParameterTerm, Term);

Description

The OTX SetParameterValue activity sets a specific value to a Parameter element. The value to be set is to be provided as an OTX simple type, an OTX lists or maps or an OTX Quantity

Properties

Name Data Type Class Default Cardinality Description
Parameter Parameter Term - [1] This element specifies the parameter which will be set.
Value - Term - [1] This element specifies the value that shall be set to the Parameter. Allowed input types are OTX simple types, OTX bytefields, lists and maps and OTX quantities.

OTL Examples

DiagCom.Request Request1;
DiagCom.Parameter Parameter1;

/// Flow

Request1 = DiagCom.GetRequest(DiagCom.CreateDiagServiceByName(DiagCom.GetComChannel("LL_GatewUDS", "", false), "SinglJob_PostDataSet"));
Parameter1 = DiagCom.GetParameterByPath(Request1, {"IPA_Refer"});
DiagCom.SetParameterValue(Parameter1, &FFFF);

See also

GetComChannel
CreateDiagServiceByName
CreateDiagServiceBySemantic
GetRequest
GetParameterByPath