将数据导入 Campaign ootb-profiles

Last update: Mon Jun 09 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

适用对象：
Campaign v8
Campaign Classic v7

主题：
数据管理

创建对象：

初学者
用户

Campaign 可帮助您将联系人添加到云数据库。您可以加载文件、计划和自动更新多个联系人，在网站上收集数据，或直接在收件人表格中输入轮廓信息。

受众入门

了解营销活动数据模型

在工作流中导入轮廓

轮廓导入在专用模板中进行配置，通过导入活动工作流执行。它们可以根据计划自动重复，例如用于在多个信息系统之间自动交换数据。在此部分中了解更多信息。

运行统一导入

创建并执行通用数据导入任务，以便在云数据库中加载联系人。

导入数据

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

NOTE

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

导入助手允许您配置导入、定义其选项（如数据转换）并启动执行。它是一系列屏幕，其内容取决于导入类型（简单或多个）和操作员权限。

创建新导入作业后，将显示导入助手。

NOTE

如果使用 IIS Web 服务器，则可能需要通过配置授权上传大文件 (> 28 MB)。

源文件 source-file

在源文件中，每行都与记录一致。记录中的数据由分隔符（空格、制表符、字符等）分隔。这意味着以列的形式检索数据，并且每列与数据库的字段相关联。

第1步 — 选择导入模板 step-1---choosing-the-import-template

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

选择 Profiles and Targets > Job > Generic imports and exports 文件夹。
点击 New，然后点击 Import 以创建导入模板。
单击 Import template 字段右侧的箭头以选择您的模板，或单击 Select link 以浏览树。

本机模板为 New text import。不得修改此模板，但您可以复制此模板，以根据您的要求配置新模板。默认情况下，导入模板保存在 Profiles and targets > Templates > Job templates 节点中。
在 Label 字段中输入此导入的名称。您可以添加描述。
在相应的字段中选择导入类型。有两种可能的导入类型：Simple import 用于仅导入一个文件，而 Multiple import 用于在单次执行中导入多个文件。

对于多次导入，从导入助理第一个屏幕中的 Import type 下拉列表中选择 Multiple import。

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

每次添加文件时，都会显示 File to import 助理的屏幕。请参阅第步 — 选择Source文件部分，并按照助手中的步骤将导入选项定义为简单导入。

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

高级参数 advanced-parameters

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 并使用变量编辑器。

note important
IMPORTANT
Variables 选项卡仅供工作流类型编程使用，且仅应由专家用户配置。

第 2 步 - 源文件选择 step-2---source-file-selection

源文件可以是文本格式（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 链接允许您筛选源数据并访问高级选项。在此屏幕中，您可以选择仅导入部分文件。您还可以定义过滤器，例如根据相应行的值仅导入“Prospect”或“Customer”类型的用户。这些选项仅供专业 JavaScript 用户使用。

更改文件格式 changing-the-file-format

Click here to change the file format… 选项允许您设置源文件数据的格式，特别是指定列分隔符和每个字段的数据类型。此配置通过以下窗口执行：

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

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

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

第 3 步 - 字段映射 step-3---field-mapping

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

Destination schema 字段允许您选择将在其中导入数据的架构。此信息是必填的。单击 Select link 图标以选择现有架构之一。单击 Edit link 以显示选定表的内容。

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

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

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

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

您可以对导入的字段应用转换。为此，请单击 Transformation 列中与该字段相关的单元格，然后选择要应用的转换。

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

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

计算字段 calculated-fields

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

有四种类型的计算字段：

Fixed string：对于源文件的所有行，计算字段的值都相同。用于设置插入或更新记录的字段的值。例如，您可以为所有导入的记录将标记设置为“是”。
String with JavaScript tags：计算字段的值是包含JavaScript命令的字符串。
JavaScript expression：计算字段的值是JavaScript函数求值的结果。返回的值可以是数字、日期等。
Enumeration：字段的值是根据源文件中包含的某个值而归因的。编辑器允许您指定源列并输入枚举值清单，如以下示例所示：

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

第 4 步 – 调解 step-4---reconciliation

通过import assistant的协调步骤，可定义文件数据与数据库中现有数据的协调模式，并设置文件数据与数据库数据之间的优先级规则。配置窗口如下所示：

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

每个节点（表或字段）都有特殊选项可用。当您单击列表中相关的节点时，其参数和简要说明将显示如下。为每个元素定义的行为将显示在相应的 Behavior 列中。

操作类型 types-of-operation

对于导入涉及的每个表，必须定义操作的类型。以下操作可用于数据库的主要元素：

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：在更新或插入操作期间，将只导入新的源文件记录。

NOTE

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

合并关键项 reconciliation-keys

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

协调键值是用于标识记录的一组字段。例如，要导入收件人，协调键值可以是帐号、“电子邮件”字段或“姓氏、名字、公司”字段等。

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

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

NOTE

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

因此，仅对此文件夹执行调解（除非未选择任何文件夹）。

重复数据删除 deduplication

NOTE

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

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

Management of doubles 字段允许您配置重复数据删除。重复数据删除涉及 源文件 中多次出现的记录（或多文件导入时的源文件），即合并关键项的字段相同的行。

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

IMPORTANT

仅在内存中执行重复数据删除。因此，带重复数据删除的导入的大小受到限制。此限制取决于多个参数（应用程序服务器的容量、活动、键中的字段数等）。重复数据删除的最大大小为 1,000,000 行。

重复数据删除涉及源文件和数据库中都存在的记录。它只涉及与更新有关的操作（即 Update and insertion 或 Update）。 Duplicate management 选项允许您更新或忽略记录（如果它同时位于源文件和数据库中）。 Update or insert based on origin 选项属于可选模块，无法在标准上下文中使用。

选项 Reject 和 Ignore 按上述方式运行。

发生错误时 behavior-in-the-event-of-an-error

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

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

有两种类型的拒绝（该类型显示在 Connector 列中）：

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

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

Ignore and log a warning：已将所有字段导入数据库，但生成错误的字段除外。
Reject parent element：记录的整行都遭到拒绝，不仅是因为导致错误的字段。
Reject all elements：导入停止，记录的所有元素都被拒绝。

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

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

第 5 步 - 导入收件人时的附加步骤 step-5---additional-step-when-importing-recipients

在import assistant的下一个步骤中，您可以选择或创建数据将导入到的文件夹，自动将导入的收件人映射到（新的或现有的）列表，并将收件人订阅服务。

NOTE

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

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

导入到文件夹中

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

note note
NOTE
运算符的默认文件夹是运算符具有写入权限的第一个文件夹。在管理文件夹和视图中了解详情。

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

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

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

与清单相关联

Add recipients to a list 部分中的 Edit… 链接允许您选择或创建收件人将导入到的列表。

您可以单击 Select link，然后单击 Create 为这些收件人创建新列表。

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

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

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

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

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

步骤6 — 启动导入 step-6---launching-the-import

利用该助理的最后一步可以启动数据导入。为此，请单击 Start 按钮。

然后，您可以监视导入作业的执行（请参阅监视工作流执行）。

导出数据

导出作业允许您访问数据库并从数据库中提取数据：联系人、客户端、列表、区段等。

例如，在电子表格中使用促销活动跟踪数据（跟踪历史记录等）会很有用。输出数据可以是 txt、CSV、TAB 或 XML 格式。

导出助手允许您配置导出、定义其选项并启动执行。它是一系列屏幕，其内容取决于导出类型（简单或多个）和操作员的权限。

创建新导出作业后，将显示导出助手。

第1步 — 选择导出模板 step-1---choosing-the-export-template

启动导出助理时，必须首先选择模板。例如，要配置最近注册的收件人的导出，请按照以下步骤操作：

选择 Profiles and Targets > Job > Generic imports and exports 文件夹。
点击 New，然后点击 Export 以创建导出模板。
单击 Export template 字段右侧的箭头以选择您的模板，或单击 Select link 以浏览树。

本机模板为 New text export。不得修改此模板，但您可以复制它以配置新模板。默认情况下，导出模板保存在 Resources > Templates > Job templates 节点中。
在 Label 字段中输入导出名称。您可以添加描述。
选择导出类型。有两种可能的导出类型：Simple export 用于仅导出一个文件，而 Multiple export 用于从一种或多种类型的源文档在单次执行中导出多个文件。

第 2 步 - 要导出的文件类型 step-2---type-of-file-to-export

选择要导出的文档类型，即要导出的数据模式。

默认情况下，从 Jobs 节点启动导出时，数据来自收件人表。从数据列表（从 right click > Export 菜单）启动导出时，数据所属的表会自动填充到 Document type 字段中。

默认情况下，Download the file generated on the server after the export 选项处于选中状态。在 Local file 字段中，填写要创建的文件的名称和路径，或单击字段右侧的文件夹浏览本地磁盘。您可以取消选择此选项以输入服务器输出文件的访问路径和名称。

note note
NOTE
始终在服务器上执行自动导入和导出作业。
要仅导出部分数据，请单击 Advanced parameters 并在相应的字段中输入要导出的行数。

您可以创建差异导出，以仅导出自上次执行以来修改的记录。为此，请单击 Advanced parameters 链接，单击 Differential export 选项卡，然后选择 Activate differential export。

必须输入上次修改的日期。它可以从字段中检索或计算。

步骤3 — 定义输出格式 step-3---defining-the-output-format

选择导出文件的输出格式。可以使用以下格式：文本、固定列文本、CSV 和 XML。

对于 Text 格式，选择分隔符以分隔列（制表符、逗号、分号或自定义）和字符串（单引号、双引号或无）。
对于 text 和 CSV，您可以选择选项 Use first lines as column titles。
指示日期格式和数字格式。为此，请单击相关字段的 Edit 按钮并使用编辑器。
对于包含枚举值的字段，可以选择 Export labels instead of internal values of enumerations。例如，标题可以以 1=Mr格式存储。，2=小姐，3=太太。。如果选择此选项，将导出 Mr. 、Miss 和 Mrs.。