publish() method
Enregistre un cadre de données Pandas ou HCL dans un ensemble de données du Centre d'activité.
Syntaxe
hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = True|False)
AC = Centre d'activité
Paramètres
| Nom | Description |
|---|---|
| dataframe_name |
Le nom du cadre de données Pandas ou HCL à enregistrer dans le Centre d'activité Toutes les colonnes du cadres de données sont enregistrées. Si vous souhaitez enregistrer uniquement une sélection de colonnes, créez d'abord un cadre de données correctement configuré, avant d'utiliser publish(). |
| nom_table = nom_ensemble_de_données_AC |
Le nom de l'ensemble de données du Centre d'activité. Remarque Examinez les noms des ensembles de données existants dans le Centre d'activité et assurez-vous de spécifier un nom d'ensemble de données unique. La méthode publish() ne vous empêche pas de spécifier un nom d'ensemble de données en doublon, ce qui peut créer une situation confuse dans le Centre d'activité. |
| column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} facultatif |
Un mappage entre un nom de colonne dans le cadre de données et un nom d'affichage pour le champ correspondant dans l'ensemble de données du Centre d'activité. Construisez le mappage pour une ou plusieurs colonnes à l'aide d'un dictionnaire Python standard. Vous spécifiez un nom d'affichage uniquement pour le champ dans l'ensemble de données du Centre d'activité. Le nom du champ sous-jacent dans le Centre d'activité reste inchangé. Vous pouvez choisir de spécifier des noms d'affichage pour uniquement un sous-ensemble de colonnes. Les colonnes sans nom d'affichage spécifié utilisent le nom de la colonne du cadre de données dans le Centre d'activité. Le paramètre noms_de_colonne ne détermine pas quelles colonnes sont enregistrées. Par défaut, la méthode publish() enregistre toutes les colonnes dans le cadre de données du Centre d'activité. Remarque Assurez-vous que les noms d'affiche spécifiés sont uniques. La méthode publish() ne vous empêche pas de spécifier un nom d'affichage en doublon. Cependant, cela entraîne l'échec de la publication dans le Centre d'activité. Pour plus d’informations, consultez la section Les noms de colonnes et les noms d'affichage doivent être uniques.. |
| noms_colonnes = objet_dictionnaire facultatif |
Un objet de dictionnaire pré-existant qui mappe un ou plusieurs noms de colonnes dans le cadre de données pour afficher les noms pour les champs correspondants dans l'ensemble de données du Centre d'activité. Plutôt que de créer le mappage de la colonne à l'intérieur de publish(), vous pouvez créer le mappage dans un dictionnaire distinct et spécifier uniquement le nom du dictionnaire dans publish(). Si vous devez créer le même jeu de noms d'affichage pour plusieurs tables de destination dans le Centre d'activité, cette approche est plus efficace. Les directives qui s'appliquent lors de la création d'un dictionnaire à l'intérieur de publish() s'appliquent également lors de la création d'un dictionnaire séparé. |
| append = True | False |
Si vous omettez le paramètre, les données enregistrées écrasent toutes les données existantes par défaut. |
Renvoie
En cas de succès, le code de retour 204. En cas d'échec, un message d'erreur.
Le code de retour 204 signifie que Robots a réussi à envoyer les données au Centre d'activité. Le traitement des données suivant dans le Centre d'activité doit également être réussi avant que les données envoyées depuis Robots ne soient disponibles en tant qu'ensemble de données dans le Centre d'activité.
Exemples
Enregistrer un cadre de données dans un ensemble de données du Centre d'activité
Vous enregistrez le cadre de données customer_summary dans un ensemble de données du Centre d'activité nommé Client. Si l'ensemble de données Client existe déjà dans le centre d'activité, les enregistrements existants sont écrasés.
hcl.publish(customer_summary, table_name = "Customer")
Remarques
Les noms de colonnes et les noms d'affichage doivent être uniques.
Pour publier avec succès des données depuis Robots vers le Centre d'activité, les noms des colonnes du cadre de données doivent être uniques. Un nom de colonne en doublon dans le cadre de données entraîne un message d'erreur et un échec de la méthode publish().
Si vous spécifiez des noms d'affichage pour les champs dans un ensemble de données du Centre d'activité, les noms d'affichage doivent également être uniques. Un nom d'affichage en doublon n'entraîne pas l'échec de la méthode publish(), et un script contenant la méthode s'exécute jusqu'à son terme.. Cependant, le traitement des données ultérieur échoue, et la publication dans le Centre d'activité n'est pas réussie.
Portée de la fonctionnalité de publication
Les permissions en écriture pour les ensembles de données du Centre d'activité créés par Robots sont basées sur le robot. Pour mettre à jour un ensemble de données, vous devez utiliser le même robot que celui ayant initialement créé l'ensemble de données. La méthode publish() ne prend pas en charge le franchissement des frontières de robot lors de la mise à jour des ensembles de données.
Ajout automatique des dates et des heures de publication
La méthode crossing publish() inclue automatiquement la date et l'heure de publication dans les données envoyées au Centre d'activité. Lorsque vous ajoutez les données sous forme de table à une analyse et à un tableau de bord dans le Centre d'activité, incluez le champ Publié à pour afficher la date et l'heure de la dernière publication, mises à jour dynamiquement, pour chaque enregistrement dans la table.
Ces informations sur l'horodatage sont utiles pour vérifier qu'une publication planifiée depuis Robots a été exécutée à la date et à l'heure attendues. Si vous ajoutez des enregistrements à un ensemble de données, les informations d'horodatage indiquent également quand chaque enregistrement a été ajouté, et vous permettent de trier par horodatage.
