配置导入作业

Adobe Campaign允许您以文本、CSV、TAB或XML格式从一个或多个文件将数据导入数据库。 这些文件与表(主表或链接的表)相关联,并且源文件的每个字段与数据库的字段相关联。

注意

您无需使用​Import a list​函数将数据与数据库数据映射即可导入数据。 然后,可以通过​Read list​对象在工作流中专门使用数据。 有关详细信息,请参见此页面

利用导入向导,可配置导入、定义其选项(如数据转换)和启动执行。 它是一系列屏幕,其内容取决于导入类型(简单或多个)和操作员权限。

创建新导入作业后,将显示导入向导(请参阅创建导入和导出作业)。

注意

如果使用 IIS Web 服务器,则可能需要通过配置授权上传大文件 (> 28 MB)。有关更多信息,请参见此章节

源文件

在源文件中,每行与一条记录重合。记录中的数据由分隔符(空格、制表符、字符等)分隔。这意味着以列的形式检索数据,并且每列与数据库的字段相关联。

步骤1 — 选择导入模板

启动导入向导时,首先必须选择模板。例如,要配置导入收到简报的收件人,请按照以下步骤操作:

  1. 选择​Profiles and Targets > Job > Generic imports and exports​文件夹。

  2. 点击 New,然后点击 Import 以创建导入模板。

  3. 单击​Import template​字段右侧的箭头以选择模板,或单击​Select link​以浏览树。

    本机模板为​New text import。 不得修改此模板,但您可以根据您的要求复制它以配置新模板。默认情况下,导入模板会保存在​Profiles and targets > Templates > Job templates​节点中。

  4. 在​Label​字段中输入此导入的名称。 您可以添加描述。

  5. 在相应字段中选择导入类型。可能有两种类型的导入:Simple import​仅导入一个文件,Multiple import​在单次执行中导入多个文件。

    对于多次导入,请从导入向导第一个屏幕的​Import type​下拉列表中选择​Multiple import

  6. 通过单击​Add​指定要导入的字段。

    每次添加文件时,都会显示​File to import​向导的屏幕。 请参阅步骤2 — 源文件选择部分,并按照向导中的步骤定义导入选项,以便进行简单导入。

    注意

    Multiple import 应仅用于满足特定需求,不是建议的选项。

高级参数

Advanced parameters​链接允许您访问以下选项:

  • General 选项卡

    • Stop execution if there are too many rejects

      默认选中此选项。如果要继续执行导入而不考虑拒绝次数,可以取消选择。默认情况下,如果拒绝前 100 行,则停止执行。

    • Trace mode

      选择此选项可追踪每行的导入执行情况。

    • Start the job in a detached process

      默认选中此选项。它允许您分离导入的执行,使其不会影响数据库中正在进行的其他作业。

    • Do not update enumerations

      选择此选项可避免扩大数据库中的枚举值清单。请参阅管理枚举

  • Variables 选项卡

    您可以定义与可在查询编辑器和计算字段中访问的作业关联的变量。要创建变量,请单击​Add​并使用变量编辑器。

    重要

    Variables​选项卡仅用于工作流类型编程,且应仅由专家用户配置。

第 2 步 - 源文件选择

源文件可以是文本格式(txt、csv、tab、固定列)或 xml。

默认情况下,选择​Upload file on the server。 单击​Local file​字段右侧的文件夹以浏览本地磁盘并选择要导入的文件。 您可以取消选择此选项以输入访问路径以及要在服务器上导入的文件名。

指定文件后,可通过单击​Auto-detect format​在窗口的下半部分查看其数据。 此预览显示源文件的前 200 行。

使用此视图上方提供的选项配置导入。通过这些选项定义的参数将传输到预览中。可以使用以下选项:

  • Click here to change the file format… 允许您检查文件格式并微调配置。
  • Update on server… 允许您将本地文件传输到服务器。仅当选择​Upload file on the server​时,此选项才可用。
  • Download 仅当文件已上载到服务器上时,才可用。
  • Auto-detect format 用于重新初始化数据源的格式。此选项允许您将原始格式重新应用于已通过​Click here to change the file format…​选项格式化的数据。
  • Advanced parameters​链接允许您过滤源数据并访问高级选项。 在此屏幕中,您可以选择仅导入部分文件。您还可以定义筛选器,例如,根据相应行的值仅导入“潜在客户”或“客户”类型的用户。这些选项仅供专业 JavaScript 用户使用。

更改文件格式

使用​Click here to change the file format…​选项可以格式化源文件的数据,特别是指定列分隔符和每个字段的数据类型。 此配置通过以下窗口执行:

此步骤允许您描述应如何读取文件字段的值。例如,在日期的情况下,日期或日期+时间数据可以与某种格式(dd/mm/yyyy、mm/dd/yy 等)相关联。如果输入数据与预期格式不匹配,则在导入期间将发生拒绝。

您可以在窗口下部的预览区域中查看配置结果。

单击​OK​以保存格式,然后单击​Next​以显示下一步。

第 3 步 - 字段映射

然后,您必须选择目标模式并将每列的数据映射到数据库中的字段。

  • 利用​Destination schema​字段,可选择导入数据的架构。 此信息是强制性的。单击​Select link​图标以选择现有架构之一。 单击​Edit link​以显示所选表的内容。

  • 中央表显示源文件中定义的所有字段。选择要导入的字段以将目标文件与它们相关联。可以手动或自动映射这些字段。

    要手动映射字段,请点击复选框以选择源字段,然后点击第二列以激活与所选字段映射的单元格。接下来,单击​Edit expression​图标以显示当前表的所有字段。 选择目标字段,然后单击​OK​以验证映射。

    要自动关联源字段和目标字段,请单击字段列表右侧的​Guess the destination fields​图标。 如果需要,可以修改建议的字段。

    重要

    在继续执行下一步之前,务必验证此操作的结果。

  • 您可以将转换应用于导入的字段。要实现此目的,请单击与相关字段相关的​Transformation​列的单元格,然后选择要应用的转换。

    重要

    转换在导入时应用。但是,如果已定义了对目标字段的约束(在上面的示例中为 @lastname 字段),则这些约束优先。

  • 您可以使用位于中央表右侧的相应图标添加计算字段。通过计算字段,您可以执行复杂的转换,添加虚拟列或合并多列的数据。有关各种可能性的详细信息,请参见以下部分。

计算字段

计算字段是添加到源文件并从其他列计算所得到的新列。然后,计算字段可以与 Adobe Campaign 数据库的字段相关联。但是,在计算字段中无法进行对帐操作。

有四种类型的计算字段:

  • Fixed string:对于源文件的所有行,计算字段的值是相同的。允许您设置插入或更新的记录的字段值。例如,您可以为所有导入的记录将标记设置为“是”。

  • String with JavaScript tags:计算字段的值是包含JavaScript命令的字符串。

  • JavaScript expression:计算字段的值是评估JavaScript函数的结果。返回的值可以是数字、日期等。

  • Enumeration:字段的值根据源文件中包含的值进行归因。编辑器允许您指定源列并输入枚举值清单,如以下示例所示:

    Preview​选项卡允许您查看定义配置的结果。 在此,添加了​Subscription​列。 该值通过 Status 字段计算。

第 4 步 – 调解

导入向导的调解步骤允许您定义将文件中的数据与数据库中的现有数据进行调解的模式,并设置文件数据和数据库数据之间的优先级规则。配置窗口如下所示:

屏幕的中央部分包含一个树状结构,其中包含要导入数据的 Adobe Campaign 数据库的字段和表。

每个节点(表或字段)都有特殊选项。点击清单中的相关节点时,其参数和简要说明将显示在下方。为每个元素定义的行为将显示在相应的​Behavior​列中。

操作类型

对于与导入相关的每个表,都必须定义操作类型。以下操作可用于数据库的主要元素:

  • Update or insertion:如果记录存在于数据库中,则更新该记录,如果不存在,则创建该记录。
  • Insertion:将记录插入数据库。
  • Update:仅更新现有记录(忽略其他记录)。
  • Reconciliation only:在数据库中查找记录,但不执行更新。例如,允许您根据文件列关联要导入的收件人文件夹,而不更新文件夹中的数据。
  • Deletion:允许您销毁数据库中的记录。

导入所涉及的表中的每个字段都有以下选项:

  • Update (empty) if source value is empty:如果源文件中的字段为空,则在发生更新时,字段中的值将删除数据库值。否则,保留数据库字段。
  • Update only if destination is empty:除非数据库字段为空,否则源文件中的值不会覆盖数据库字段中的值。在这种情况下,它采用源文件的值。
  • Update the field only when the record is inserted:在更新或插入操作期间,将只导入新的源文件记录。
注意

除非在没有重复数据删除的情况下插入,否则合并关键项的定义始终是​强制​的。

合并关键项

必须至少填写一个合并关键项才能管理重复数据删除。

合并关键项是用于标识记录的一组字段。例如,要导入收件人,合并关键项可以是账号,“电子邮件”字段或“姓氏、名字、公司”字段等。

在这种情况下,要查明文件的某一行是否与数据库中的现有收件人匹配,导入引擎会将该文件的值与该键的所有字段的数据库值进行比较。当字段特定于记录时,可以执行源数据和目标数据之间的精细比较,从而保证导入后数据的完整性。可以为同一个表填写第二个合并关键项;它用于第一个关键项为空的行。

避免选择在导入期间可能被修改的字段;如果发生这种情况,引擎可能会创建额外的记录。

注意

对于收件人导入,所选文件夹的标识符将隐含地添加到密钥中。

因此,仅对此文件夹执行调解(除非未选择任何文件夹)。

重复数据删除

注意

“double”是指在要导入的文件中存在两次或更多次的项目。

“duplicate”是指同时存在于要导入的文件和数据库中的项目。

利用​Management of doubles​字段,可配置重复数据删除。 重复数据删除涉及​源文件​中多次出现的记录(或多文件导入时的源文件),即合并关键项的字段相同的行。

  • 在​Update​模式(默认模式)下进行重复管理时,不执行重复数据删除。 因此,最后一条记录具有优先权(因为它更新了先前记录的数据)。在此模式下不执行重复计数。
  • 在​Ignore​模式或​Reject entity​模式下进行重复管理时,会从导入中排除重复项。 在这种情况下,不会导入任何记录。
  • 在​Reject entity​模式下,不会导入元素,并且会在导入日志中生成错误。
  • 在​Ignore​模式下,不会导入元素,但不会保留错误跟踪。 此模式可让您优化性能。
重要

重复数据删除仅在内存中执行。因此,采用重复数据删除的导入存在大小限制。限制取决于几个参数(应用程序服务器的容量、活动、密钥中的字段数等)。重复数据删除的最大大小为 1,000,000 行。

重复数据删除涉及源文件和数据库中都存在的记录。它仅涉及更新操作(即​Update and insertion​或​Update)。 Duplicate management​选项允许您更新或忽略源文件和数据库中的记录。 Update or insert based on origin​选项属于可选模块,不能在标准上下文中使用。

选项​Reject​和​Ignore​将按如上所述运行。

出现错误时

大多数数据传输操作会产生各种类型的错误(不一致的行格式,无效的电子邮件地址等)。导入引擎生成的所有错误和所有警告都将存储并链接到导入实例。

可通过​Rejects​选项卡查看这些拒绝的详细信息。

拒绝类型有两种(类型显示在​Connector​列中):

  • 拒绝文本连接器涉及在处理文件行时发生的错误(计算字段、数据分析等)。在这种情况下,如果发生错误,则始终拒绝整行。
  • 数据库连接器拒绝涉及数据调解或写入数据库期间发生的错误。在导入到多个表的情况下,拒绝只涉及记录的一部分(例如,对于收件人和相关事件的导入,错误可以阻止更新事件而不拒绝收件人)。

在数据调解页面中,您可以按字段和逐个表定义所需的错误管理类型字段。

  • Ignore and log a warning:除生成错误的字段外,所有字段都会导入数据库。

  • Reject parent element:记录的整行内容都会被拒绝,不仅仅是导致错误的字段。

  • Reject all elements:导入停止,并拒绝记录的所有元素。

导入实例的拒绝屏幕中的树状结构指示哪些字段被拒绝以及错误发生的位置。

您可以通过​Export rejects​图标生成包含这些记录的文件:

第 5 步 - 导入收件人时的附加步骤

导入向导的下一步允许您选择或创建将导入数据的文件夹,自动将导入的收件人映射到(新的或现有的)清单,将收件人订阅映射到服务。

注意

在仅导入收件人时以及使用预设的 Adobe Campaign 收件人表 (nms:recipient) 时,将出现此步骤。

  • 单击​Edit​链接以选择要与收件人关联或订阅的文件夹、列表或服务。

    1. 导入到文件夹中

      通过​Import into a folder​部分的​Edit…​链接,可以选择或创建将导入收件人的文件夹。 默认情况下,如果未定义分区,则会将数据导入到操作员的预设文件夹中。

      注意

      操作员的预设文件夹是操作员具有写访问权限的第一个文件夹。在文件夹访问管理中了解详情。

      要选择导入文件夹,请单击​Folder​字段右侧的箭头,然后选择相关文件夹。 您还可以使用​Select link​图标在新窗口中显示树或创建新文件夹。

      要创建新文件夹,请选择要从中添加文件夹的节点,然后按鼠标右键。选择 Create a new ‘Recipients’ folder

      该文件夹会添加到当前节点下方。输入新文件夹的名称,按Enter进行确认,然后单击​OK

    2. 与清单相关联

      通过​Add recipients to a list​部分中的​Edit…​链接,可以选择或创建将导入收件人的列表。

      单击​Select link,然后单击​Create,可为这些收件人创建新列表。 列表的创建和管理请参见此部分

      您可以决定将收件人添加到清单中已存在的收件人,或者使用新收件人重新创建清单。在这种情况下,如果清单已包含收件人,则它们将被删除并被导入的收件人替换。

    3. 订阅服务

      要为所有导入的收件人订阅信息服务,请单击​Subscribe recipients to a service​部分的​Edit…​链接,以选择或创建收件人将订阅的信息服务。 您可以选择​Send a confirmation message​选项:此消息的内容在与订阅服务关联的投放模板中定义。

      您可以单击​Select link,然后单击​Create​图标,为这些收件人创建新服务。 这部分介绍了信息服务的管理。

  • 使用​Origin​字段,将有关收件人来源的信息添加到其用户档案。 此信息在多次导入的框架内特别有用。

单击​Next​以验证此步骤并显示以下步骤。

第6步 — 启动导入

向导的最后一步允许您启动数据导入。为此,请单击​Start​按钮。

然后,您可以监视导入作业的执行情况(请参阅监视作业执行

在此页面上