外部データをアップロードする

概要

ダッシュボードでは、CSVファイルをアップロードして「外部データテーブル」を作成することで、HRMOSデータを元にした標準テーブルと含めて、テーブルとして一元管理することができます。

一元管理するテーブルを自由に組み合わせてデータセットを作成し、分析を行うことで、外部データとHRMOSデータを掛け合わせた分析が可能になります。

外部データテーブルは管理者権限ユーザーのみが操作可能です。作成した外部データテーブルは、作成者に限らず全ての管理者権限ユーザーが操作可能になります。

本記事では、外部データテーブルの作成方法、および利用方法について説明します。

目次

・外部データテーブルを作成する
・外部データテーブルにデータを追加する
・外部データテーブルのカラムを編集する
・外部データテーブルの名前を変更する
・外部データテーブルを削除する
・仕様
　・外部データテーブルの仕様
　・アップロードするCSVファイルの仕様
　・データ型の仕様
　・CSVファイルアップロード時に出るエラー

詳細

外部データテーブルを作成する

1. 「設定」タブ＞「テーブル管理」＞「外部データ」を開きます。画面右上、または、画面中央の「CSVアップロード」ボタンをクリックします。

2. アップロードしたいCSVファイルを選択し、「アップロード」ボタンをクリックします。

※CSVファイルは指定以外の形式はアップロードできません。また、アップロードに関して制限事項があります。詳細は＜こちら＞をご参照ください。

3. テーブル定義設定を行います。テーブル名、カラムごとのデータ型を設定後、「次」へボタンをクリックします。

※CSVファイルの1行目（ヘッダー情報）を元に、カラムを自動で抽出します。表示されたカラムごとにデータ型を選択してください。データ型の詳細は＜こちら＞をご参照ください。

4. アップロードするデータを確認し、問題なければ「追加」をクリックします。

5.アップロードしたCSVファイルの取り込みが開始されます。
アップロードに多少時間がかかるため、初期表示時は取り込み状況が「取り込み中」で表示される場合があります。

一定時間経過後、ブラウザをリロードして取り込み状況を再度確認してください。「完了」になれば、正常にアップロードが完了しています。

※アップロードでエラー発生した場合
エラーを確認し、CSVファイル内容を修正し、再度アップロードします。
CSVファイル取り込みでエラーが発生した場合、取り込み状況が「失敗」になります。

「詳細」をクリックすることで、エラー内容の詳細を確認できます。
当エラー詳細は、最大10行までのエラーを表示します。

詳細内容を確認し、CSVファイルのエラー箇所を修正して再度アップロードしてください。

外部データテーブルにデータを追加する

作成した外部データテーブルにCSVファイルをアップロードしてデータを追加できます。
勤怠データなど、他システムからダウンロードしたCSVファイルを月次でアップロードするような利用が可能です。

1. 「設定」タブ＞「データ管理」＞「外部データ」を開きます。データを追加したい外部データテーブルを選択します。

2. 画面右上の「CSVアップロード」ボタンをクリックします。

3. 追加したいCSVファイルを選択し、「アップロード」ボタンをクリックします。
外部データテーブルで設定したカラム名と、追加するCSVファイル1行目ヘッダー情報において、カラム名とカラム順が一致する必要があります。

4. アップロードするデータを確認後に「追加」ボタンをクリックし、取り込みが正常に完了したことを確認します。
以降は、外部データテーブル作成と同様に操作してください。

2024年11月のアップデートにより、外部データテーブルのカラム順と、CSVファイルのカラム順に差異があっても、データを追加できるようになりました。
カラム名は一致している必要がありますので、CSVファイルのアップロード前にカラム名が一致しているか、確認するようにしてください。

外部データテーブルのカラムを編集する（2024年11月アップデート）

外部データテーブルの作成後に外部データのフォーマットが変わった場合、カラムの追加・カラム名の変更を行うことができます。
以下の手順を参考に、テーブル情報の編集から、カラムの編集を行なってください。
※ 本手順は、変更後のCSVアップロードを行う前に行なってください。

なお、カラムの削除・カラムのデータ型の変更は、分析に影響を与えるため、編集できません。
カラムの削除・カラムのデータ型の変更が必要な場合は、再度、外部データテーブルを作成してください。

2024年11月のアップデートにより、外部データテーブルで定義したカラムがCSVファイルに含まれていなくても、そのままデータを追加できるようになりました。
※CSVファイルに含まれていないカラムは、NULL値が登録されます。
カラムの削除はできませんが、カラムの削除をせずともデータの追加ができますので、外部データの仕様変更時などでご利用ください。

1. 変更したい外部データテーブルを選択する
テーブル管理 > 外部データより、変更したい外部データテーブルを選択します。
「テーブル情報」を選択し、画面右上の鉛筆アイコンを選択します。

2. カラム情報を編集する
カラムを追加したい場合は、カラム一覧の下部にある「カラムを追加」を選択します。
追加したいカラムのカラム名を入力、データ型を指定して、「保存」を選択します。

カラム名を変更したい場合は、直接カラム名を修正し、「保存」を選択します。

3. カラム情報が変更されていることを確認する
テーブル情報に変更したカラムの内容が表示されていることを確認してください。

これでカラムの変更は完了となります。
変更後のカラム情報と合致していることを確認のうえ、外部データのCSVアップロードを行なってください。

外部データテーブルの名前を変更する

外部データテーブルの作成後に、テーブル名・説明を変更することもできます。

1. 「設定」タブ＞「データ管理」＞「外部データ」を開きます。編集したい外部データテーブルを選択します。

2. 左メニューから「テーブル情報」をクリックし、現在のテーブル名を確認します。

3. 画面右上の 鉛筆マークをクリックします。

4. テーブル名を変更し、画面右下の「保存」ボタンをクリックします。

外部データテーブルを削除する

作成した外部データテーブルは削除できます。

データテーブルは残したまま、データのみを削除することも可能です。
外部データのデータを削除する方法については、＜こちら＞をご確認ください。

1.「設定」タブ ＞「データ管理」＞「外部データ」を開きます。削除したい外部データテーブルを選択します。

2. 画面右上の三点リーダーから、「テーブルを削除」ボタンをクリックします。

削除して問題ない場合は、「削除」をクリックします。

なお、該当外部データテーブルをデータセットで使用している場合は、下記メッセージが表示され、削除できません。削除したい場合は、先に対象データセットを削除してください。

仕様

外部データテーブルを作成するにあたっての仕様や制限事項をまとめています。

外部データテーブルの仕様

アップロードするCSVファイルの仕様

データ型の仕様

CSVファイルアップロード時に出るエラーと対処法