Robotspublish()-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 = True|False)
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. Voor scripts die u in de productiemodus wilt activeren, moet u verschillende namen voor ontwikkelings- en productiegegevenssets maken. |
| 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. |
| 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
Gegevenssets met dubbele namen voor Activiteitencentrum vermijden
De methode publish() en het Activiteitencentrum verhinderen niet dat gegevenssets met dubbele of identieke namen worden gepubliceerd. Gegevenssets met dezelfde naam zorgen voor een verwarrende situatie in Activiteitencentrum.
Er zijn twee verschillende situaties die kunnen leiden tot gegevenssets met identieke namen in Activiteitencentrum:
De methode publish() met een gegevensset met een identieke naam wordt in twee verschillende robots uitgevoerd.
De methode publish() met een gegevensset met een identieke naam wordt zowel in de ontwikkelmodus als in de productiemodus in dezelfde robot uitgevoerd.
U voorkomt als volgt dat u dubbele namen voor gegevenssets maakt:
Een unieke naam opgevenVoordat u een naam voor een gegevensset opgeeft in de parameter Table_name controleert u de namen van bestaande gegevenssets in Activiteitencentrum. Zorg ervoor dat u een unieke naam voor de gegevensset opgeeft.
Gebruik verschillende namen voor gegevenssets voor ontwikkeling en voor productieGebruik in de ontwikkelingsmodus een naam voor de ontwikkelingsgegevensset in de parameter table_name. Voordat u een scriptversie activeert in de productiemodus, moet u de parameter table_name bijwerken om een naam voor de productiegegevensset te gebruiken.
Bijvoorbeeld, werk table_name = "Customer_dev" bij naar table_name = "Customer".
Opmerking
Ontwikkelmodus en productiemodus scheiden standaard gegevens die binnen Robots zijn opgeslagen. Deze scheiding voorkomt onbedoelde wijziging of verwijdering van productiegegevens door een actie of script in de ontwikkelingsmodus. Hierdoor zijn tabellen, of dataframes of gegevenssets met identieke namen in de twee modi volledig gescheiden objecten zonder verbinding met elkaar.
Raadpleeg voor meer informatie Ontwikkelingsmodus en productiemodus in Robots.
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 in een gegevensset zorgt er niet voor dat de methode publish() 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.
