Kick-Starts场景：将多个选项自定义字段导入Workfront

单击Adobe Workfront右上角的​ 主菜单 ​图标 ，或（如果可用）单击左上角的​ 主菜单 ​图标 ，然后单击​ 设置 。

展开左侧菜单中的​ 系统，然后单击​ 导出数据(Kick-Starts)。

在​ 要包含的内容 ​部分中选择​ 自定义数据。

在​ 下载格式 ​部分中选择​ .xlsx文件。

单击​ 下载。 将.xlsx文件下载到您的计算机。 导航到它并将其打开。

检查下载的文件，并记下以下详细信息：

• 文件包含几张工作表。 您可能不需要了解每个工作表中的信息，但您将使用某些工作表来导入信息。 请花一些时间熟悉其内容，尤其是每张纸中内容的格式。
• 请特别注意列名以及每列数据显示的格式。
• 不得更改任何页面中的列名或列顺序。 列标题指示每行中需要填写信息的字段。 如果列标题以粗体显示，则它是必填字段，因此该列中必须具有信息。

• 保留下载的文件以供将来参考，并转到以下部分。

单击Adobe Workfront右上角的​ 主菜单 ​图标 ，或（如果可用）单击左上角的​ 主菜单 ​图标 ，然后单击​ 设置 。

在左侧菜单中展开​ 系统。

单击​ 导入数据(Kick-Starts)。

在​ 下载空白的快速启动电子表格 ​区域，选中​ 自定义数据 ​复选框，然后单击​ 下载。

将空白的快速启动文件下载到您的计算机。

打开您在上一部分下载的Excel电子表格，然后查看这些工作表。 每个工作表都表示应用程序中的一个对象。

例如，Parameter（引用自定义字段）、Parameter Option（引用自定义字段选项）、Category（引用自定义表单）。

必须使用Workfront数据库支持的格式编写对象名称及其属性。

有关这些对象含义的信息，请参阅 Adobe Workfront 术语🔗的术语表。

有关Workfront数据库中对象名称的信息，请参阅API资源管理器。

数据导出中包含的

确保以下信息的格式正确：

• 每个页面的第一行必须保持为空，否则导入将生成错误。

• 每个工作表中的列标题表示可在导入期间设置的对象的属性。 在导出工作表时，所有列标题必须保持与找到它们相同的顺序，并且不能重命名它们。

• 以粗体显示的列标题是必填字段，它们必须具有值。

  note tip
  TIP
  某些列虽然不是粗体的，但还是需要它们的。 例如，isNew和ID列不是粗体，但它们是必填字段。

选择​**0}工作表并在以下必填列中添加有关新自定义字段的信息：**​PARAM Parameter

• isNew =在此列中为每个代表新自定义字段的行输入​ TRUE。 这表示该字段是新字段，在Workfront中不存在。

  note tip
  TIP
  如果某行代表Workfront中已存在的字段，则应输入​**isNew** = FALSE。

• ID =对于表示新字段的每一行必须是唯一数字。 您可以使用以1开头的任意数字，但前提是每个新字段具有唯一数字。

• setDataType =对于表示新字段的每一行，输入该字段支持的数据类型。 必须按数据库中显示的数据类型输入。 从以下数据类型中选择：

  • 数字​ NMBR
  • CURC ​货币
  • 文本的​ TEXT

• **setDisplaySize**=任意多个选项自定义字段的显示大小('setDisplaySize')始终为0。

• setDisplayType =对于表示新字段的每一行，输入该字段的显示类型。 必须按数据库中显示的形式输入显示类型。

  对于多选项自定义字段，请从以下选项中选择：

  • 多选下拉列表的​ MULT
  • 下拉列表的​ SLCT
  • 单选按钮的​ RDIO
  • 复选框的​ CHCK

  note tip
  TIP
  要查找数据类型和显示类型信息，请参阅API Explorer，展开​ Parameter ​对象，然后在​ 字段 ​选项卡下查找这些属性。

• setName =输入您希望在Workfront中显示的自定义字段的名称。

  note info
  INFO
  例如，我们可能会导入两个自定义字段，名为​_Brand_（复选框字段）和​_Media_（单选按钮字段）。

• setName ​和​ setValue ​列通常包含相同的信息，它们应该反映新字段的Workfront界面中所需的名称。

字段的值是报表中显示的名称，例如，而名称显示在附加到对象的自定义表单中。

有关详细信息，请参阅创建自定义表单。

选择​ POPT Parameter Options ​工作表并在以下必填列中添加有关每个自定义字段选项的信息：

• isNew =在此列中为每个代表新字段选项的行输入​ TRUE。

  note tip
  TIP
  如果某行表示现有选项，则应当输入​**isNew** = FALSE。

• ID =表示新选项的每行必须是唯一数字。 您可以使用以1开头的任意数字，但前提是每个新选项具有唯一的数字。

• setIsDefault =为每个字段输入要默认显示的选项的TRUE，并为所有其他选项输入FALSE。 例如，我们希望​ Nike ​是​ Brand ​的默认选项，而​ Print ​是​ Media ​的默认选项。

  note tip
  TIP
  每个字段只能有一个默认选项。

• setParameterID =与​ 品牌 ​自定义字段对应的选项的​ setParameterID ​为1，与​ 媒体 ​对应的选项的​ setParameterID ​为2。 PARAM和POPT工作表相互交叉引用，以指示哪些选项属于哪个自定义字段。

• setDisplayOrder=显示顺序列指示选项在自定义字段中的显示顺序。 您可以从1开始并按升序继续所有选项，无论它们属于哪个字段。 这里的重要事项是为每个选项设置唯一的数字。

• setLabel ​和​**1}列通常包含相同的信息，它们应反映Workfront UI中所需的名称。 **​setValue选项的值是报表中显示的名称，例如，而标签在附加到对象时显示在自定义表单中。 有关详细信息，请参阅创建自定义表单。

• setIsHidden =如果您希望隐藏任何选项，请输入TRUE。

（可选）如果您还想创建一个自定义表单，以便稍后在其中添加新字段，请选择​ CTGY Category ​工作表并更新自定义表单信息的以下必填列：

• isNew =在此列中为每个代表新自定义表单的行输入​ TRUE。
• ID =为表示新表单的每一行输入一个唯一数字。 您可以使用以1开头的任意数字，但前提是每个新选项或行具有唯一的数字。
• setGroupID =添加主组，或系统中您希望其成员访问此表单的任何其他组的组ID。 这是必填字段。

要查找组的ID，您可以生成组报告并在视图中添加ID字段，或者导航到组并查找组的URL。 组ID将位于组页面的URL中。 例如，如果组的URL是https://companyName.my.workfront.com/group/575b000800467a6f66e747932c807464/members，则组ID是575b000800467a6f66e747932c807464。

• setCatObjCode=这是您希望为其创建表单的对象类型的对象代码。 从以下选项输入代码：

  • 公司​ CMPY
  • 任务​ TASK
  • 项目​ PROJ
  • Portfolio的​ PORT
  • 项目群​ PRGM
  • 用户​ USER
  • 文档​ DOCU
  • 问题​ OPTASK
  • 费用​ EXPNS
  • 迭代的​ ITRN
  • 用于开票记录的​ BILL
  • 组​ GROUP

  note note
  NOTE
  对于多对象表单，请输入在UI中创建表单时将选择的第一个对象。 例如，将setCatObjCode设置为TASK，如果您要在Workfront界面中选择Task，然后选择Issue、Portfolio等，但不希望该表单在Projects中可用。

• setName =这是您希望在Workfront界面中显示的自定义表单的名称。

  已填写

将电子表格另存为.xls或.xlsx文件。 您的Excel电子表格已填写，现在可以导入到Workfront中。

单击Adobe Workfront右上角的​ 主菜单 ​图标 ，或（如果可用）单击左上角的​ 主菜单 ​图标 ，然后单击​ 设置 。

单击​ 系统>导入数据(Kick-Starts)。

单击​ 使用Kick-Start电子表格上载数据 ​部分下的​ 选择文件。

在计算机上浏览您准备的Excel电子表格，并在找到时选择它。

文件会自动上传，并显示已成功导入的通知。 根据您导入的信息量，此步骤可能需要几秒钟到一分钟的时间。

新的自定义字段和表单现在包含在Workfront系统中。 您可以在“设置”的自定义Forms区域中找到它们。

有关向自定义表单添加字段的信息，请参阅创建自定义表单。

（视情况而定）如果导入失败，您将收到一条错误消息，说明问题所在。 尝试确定出现问题的字段、工作表和行号，并更正Excel文件中的信息。 然后，再次尝试导入文件。

（视情况而定）根据错误消息中所述问题的性质，某些信息可能已导入。 必须执行下列操作之一，才能再次导入工作表：

• 从自定义Forms区域删除成功从Workfront导入的信息，然后进行错误消息所指示的更正。
• 指示系统中已经存在字段或表单，用于已导入的字段或表单，然后进行更正。
  要指示Workfront中已存在某个字段或自定义表单，您必须确保在包含有关表单(CTGY)或快速启动导入工作表中的字段(PARAM)的信息的工作表中将inNew字段标记为FALSE。