IMPORT MULTIEXCEL 命令

概念信息

通过定义并导入多个 Microsoft Excel 工作表或者命名区域来创建多个 Analytics 表。

语法

IMPORT MULTIEXCEL <TO 导入文件夹> FROM {源文件名|源文件夹} TABLE 输入工作表或命名区域 <PREFIX> <KEEPTITLE> <STARTLINE 行号> <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 文件指定完整的文件名和扩展名。示例 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" 说明当您指定文件夹时，如果该文件夹内的任何 Excel 文件中的任何工作表的名称匹配 TABLE 值，则该工作表会被导入。
TABLE `输入工作表或命名区域`	要导入的工作表或命名区域的名称。对于每个被导入的工作表或命名区域，都会创建一个单独的 Analytics 表。请将`输入工作表或命名区域`指定为带引号的字符串。请使用通配符 () 代替工作表或区域的名称中的唯一字符。例如，"Trans_$" 选择下列工作表： Trans_Jan Trans_Feb Trans_Mar 依此类推说明通配符 () 代表任何字母、数字或特殊字符的零 (0) 个或更多个实例。您可以在一个以上的位置使用通配符。例如，Trans*$ 选择： Trans_Jan Jan_Trans 美元符号 ($) 的含义在 Excel 文件中，工作表被用附加到工作表名称的美元符号 ($) 标识 (Trans_Jan$)。美元符号在 Excel 中不可见。命名区域被通过省略美元符号标识 (Trans_Jan_commercial)。使用 IMPORT MULTIEXCEL 时不需要指定美元符号。但是，在下列情况下，您应该包括它或者排除它：包括 "$" 如果您想要只导入工作表而不导入命名区域，请在工作表名称的末尾包括美元符号排除 "$" 如果您想要在单个导入操作中导入命名区域或者同时导入工作表和命名区域，请不要包括美元符号
PREFIX 可选	将 Excel 文件名添加到 Analytics 表名称的前面。提示如果不同文件中的工作表具有相同名称，则在前面添加 Excel 文件名使您可以避免表名称冲突。
KEEPTITLE 可选	KEEPTITLE 不与 STARTLINE 一起使用将第一行数据视为域名称而非数据。将 KEEPTITLE 与 ALLFIELDS 一起使用将 STARTLINE 所指定的行号视为域名称而不是数据。省略 KEEPTITLE 使用通用域名称。将数据的第一行或 STARTLINE 所指定的行号视为数据。说明您导入的工作表和命名区域中应该使用一致的方法。在所有数据集中，首行或起始行应该是域名称或者数据。在单个导入操作中，请避免混用两个方法。如果数据集采用不一致的结构，请使用两个独立的导入操作。
STARTLINE 行号可选	开始读取工作表的行号。例如，如果工作表的前三行包含您不需要的标题信息，请指定 STARTLINE 4 从第四行开始读取数据。如果您省略 STARTLINE，则起始行是该工作表中的第一行。说明不支持将 STARTLINE 与命名区域结合使用。
CHARMAX 最大域长度可选	Analytics 表中所有字段的最大字符长度，源自 Excel 源数据文件中的字符数据。 Excel 文件中超过最大字段长度的数据在导入 Analytics 时会被截断。截断字段这项功能，可防止偶尔出现的长值将整体记录长度扩展到超过导入流程支持的长度范围： 32,767 个字符（非 Unicode 版 Analytics） 16,383 个字符（Unicode 版 Analytics）

示例

下面的示例假定您在三个 Excel 文件中存储三个年度的每月交易数据：

Transactions_FY18.xlsx
Transactions_FY17.xlsx
Transactions_FY16.xlsx

每个 Excel 文件包含 12 个工作表 — 该年度的每个月都有一个工作表。这些工作表还包括一些命名区域，它们标识各种交易子集。

说明

对于您导入的每个工作表或命名区域，都会创建一个单独的 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

从全部三个文件中导入所有工作表

您想要从三个 Excel 文件中导入全部 36 个月工作表，并且忽略所有命名区域。

在每个工作表名称中，您使用通配符 (*) 代替月份
在工作表名称的末尾包括美元符号 ($)，以便只选择工作表，而不选择命名区域
在每个 Excel 文件名中，使用通配符 (*) 代替年份
作为减少命名冲突机会的一种方式，您使用 PREFIX 将源 Excel 文件的名称添加到每个 Analytics 表名称的前面

IMPORT MULTIEXCEL FROM "Transactions_FY*.xlsx" TABLE "Trans_*$" PREFIX

导入命名区域

导入所有 FY18 "Commercial_transaction" 命名区域

您想要从 FY18 Excel 文件中导入所有 "Commercial_transaction" 命名区域，并且忽略工作表和其他命名区域。

您在不同区域的名称中出现唯一标识符的位置使用通配符 (*)
您排除美元符号 ($)，以使命名区域可以被选择

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 dataAnalytics 文件夹中保存它们。

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 命令 — 对于所导入的每个工作表都执行一个。如果您双击日志中的 IMPORT MULTIEXCEL 条目，则会在显示区域显示各个 IMPORT EXCEL 命令。

导入的最后一个表被自动打开

IMPORT MULTIEXCEL 不支持 OPEN 关键字。但是，在该命令执行后，导入的最后一个表被自动打开。

在导入多个工作表后组合它们

在将多个工作表导入到各个 Analytics 表之后，您可能想要将其组合为单个 Analytics 表。例如，您可以将十二个月度表中的数据组合为包含所有数据的单个年度表。

有关组合多个 Analytics 表的信息，请参见APPEND 命令。

名称	描述
TO `导入文件夹` 可选	要向其中导入数据的文件夹。要指定该文件夹，请使用绝对文件路径或者一个相对于包含该 Analytics 项目的文件夹的文件路径。请将`导入文件夹`指定为带引号的字符串。示例 TO "C:\Point of sale audit\Data\Transaction working data" TO "Data\Transaction working data" 如果您省略 TO，则数据被导入到包含该 Analytics 项目的文件夹。
FROM `源文件名` \| `源文件夹`	一个或多个源数据文件的名称，或者包含一个或多个源数据文件的文件夹。请将`源文件名`或者`源文件夹`指定为带引号的字符串。根 Analytics 项目文件夹中的一个或多个源数据文件单个 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" 说明当您指定文件夹时，如果该文件夹内的任何 Excel 文件中的任何工作表的名称匹配 TABLE 值，则该工作表会被导入。
TABLE `输入工作表或命名区域`	要导入的工作表或命名区域的名称。对于每个被导入的工作表或命名区域，都会创建一个单独的 Analytics 表。请将`输入工作表或命名区域`指定为带引号的字符串。请使用通配符 () 代替工作表或区域的名称中的唯一字符。例如，"Trans_$" 选择下列工作表： Trans_Jan Trans_Feb Trans_Mar 依此类推说明通配符 () 代表任何字母、数字或特殊字符的零 (0) 个或更多个实例。您可以在一个以上的位置使用通配符。例如，Trans*$ 选择： Trans_Jan Jan_Trans 美元符号 ($) 的含义在 Excel 文件中，工作表被用附加到工作表名称的美元符号 ($) 标识 (Trans_Jan$)。美元符号在 Excel 中不可见。命名区域被通过省略美元符号标识 (Trans_Jan_commercial)。使用 IMPORT MULTIEXCEL 时不需要指定美元符号。但是，在下列情况下，您应该包括它或者排除它：包括 "$" 如果您想要只导入工作表而不导入命名区域，请在工作表名称的末尾包括美元符号排除 "$" 如果您想要在单个导入操作中导入命名区域或者同时导入工作表和命名区域，请不要包括美元符号
PREFIX 可选	将 Excel 文件名添加到 Analytics 表名称的前面。提示如果不同文件中的工作表具有相同名称，则在前面添加 Excel 文件名使您可以避免表名称冲突。
KEEPTITLE 可选	KEEPTITLE 不与 STARTLINE 一起使用将第一行数据视为域名称而非数据。将 KEEPTITLE 与 ALLFIELDS 一起使用将 STARTLINE 所指定的行号视为域名称而不是数据。省略 KEEPTITLE 使用通用域名称。将数据的第一行或 STARTLINE 所指定的行号视为数据。说明您导入的工作表和命名区域中应该使用一致的方法。在所有数据集中，首行或起始行应该是域名称或者数据。在单个导入操作中，请避免混用两个方法。如果数据集采用不一致的结构，请使用两个独立的导入操作。
STARTLINE 行号可选	开始读取工作表的行号。例如，如果工作表的前三行包含您不需要的标题信息，请指定 STARTLINE 4 从第四行开始读取数据。如果您省略 STARTLINE，则起始行是该工作表中的第一行。说明不支持将 STARTLINE 与命名区域结合使用。
CHARMAX 最大域长度可选	Analytics 表中所有字段的最大字符长度，源自 Excel 源数据文件中的字符数据。 Excel 文件中超过最大字段长度的数据在导入 Analytics 时会被截断。截断字段这项功能，可防止偶尔出现的长值将整体记录长度扩展到超过导入流程支持的长度范围： 32,767 个字符（非 Unicode 版 Analytics） 16,383 个字符（Unicode 版 Analytics）