publish()-methode
Slaat een Pandas- of HCL-dataframe op in een Activiteitencentrum-dataset.
Syntaxis
hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = Waar|Onwaar)
AC = Activiteitencentrum
Parameters
| Naam | Beschrijving |
|---|---|
| dataframe_name |
De naam van het Pandas- of HCL-dataframe dat moet worden opgeslagen in het Activiteitencentrum. Alle kolommen in het dataframe worden opgeslagen. Als u slechts een selectie van de kolommen wilt opslaan, maakt u eerst een op de juiste manier geconfigureerd dataframe voordat u publish() gebruikt. |
| table_name = AC_dataset_name |
De naam van de Activiteitencentrum-dataset. Opmerking Controleer de namen van bestaande datasets in het Activiteitencentrum en zorg ervoor dat u een unieke datasetnaam opgeeft. De publish()-methode voorkomt niet dat u een dubbele datasetnaam opgeeft, wat verwarrende situaties in het Activiteitencentrum kan veroorzaken. |
| column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} optioneel |
Een toewijzing tussen een kolomnaam in het dataframe en een weergavenaam voor het overeenkomstige veld in de Activiteitencentrum-dataset. Maak de toewijzing voor een of meer kolommen met behulp van een standaard Python-dictionary. U geeft alleen een weergavenaam op voor het veld in de Activiteitencentrum-dataset van het doel. De onderliggende veldnaam in Activiteitencentrum blijft ongewijzigd. U kunt ervoor kiezen om weergavenamen alleen voor een subset van kolommen op te geven. Kolommen zonder opgegeven weergavenaam gebruiken de dataframekolomnaam in het Activiteitencentrum. Met de parameter column_names wordt niet geselecteerd welke kolommen worden opgeslagen. Standaard slaat de publish()-methode alle kolommen in het dataframe op in het Activiteitencentrum. Opmerking Zorg ervoor dat de weergavenamen die u opgeeft, uniek zijn. De publish()-methode voorkomt niet dat u een dubbele weergavenaam opgeeft. Publicatie naar het Activiteitencentrum mislukt echter. Voor meer informatie raadpleegt u Kolom- en weergavenamen moeten uniek zijn. |
| column_names = dictionary_object optioneel |
Een vooraf bestaand woordenboekobject dat een of meer kolomnamen in het dataframe koppelt aan weergavenamen voor de bijbehorende velden in de Activiteitencentrum-dataset. Als alternatief voor het maken van de kolomtoewijzing in publish(), kunt u de toewijzing in een afzonderlijk woordenboek maken en alleen de naam van het woordenboek opgeven in publish(). Als u dezelfde set weergavenamen voor meerdere doeldatasets in Activity Center moet maken, is deze aanpak efficiënter. De richtlijnen die gelden bij het maken van een woordenboek in publish(), gelden ook bij het maken van een afzonderlijk woordenboek. |
| append = Waar | Onwaar |
Als u de parameter weglaat, worden bestaande gegevens standaard overschreven door opgeslagen gegevens. |
Retourneert
Voor succes is de retourcode 204. Voor een fout, een foutmelding.
De retourcode 204 betekent dat Robots de gegevens succesvol naar het Activiteitencentrum heeft verzonden. Ook de daaropvolgende gegevensverwerking in het Activiteitencentrum moet succesvol zijn voordat de door Robots verzonden gegevens als dataset in het Activiteitencentrum beschikbaar zijn.
Voorbeelden
Een dataframe opslaan in een Activiteitencentrum-dataset
U slaat het dataframe customer_summary op in een Activiteitencentrum-dataset met de naam Klant. Als de dataset Klant al bestaat in het Activiteitencentrum, worden bestaande records overschreven.
hcl.publish(customer_summary, table_name = "Customer")
Opmerkingen
Kolom- en weergavenamen moeten uniek zijn
Om gegevens van Robots naar het Activiteitencentrum succesvol te kunnen publiceren, moeten de kolomnamen in het dataframe uniek zijn. Een dubbele kolomnaam in een dataframe zorgt ervoor dat de publish()-methode mislukt en er een foutmelding verschijnt.
Als u weergavenamen opgeeft voor velden in een Activiteitencentrum-dataset, moeten de weergavenamen ook uniek zijn. Een dubbele weergavenaam zorgt er niet voor dat de publish()-methode mislukt en dat een script dat de methode bevat, wordt voltooid. De verdere gegevensverwerking mislukt echter en de publicatie naar het Activiteitencentrum is niet succesvol.
Omvang van de publicatiemogelijkheid
Schrijfrechten voor Activiteitencentrum-datasets die zijn gemaakt met Robots zijn robotgebaseerd. Om een dataset bij te werken, moet u dezelfde robot gebruiken die de dataset oorspronkelijk heeft gemaakt. De publish()-methode ondersteunt het overschrijden van robotgrenzen niet bij het bijwerken van datasets.
Automatische toevoeging van publicatiedatum en -tijd
De methode publish() voegt automatisch de datum en tijd van publicatie toe aan de gegevens die naar het Activiteitencentrum worden verzonden. Wanneer u de gegevens als een tabel toevoegt aan een analyse en een dashboard in het Activiteitencentrum, voegt u het veld Gepubliceerd op toe om de meest recente publicatiedatum en -tijd, dynamisch bijgewerkt, voor elke record in de tabel weer te geven.
Deze tijdstempelinformatie is handig om te verifiëren of een geplande publicatie van Robots op de verwachte datum en tijd is uitgevoerd. Als u records aan een dataset toevoegt, wordt in de tijdstempelinformatie ook weergegeven wanneer elk record is toegevoegd. U kunt de gegevens ook sorteren op tijdstempel.
