配置Adobe Workfront for Jira
您可以使用Adobe Workfront for Jira来集成Jira和Workfront系统。
安装加载项后，您可以定义在创建Workfront工作项时自动创建Jira问题的工作流。 两个应用程序中的项目会相互链接，并且其中的一些信息会在两个系统中自动更新。
Workfront和Jira中的所有用户都可从此集成中受益。 他们只需要许可证就可以使用他们最常使用的系统，而不需要许可证就可以同时使用两个系统。
此加载项可用于Jira软件的服务器和OnDemand （或云）版本。
有关Workfront for Jira当前支持的Jira版本的列表，请参阅Atlassian Marketplace上的Workfront for Jira。
访问要求
您必须具备以下条件：
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 计划 |
新建：任何 或 当前： Pro或更高版本 |
| Adobe Workfront 许可证 |
新文档： Standard 或 当前： 计划 |
| Jira 访问 |
系统管理员访问权限 重要提示：建议您在Jira和Workfront中创建单独的系统管理员帐户以专门用于此集成，而不是使用可能附加到用户的现有帐户。 |
| 访问级别配置 | 您必须是Workfront管理员。 |
有关此表中信息的更多详细信息，请参阅Workfront文档中的访问要求。
先决条件
在配置Workfront for Jira之前，您必须：
- 安装Workfront for Jira。
有关安装Workfront for Jira的说明，请参阅安装 Adobe Workfront for Jira。
配置Workfront for Jira
通过配置Workfront for Jira，您可以：
- 定义将在创建Workfront项时创建Jira项的触发器。
- 指定在Jira和Workfront之间链接的项之间应同步的字段。
- 在您的Jira环境中配置Workfront for Jira后，所有Jira用户都会看到针对所有Jira项目的Workfront右侧面板。 该面板包含有关可能从Workfront链接的项的信息，或指定没有Workfront项链接到Jira项。
- 使用Jira Server安装时，只有与标识为Workfront集成触发器的项目关联的问题才会显示Workfront面板。 有关为Workfront to Jira工作流设置触发器的详细信息，请参阅配置触发器以自动链接介于 Jira 和 Workfront之间的项目。
要配置Workfront for Jira：
-
以Jira管理员身份登录Jira。
-
在主Jira菜单中单击 设置。
-
单击 加载项，然后单击 管理加载项。
-
展开 Workfront 加载项。
-
单击 配置。
-
按照提示登录Workfront。
note note NOTE 用户必须在Workfront中具有有效的 apiKey才能创建成功的连接。您必须以Workfront管理员身份登录到Workfront才能继续配置。
note note NOTE - Workfront使用OAuth 2.0连接到Jira，该标准由大多数基于Web的集成用于用户身份验证和授权。
- 当系统提示您输入Workfront帐户的域时，请使用此格式键入该域： 您的公司'sDomain.my.workfront.com。 您公司的域通常是您公司的名称。
- 在Workfront管理员为此集成启用增强身份验证之前，该身份验证不可用。
-
在Jira中，选择 触发器 选项卡，以便在创建新Workfront项时配置自动创建Jira项。
有关将Workfront的触发器设置为Jira工作流的详细信息，请参阅配置触发器以自动链接介于 Jira 和 Workfront之间的项目。
-
选择 设置 选项卡以配置链接的Jira和Workfront项之间的字段同步。
有关设置Jira和Workfront之间的字段同步的详细信息，请参阅配置 Jira 和 Workfront 项之间的字段同步。
note note NOTE 定义两个应用程序之间的触发器和字段同步后，任何可以创建任务或问题的Workfront用户都可能会触发在Jira中创建项目。 如果所创建项目的条件与Jira中的触发器匹配，则用户可以创建项目，即使用户没有Jira许可证。 此外，任何Jira用户都可以立即开始处理Jira项目，并且他们的更新在Workfront中可见，而无需他们具有Workfront许可证。 Workfront中的任何更新也可在Jira项中看到。 -
（可选）选择 活动日志 选项卡以查看集成期间可能发生的任何错误。
有关活动日志的详细信息，请参阅查看 Jira 活动日志。
配置触发器以自动链接Jira和Workfront之间的项目
作为Jira系统管理员，您可以定义在Workfront中的项满足特定条件时，在Jira中自动创建问题的触发器。
在创建Workfront项时配置触发创建Jira项时，请考虑以下事项：
- 该集成是单向的：您只能触发您在Workfront中创建的项以便在Jira中自动创建。 您无法触发您在Jira中创建的项以在Workfront中自动创建。
- 您可以触发的触发器数量没有限制。
- 如果在Workfront中创建的项与多个触发器匹配，则在Jira中只创建一个项。 该项根据第一个触发器在Jira中创建（按照它们在Jira中定义的顺序）。 所有其他触发器将被忽略。
- Workfront中只能有一个项目链接到Jira中的一个项目。 您永远不能将一个Workfront项目链接到多个Jira问题，或将一个Jira问题链接到多个Workfront项目。
要配置触发器以在Jira中自动创建项目，请执行以下操作：
-
以系统管理员身份登录到Jira。
-
在主Jira菜单中单击 设置。
-
单击 插件，然后单击 管理插件。
-
展开 Workfront 加载项。
-
单击 配置。
-
以系统管理员身份登录到Workfront。
在Jira中，默认选择 触发器 选项卡。
-
单击 添加触发器 以添加新触发器。
-
在 Workfront团队/用户/角色 字段中，指定Workfront团队、用户或工作角色的名称，然后单击以将其在列表中显示。
note note NOTE 同一团队、用户或角色不能有多个触发器。 当有人创建任务或问题并将其分配给其中一个实体时，问题会在Jira中自动创建。
-
在 Jira项目 字段中，开始输入Jira项目的名称，然后单击以将其在列表中显示。
创建Jira问题后，该问题将放置到您在此处选择的项目上。
-
从下拉菜单中选择 I问题类型。
此表示当满足此触发器的条件时，根据Jira中该特定项目的设置在Jira中创建的问题类型。
-
单击 保存。
使用此配置，每次Workfront用户创建与指定触发器匹配的项时，Jira中都会创建一个新问题。
配置Jira和Workfront项之间的字段同步
作为Jira管理员，您可以定义哪些字段应该自动同步在Workfront和Jira之间链接的项目。 某些字段可以从Workfront同步到Jira项，而其他字段可以从Jira同步到Workfront。
要定义应在两个应用程序之间链接的项目上自动同步的字段，请执行以下操作：
-
以Jira管理员身份登录Jira。
-
在主Jira菜单中单击 设置。
-
单击 插件，然后单击 管理插件。
-
展开 Workfront 加载项。
-
单击 配置。
-
以Workfront管理员身份登录到Workfront。
-
在Jira中，单击 设置 选项卡。
-
在 从Workfront同步到Jira 部分中，选择在Workfront中更新时要在Jira中更新的字段。
-
选择以下任何与字段同步的频率：
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header On Creation 在Workfront中创建项时，您指定的字段会在链接的Workfront和Jira项之间同步。 Always 在Workfront中更新字段时，您指定的字段会在链接的Workfront和Jira项之间同步。 从不 您指定的字段从不在链接的Workfront和Jira项之间同步。 Jira中没有指示该字段已在Workfront中更新。 -
选择以下任一选项以同步从Workfront到Jira的字段：
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 名称 Workfront中任务或问题的名称将成为它在Jira中链接到的问题的名称。
注意：在Jira中自动创建新项目时，Workfront名称始终在Jira项目上更新，无论是否在此处启用此字段。 当Jira项手动链接到Workfront项时，当您选择 始终 同步此字段时，Workfront项的名称仅在Jira中更新。 有关手动或自动链接项目的详细信息，请参阅链接介于Adobe Workfront和Jira之间的项目。
描述 Workfront中任务或问题的描述将成为它在Jira中链接到的问题的描述。 文档 附加到Workfront中任务或问题的文档也附加到Jira中与之链接的问题。 来自Workfront的新文档版本将作为单独的文档添加到Jira中，并附加有 _v<版本号> 以指示Workfront中的编号版本。
例如，如果Workfront中文档的名称为 Main Ad，而您在Workfront中为其添加了新版本，则新版本将作为名称为 Main Ad_v2 的新文档传输到Jira。
重要提示：
同步文档时，请考虑以下事项：
-
大于5MB的文档不会同步。 如果文档同步因文档太大而失败，则活动日志中会记录一个错误。
有关活动日志的详细信息，请参阅查看Jira活动日志。
-
链接到来自外部服务器的任务和问题的文档未传输到Jira项。 只有直接在任务中上传的文档或Workfront中的问题才会传输到Jira中的链接问题。
-
要从文档创建验证，必须在Workfront中生成验证。
计划完成日期 Workfront中任务或问题的规划完成日期将变为Jira中链接到的问题的到期日期。
注意：请确保在Jira个问题上显示 到期日期，以便同步该值。
-
-
-
在 从Jira同步到Workfront 分区中，选择在Jira中更新时要在Workfront中更新的字段。
-
选择以下任何与字段同步的频率：
table 0-row-2 1-row-2 layout-auto html-authored no-header Always 在Jira中更新字段时，您指定的字段始终在链接的Workfront和Jira项之间同步。 从不 您指定的字段从不在链接的Workfront和Jira项之间同步。 Workfront中没有指示该字段已在Jira中更新。
注意：当您选择“从不”时，仍然可以从Jira问题左侧Workfront面板的Jira手动更新Workfront字段。 这些更新仅显示在Jira和Workfront中的Workfront项中，而不显示在Jira项中。
-
选择以同步从Jira到Workfront的以下任何字段：
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header 状态 Jira中问题的状态将变为Workfront中链接到的任务或问题的状态。
有关Workfront状态的详细信息，请参阅创建或编辑状态。被分派人 Jira中问题的任务接受者成为Workfront中链接到的任务或问题的任务接受者。
重要提示：当您将Jira中的项分配给没有Workfront帐户的用户时，只有当Jira用户没有Workfront帐户的 在Workfront中自动创建用户设置为 Always 时，集成才会在Workfront中创建新的活动用户。 此用户未占用Workfront许可证。 可将活动用户分配给Workfront中的工作项，但不能将其包含在更新中。
附件 Jira中问题的附件也附加到Workfront中链接到的任务或问题。 Comments 有关Jira问题的注释也会发布在更新区域的链接Workfront项上。 相反，更新区域中针对Workfront任务或问题的注释同步到Jira的链接问题的本机注释流。
默认情况下设置为 Always。 如果在此选择 Never，则仍可在Workfront或Jira中对链接项手动发布评论。
-
-
在 OTHER 部分中，选择应在链接项之间更新的其他字段。
-
选择一个选项，以确定您指定的字段 始终 还是 从不 在Jira或Workfront中进行更新（修改时）。
-
从以下字段和更新中进行选择：
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header [！UICONTROL在Jira的右侧面板中复制Workfront自定义数据 在Workfront右侧面板中显示项目的Workfront自定义数据。
注意：自定义表单分区显示在Workfront右侧面板中，其访问级别为Workfront系统管理员。
[！UICONTROL复制Jira中右侧面板的Workfront优先级 在Workfront右侧面板中显示项目的Workfront优先级。 [！UICONTROL在Workfront更新选项卡中添加有关Jira中到期日期更改的更新 当链接的Jira项中的截止日期发生更改时，在Workfront项的更新选项卡中添加注释。 如果Jira用户没有Workfront帐户，则在Workfront中自动创建用户 存在以下情况：
-
当您选择 Always 时，您可以启用集成，以便在每次没有Workfront帐户的Jira用户对链接的Jira问题执行以下操作，创建新的Workfront用户：
-
已分派到Jira问题
-
将时间记录到Jira问题
此新用户未占用Workfront许可证。 默认设置为“始终”。 在Workfront中通过这种方式创建的用户在名称中添加了“Jira”。
-
-
选择 Never 时，会发生以下情况：
- 在Workfront项中看不到任何Jira分配。 在这种情况下，只有在Workfront中进行的分配会显示在Workfront项中。
- 没有Workfront帐户的用户登录到链接的Jira问题的时间不会自动传输到链接的Workfront项目。 您仍然可以在Jira问题的右侧面板中的Workfront项上记录时间。
-
-
-
单击 保存。
现在，每次用户更新此配置中针对Jira或Workfront中的项指定的任何字段时，另一个应用程序中的链接项也会更新。
故障排除
无法在Jira中创建项目，因为未能找到标记为“”的触发器字段”
问题
当Workfront for Jira应用程序发生错误时，Workfront将禁用触发器以防止进一步的复杂性。 禁用这些触发器后，它们显示为“找不到”。
解决方案
找到禁用触发器的错误。 您可以在Workfront for Jira 活动日志中找到该错误。
导致此行为的最常见原因是错误''无法设置字段'duedate'。 它不在相应的屏幕上，或者未知。”
此错误表示您正在尝试将"计划完成日期"从Workfront同步到Jira。 为此，您必须确保您的Jira对象具有一个名为“到期日期”的字段。 如果他们没有此字段，Workfront将无法从Workfront同步计划完成日期，并禁用您的触发器。
要解决此错误，请尝试以下操作之一：
- 要求您的Jira管理员更新受影响的Jira对象，以确保它们具有到期日期字段。
- 在Workfront 设置页面中禁用Workfront计划完成日期的同步。