Robotspublish()-Methode
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. Für Skripte, die Sie im Produktionsmodus aktivieren möchten, müssen Sie unterschiedliche Namen für Entwicklungs- und Produktions-Datensets erstellen. |
| 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. |
| 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
Activity Center-Datensets mit doppelten Namen vermeiden
Die Methode publish() und das Activity Center verhindern nicht, dass Datensets mit doppelten oder identischen Namen veröffentlicht werden. Datensets mit demselben Namen führen zu Verwirrung im Activity Center.
Zwei verschiedene Situationen können zu Datensets mit identischen Namen im Activity Center führen:
Die Methode publish() wird mit einem Datenset mit identischem Namen in zwei verschiedenen Robots ausgeführt.
Die Methode publish() wird mit einem identischen Datenset sowohl im Entwicklungsmodus als auch im Produktionsmodus im selben Robot ausgeführt.
So vermeiden Sie doppelte Datensetnamen:
Geben Sie einen eindeutigen Namen an.Bevor Sie einen Datensetnamen im Parameter table_name angeben, prüfen Sie die Namen der vorhandenen Datensets im Activity Center. Stellen Sie sicher, dass Sie einen eindeutigen Datensetnamen angeben.
Verwenden Sie unterschiedliche Namen für Entwicklungs- und Produktions-Datensets.Verwenden Sie im Entwicklungsmodus einen Namen für ein Entwicklungs-Datenset im Parameter table_name. Bevor Sie eine Skriptversion im Produktionsmodus aktivieren, aktualisieren Sie den Parameter table_name, um einen Produktions-Datensetnamen zu verwenden.
Aktualisieren Sie beispielsweise table_name = "Customer_dev" zu table_name = "Customer".
Hinweis
Entwicklermodus und Produktionsmodus trennen Daten, die innerhalb von Robots gespeichert werden. Diese Trennung verhindert, dass Produktionsdaten durch Aktionen oder Skripte im Entwicklungsmodus versehentlich geändert oder gelöscht werden. Das bedeutet, dass Tabellen, Datenrahmen oder Datensets, die in beiden Modi identisch benannt sind, vollständig getrennte Objekte sind, die keine Verbindung zueinander haben.
Weitere Informationen finden Sie unter Entwicklungsmodus und Produktionsmodus in der Robots-App.
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 in einem Datenset 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.
