Gibt das letzte Vorkommen eines Zeitabschnitts in einem definierten Zeitbereich für eine ausgewählte Zeitabschnittsablage zurück.
Message "GetLastHdTimePeriodOccurrenceRequest"
Struktur
GetLastHdTimePeriodOccurrenceRequest{
QueryMode{…}
ColumnFilter{…}
}
Parameter
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
hd_store_name |
string |
Eindeutiger Name der zeitbasierten HD-Ablage, die die übergeordnete Ablage für die Zeitabschnittsablage ist. |
|
2 |
time_period_store_name |
string |
Name der Zeitabschnittsablage, deren Daten abgefragt werden. |
|
3 |
time_range_from |
int64 |
Startzeit des angefragten Zeitbereichs im Unix-Zeitstempelformat in Mikrosekunden. |
|
4 |
time_range_to |
int64 |
Endzeit des angefragten Zeitbereichs im Unix-Zeitstempelformat in Mikrosekunden. |
|
5 |
query_mode |
- |
Abfragemodus, um festzulegen, ob Start- und Endzeit im Abfragezeitbereich enthalten sind oder nicht, siehe Message "QueryMode". |
|
6 |
filter |
- |
Filter für angeforderte Infofelder, siehe Message "ColumnFilter". |
Message "GetLastHdTimePeriodOccurrenceResponse"
Gibt für den letzten Zeitabschnitt der angeforderten Zeitabschnittsablage die Message TimePeriodData mit Start- und Endzeitstempel im Unix-Zeitstempelformat in Mikrosekunden zurück.
Für Zeitabschnitte ohne gültige Endzeit wird eine "0" zurückgegeben.
Alle Standardwerte der Infofelder werden standardmäßig hinzugefügt. Die nach Info_field_names gefilterten benutzerdefinierten Infofelder werden hinzugefügt und nach Variablentyp geordnet.
Struktur
GetLastHdTimePeriodOccurrenceResponse{
TimePeriodData{
NumericField{…}
Int32Field{…}
Int64Field{…}
TextField{…}
DigitalField{…}
}
}
Parameter
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
id |
int64 |
Eindeutige ID des Zeitabschnitts |
|
2 |
start_time |
int64 |
Unix-Zeitstempel für die Startzeit des Zeitabschnitts in Mikrosekunden. |
|
3 |
end_time |
int64 |
Unix-Zeitstempel für die Endzeit des Zeitabschnitts in Mikrosekunden. Für Zeitabschnitte ohne gültige Endzeit wird eine "0" zurückgegeben. |
|
4 |
name |
string |
Name des Zeitabschnittseintrags |
|
5 |
start_trigger |
double |
Absolute Zeit in Sekunden im Verhältnis zur Startzeit |
|
6 |
stop_trigger |
double |
Absolute Zeit in Sekunden, zu dem die Startzeit im Verhältnis zur Startzeit eintrat. Der Wert ist 0,0, wenn kein Stopptrigger aufgetreten ist. |
|
7 |
comment |
string |
Kommentar |
|
8 |
metadata_id |
int32 |
ID der für diesen Zeitabschnitt verwendeten Metadatengruppe |
|
9 |
double_fields |
- |
Infofelder vom Typ "double", siehe Message "NumericField". |
|
10 |
int32_fields |
- |
Infofelder vom Typ "int32", siehe Message "Int32Field". |
|
11 |
int64_fields |
- |
Infofelder vom Typ "int64", siehe Message "Int64Field". |
|
12 |
text_fields |
- |
Textinfofelder, siehe Message "TextField". |
|
13 |
digital_fields |
- |
Infofelder vom Typ "bool", siehe Message "DigitalField". |
|
14 |
autoClosed |
bool |
True, wenn der Zeitabschnitt die maximale Zeitabschnittsdauer vor dem Stopp-Trigger erreicht, und automatisch geschlossen wurde |
|
15 |
dataMissing |
bool |
True, wenn Daten innerhalb des Zeitabschnitts fehlen, z. B. wenn die Datenaufzeichnung unterbrochen wurde |
Message "QueryMode"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
is_start_time_in_time_range |
bool |
Legt fest, ob die Startzeit der Zeitabschnitte in die Abfrage einbezogen werden soll oder ob die Startzeit vor dem abgefragten Zeitbereich liegt |
|
2 |
is_end_time_in_time_range |
bool |
Legt fest, ob der Endzeitpunkt der Zeitabschnitte in die Abfrage einbezogen werden soll oder ob der Endzeitpunkt später als das Ende des abgefragten Zeitbereichs liegen kann |
|
3 |
include_open |
bool |
Angabe, ob nicht abgeschlossene Zeitabschnitte in das Ergebnis einbezogen werden oder nur abgeschlossene Zeiträume mit Start- und Endzeit verwendet werden |
|
4 |
column_filter_active |
bool |
Spaltenfilter aktivieren oder deaktivieren |
|
5 |
order_by |
enum (OrderByType) |
Ergebnisse nach der Startzeit in aufsteigender oder absteigender Reihenfolge ordnen |
Message "ColumnFilter"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
info_field_names |
string |
Es werden nur die Infofelder abgefragt, die als Filter angegeben sind. Die vollständige Liste der verfügbaren Feldnamen können Sie mit GetHdTimePeriodStoreSchema() anfordern, siehe GetHdTimePeriodStoreSchema(). |
Message "NumericField"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
name |
string |
Name des Feldes |
|
2 |
value |
double |
Wert des Feldes |
|
3 |
isData |
bool |
Ist TRUE, wenn der aktuelle Wert entweder wahr oder falsch ist, und ist FALSE, wenn der aktuelle Wert null ist. |
Message "Int32Field"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
name |
string |
Name des Feldes |
|
2 |
value |
int32 |
Wert des Feldes |
|
2 |
isData |
bool |
Ist TRUE, wenn der aktuelle Wert entweder wahr oder falsch ist, und ist FALSE, wenn der aktuelle Wert null ist. |
Message "Int64Field"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
name |
string |
Name des Feldes |
|
2 |
value |
int64 |
Wert des Feldes |
|
3 |
isData |
bool |
Ist TRUE, wenn der aktuelle Wert entweder wahr oder falsch ist, und ist FALSE, wenn der aktuelle Wert null ist. |
Message "TextField"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
name |
string |
Name des Feldes |
|
2 |
value |
double |
Wert des Feldes |
|
3 |
isData |
bool |
Ist TRUE, wenn der aktuelle Wert entweder wahr oder falsch ist, und ist FALSE, wenn der aktuelle Wert null ist. |
Message "DigitalField"
|
Pos. |
Parameter |
Datentyp |
Bedeutung |
|---|---|---|---|
|
1 |
name |
string |
Name des Fldes |
|
2 |
value |
bool |
Wert des Feldes |
|
3 |
isData |
bool |
Ist TRUE, wenn der aktuelle Wert entweder wahr oder falsch ist, und ist FALSE, wenn der aktuelle Wert null ist. |