to_hb_results()-Methode
Speichert einen HCL-Datenrahmen in eine Ergebnisse-App-Tabelle.
Hinweis
Die Verwendung der Methode to_hb_results() erfordert, dass Sie auch eine Kennwortvariable namens v_hb_token im Fenster Variablen des HCL-Skript-Editors erstellen und einen HighBond-API-Token als Variablenwert zuweisen. Weitere Informationen finden Sie unter HCL-Variablen werden im Fenster „Variablen“ definiert..
Syntax
datenrahmen_name.to_hb_results(table_id = Ergebnistabellen_ID_nummer, column_names = {"spaltenname":"Ergebnisanzeigename", "...n":"...n"}|dictionary_objekt, overwrite = True|False)
Parameter
Name | Beschreibung |
---|---|
table_id = Ergebnistabellen_ID_nummer | Die numerische ID der Ergebnistabelle. |
column_names = {"spaltenname" : "Ergebnisanzeigename", "...n" : "...n"} Optional |
Eine Zuordnung zwischen einem Spaltennamen im Datenrahmen und einem Anzeigenamen für das entsprechende Feld in „Ergebnisse“. Erstellen Sie die Zuordnung für eine oder mehrere Spalten mit einem standardmäßigen Python-Dictionary. Sie geben den Anzeigenamen nur für das Feld in der Zielergebnistabelle an. Der Name des zugrunde liegenden Feldes in „Ergebnisse“ bleibt gleich. |
column_names = dictionary_object Optional |
Ein bereits vorhandenes Dictionary-Objekt, das Spaltennamen im Datenrahmen Anzeigenamen für die entsprechenden Felder in „Ergebnisse“ zuordnet. Als Alternative zur Erstellung einer Spaltenzuordnung in to_hb_results() können Sie die Zuordnung in einem separaten Dictionary erstellen und nur den Dictionary-Namen in to_hb_results() angeben. Wenn Sie dieselben Anzeigenamen für mehrere Zieltabellen in „Ergebnisse“ erstellen müssen, ist dieser Ansatz effizienter. Sie geben den Anzeigenamen nur für das Feld in der Zielergebnistabelle an. Der Name des zugrunde liegenden Feldes in „Ergebnisse“ bleibt gleich. |
overwrite = True | False |
Wenn der Parameter weggelassen wird, werden gespeicherte Daten standardmäßig angehängt. |
Gibt zurück
Im Erfolgsfall lautet der Rückgabecode 202. Bei einem Fehler wird die Fehlermeldung ausgegeben.
Beispiele
Datenrahmen in eine Ergebnisse-App-Tabelle speichern
Sie speichern den Datenrahmen customer_summary in die Ergebnisse-App-Tabelle mit der ID 587293. Bestehende Datensätze in der Ergebnisse-App-Tabelle werden überschrieben.
customer_summary.to_hb_results(table_id = "587293", overwrite = True)
Datenrahmen speichern und Feldanzeigenamen in „Ergebnisse“ erstellen
Sie speichern den Datenrahmen customer_summary in die Ergebnisse-App-Tabelle mit der ID 587293. Gleichzeitig erstellen Sie drei Anzeigenamen für Felder in der Zielergebnistabelle.
In der Ergebnisse-App:
- Das Feld No verwendet den Anzeigenamen Customer Number.
- Das Feld First verwendet den Anzeigenamen First Name.
- Das Feld Last verwendet den Anzeigenamen Last Name.
customer_summary.to_hb_results(table_id = "587293", column_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}, overwrite = True)
Mehrere Datenrahmen speichern und Feldanzeigenamen mit einem bereits vorhandenen Dictionary erstellen
Sie verwenden ein einzelnes Dictionary-Objekt (display_names), um dieselben Anzeigenamen in drei Ergebnistabellen zu erstellen.
display_names = {"No":"Customer Number", "First":"First Name", "Last":"Last Name"}
customer_summary_us.to_hb_results(table_id = "587293", column_names = display_names, overwrite = True)
customer_summary_eu.to_hb_results(table_id = "587294", column_names = display_names, overwrite = True)
customer_summary_ap.to_hb_results(table_id = "587295", column_names = display_names, overwrite = True)
Bemerkungen
Zuordnung von Datentypen
Wenn Sie einen HCL-Datenrahmen in einer Tabelle in „Ergebnisse“ speichern, werden Spaltendatentypen im Datenrahmen automatisch den Felddatentypen in der Tabelle zugeordnet:
Spaltendatentyp in HCL-Datenrahmen | Felddatentyp in Ergebnistabelle |
---|---|
Objekt | Zeichen |
Kategorie | Zeichen |
int64 | numerisch |
float64 | numerisch |
datetime64[ns] | Datumzeit |
timedelta64[ns] | numerisch |
bool | logisch |
Automatisches Entfernen der Felder „metadata“ und „extras“
Wenn ein Datenanalyse-Workflow Daten von „Ergebnisse“ zu Robots und wieder zurück zu „Ergebnisse“ leitet, werden die Felder metadata und extras in einem HCL-Datenrahmen automatisch aus den Daten entfernt, die in „Ergebnisse“ gespeichert werden. Die Felder werden unabhängig davon entfernt, ob Sie den HCL-Datenrahmen wieder in derselben Tabelle in „Ergebnisse“ oder in einer neuen Tabelle speichern.
Die Felder metadata und extras werden vom System in „Ergebnisse“ generiert und sind geschützt. Wenn der Inhalt dieser Felder bearbeitbar ist, kann er nur in „Ergebnisse“ bearbeiten werden. Aus diesem Grund können Sie diese Felder nicht aus Robots überschreiben oder ergänzen.
Hinweis
Wenn Sie per Round-Trip zurückgeleitete Daten wieder in „Ergebnisse“ speichern, werden die Felder metadata und extras mit den gespeicherten Daten angezeigt. Dabei handelt es sich aber um neue Felder, die automatisch von „Ergebnisse“ erstellt werden. Sie sind nicht dieselben Felder wie in Robots.
Die folgenden metadata- und extras-Felder werden automatisch aus den gespeicherten Daten entfernt, wenn sie in Robots vorhanden sind:
-
metadata.priority
-
metadata.status
-
metadata.publish_date
-
metadata.publisher
-
metadata.assignee
-
metadata.group
-
metadata.updated_at
-
metadata.closed_at
-
extras.record_id
-
extras.collection
-
extras.results_table