publish() メソッド

Pandas または HCL データフレームをアクティビティ センター データセットに保存します。

構文

hcl.publish（データフレーム名, table_name = AC データセット名, column_names = {"列名":"データセット表示名", "...n":"...n"}|ディクショナリ オブジェクト, append = True|False）

AC = アクティビティ センター

パラメーター

名前	説明
dataframe_name	アクティビティ センターに保存する Pandas または HCL データフレームの名前。 データフレーム内のすべての列が保存されます。選択した列のみを保存する場合は、publish() を使用する前に、まず適切に構成されたデータフレームを作成します。
table_name = AC データセット名	アクティビティ センター データセットの名前。 メモ アクティビティ センターで既存のデータセットの名前を確認し、一意のデータセット名を指定してください。publish() メソッドでは、重複するデータセット名を指定することを防ぐことはできません。これにより、アクティビティ センターで混乱を招く可能性があります。
column_names = {"列名" : "データセット表示名", "...n" : "...n"} 省略可能	データフレーム内の列名と、アクティビティ センターのデータセットの対応するフィールドの表示名とのマッピング。 標準 Python ディクショナリを使用して、1 つ以上の列のマッピングを作成します。 表示名を指定するのは、宛先のアクティビティ センターのデータセットのフィールドのみです。アクティビティ センターのデータセットの基本のフィールド名は変更されません。 列のサブセットのみの表示名を指定するように選択できます。表示名が指定されていない列は、アクティビティ センター内のデータフレーム列名を使用します。 column_names パラメーターは、保存する列を選択しません。デフォルトでは、publish() メソッドは、データフレーム内のすべての列をアクティビティ センターに保存します。 メモ 指定する表示名が一意であることを確認してください。publish() メソッドでは、重複する表示名を指定することを防ぐことはできません。ただし、アクティビティ センターへの公開は失敗します。 詳細については、「列名と表示名は一意である必要があります」を参照してください。
column_names = ディクショナリ オブジェクト 省略可能	データフレーム内の 1 つ以上の列名を、アクティビティ センターのデータセット内の対応するフィールドの表示名にマッピングする、既存のディクショナリオブジェクト。 publish() 内で列マッピングを作成する代わりに、別のディクショナリでマッピングを作成し、publish() 内でのみディクショナリ名を指定できます。アクティビティ センターの複数の宛先データセットに対して同じ表示名のセットを作成する必要がある場合は、この方法がより効率的です。 publish() 内でディクショナリを作成するときに適用されるガイドラインは、別のディクショナリを作成するときにも適用されます。
append = True | False	True 保存されたデータはアクティビティ センターのデータセットの既存のデータの最後に追加されます。 False 保存されたデータはアクティビティ センターのデータセットの既存のデータを上書きします。 このパラメーターを省略した場合、デフォルトでは、保存されたデータは既存のデータを上書きします。

戻り値

成功した場合、戻りコードは 204 です。失敗した場合、エラー メッセージ発生します。

リターン コード 204 は、ロボットがデータをアクティビティ センターに正常に送信したことを意味します。ロボットから送信されたデータをアクティビティ センターのデータセットとして利用できるようになるには、その後のアクティビティ センターでのデータ処理も成功する必要があります。

例

備考

列名と表示名は一意である必要があります

ロボットからアクティビティ センターにデータを正常に公開するには、データフレームの列名が一意である必要があります。データフレーム内の列名が重複すると、publish() メソッドが失敗し、エラーメッセージが表示されます。

アクティビティ センター データセットのフィールドに表示名を指定する場合、それぞれの表示名も一意である必要があります。表示名が重複しても publish() メソッドは失敗せず、メソッドを含むスクリプトは完了まで実行されます。ただし、後続のデータ処理は失敗し、アクティビティ センターへの公開は成功しません。

公開機能のスコープ

ロボットから作成されたアクティビティ センター データセットの書き込みアクセス許可は、ロボットベースです。データセットを更新するには、データセットを最初に作成したのと同じロボットを使用する必要があります。publish() メソッドは、データセットを更新するときにロボットの境界を越えることをサポートしていません。

公開日時の自動追加

publish() メソッドは、アクティビティ センターに送信されるデータに公開日時を自動的に含めます。アクティビティ センターの分析およびダッシュボードにデータをテーブルとして追加する場合は、［公開日時］フィールドを含めると、テーブル内の各レコードの最新の公開日時が動的に更新されます。

このタイムスタンプ情報は、ロボットからのスケジュールされた公開が、予定された日時に実行されたことを確認するのに役立ちます。データセットにレコードを追加すると、タイムスタンプ情報には各レコードがいつ追加されたかも表示され、タイムスタンプで並べ替えることができます。