RobotsMetodo publish()
Viene salvato un dataframe HCL in un set di dati del Centro attività.
Sintassi
hcl.publish(dataframe_name, table_name = AC_dataset_name, column_names = {"column_name":"dataset_display_name", "...n":"...n"}|dictionary_object, append = True|False)
AC = Centro attività
Parametri
| Nome | Descrizione |
|---|---|
| dataframe_name | Il nome del dataframe Pandas o HCL da salvare in Centro attività. Tutte le colonne nel dataframe vengono salvate. Se si desidera salvare solo una selezione delle colonne, creare prima un dataframe configurato in modo appropriato, prima di usare publish(). |
| table_name = AC_dataset_name | Il nome del set di dati del Centro attività. Nota Esaminare i nomi dei set di dati esistenti in Centro attività e assicurarsi di specificare un nome unico per il set di dati. Per gli script che intendi attivare in modalità di produzione, devi creare nomi diversi per i set di dati di sviluppo e di produzione. |
| column_names = {"column_name" : "dataset_display_name", "...n" : "...n"} opzionale | Una mappatura tra un nome di colonna nel dataframe e un nome visualizzato per il campo corrispondente nel set di dati di Centro attività. Costruire la mappatura per una o più colonne utilizzando un dizionario Python standard. Si sta specificando un nome visualizzato solo per il campo nel set di dati di Centro attività di destinazione. Il nome del campo sottostante in Centro attività rimane invariato. È possibile scegliere di specificare i nomi di visualizzazione solo per un sottoinsieme di colonne. Le colonne senza nome di visualizzazione specificato utilizzano il nome della colonna del dataframe in Centro attività. Il parametro column_names non seleziona le colonne da salvare. Per impostazione predefinita, il metodo publish() salva tutte le colonne del dataframe in Centro attività. |
| column_names = dictionary_object opzionale | Un oggetto dizionario preesistente che mappa uno o più nomi di colonna nel dataframe per visualizzare i nomi dei campi corrispondenti in Risultati. In alternativa alla creazione della mappatura delle colonne all'interno di publish(), è possibile creare la mappatura in un dizionario separato e specificare solo il nome del dizionario all'interno di publish(). Se è necessario creare lo stesso set di nomi visualizzati per più set di dati di destinazione in Centro attività, questo approccio è più efficiente. Le linee guida che si applicano quando si crea un dizionario all'interno di publish() si applicano anche quando si crea un dizionario separato. |
| ascending = True | False |
Se si omette il parametro, i dati salvati sovrascrivono tutti i dati esistenti per impostazione predefinita. |
Restituisce
In caso di operazione riuscita, il codice restituito è 204. In caso di errore, un messaggio di errore.
Il codice di ritorno 204 significa che Robot ha inviato correttamente i dati a Centro attività. Anche la successiva elaborazione dei dati in Centro attività deve avvenire correttamente prima che i dati inviati da Robot siano disponibili come set di dati in Centro attività.
Esempi
Salvare un dataframe in un set di dati del Centro attività
Si salva il dataframe customer_summary in un set di dati di Centro attività denominato Customer. Se il set di dati Customer esiste già in Centro attività, i record esistenti vengono sovrascritti.
hcl.publish(customer_summary, table_name = "Customer")
Osservazioni
Evitare i set di dati del Centro attività con nomi duplicati
Il metodo publish() e il Centro attività non impediscono la pubblicazione di set di dati con nomi duplicati o identici. I set di dati con lo stesso nome creano confusione nel Centro attività.
Nel Centro attività, due situazioni diverse possono portare a set di dati con nomi identici:
Il metodo publish() con un set di dati dal nome identico viene eseguito in due robot diversi.
Il metodo publish() con un set di dati dal nome identico viene eseguito sia in modalità sviluppo sia in modalità produzione nello stesso robot.
Per evitare di creare nomi di set di dati duplicati:
Specifica un nome univocoPrima di specificare il nome di un set di dati nel parametro table_name, controlla i nomi dei set di dati esistenti nel Centro attività. Assicurati di specificare un nome di set di dati che sia univoco.
Usa nomi diversi per i set di dati di sviluppo e di produzioneIn modalità sviluppo, usa un nome di set di dati di sviluppo nel parametro table_name. Prima di attivare una versione dello script in modalità di produzione, aggiorna il parametro table_name per utilizzare un nome di set di dati di produzione.
Ad esempio, aggiorna table_name = "Customer_dev" a table_name = "Customer".
Nota
Per progettazione, la modalità di sviluppo e la modalità di produzione separano i dati memorizzati nei robot. Questa separazione impedisce la modifica o la cancellazione involontaria dei dati di produzione da parte di qualsiasi azione o script in modalità di sviluppo. Ciò significa che le tabelle, i dataframe o i set di dati che vengono nominati in modo identico nelle due modalità sono oggetti completamente separati e non hanno alcun legame tra loro.
Per ulteriori informazioni, consulta Modalità di sviluppo e modalità di produzione in Robot.
Il nome delle colonne e di visualizzazione devono essere univoci
Per pubblicare correttamente i dati da Robot a Centro attività, i nomi delle colonne del dataframe devono essere univoci. Un nome di colonna duplicato in un dataframe causa il fallimento del metodo publish() con un messaggio di errore.
Se si specificano i nomi di visualizzazione per i campi di un set di dati del Centro attività, anche i nomi di visualizzazione devono essere univoci. Un nome di visualizzazione duplicato in un set di dati non causa il fallimento del metodo publish() e uno script contenente il metodo viene eseguito fino al completamento. Tuttavia, l'elaborazione successiva dei dati non riesce e la pubblicazione nel Centro attività non va a buon fine.
Ambito della capacità di pubblicazione
Le autorizzazioni di scrittura per i set di dati del Centro attività creati da Robot sono basate sul robot. Per aggiornare un set di dati, è necessario utilizzare lo stesso robot che ha creato inizialmente il set di dati. Il metodo publish() non supporta l'attraversamento dei confini dei robot durante l'aggiornamento dei set di dati.
Aggiunta automatica della data e dell'ora di pubblicazione
Il metodo publish() include automaticamente la data e l'ora di pubblicazione con i dati inviati a Centro attività. Quando si aggiungono i dati come una tabella a un'analisi e a una dashboard in Centro attività, includere il campo Pubblicato alle ore per visualizzare la data e l'ora di pubblicazione più recente, aggiornata dinamicamente, per ogni record della tabella.
Queste informazioni sulla marca temporale sono utili per verificare che una pubblicazione pianificata da Robot sia stata eseguita alla data e all'ora previste. Se si aggiungono record a un set di dati, le informazioni sulla marca temporale mostrano anche quando ogni record è stato aggiunto e permettono di ordinare per marca temporale.
