publish() method
Speichert einen Pandas- oder HCL-Datenrahmen in einem Activity Center-Datenset.
Syntax
hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = True|False)
AC = Activity Center
Parameter
| Name | Beschreibung |
|---|---|
| dataframe_name |
Der Name des Pandas- oder HCL-Datenrahmens, der im Activity Center gespeichert werden soll. Alle Spalten im Datenrahmen werden gespeichert. Wenn Sie nur eine Auswahl der Spalten speichern möchten, erstellen Sie zunächst einen entsprechend konfigurierten Datenrahmen, bevor Sie publish() verwenden. |
| table_name = AC_dataset_name |
Der Name des Activity Center-Datensets Hinweis Überprüfen Sie die Namen der vorhandenen Datensets im Activity Center und stellen Sie sicher, dass Sie einen eindeutigen Datensetnamen angeben. Die publish()-Methode verhindert nicht, dass Sie einen doppelten Datensetnamen angeben, was zu einer verwirrenden Situation im Activity Center führen kann. |
| column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} Optional |
Eine Zuordnung zwischen einem Spaltennamen im Datenrahmen und einem Anzeigenamen für das entsprechende Feld im Activity Center-Datenset. 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 im Activity Center-Zieldatenset an. Der Name des zugrunde liegenden Feldes im Activity Center bleibt gleich. Sie können auswählen, ob Anzeigenamen nur für eine Teilmenge von Spalten angegeben werden sollen. Spalten ohne einen bestimmten Anzeigenamen verwenden den Spaltennamen des Datenrahmens im Activity Center. Der Parameter column_names wählt nicht aus, welche Spalten gespeichert werden. Standardmäßig speichert die publish()-Methode alle Spalten im Datenrahmen im Activity Center. Hinweis Achten Sie darauf, dass die von Ihnen angegebenen Anzeigenamen eindeutig sind. Die publish()-Methode verhindert nicht, dass Sie einen doppelten Anzeigenamen angeben. Allerdings schlägt die Veröffentlichung im Activity Center fehl. Weitere Informationen finden Sie unter Spalten- und Anzeigenamen müssen eindeutig sein.. |
| column_names = dictionary_object Optional |
Ein bereits vorhandenes Dictionary-Objekt, das Spaltennamen im Datenrahmen Anzeigenamen für die entsprechenden Felder im Activity Center zuordnet. Als Alternative zur Erstellung einer Spaltenzuordnung in publish() können Sie die Zuordnung in einem separaten Dictionary erstellen und in publish() nur den Dictionary-Namen angeben. Wenn Sie dieselben Anzeigenamen für mehrere Zieldatensets im Activity Center erstellen müssen, ist dieser Ansatz effizienter. Die Richtlinien, die für die Erstellung eines Dictionarys innerhalb von publish() gelten, gelten auch für die Erstellung eines separaten Dictionarys. |
| append = True | False |
Wenn Sie den Parameter weglassen, überschreiben gespeicherte Daten standardmäßig alle vorhandenen Daten. |
Gibt zurück
Im Erfolgsfall lautet der Rückgabecode 204. Bei einem Fehler wird eine Fehlermeldung ausgegeben.
Der Rückgabecode 204 bedeutet, dass Robots die Daten erfolgreich an das Activity Center gesendet hat. Die anschließende Datenverarbeitung im Activity Center muss ebenfalls erfolgreich sein, bevor die von Robots gesendeten Daten als Datenset im Activity Center verfügbar sind.
Beispiele
Einen Datenrahmen in einem Activity Center-Datenset speichern
Sie speichern den Datenrahmen customer_summary in einem Activity Center-Datenset namens Kunde. Wenn das Datenset Kunde bereits im Activity Center vorhanden ist, werden vorhandene Datensätze überschrieben.
hcl.publish(customer_summary, table_name = "Kunde")
Bemerkungen
Spalten- und Anzeigenamen müssen eindeutig sein.
Um Daten von Robots erfolgreich im Activity Center zu veröffentlichen, müssen die Spaltennamen im Datenrahmen eindeutig sein. Ein doppelter Spaltenname in einem Datenrahmen führt dazu, dass die publish()-Methode mit einer Fehlermeldung fehlschlägt.
Wenn Sie Anzeigenamen für Felder in einem Activity Center-Datenset angeben, müssen die Anzeigenamen ebenfalls eindeutig sein. Ein doppelter Anzeigename führt nicht dazu, dass die publish()-Methode fehlschlägt, und ein Skript, das die Methode enthält, wird vollständig ausgeführt. Die anschließende Datenverarbeitung schlägt jedoch fehl und die Veröffentlichung im Activity Center ist nicht erfolgreich.
Umfang der Veröffentlichungsfunktion
Schreibberechtigungen für Activity Center-Datensets, die von Robots erstellt wurden, sind robotbasiert. Um ein Datenset zu aktualisieren, müssen Sie denselben Robot verwenden, der das Datenset ursprünglich erstellt hat. Die publish()-Methode unterstützt keine Überschreitung von Robot-Grenzen bei der Aktualisierung von Datensets.
Automatische Ergänzung von Datum und Uhrzeit der Veröffentlichung
Die publish()-Methode fügt automatisch das Datum und die Uhrzeit der Veröffentlichung zu den an das Activity Center gesendeten Daten hinzu. Wenn Sie die Daten als Tabelle zu einer Analyse und einem Dashboard im Activity Center hinzufügen, fügen Sie das Feld Veröffentlicht am hinzu, um das neueste Datum und die Uhrzeit der Veröffentlichung für jeden Datensatz in der Tabelle dynamisch aktualisiert anzuzeigen.
Diese Zeitstempelinformationen sind nützlich, um zu überprüfen, ob eine geplante Veröffentlichung von Robots zum erwarteten Datum und Zeitpunkt ausgeführt wurde. Wenn Sie Datensätze an ein Datenset anhängen, wird in den Zeitstempelinformationen auch angezeigt, wann jeder Datensatz angehängt wurde, und Sie können nach Zeitstempel sortieren.
