Difference between revisions of "Extensions.Job.AddBranchByIndex"

From emotive
Jump to navigation Jump to search
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{DISPLAYTITLE:  '''AddBranchByIndex '''}}
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | AddBranchByIndex | Adds a set of response parameters by index | [[Action]] | [[Job|OTX Job extension]] | [[Job related actions]] | [[TypeMismatchException]]<br/>[[OutOfBoundsException]] | - }}
+
{{ClassificationActivity | AddBranchByIndex | Adds a set of response parameters to the response structure by its index| [[Action]] | [[Extensions.Job|OTX Job extension]] | [[Extensions.Job#Actions|Job related actions]] | [[Core.DataTypes.ComplexDataType.TypeMismatchException|TypeMismatchException]]<br/>[[Core.DataTypes.ComplexDataType.OutOfBoundsException|OutOfBoundsException]] | - }}
 +
 
 +
== OTL Syntax ==
 +
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
Job.AddBranchByIndex(ParameterContainerTerm parameterContainer, ParameterContainerTerm content, NumericTerm index);
 +
</syntaxhighlight>
  
 
== Description ==
 
== Description ==
'''AddBranchByIndex''' is used to add a number of parameters '''Response''' to '''Response''' structure according to the definition of a database by its index multiplexer.
+
The '''AddBranchByIndex''' is used to add a number of parameters '''Response''' to '''Response''' structure according to a multiplexer database definition given by its index.
  
 
== Properties ==
 
== Properties ==
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| ParameterContainer | [[ParameterContainer]] | [[Term]] | - | [1] | The parameters in which new element (s) to be added.}}
+
{{TableRowPropertie2| ParameterContainer | [[Extensions.DiagCom.ParameterContainer|ParameterContainer]] | [[Term]] | - | [1] | The parameter where new element(s) will be added.}}
{{TableRowPropertie2| Index | [[Integer]] | [[Term]] | - | [0..1] | The index of the multiplexer branch is added to the}}
+
{{TableRowPropertie1| Index | [[Numeric]] | [[Term]] | - | [1] | The index of the multiplexer branch to be added. [[Core.DataTypes.SimpleDataType.Float|Float]] values will be truncated.}}
{{TableRowPropertie1| Content | [[ParameterContainer]] | [[Term]] | - | [0..1] | The element that is placed in the newly created branch multiplexer}}
+
{{TableRowPropertie2| Content | [[Extensions.DiagCom.ParameterContainer|ParameterContainer]] | [[Term]] | - | [0..1] | The element(s) to be placed in the newly created multiplexer branch.}}
 
|}
 
|}
 +
 +
== OTL Examples ==
 +
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 +
/// Local Declarations
 +
 +
DiagCom.ComChannel ComChannel1;
 +
DiagCom.DiagService DiagService1;
 +
DiagCom.Result Result1;
 +
DiagCom.Response Response1;
 +
DiagCom.Parameter Parameter1;
 +
 +
/// Flow
 +
 +
ComChannel1 = DiagCom.GetComChannel("LL_GatewUDS", "EV_GatewLear_006", false);
 +
DiagService1 = DiagCom.CreateDiagServiceByName(ComChannel1, "DiagnServi_ReadDataByIdentECUIdent");
 +
[#MetaData(RequestPdu), <#Data>22 04 07</#Data>]
 +
DiagCom.ExecuteDiagService(DiagService1, {Param_RecorDataIdent = "VW Logical Software Block Counter Of Programming Attempts"}, {}, Result1, NULL, false, false);
 +
Response1 = DiagCom.GetFirstResponse(Result1);
 +
Parameter1 = DiagCom.GetParameterByPath(Response1, {"Param_DataRecor"});
 +
Job.AddBranchByIndex(Response1, Parameter1, 1);
 +
</syntaxhighlight>
  
 
== See also ==
 
== See also ==
[[SendFinalResult]]<br/>
+
[[Extensions.Job.SendFinalResult|SendFinalResult]]<br/>
[[SendIntermediateResult]]<br/>
+
[[Extensions.Job.SendIntermediateResult|SendIntermediateResult]]<br/>
[[SetJobInfo]]<br/>
+
[[Extensions.Job.SetJobInfo|SetJobInfo]]<br/>
[[SetProgressInfo]]<br/>
+
[[Extensions.Job.SetProgressInfo|SetProgressInfo]]<br/>
[[AddElement]]<br/>
+
[[Extensions.Job.AddElement|AddElement]]<br/>
[[AddBranchByName]]<br/>
+
[[Extensions.Job.AddBranchByName|AddBranchByName]]<br/>
[[AddBranchByValue]]<br/>
+
<!--[[Extensions.Job.AddBranchByIndex|AddBranchByIndex]]<br/>-->
[[AddEnvDataByDtc]]
+
[[Extensions.Job.AddBranchByValue|AddBranchByValue]]<br/>
 +
[[Extensions.Job.AddEnvDataByDtc|AddEnvDataByDtc]]<br/>
 +
[[Extensions.DiagCom.GetComChannel|GetComChannel]]<br/>
 +
[[Extensions.DiagCom.CreateDiagServiceByName|CreateDiagServiceByName]]<br/>
 +
[[Extensions.DiagCom.ExecuteDiagService|ExecuteDiagService]]<br/>
 +
[[Extensions.DiagCom.GetFirstResponse|GetFirstResponse]]<br/>
 +
[[Extensions.DiagCom.GetRequest|GetRequest]]<br/>

Latest revision as of 03:26, 13 September 2019

Classification

Name AddBranchByIndex
Short Description Adds a set of response parameters to the response structure by its index
Class Action
Extension OTX Job extension
Group Job related actions
Exceptions TypeMismatchException
OutOfBoundsException
Checker Rules -
Standard Compliant Yes

OTL Syntax

Job.AddBranchByIndex(ParameterContainerTerm parameterContainer, ParameterContainerTerm content, NumericTerm index);

Description

The AddBranchByIndex is used to add a number of parameters Response to Response structure according to a multiplexer database definition given by its index.

Properties

Name Data Type Class Default Cardinality Description
ParameterContainer ParameterContainer Term - [1] The parameter where new element(s) will be added.
Index Numeric Term - [1] The index of the multiplexer branch to be added. Float values will be truncated.
Content ParameterContainer Term - [0..1] The element(s) to be placed in the newly created multiplexer branch.

OTL Examples

/// Local Declarations

DiagCom.ComChannel ComChannel1;
DiagCom.DiagService DiagService1;
DiagCom.Result Result1;
DiagCom.Response Response1;
DiagCom.Parameter Parameter1;

/// Flow

ComChannel1 = DiagCom.GetComChannel("LL_GatewUDS", "EV_GatewLear_006", false);
DiagService1 = DiagCom.CreateDiagServiceByName(ComChannel1, "DiagnServi_ReadDataByIdentECUIdent");
[#MetaData(RequestPdu), <#Data>22 04 07</#Data>]
DiagCom.ExecuteDiagService(DiagService1, {Param_RecorDataIdent = "VW Logical Software Block Counter Of Programming Attempts"}, {}, Result1, NULL, false, false);
Response1 = DiagCom.GetFirstResponse(Result1);
Parameter1 = DiagCom.GetParameterByPath(Response1, {"Param_DataRecor"});
Job.AddBranchByIndex(Response1, Parameter1, 1);

See also

SendFinalResult
SendIntermediateResult
SetJobInfo
SetProgressInfo
AddElement
AddBranchByName
AddBranchByValue
AddEnvDataByDtc
GetComChannel
CreateDiagServiceByName
ExecuteDiagService
GetFirstResponse
GetRequest