お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Zoho DataPrepでは、クラウドストレージサービスのBoxからデータをインポートできます。Boxでは、ファイルの保存や共同編集、安全な管理を、あらゆるデバイスからアクセス可能なオンラインフォルダーシステム上で行えます。

メモ：Boxクラウドストレージは、CNデータセンターを除くすべてのデータセンターで利用できます。

Boxからデータをインポートするには

1. ［ホーム］ページ、［パイプライン］タブ、または［ワークスペース］タブから、既存のパイプラインを開くか、［パイプラインを作成］し、［データを追加］をクリックします。

情報：パイプラインビルダー上部の［データをインポート］アイコンをクリックして、複数のデータ元からパイプラインにデータを取り込むこともできます。

メモ：以前にBoxの接続を追加している場合は、左側の欄から［保存済みの接続］カテゴリーをクリックして、インポートに進みます。保存済みの接続の詳細については、［こちら］をクリックしてください。

メモ：新しいBoxアカウントを追加するには、［新しく追加］リンクをクリックします。Boxの接続は必要な数だけ作成できます。

4. Boxアカウントを認証します。初回は、Zoho DataPrepによるファイルへのアクセスを許可する必要があります。

メモ：接続設定は、今後Boxからインポートする際に使用できるよう保存されます。認証情報は安全に暗号化して保存されます。

5. インポートするファイルを選択し、［インポート］ボタンをクリックします。［詳細選択］オプションを使用して、特定のパターンに一致するファイルをインポートすることもできます。詳細については、［こちらをクリックしてください］。

情報：Boxで新しく作成したファイルが検索結果に反映されるまで、10分ほどかかります。

 

メモ：Boxの共有フォルダーからファイルをインポートすることもできます。共有ファイルは、［マイドライブ］タブにも表示されます。

7. 追加入力が必要なファイルがある場合、パイプラインビルダーのヘッダーに［対応が必要］インジケーターが表示されます。注意が必要な各ファイルの一覧を表示するには、［対応が必要］をクリックして［インポート］パネルを開きます。ファイルごとに、次の操作を行います。

• ファイルがパスワードで保護されている場合は、表示された項目にパスワードを入力します。
• ファイルに複数のシートが含まれている場合は、インポートするシートを選択し、［インポート］をクリックします。

HTML、XLS、XLSXファイルの場合は、［プレビュー］をクリックしてデータのサンプルを確認できます。

9. データフローの作成と、ステージへの必要な変換の適用が完了したら、ステージを右クリックして［出力先を追加］し、データフローを完成させます。

メモ：パイプラインに出力先を追加したら、まず手動実行でパイプラインを実行できます。手動実行が正常に動作することを確認した後、パイプラインを自動化するスケジュールを設定できます。実行方法の種類について詳しくは、こちらをご覧ください。

詳細選択

1.  ［詳細選択］リンクをクリックします。

詳細選択では、正規表現に基づいてファイルを動的に選択できます。これにより、Boxアカウントから新規データまたは増分データを取得できます。指定したデータ間隔内に追加または変更され、ファイルパターンに一致するファイルがBoxアカウントから取得されます。増分取得について詳しくは、こちらをご覧ください。

重要：詳細選択は、増分取得だけに使用するものではありません。ファイルパターンに基づいてファイルを一括インポートする場合にも使用できます。

2. 次の詳細を入力します。

• ［フォルダーのパス］：ファイルを検索するフォルダーのパスです。例：2023/
  
  ファイルがフォルダーに格納されず、ドライブ直下に保存されている場合は、この項目を空欄にできます。

  

  ［フォルダーのパス］はディレクトリパスの項目であり、正規表現には対応していません。
  情報：フォルダーのパスでは、大文字と小文字が区別されます。
  メモ：Boxで新しく作成したファイルがDataPrepのインポート時に反映されるまで、最大10分かかります。

• ［サブフォルダーを含める］：ファイルの検索時にサブフォルダーも対象にする場合は、［サブフォルダーを含める］チェックボックスを選択します。
  

• ［ファイルパターン］：アカウント内のファイル名との照合に使用するパターンです。正規表現形式の照合に対応しています。指定したパス内のすべてのファイルに一致させるには、パターン「.*」を使用できます。
  情報：ファイルパターンでは、大文字と小文字が区別されます。

メモ：ファイルパターンの照合には、簡易的な正規表現が使用されます。たとえば、Sales_2022.csv、Sales_2023.csv、Sales_2024.csvなどのファイル名を持つファイルを取得するには、パターンとしてSales_.*を入力します。

同様に、PublicData1.csv、PublicData2.csv、PublicData3.csvなどのファイルを取得するには、Public.*を使用します。

1つのファイルのみをインポートする場合は、正確なファイル名を使用してパターンを指定します。
例：leads_jan_2022.*

• 
  ［ファイルのパスワード］：ファイルがパスワードで保護されている場合は、パスワードを入力します。
  

• ［ファイルを統合してインポート］-指定したパターンに一致するすべてのファイルを統合し、1つのデータセットとしてインポートします。
  

重要：このオプションを使用すると、インポート後にユニオン処理を行うことなく、インポート時にファイルを統合できます。

情報：このオプションで一度に統合できるファイルは、最大5件です。

メモ：このチェックボックスを選択しない場合、一度に取得されるファイルは1件のみです。

例：Boxアカウントに10件のファイルがある場合、最初の5件が1つのデータセットに統合され、インポートされます。次回の再読み込み時に、残りの5件が統合され、インポートされます。

同様に、Boxアカウントに8件のファイルがある場合は、最初の5件が統合されて取得され、その後、残りの3件が統合されて取得されます。

• ［ファイル形式］：必要なファイル形式を選択します。利用可能な形式は、CSV、TSV、JSON、XLS、XLSX、XML、TXTです。
• ［シートパターン］：このオプションは、XLS形式とXLSX形式でのみ使用できます。ファイル内のシート名との照合に使用するパターンです。正規表現形式の照合に対応しています。ファイル内のすべてのシートに一致させるには、パターン「.*」を使用できます。

  
  

  

  シートパターンの照合にも、簡易的な正規表現が使用されます。たとえば、Sales_2022、Sales_2023、Sales_2024などの名前のシートを取得するには、パターンとしてSales_.*を入力します。
  

  
  

  同様に、PublicData1、PublicData2、PublicData3などのシートを取得するには、Public.*を使用します。

  
  

  1つのシートのみをインポートする場合は、正確なシート名を使用してパターンを指定します。

  例：Leads_Jan_2022.*
  

  
  
• 
  情報：シートパターンでは、大文字と小文字が区別されます。
  
  
• ［シートのパスワード］：このオプションは、XLS形式とXLSX形式でのみ使用できます。シートがパスワードで保護されている場合は、パスワードを入力します。
  
• ［シートを統合してインポート］：指定したパターンに一致するすべてのシートを統合し、1つのデータセットとしてインポートします。

このオプションを使用すると、インポート後にユニオン処理を行うことなく、インポート時にシートを統合できます。

メモ：このチェックボックスを選択しない場合、一度に取得されるシートは1件のみです。

3. ［インポート］ボタンをクリックします。すぐにパイプラインビルダーページに移動し、バックグラウンドでインポートが実行されます。

メモ：対応している形式は、CSV、TSV、JSON、XML、TXT、XLS、XLSXです。ZIP形式のファイルもインポートできます。

ZIPファイルの場合、対応しているファイルは1件のみです。.zipファイル内に圧縮されているファイルが1件だけであることを確認してください。

ファイルの解析

ファイルの解析とは、インポート時にファイルを解釈して構造化し、処理できるようにデータを行と列に正しく整理する処理です。

ファイルの解析には、［自動解析］と［カスタム解析］の2つのオプションがあります。

1. ［自動解析］-ファイル構造（区切り文字、見出し、文字コードなど）を自動的に検出し、それに応じてデータを整形します。
   
2. ［カスタム解析］-ファイルの読み取り方法を手動で設定できます。区切り文字、見出し、文字コードなどの設定を詳細に指定できます。
   

［カスタム解析］には、次のオプションがあります。

• ［ファイルの文字コード］：［ファイルの文字コード］オプションで、UTF-8などの文字コード方式を使用してファイルをエンコードできます。

• ［テキスト修飾子］：単一引用符（'）や二重引用符（'）など、テキスト項目の先頭と末尾を示す文字を指定できます。

• ［区切り文字］：コンマ（,）、セミコロン（;）、スペース、タブ、パイプ（|）などの区切り文字を使用して、データを分割できます。独自の区切り文字を指定できる［カスタム区切り文字］オプションもあります。

• ［先頭行をスキップ］：ファイルの先頭から、指定した行数を解析対象から除外します。

• ［コメント文字］：コメント行の先頭文字を指定します。コメント行はインポート時にスキップされます。

• ［エスケープ文字］：区切り文字や引用符をエスケープし、書式なしテキストとして扱うための文字を指定します。使用可能なオプションは、二重引用符（'）、バックスラッシュ（）、パイプ（|）、キャレット（^）、チルダ（~）です。

• ［空白を自動的に削除］：データのインポート時に、すべての列の先頭と末尾にある空白を削除します。

• ［データに見出しを含む］：列見出しとして使用する行番号を指定します。

ファイル解析オプション