IMPORT MULTIEXCEL コマンド

複数の Microsoft Excel ワークシートまたは名前付き範囲を定義およびインポートして、複数の Analytics テーブルを作成します。

構文

IMPORT MULTIEXCEL <TO インポート フォルダー> FROM {ソース ファイル名|ソース フォルダー} TABLE 入力ワークシートまたは名前付き範囲 <PREFIX> <KEEPTITLE> <CHARMAX 最大フィールド長>

メモ

IMPORT MULTIEXCEL パラメーターを上記と完全に同じ順序で、以下のテーブルで指定する必要があります。

ワークブックの保護ビューが有効な場合、analytics は Excel ワークブックからインポートできません。 まず、ワークブックで編集を有効にし、ワークブックを保存して閉じてから、インポートを実行する必要があります。

パラメーター

名前 説明
TO インポート フォルダー

省略可能

データをインポートするフォルダー。

フォルダーを指定するには、絶対ファイル パス、または Analytics プロジェクトを含むフォルダーに相対的なファイル パスを使用します。 インポート フォルダーは引用符で囲んで指定します。

例

TO "C:\Point of sale audit\Data\Transaction working data"
TO "Data\Transaction working data"

TO を省略すると、データは Analytics プロジェクトを含むフォルダーにインポートされます。

FROM ソース ファイル名 | ソース フォルダー

ソース データ ファイル、またはソース データファイルを含むフォルダーの名前。

ソース ファイル名 またはソース フォルダーは引用符で囲んで指定します。

ルートの Analytics プロジェクト フォルダーのソース データ ファイル

  • 単一の Excel ファイル

    Excel ファイルの完全なファイル名と拡張子を指定します。

    例

    FROM "Transactions_FY18.xlsx"
  • 複数の Excel ファイル

    複数のファイルを指定するには、ファイル名の中の一意の文字の代わりに、ワイルドカード文字 (*) を使用します。 ワイルドカード文字は、任意の文字、数字、または特殊文字のゼロ (0) 回以上の出現を表します。

    例

    FROM "Transactions_FY*.xlsx"

    次のファイルが選択されます。

    Transactions_FY18.xlsx

    Transactions_FY17.xlsx

    ワイルドカードは、ファイル名およびファイル拡張子における複数の位置にも使用できます。

    例

    FROM "Transactions_FY*.*"

    次のファイルが選択されます。

    Transactions_FY18.xlsx

    Transactions_FY17.xls

ルートの Analytics プロジェクト フォルダーのソース データ ファイル

ソース データ ファイルまたはファイルが Analytics プロジェクトと同じディレクトリに位置しない場合、ファイルの位置を指定するために絶対ファイル パスまたはプロジェクトを含むフォルダへの相対ファイル パスを使用する必要があります。

例

FROM "C:\Point of sale audit\Data\Transaction master files\Transactions_FY18.xlsx"
FROM "Data\Transaction master files\Transactions_FY*.xlsx"

ソース データ ファイルを含むフォルダー

ファイル名を指定する代わりに、ソース データ ファイルを含むフォルダーの名前を指定できます。

ソース データ フォルダーを指定するには、絶対ファイル パス、またはAnalytics プロジェクトを含むフォルダーに相対的なファイル パスを使用します。

例

FROM "C:\Point of sale audit\Data\Transaction master files"
FROM "Data\Transaction master files"

メモ

フォルダーを指定すると、ワークシート名が TABLE 値と一致する場合に、フォルダーの任意の Excel ファイルのワークシートがインポートされます。
TABLE 入力ワークシートまたは名前付き範囲

インポートするワークシートまたは名前付き範囲の名前。 インポートされた各ワークシートまたは名前付き範囲の個別の Analytics テーブルが作成されます。

input_worksheets_or_named_ranges は引用符で囲んで指定します。

ワークシートまたは範囲の名前で、固有の文字の代わりに、ワイルドカード (*) を使用します。

たとえば、"Trans_*$" は、次のワークシートを選択します。

  • Trans_Jan
  • Trans_Feb
  • Trans_Mar
  • など

メモ

ワイルドカード文字 (*) は、任意の文字、数字、または特殊文字のゼロ (0) 回以上の出現を表します。

複数の場所でワイルドカードを使用できます。 たとえば、*Trans*$ は以下を選択します。

  • Trans_Jan
  • Jan_Trans

ドル記号 ($) の意味

Excel ファイルでは、ワークシートは、ワークシート名（Trans_Jan$）に付加されているドル記号（$）で識別されます。 ドル記号は Excel には表示されません。

名前付き範囲は、ドル記号がないことによって特定されます (Trans_Jan_commercial)。

IMPORT MULTIEXCEL を使用するときには、ドル記号の指定は不要です。 ただし、次の状況では、それを含めるか、除外してください。

  • "$" を含めるワークシートのみをインポートし、名前付き範囲をインポートしない場合は、ワークシート名の最後にドル記号 ($) を入れます。
  • "$" を除外する 名前付き範囲またはワークシートと名前付き範囲を 1 つのインポート処理でインポートする場合は、ドル記号を入れません。

PREFIX

省略可能

Excel ファイルを Analytics テーブルの名前の前に追加します。

ヒント

別のファイルのワークシートの名前が同じ場合は、Excel ファイル名を前に付けると、テーブル名の競合を回避できます。
KEEPTITLE

省略可能

データの代わりに、フィールド名としてデータの最初の行を処理します。 省略すると、汎用フィールド名が使用されます。

メモ

インポートするワークシートと名前付き範囲のすべての最初の行は、一貫性がある方法を使用してください。 最初の行は、すべてのデータセットで、フィールド名、データのいずれかです。 1 つのインポート処理で 2 つの内容を混在させないでください。

データ セットの最初の行へのアプローチに一貫性がない場合、2 つの別のインポート処理を使用してください。
CHARMAX 最大フィールド長

省略可能

ソース データ ファイル内の文字データから発生する Analytics テーブルの任意のフィールドの文字の最大長。

例

次の例は、Excel ファイルに保存された 3 年間分の月次取引データがあるとします。

  • Transactions_FY18.xlsx
  • Transactions_FY17.xlsx
  • Transactions_FY16.xlsx

各 Excel ファイルには 12 ワークシート（年の各月に 1 つずつ）。 また、ワークシートには、取引の各種サブセットを識別する一部の名前付き範囲もあります。

メモ

インポートする各ワークシートまたは名前付き範囲の個別の Analytics テーブルが作成されます。

ワークシートのインポート

すべての FY18 ワークシートのインポート

FY18 Excel ファイルから、すべての 12 ヶ月のワークシートをインポートします。

  • 各ワークシート名で月が発生する場所で、ワイルドカード記号 (*) を使用します。
  • ワークシート名の最後にドル記号 ($) を入れ、ワークシートのみが選択され、名前付き範囲が選択されないようにします。
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Trans_*$"

すべての FY18 ワークシートをインポートし、フィールド名を保持し、最大文字フィールド長を指定します。

この例は上記の例と同じですが、Excel ファイルのフィールド名を保持し、文字フィールドの長さを制限します。

  • KEEPTITLE を追加すると、Excel データの最初の行をフィールド名として使用できます。

  • CHARMAX 50 を追加し、Excel ファイルの文字データとして発生するフィールドが、結果の Analytics テーブルで 50 文字に制限されます。

IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Trans_*$" KEEPTITLE CHARMAX 50

すべての 3 つのファイルからすべてのワークシートをインポート

3 つの Excel ファイルから、すべての 36 ヶ月のワークシートをインポートします。

  • 各ワークシート名で月が発生する場所で、ワイルドカード記号 (*) を使用します。
  • ワークシート名の最後にドル記号 ($) を入れ、ワークシートのみが選択され、名前付き範囲が選択されないようにします。
  • 各 Excel ファイル名で年が発生する場所で、ワイルドカード記号 (*) を使用します。
  • 命名の競合の可能性を削減する方法として、PREFIX を使用して、ソース Excel ファイルの名前を各 Analytics テーブル名の前に追加します。
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Trans_*$"

名前付き範囲のインポート

すべての FY18 "Commercial_transaction" 名前付き範囲のインポート

すべての "Commercial_transaction" 名前付き範囲を FY18 Excel ファイルからインポートし、ワークシートと他の名前付き範囲を無視します。

  • 別の範囲の名前で一意の識別子が発生する場所でワイルドカード記号 (*) を使用します。
  • ドル記号 ($) を除外し、名前付き範囲が選択できるようにします。
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "Commercial_transaction_*"

ワークシートと名前付き範囲のインポート

すべての FY18 ワークシートと名前付き範囲のインポート

FY18 Excel ファイルから、すべての 12 ヶ月のワークシートと他の名前付き範囲をインポートします。

  • TABLE でワイルドカード記号 (*) のみを使用して、ファイルのすべてのワークシートと名前付き範囲が選択されるようにします。
  • ドル記号 ($) を除外し、名前付き範囲が選択できるようにします。
IMPORT MULTIEXCEL FROM "Transactions_FY18.xlsx" TABLE "*"

ディレクトリの管理

指定されたフォルダーですべての Excel ファイルからすべてのワークシートをインポート

C:\Point of sale audit\Data\Transaction master files フォルダーで、すべての Excel ファイルからすべてのワークシートをインポートします。

  • TABLE でワイルドカード記号 (*) のみを使用して、各ファイルのすべてのワークシートが選択されるようにします。また、ドル記号 ($) を使用して、ワークシートのみが選択され、名前付き範囲が選択されないようにします。
  • 命名の競合の可能性を削減する方法として、PREFIX を使用して、ソース Excel ファイルの名前を各 Analytics テーブル名の前に追加します。
IMPORT MULTIEXCEL FROM "C:\Point of sale audit\Data\Transaction master files" TABLE "*$" PREFIX

指定されたフォルダーですべての Excel ファイルからすべてのワークシートをインポートし、Analytics テーブルを別のフォルダーに保存

この例は上記の例と同じですが、Analytics テーブルをルート プロジェクト フォルダーに保存するのではなく、C:\Point of sale audit\Data\Transaction working data フォルダーに保存します。

IMPORT MULTIEXCEL TO "C:\Point of sale audit\Data\Transaction working data" FROM "C:\Point of sale audit\Data\Transaction master files" TABLE "*$" PREFIX

備考

複数の IMPORT EXCEL コマンド

IMPORT MULTIEXCEL コマンドは、実際に、複数の個別の IMPORT EXCEL コマンドを実行します。インポートされる各ワークシートに 1 つあります。 ログの IMPORT MULTIEXCEL エントリをダブルクリックすると、個別の IMPORT EXCEL コマンドが表示領域に表示されます。

インポートされた最後のテーブルは、自動的に開きます。

IMPORT MULTIEXCEL は OPEN キーワードをサポートしません。 ただし、コマンドの実行後、インポートされた最後のテーブルが自動的に開きます。

インポート後に複数のワークシートを結合

複数のワークシートを個々の Analytics テーブルにインポート後に、それらを 1 つの Analytics テーブルに結合できます。 たとえば、12 個の月次テーブルのデータをすべてのデータを含む単一の年次テーブルに結合できます。

複数の Analytics テーブルを結合する方法については、APPEND コマンド を参照してください。