连接器下载：

• 2.4.4 - CAAgileCentralAddinForExcel_2.4.4.msi

适用于 Excel 的 CA Agile Central 加载项提供了一种快捷轻松的方式，以便从 CA Agile Central 订阅导入或导出数据从而进行跟踪、报告或共享：

• 可通过透视表对数据进行组织，或使用 Excel 的内置制图功能显示数据。
• 将多个 CA Agile Central 对象类型导出到多个选项卡，并交叉引用数据以实现更复杂的需求。
• 将多个 CA Agile Central 对象类型导入到 CA Agile Central。
• 使用该加载项导出项目中的所有工作项，然后将新项导入到其他项目。
• 以批量上传方式创建（不只是更新）新用户。

此安装和用户指南包括以下内容：

• 安装加载项
• 卸载加载项
• 在 Excel 内部设置该加载项
• 身份验证
  • SSO
  • 基本身份验证
• 导出数据
• 导入数据
  • 构件值字段验证
  • 导入用户
• 示例文件
• 故障排除和日志文件
  • 系统事件日志记录
  • 国际用法
• 修订历史记录 - 增强功能和已知问题

安装加载项

验证当前版本

如果您先前已安装适用于 Excel 的 CA Agile Central 加载项，请确定是否安装了当前版本：

在 Windows 中，转到“开始”→“控制面板”→“程序和功能”→“适用于 Excel 的 CA Agile Central 的加载项”。请注意，根据您的 Windows 版本不同，路径位置可能稍有不同，但可以在控制面板中找到。

先决条件：

• Windows Vista/7/8/10
• 在 32 位和 64 位系统上运行
• Microsoft Office 2007、2010、2013
• Microsoft .NET Framework 4.5（下载）
• Microsoft Visual Studio 2010 Tools for Office Runtime（下载）
注意：Microsoft 频繁更新 Microsoft Visual Studio 2010 Tools for Office Runtime 最新版本的下载位置。如果上面提供的链接没有将您引领到正确的位置，您可以在 Microsoft 网站中搜索“Runtime”并下载最新版本：http://www.microsoft.com/en-us/download/default.aspx。

连接器下载：

• 2.4.4 - CAAgileCentralAddinForExcel_2.4.4.msi

适用于 Excel 的 CA Agile Central 加载项作为单个 .msi 安装程序包分发。要进行安装，请运行 msi 文件。

如果未检测到任何先决条件，直接运行 .msi 将导致安装失败。

卸载加载项

在 Excel 的“文件”→“选项”→“加载项”对话框中禁用该加载项。

要完全卸载该加载项，请在控制面板的“添加/删除程序”或“程序和功能”部分中将其删除。

在 Excel 内部设置该加载项

安装该加载项之后，新的 CA Agile Central 选项卡会显示在 Excel 功能区中。

因为在此配置时刻不能连接到 CA Agile Central，所以将禁用大部分功能。

开始方法如下：单击“配置”区域中的“连接到 CA Agile Central”图标，在 Excel 加载项中连接到 CA Agile Central。

此操作将启动“CA Agile Central 连接设置”对话框：

重要信息：对于内部部署客户，您将需要选择“信任所有 SSL 证书”选项并在公司网络中工作，以便从 Excel 加载项连接到 CA Agile Central。

身份验证

SSO 身份验证

CA Agile Central 对于 SSO 身份验证遵循 SAML 规范。该规范要求在 SSO 身份验证握手中的参与者之间传递一个名为 RelayState 的值。RelayState 指定了用户在进行身份验证之后想要访问的最终目标，并始终是一个 URL。所有 SAML SSO 提供程序均允许用户设置此值。通常通过将一个附加 URL 参数添加到正常的 SSO 连接 URL 来完成此操作。请注意，不同的 SSO 提供程序使用不同的参数名称来设置此值。

为了使用 SSO 和 Excel 加载项成功登录，您必须运行受支持的 Internet Explorer 版本。请与您的内部 IT 部门核实以便更新为最新的 IE 版本。

如果您使用的 IE 版本不受支持，那么当尝试使用 SSO 登录时，Excel 可能会显示一条预期标识符脚本错误或不受支持的浏览器消息。Excel 加载项使用 .NET 4.5 webform 组件显示成功的 SSO IdP/Rally 登录操作的浏览器交互方面。默认情况下，.NET 在显示 webform 时将始终使用用户计算机上安装的当前版本 IE。

基本身份验证

1. 输入您的 CA Agile Central 服务器（默认为 rally1.rallydev.com）、用户名和密码。
注意：大多数用户不需要代理设置。但是，如果通过代理路由您的网络通信，将需要提供有效的代理服务器地址。如果您的代理已经过身份验证，还应指定用户名和密码。
2. 单击“保存”。遵循以下导出说明或导入说明之一以完成该过程。

将数据从 CA Agile Central 导出到 Excel

1. 单击 Excel 中的“导出”选项。



2. 定义您想要导出的“工作区”和“项目”。否则，导出过程将使用默认的工作区和项目。




3. 单击“管理查询”按钮启动“查询”对话框。




4. 单击“新建”创建新的查询。



5. 指定要导出的 CA Agile Central 对象类型，然后选择数据的排列顺序。





要导出的字段将指定为“列”文本框中以逗号分隔的列表。

“选择”按钮会启动“列”对话框以便轻松地选择字段：



您还可以在文本框中输入子对象字段。例如，您还可以将 Release.ReleaseStartDate 或 Parent.Project.Name 添加到以逗号分隔的字段列表。将“列”保留为空或指定 True 将导致返回所有字段。

注意：日期和时间字段以 UTC 格式保存并以 UTC 格式导出。
重要信息：指定子字段的唯一方法是手动键入。手动添加子字段后从选择器中选择项会清除手动输入的子字段。在手动输入和列选择器之间来回切换时，请务必谨慎。必须将 AND/OR 语句手动添加到“筛选”字段。
6. （可选）指定要应用于查询的筛选。筛选语法由 CA Agile Central WSAPI 使用并记录在此处，例如：(ScheduleState = Accepted)。

“选择”按钮会启动“筛选”对话框以便轻松地选择基本筛选：



{user} 是特殊的宏，将在运行查询时自动替换为用户参考。

可以在查询子句时使用子字段：（Release.Name 包含 "2011 Q2"）

使用 AND 或 OR 可以组合多个查询子句：((ScheduleState = Accepted) AND (Release.Name Contains "2011 Q2"))

注意：使用将查找用户情景并显示该情景的父项的查询时，您可以使用列字段中项目组合项的值以查看项目组合项的父项信息。

一旦您已定义一个或多个查询，即可导出 CA Agile Central 数据。

7. 选择一个工作表，然后在“查询”下拉列表中选择查询。


8. 单击“运行选定查询”填充当前工作表的数据。

注意：您可以设置查询行限制，值最大为 2147483647。默认值为 200 行。

当您保存工作簿时，可以在工作表中嵌入查询。“刷新所有查询”按钮会运行已保存工作簿中嵌入的所有查询。任何基于数据的数据透视图或透视表都会自动刷新。

安装程序中包含示例工作簿。您可以在安装该加载项之后访问此示例工作簿。请注意，此工作簿仅作为示例使用，不可导入到您的 CA Agile Central 工作区。

• 对于 Windows 64 位：示例文件位于 %PROGRAMFILES(x86)%\Rally Software, Inc\Rally Add-in for Excel\Sample.xlsx。
• 对于 Windows 32 位：示例文件位于 %PROGRAMFILES%\Rally Software, Inc\Rally Add-in for Excel\Sample.xlsx。

注意：凭据不会存储在 Excel 文件中，而是存储在 CA Agile Central 插件配置设置文件中。

导出测试用例步骤

重要信息：要确保正确导出测试用例步骤，请验证以下内容：

• 针对您想要导出的测试用例填充测试用例的“输入”和“预期结果”字段。

  

• 请确保不仅在“验证输入”和“验证预期结果”字段中列出测试用例步骤。使用“测试用例”类型从加载项中导出这些字段。

要了解有关使用 Excel 的测试用例和测试用例步骤的详细信息，请单击此处。

将数据从 Excel 导入到 CA Agile Central

您可以导入缺陷、迭代、项目组合项（功能、新方案及主题）、发布、任务、测试用例、测试用例结果及步骤、测试文件夹、测试集、用户和用户情景。

“导入到 CA Agile Central”功能显示了适用于您的 CA Agile Central 工作区的可导入构件类型的列表。除非您按照以下说明的技术进行操作，否则不会在 CA Agile Central 中定义使用 XML 导入的文本字段。

CA Agile Central 已经过测试并已成功导入 500,000 行数据。您可以导入的行数可能取决于您的 Excel 版本（2007 或 2010）。升级到新的 Excel 版本时，需要先卸载旧版本，然后再安装新版本。此过程将删除日志文件，但会保留配置文件。升级到新的 Excel 版本之后，将可以使用连接信息和查询。

1. 在 Excel 中连接到 CA Agile Central 之后，选择 Excel 功能区中的“导入到 CA Agile Central”。

2. 在“选择导入”窗口中，选择 CA Agile Central 中您想要导入构件类型的工作区，然后选择想要导入指定工作区的构件的类型。默认情况下，会选择上次在会话期间使用过的工作区和构件类型。

注意：如果父项、关联的需求或测试用例的名称存在重复，请选择“项目范围所有查找”复选框以将工作项关联到同一项目中的父项。如果您在不同项目中有多个工作项具有相同名称，选中该复选框会使您无需输入“格式化 ID”或“OID”即可确认您在存在名称重复工作项时想要关联的项。
3. 单击“架构”可查看选定构件类型的架构。

架构列出了有关选定构件类型的可导入值的详细信息。例如，缺陷架构列出缺陷中的所有有效字段。架构是包含 CA Agile Central 中关联类型的系统中可用的所有构件类型的子集。

可以根据需要修改字段架构列。例如，您可能想让“必填”字段位于所有列的左侧，以便您可以快速了解架构的必填字段。根据需要拖放列标题。



您可以通过单击“保存 PDF”将架构保存为 PDF 格式以供参考。

与架构相关的重要说明：

• 指定对象引用的方法有三种：“名称”（并非所有对象类型都具有名称）、“OID”和“格式化 ID”（并非所有对象类型都具有格式化 ID）。
• 可接受的布尔值包括 Yes/No、True/False 或 1/0。
• 对于日期字段，必须采用您的计算机上指定的日期格式来指定日期。
• “存在”列表示当前版本的电子表格中是否存在构件类型值。
• 对于“发布构件类型”，请在导入之前先确保电子表格有效，因为 CA Agile Central 的 Excel 加载项的撤消功能中不可删除发布，必须在 CA Agile Central 中手动删除。
• 当前的 Excel 加载项中不支持以下值：集合、附件、链接和只读。
• 下载其中包含“所有者”值的任何构件类型的架构时，架构中所列的有效值是“所有者”显示值，而不是“所有者登录用户名”。

为了使导入操作成功，电子表格需要包含所有必填字段的列。所有其他字段的列是可选的。

构件值字段验证

通过单击“验证”来验证电子表格是否准备好进行导入。该选项读取电子表格中的数据，可确保其基于架构中列出的约束有效，并搜索指定为名称或格式化 ID 的所有对象引用。如果出现验证错误，出现的弹出窗口将为您提供有关错误性质以及电子表格中发生错误的列或行的信息。您可以将该文件保存为 PDF。

单击“导入”按钮将构件数据传递给 CA Agile Central。在导入期间，您将能够根据需要暂停和恢复导入过程。导入进度窗口还详细说明了所用时间、剩余项数、平均所用时间、估算总时间、估算剩余时间和估算完成时间。

导入功能还允许您在出于任何原因而需要的情况下撤消成功的导入（发布除外）。必须在 CA Agile Central 中手动删除发布。

下面示例中是需要导入到 CA Agile Central 的用户情景的电子表格。我们审核“用户情景”构件类型并进行验证。然后，我们针对“用户情景”构件类型单击“导入”。

导入之后会出现弹出窗口，确认已导入我们的用户情景。

检查 CA Agile Central 中的工作区时，已成功添加新的用户情景。

导入用户

管理员可以使用 Excel 加载项导入多个用户。

要导入用户，请选择“用户”类型。因为导入用户时不能选择工作区，所以工作区为灰显。

您可以查看用户属性的架构。架构定义了各个可导入字段的有效值。

重要说明：

• 如果您设置用户的默认工作区，将要求您设置默认项目。
• 在用户导入过程中不遵循为工作区设置的默认项目权限（“编辑者”、“查看者”）。必须在要为其授予“编辑者”/“查看者”权限的各个项目的导入文件中指定这些权限。否则，新用户不会收到项目的任何访问权限。在工作区设置的“新用户的默认项目访问权限”字段中指定权限。
• 只能在“工作区”列中指定管理员。尝试指定项目和团队成员资格将导致出现错误。
• 设为查看者和团队成员的用户将被自动提升为编辑者。
• 用户必须设有项目权限，而可以选择性地设为团队成员。
• “会话超时”字段表示用户在会话超时之前可以登录的秒数。此字段必须为受支持范围内的离散值：1800/3600/7200/14400。
• 您无法导入超过 2000 个用户。如果尝试导入的用户超过 2000 个且开启了详细日志记录，会生成一个错误：

单击“导入”将用户导入 CA Agile Central。导入完成时，出现的弹出窗口会显示导入和撤消统计信息。例如，成功导入和撤消数、不成功的导入和撤消数、导入的用户数、撤消的用户数、导入时间和撤消持续时间。

故障排除和日志文件

如果您在导出时在 Excel 中收到此错误“值不能为 null。参数名称: obj”，则意味着没有可供 Excel 加载项写入的活动电子表格。该加载项必须使用活动的电子表格才能正常运作。

系统事件日志记录

始终记录导入和导出的错误。当选择“日志详细信息”选项时，会启用更详细的日志记录。一旦发生事务，则可以查看日志。双击日志字段中的任何条目可查看任何已执行事务的其他详细信息。该插件向 CA Agile Central 服务器发出若干不同类型的请求（GET、PUT 等等），并在各个操作期间以多种方式与 CA Agile Central 服务器进行通讯。

单击单条日志可在“日志消息”弹出窗口中显示整个日志条目。

您可以从系统中删除为 CA Agile Central Excel 加载项生成的所有请求日志。单击“清除并关闭”按钮，将从日志查看器以及从 Windows 系统事件日志的 RallyAddInForExcelLog 中删除所有日志。一旦清除日志之后，会自动关闭对话框窗口。

如果您需要将日志发送到 CA Agile Central 进行故障排除，则可以将日志保存为文件。

国际用法

某些国家/地区使用逗号 (,) 而非句点 (.) 来代表标称值。

使用 Excel 加载项（和导入模板）的欧洲客户在将 Windows 7 旗舰版与 MS Excel 2007 或 2010 组合使用时曾遇到有关小数点分隔符和列表分隔符的问题。

变通方法：如果 Excel 中的小数点分隔符设为逗号，那么将 Windows 中的列表分隔符也改为逗号不起作用。欧洲用户将需要更改为美国数字设置：小数 (. Iso ,) 和千位分隔符：(, iso .)。这让您可以在 Windows 中更改列表分隔符（从 ; 改为 ,）。

在可以导入这些更改之后，模板和 Excel 应会如预期运行。

示例文件

可以使用以下示例文件将用户、用户情景、发布或项目组合项功能导入到范围限为“工作区”→“示例项目”的默认 CA Agile Central 实例中。每个文件均包含指定 CA Agile Central 构件的必填列和字段。

• Import_Users_Required_Fields.xlsx
• Import_User_Stories_Required_Fields.xlsx
• Import_Releases_Required_Fields.xlsx
• Import_PI_Features_Required_Fields.xlsx

修订历史记录

• 2.4.4 - 2018 年 5 月
  • 增强功能：
    • TLS 1.2 支持
    • 其他安全修补程序
• 2.4.3 - 2016 年 4 月
  • 增强功能：
    • 改进的新错误消息指出，Excel 用户必须以管理员身份运行该加载项才能清除日志文件。
• 2.4.2 - 2016 年 3 月
  • 增强功能：
    • 切换工作区时，更新为范围确定用于查询项目组合项的正确工作区。
• 2.4.1.0 - 2015 年 11 月
  • 增强功能：
    • 重新设计品牌。
• 2.3.3 - 2015 年 3 月
  • 修复：
    • 创建发布和迭代时，无法指定项目。
    • 无法导入用户。
    • HtmlAgilityPack 错误。
• 2.3.2 - 2015 年 3 月
• 增强功能：
• 使用新的 Rally 徽标更新该加载项。
• 2.3.1.0 - 2014 年 11 月
• 修复：
• 当尝试使用 SSO 连接到 Rally 时会收到以下错误：连接到 Rally 出错: 无法加载文件或无法组合 'HtmlAgilityPack, Version=1.4.6.0, Culture=neutral, PublicKeyToken=bd319b19eaf3b43a' 或其依存关系之一。系统无法找到指定的文件。
• 2.3 - 2014 年 10 月
• 增强功能：
• 在“导入”对话框中，默认情况下会选择上次在会话期间使用过的工作区和构件类型。
• 如果您需要将日志发送到 Rally 进行故障排除，则可以将日志保存为文件。
• 修复：
• 导出到 Excel 时，格式文本字段（如“说明”和“注释”）的格式不正确
• 导入“项目”或“名称”字段中具有特殊字符的构件时失败
• 导入其数字名称中包含点号的情景（例如，2014.09）时失败
• 2.2.1 - 2014 年 7 月
• 修复：
  • 修复了导出到 Excel 时格式文本字段的格式出现的问题。
• 2.2 - 2014 年 7 月
  • 增强功能/修复：
    • 从 Excel 功能区中删除导入/导出模式。
    • 向功能区添加了“收藏夹”和“最近的查询”下拉菜单。
    • 为“列”选择器添加了拖放排序和选择功能。
  • 已知问题/限制：
    • 请注意，如果从版本 2.2 降级到版本 2.1.2，某些查询可能不起作用，可能需要删除。
• 2.1.2 - 2014 年 4 月
  • 增强功能/修复：
    • 导入用户时，支持新的“项目管理员”权限
    • 在没有定义任何权限的情况下不能导入用户
    • 插件已在 Excel 2013 上测试成功
    • 项目范围确定为重复的父项、关联的需求或测试用例
    • 时区允许的值现在正确
    • 正确处理包含特殊字符（如“&”）的查询
    • 在导出期间必要的情况下将创建新的电子表格
    • 正确处理将架构保存为 .pdf 这一操作
    • 能够去除已导出文本字段中的 xml/html
    • 已修复用户导入缺陷
  • 已知问题/限制：
    • 如果您要使用 SSO 通过 Excel 插件登录到 Rally，请注意以下事项： 我们的内部单点登录服务器升级之后，我们发现了通过嵌入到身份提供程序 (IDP) 登录页面的 Javascript 提交 HTML 表单出现问题。包含 Javascript 的 IDP 登录页面必须与 Internet Explorer 7 Javascript 用法兼容才能让 Rally Excel 插件与 SSO 一起正常运行。
• 2.1.1 - 2014 年 1 月
  • 增强功能/修复：
    • 支持 1,000 多个项目和工作区
• 2.1.0 - 2013 年 12 月
  • 增强功能/修复：
    • 现在，用户可以针对 Excel 使用单点登录 (SSO)
    • 现在，可以通过用户名或 OID 指定用户
    • 支持最新的 1.43 版 Web 服务 API
• 2.0.0 - 2013 年 8 月
  • 增强功能/修复：
    • 批量上传新用户，但是不允许更新现有的用户。
    • 删除了 10,000 行查询限制。
    • 现在，可以将验证错误文件保存为 PDF 格式。
    • 支持最新的 1.42 版 Web 服务 API（1.30、1.37）
  • 已知问题/限制：
    • 导入大量对象时，导入的持续时间与要导入对象的数量直接相关联。要导入的对象越多，导入过程的持续时间越长。
    • 对于其中列出运行连接器的用户的订阅之外的其他订阅中列出的重复用户，验证步骤不能正确识别。但是，导入过程结束时将列出重复用户。
    • 如果大规模网络故障中断了“导入用户”过程，您可能需要手动删除开通不完全的用户。最后的导入屏幕会显示所有导入失败的用户以帮助对创建不完全的用户进行故障排除。如果您选择使用撤消选项删除所有用户，最后的屏幕将显示未成功删除的用户。该屏幕上的其他有用统计信息包括导入/撤消成功的数量、导入/撤消失败的数量、导入的用户数、撤消的用户数、导入时间、撤消持续时间以及更多信息。
• 1.11 - 2013 年 1 月
  • 增强功能/修复：
    • 修复了功能区选项卡标签在没有配置文件时不显示的问题。
• 1.10 - 2012 年 12 月
  • 增强功能/修复：
    • 更新为支持从 Excel 导入。
  • 已知问题/限制：
    • 卸载后升级到较新版本时，不会删除所有文件。卸载之后会保留以下文件：
      Windows XP：%USERPROFILE%\Application Data\Rally\ExcelAddIn\rallyExcel.xml
      Windows Vista & 7 %USERPROFILE%\AppData\Rally\ExcelAddIn\rallyExcel.xml
      此文件用于存储先前的 Excel 加载项的配置。当加载项连接到 Rally 时，会创建此文件。更新到较新版本（例如，卸载、重新安装）之后，此文件将保留在系统上，且将包含以前的配置。然后当启动 Excel 时，在单击 Rally 的“连接”按钮之后，旧的配置将加载并显示在 Rally 的登录屏幕中。解决方案：更新之前重命名此文件（其中可能包含您想要重新使用的已保存查询）。
• 1.09 - 2012 年 8 月
  • 增强功能/修复：
    • 更新为可使用 Excel 2007 以及 Excel 2010。
    • 支持 UTF-8 字符集。
    • 不再要求安装 PIA。
    • 如果尚未出现 ObjectID 请在查询排序中包含它以便减轻问题的后果（DE14047 - 当查询使用的顺序所依据的值不是唯一值时，返回的数据会有重复和/或缺失的记录）。
  • 已知问题/限制：
    • 无
• 1.08 - 2011 年 1 月
  • 增强功能/修复：
    • 修复了刷新以前运行的查询时缺失数据的问题
  • 已知问题/限制：
    • 无