导入记录

从指定的文件或数据源导入记录。

选项 

  • 包括对话框”指定在执行此脚本步骤时是否显示与导入相关的对话框。但是,如果没有指定数据源文件,则运行脚本时将显示“打开文件”对话框。

  • 指定数据源”指定要导入的数据文件或数据源。根据您选择的文件或数据源,将显示一个相应的对话框,用于指定以下附加选项:

  • 当您选择该文件或数据源时

    请执行此操作

    文件

    在“指定文件”对话框中,选择要导入的文件,或者在列表中直接键入文件路径。每行指定一个路径。FileMaker Pro 将使用它找到的第一个路径作为要导入的文件。请参阅创建文件路径

    如果在指定数据源后出现“第一行选项”对话框,则可以指定是否将第一行用作字段名称。但如果使用“指定导入顺序”选项,则可以在支持的导入/导出文件格式中所指示的某些文件格式导入时选择要用作字段名称的任何记录。

    如果在“指定文件”对话框中指定具有自定义字段分隔符的文件,则对于“文件类型”,选择“自定义分隔值”,并指定字段分隔符。

    文件夹

    在“文件夹文件导入选项”对话框中,选择要导入的图像或文本文件所在的文件夹,或者直接在列表中键入文件夹路径。每行指定一个路径。FileMaker Pro 将使用它找到的第一个路径作为要导入的文件夹。请参阅同时导入文件夹中的多个文件创建文件路径。此选项在 FileMaker WebDirect 和服务器端脚本中不受支持。

    XML 数据

    在“指定 XML 和 XSL 选项”对话框中,选择要导入的 XML 数据源,如果要在导入前应用 XSLT 样式表,则还要选择一个样式表。XML 和 XSLT 数据源可能是一个文件,也可能是 HTTP 请求的结果,或者是一个生成文件路径或 HTTP 请求的算式。请参阅导入 XML 数据

    ODBC 数据

    指定数据源名称和位置、用户 ID 和密码(如果有)以及要执行的 SQL 查询。请参阅使用“导入记录”脚本步骤,自动导入 ODBC

    SQL 语句的最大长度不能超过 256 K 个字符 (512 KB)。

    注释  如果使用“导入记录”脚本步骤导入包含 Unicode 字符串的 ODBC 数据,则 ODBC 驱动程序必须支持 Unicode。否则,结果可能不一致。

  • 指定导入顺序”定义了是否添加、更新或替换当前搜索结果中的记录,以及在运行此脚本步骤时,如何将源字段映射到目标字段。请参阅在导入过程中设置导入操作和映射字段

    注释  如果导入源字段和目标字段通过匹配名称进行了映射,则每次执行该脚本步骤时将动态执行文件名匹配。

  • 验证 SSL 证书”会验证 HTTP 请求中针对 XML 数据指定的服务器的 SSL 证书。如果无法验证证书,用户可以选择仍然连接或取消以跳过此脚本步骤。如果无法验证证书并且设置错误捕获脚本步骤设置为“打开”,则此脚本步骤的行为将与服务器不可用时相同。

兼容性 

产品 是否支持
FileMaker Pro
FileMaker Go 部分
FileMaker WebDirect 部分
FileMaker Server 部分
FileMaker Cloud 部分
FileMaker Data API
自定义 Web 发布

原始版本 

6.0 或更低版本

说明 

可以设置导入顺序并使用“指定导入顺序”选项,也可以通过对话框执行该脚本步骤,以便用户可以设置新的条件,如将数据作为新表导入。

如果源文件已打开,将导入搜索结果;否则将导入源表中的所有记录。

如果将此脚本步骤包含在服务器端脚本内,并且未将“包括对话框”设置为“打开”,则该选项将呈灰色;但此脚本步骤仍会运行。该行为将与“包括对话框”设置为“关闭”时相同。有关更多信息,请参阅 Get (文档路径列表)函数

运行服务器端脚本来执行以下任何一种操作都将返回错误:

  • 将记录导入新表

  • 从文件夹导入记录

  • 将图像导入容器字段

请参阅将数据导入 FileMaker Pro

注释 

  • 在 FileMaker Go 中:

    • 仅支持从 FileMaker Pro、逗号分隔的值、制表符分隔的值、DBF 和合并文件格式导入。

    • 不支持导入到新表。

  • 在 FileMaker WebDirect 中:

    • 此脚本步骤在移动浏览器中不受支持。

    • 不支持“指定数据源”选项。用户必须指定可通过 Web 浏览器访问的文件。

    • 仅支持从 FileMaker Pro、逗号分隔的值、制表符分隔的值、DBF、merge 和 Excel 文件格式导入。

  • 服务器端脚本只能访问特定文件夹。请参阅服务器端脚本中的路径

  • 只有当“包括对话框”设置为“关闭”时,服务器端脚本、FileMaker Go 和 FileMaker WebDirect 才支持下列选项:

    • 自定义分隔值格式的源文件

    • 将任一行用作字段名称;只有当“包括对话框”设置为“打开”时,才能指定第一行

    • 为单个字段执行自动输入选项

    在 FileMaker WebDirect 中,如果这些选项已在此脚本步骤中预定义,并且“包括对话框”设置为“打开”,则用户在脚本运行时选择的选项将改写预定义选项。

  • 指定数据源选项中,如果您指定一个变量,

  • 要在依次选择指定数据源选项和指定导入顺序选项时指定变量文件路径,请先将变量放在文件路径列表中,后接您要导入的格式的本地文件路径。选择指定导入顺序选项时,脚本步骤使用它能找到的第一个文件路径。由于脚本步骤在脚本运行之前无法评估变量,因此它会使用列表中的下一个文件路径 (本地文件),这样您可以选择选项。但是,当脚本运行时,如果可以评估变量,脚本步骤将使用变量定义的文件路径。

    如果您只指定变量,而不想使用指定导入顺序选项,则“第一行选项”对话框将会显示,让您选择第一行是否包含字段名称。

示例 1 

作为新记录从“新产品目录.xlsx”导入信息,而不提示用户。

复制
转到布局[ "产品" (产品) ;动画: 无]
导入记录[包括对话框: 关闭: 表: 产品; 源: "新产品目录.xlsx"; 工作表: "存"; 添加; Mac Roman]

示例 2 

使用“新产品目录.xlsx”中的信息替换现有记录。

复制
转到布局[ "产品" (产品) ; 动画: 无]
对记录排序[恢复;包括对话框: 关闭]
转到记录/请求/页面[第一个]
导入记录[包括对话框:关闭; 表: 产品; 来源: "新产品目录.xlsx"; 工作表: "库存"; 替换; Mac Roman]

示例 3 

导入记录后设置下一个序列值。如果为了保留日期以及其他自动输入的值而未选中“导入时执行自动输入选项”,则很有用。

复制
转到布局["产品"(产品) ; 动画: 无]
导入记录[包括对话框: 关闭; 表: 产品; 来源: "新产品目录.xlsx"; 工作表: "库存"; 添加; Mac Roman]
设置下一个序列值[产品::产品 ID; Get ( 总记录数 ) + 1 ]
对记录排序[恢复; 包括对话框: 关闭]
转到记录/请求/页面[第一个]