Difference between revisions of "Extensions.DiagDataBrowsingPlus.GetDbDiagServiceDbPreConditionStatesBySemantic"

From emotive
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:OTX '''GetDbDiagServiceDbPreConditionStatesBySemantic'''}}Category:DiagDataBrowsingPlus == Classification == {{ClassificationActivity | GetDbDiagServiceDbPr...")
 
Line 1: Line 1:
 
{{DISPLAYTITLE:OTX '''GetDbDiagServiceDbPreConditionStatesBySemantic'''}}[[Category:DiagDataBrowsingPlus]]
 
{{DISPLAYTITLE:OTX '''GetDbDiagServiceDbPreConditionStatesBySemantic'''}}[[Category:DiagDataBrowsingPlus]]
 
== Classification ==
 
== Classification ==
{{ClassificationActivity | GetDbDiagServiceDbPreConditionStatesBySemantic | UPDATING... | [[Term]] | [[Extensions.DiagDataBrowsingPlus|OTX DiagDataBrowsingPlus extension]] | UPDATING... | UPDATING... | UPDATING... }}
+
{{ClassificationActivity | GetDbDiagServiceDbPreConditionStatesBySemantic | Returns a list of String of ECU state | [[Term]] | [[Extensions.DiagDataBrowsingPlus|OTX DiagDataBrowsingPlus extension]] | [[Extensions.DiagDataBrowsingPlus|DbDiagService related terms]] | NONE | - }}
  
 
== OTL Syntax ==
 
== OTL Syntax ==
UPDATING...<!--
 
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
DiagCom.CloseComChannel(ComChannelVariable);
+
ListTerm = DiagDataBrowsingPlus.GetDbDiagServiceDbPreConditionStatesBySemantic(DbDiagServiceTerm, StringTerm);
 
</syntaxhighlight>
 
</syntaxhighlight>
-->
+
 
  
 
== Description ==
 
== Description ==
UPDATING...<!--
+
'''GetDbDiagServiceDbPreConditionStatesBySemantic''' returns a list of String of ECU state (MCDDbEcuState) short names of the given semantic one of which is required to be able to execute the given [[Extensions.DiagDataBrowsingPlus.DbDiagService|DbDiagService]] successfully. The result is reduced to states that have a semantic value equals to the given semantic. An empty list will be delivered if no ECU state of the given semantic is associated with the current [[Extensions.DiagDataBrowsingPlus.DbDiagService|DbDiagService]] as a pre-condition.
OTX CloseComChannel activity is used for the [[Diagnosis Runtime System]] to announce that an open communication channel that all relevant resources can be released and closed.
+
 
{{ComChannelMemoryUsageNote}}
+
{{Note|NOTE — The appropriate MVCI system operation is MCDDbDiagComPrimitive::getDbPreConditionStatesBySemantic}}
{{Important|Please note that the use of a shared '''ComChannel''' can bring the OTX runtime system in an undefined state and that is this case is not validated at design time!}}
+
 
-->
+
{{TermReturnValue| [[Core.DataTypes.ComplexDataType.ContainerDataType.List|List]] | Returns a list of String of ECU state (MCDDbEcuState) short names of the given semantic one of which is required to be able to execute the given [[Extensions.DiagDataBrowsingPlus.DbDiagService|DbDiagService]] successfully.}}
  
 
== Properties ==
 
== Properties ==
UPDATING...<!--
 
 
{| {{TableHeader}}
 
{| {{TableHeader}}
 
{{TableRowPropertiesHeader}}
 
{{TableRowPropertiesHeader}}
{{TableRowPropertie1| ComChannel | [[Extensions.DiagCom.ComChannel|ComChannel]] | [[Variable]] | - | [1] | Communication Channel (Control unit).}}
+
{{TableRowPropertie2| dbDiagService | [[Extensions.DiagDataBrowsingPlus.DbDiagService|DbDiagService]] | [[Term]] | - | [1..1] | The element addresses the [[Extensions.DiagDataBrowsingPlus.DbDiagService|DbDiagService]] whose pre condition states shall be returned.}}
 +
{{TableRowPropertie1| semantic | [[Core.DataTypes.SimpleDataType.String|String]] | [[Term]] | - | [1..1] | The element addresses the semantic of an ECU state one of which is required to be able to execute an instance of the current [[Extensions.DiagCom.DiagService|DiagService]]. The semantic of a ECU state is given by the semantic definition of the MCDDbEcuStateChart object.}}
 
|}
 
|}
-->
 
  
 
== OTL Examples ==
 
== OTL Examples ==
UPDATING...<!--
 
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
 
<syntaxhighlight lang="java" enclose="div" style="font-size: medium;">
DiagCom.ComChannel myComCannel;
+
DiagDataBrowsingPlus.DbComChannel DbComChannel;
 +
List<DiagDataBrowsingPlus.DbDiagService> List_DbDiagService;
 +
List<String> List_String;
  
myComCannel = DiagCom.GetComChannel("DiagnosticsCan_ECU_1", null, false);
+
/// Flow
  
// Code example using the variable myComChannel
+
DbComChannel = DiagDataBrowsingPlus.GetDbComChannel(NULL, "LL_AllEmissRelatUDSSyste");
// ...
+
List_DbDiagService = DiagDataBrowsingPlus.GetDbComChannelDbDiagServices(DbComChannel);
DiagCom.CloseComChannel(myComCannel);</syntaxhighlight>
+
List_String = DiagDataBrowsingPlus.GetDbDiagServiceDbPreConditionStatesBySemantic(List_DbDiagService[0], "CURRENTDATA");
 
</syntaxhighlight>
 
</syntaxhighlight>
-->
 
  
 
== See also ==
 
== See also ==
UPDATING...
+
[[Extensions.DiagDataBrowsingPlus.GetComChannelDbComChannel|GetComChannelDbComChannel]] <br/>
 +
[[Extensions.DiagDataBrowsingPlus.GetDbComChannel|GetDbComChannel]] <br/>
 +
[[Extensions.DiagDataBrowsingPlus.GetDbComChannelDbDiagServices|GetDbComChannelDbDiagServices]]

Revision as of 04:17, 10 September 2018

Classification

Name GetDbDiagServiceDbPreConditionStatesBySemantic
Short Description Returns a list of String of ECU state
Class Term
Extension OTX DiagDataBrowsingPlus extension
Group DbDiagService related terms
Exceptions NONE
Checker Rules -
Standard Compliant Yes

OTL Syntax

ListTerm = DiagDataBrowsingPlus.GetDbDiagServiceDbPreConditionStatesBySemantic(DbDiagServiceTerm, StringTerm);


Description

GetDbDiagServiceDbPreConditionStatesBySemantic returns a list of String of ECU state (MCDDbEcuState) short names of the given semantic one of which is required to be able to execute the given DbDiagService successfully. The result is reduced to states that have a semantic value equals to the given semantic. An empty list will be delivered if no ECU state of the given semantic is associated with the current DbDiagService as a pre-condition.

Icons Note.png NOTE — The appropriate MVCI system operation is MCDDbDiagComPrimitive::getDbPreConditionStatesBySemantic

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 Returns a list of String of ECU state (MCDDbEcuState) short names of the given semantic one of which is required to be able to execute the given DbDiagService successfully.

Properties

Name Data Type Class Default Cardinality Description
dbDiagService DbDiagService Term - [1..1] The element addresses the DbDiagService whose pre condition states shall be returned.
semantic String Term - [1..1] The element addresses the semantic of an ECU state one of which is required to be able to execute an instance of the current DiagService. The semantic of a ECU state is given by the semantic definition of the MCDDbEcuStateChart object.

OTL Examples

DiagDataBrowsingPlus.DbComChannel DbComChannel;
List<DiagDataBrowsingPlus.DbDiagService> List_DbDiagService;
List<String> List_String;

/// Flow

DbComChannel = DiagDataBrowsingPlus.GetDbComChannel(NULL, "LL_AllEmissRelatUDSSyste");
List_DbDiagService = DiagDataBrowsingPlus.GetDbComChannelDbDiagServices(DbComChannel);
List_String = DiagDataBrowsingPlus.GetDbDiagServiceDbPreConditionStatesBySemantic(List_DbDiagService[0], "CURRENTDATA");

See also

GetComChannelDbComChannel
GetDbComChannel
GetDbComChannelDbDiagServices