应用程序连接器示例

本文包含以下主题：

Dell 保修检查

Dell 保修检查连接器允许您连接到 dell 支持并检索某资产的保修信息。

请执行以下步骤：

1. 在“新建应用程序连接器”页面中，输入以下信息：
   • 应用程序连接器名称：Dell 保修检查
   • 说明（可选）
   • 连接类型：云端
   • 基础 URL：https://api.dell.com/support/v2/assetinfo
   • API 格式：XML
   • 身份验证类型：无
2. 在“操作”窗格中单击“新操作”，然后输入以下信息：
   1. “基本属性”选项卡：
      • 操作名称：获取资产保修详细信息
      • 说明（可选）
      • URL：warranty/tags.xml
      • 方法：GET

   2. “输入参数”选项卡：

      URL 参数	值	用户可识别名称
      svctags	C9CX7W1	服务标记
      apikey	d676cf6e1e0ceb8fd14e8cb69acd812d	API 密钥

   3. “输出参数”选项卡：

      1. 单击“验证”，在对话框中生成输出。

      2. 选择以下参数：

         XPath	参数	用户可识别名称
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]	a:CustomerNumber[1]	客户名称
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]	a:MachineDescription[1]	计算机说明
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[1]	a:EndDate[1]	保修 1 结束日期
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[1]	a:ServiceLevelDescription[1]	保修 1 名称
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[2]	a:EndDate[1]	保修 2 结束日期
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[2]	a:ServiceLevelDescription[1]	保修 2 名称
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[3]	a:EndDate[1]	保修 3 结束日期
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[3]	a:ServiceLevelDescription[1]	保修 3 名称
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[4]	a:EndDate[1]	保修 4 结束日期
         /GetAssetWarrantyResponse[1]/GetAssetWarrantyResult[1]/a:Response[1]/a:DellAsset[1]/a:Warranties[1]/a:Warranty[4]	a:ServiceLevelDescription[1]	保修 4 名称

3. 保存并发布连接器。 Dell 保修检查连接器已创建，并可供使用。

Rally 2.0 连接器

Rally 是一种可管理您的敏捷开发生态系统的平台。 Rally 提供用于管理版本、迭代、案例和缺陷的 API。 通过 Rally 2.0 连接器，您可以对在 Rally 中从应用程序创建版本和迭代的过程进行自动化。

请执行以下步骤：

1. 在“新建应用程序连接器”页面中，输入以下信息：
   • 应用程序连接器名称：Rally 2.0 连接器
   • 说明（可选）
   • API 版本：2.0
   • 连接类型：云端
   • 基础 URL：https://rally1.rallydev.com/slm/webservice/v2.0
   • API 格式：JSON

   • 身份验证

     归档	值
     身份验证类型	预先身份验证
     登录 URL	https://rally1.rallydev.com/slm/webservice/v2.0/security/authorize
     使用基本身份验证	True
     用户名	您的 Rally 用户名（示例：SuperAdmin@domain.com）
     密码	您的 Rally 密码
     注销 URL	https://rally1.rallydev.com/slm/webservice/v2.0/security/authorize
     输出	单击“查看测试输出并且选择参数”，然后输入以下值： 解析字符串：OperationResult.SecurityToken 识别名称：安全令牌

2. 在“操作”窗格中单击“新操作”，然后输入以下信息：
   1. 创建迭代：
      
      1. “基本属性”选项卡：
         • 操作名称：创建迭代
         • 说明（可选）
         • URL：iteration/create
         • 方法：Post

      2. “输入参数”选项卡：

         字段	值
         URL 参数	URL 参数：key 值：--（值应为空） 用户可识别名称：安全令牌（名称应匹配身份验证输出中“识别名称”的值）。
         正文	原始数据
         有效负载	复制并粘贴以下代码： 注意：使用现有代码更改“项目 ID”。 { "Iteration": { "Name": "{{Iteration Name:Iteration A}}", "Notes": "{{Iteration Notes:test}}", "PlannedVelocity": {{Iteration velocity:15}}, "Project": "https://rally1.rallydev.com/slm/webservice/v2.0/project/projectid", "StartDate": "{{Iteration Start Date:2014-09-23T06:00:00.000Z}}", "State": "Planning", "EndDate": "{{Iteration End Date:2014-10-29T06:59:59.000Z}}" } }

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            CreateResult.Object.ObjectID	迭代 ID

   2. 创建版本：单击“新操作”，然后输入以下信息：
      1. “基本属性”选项卡：
         
         • 操作名称：创建版本
         • 说明（可选）
         • URL：release/create
         • 方法：Post

          

      2. “输入参数”选项卡：

         字段	值
         URL 参数	URL 参数：key 值：--（值应为空） 用户可识别名称：安全令牌（名称应匹配身份验证输出中“识别名称”的值）。
         正文	原始数据
         有效负载	复制并粘贴以下代码： 注意：使用现有项目 ID 更改“项目 ID”。 { "Release": { "Name": "{{Release name:Release B}}", "Notes": "{{Release Notes:test}}", "PlannedVelocity": {{Release planned velocity:30}}, "Project": "https://rally1.rallydev.com/slm/webservice/v2.0/project/projectid", "State": "Planning", "ReleaseDate": "2014-09-30T06:59:59.000Z", "ReleaseStartDate": "2014-09-23T07:00:00.000Z" } }

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            CreateResult.Object.ObjectID	版本 ID

3. 保存并发布连接器。 Rally 2.0 连接器已创建，并可供使用。

ServiceAide Process Automation 连接器

Process Automation 旨在加快 IT 服务的交付速度并有助于消除人为错误。 您可以通过自动化和协调跨使用对比系统的组织孤岛之间的流程来消除人为错误。 此连接器利用其 ReST API，从而允许启动工作流、提取请求表单的列表、启动自动化工作流请求以及查询请求的状态。

请执行以下步骤：

1. 在“新建应用程序连接器”页面中，输入以下信息：
   • 应用程序连接器名称：Process Automation 连接器
   • 说明（可选）
   • API 版本：4.2
   • 连接类型：云端
   • 基础 URL：http://hostname:7000/node/rest（hostname 是安装 ITPAM 的主机的名称。）
   • API 格式：XML

   • 身份验证

     归档	值
     身份验证类型	基本身份验证
     用户名	您的 PAM 用户名
     密码	您的 PAM 密码

2. 在“操作”窗格中单击“新操作”，然后输入以下信息：
   1. 启动工作流：
      
      1. “基本属性”选项卡：
         • 操作名称：启动工作流
         • 说明（可选）
         • URL：CA:00074_CA:00074:01/_ops/Start
         • 方法：Post

      2. “输入参数”选项卡：

         字段	值
         正文	原始数据
         有效负载	复制并粘贴以下代码： <StartRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:StartRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <EntityID> <MdrElementID><上下文路径执行工作流></MdrElementID> </EntityID> </StartRequest>

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            /usm-core:EntityID[1]/usm-core:MdrElementID[1]	启动请求 ID

   2. 获取请求表单：单击“新操作”，然后输入以下信息：
      
      1. “基本属性”选项卡：
         
         • 操作名称：获取请求表单
         • 说明（可选）
         • URL：CA:00074_CA:00074:01/_ops/QueryStartRequestForms
         • 方法：Post

      2. “输入参数”选项卡：

         字段	值
         正文	原始数据
         有效负载	复制并粘贴以下代码： <QueryStartRequestFormsRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:QueryStartRequestFormsRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" ><Filter><LookUpPath>/mehni03</LookUpPath> <IsRecursive>true</IsRecursive></Filter></QueryStartRequestFormsRequest>

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            /QueryStartRequestFormsResponse[1]/StartRequestForm[1]/Description[1]	表单说明

   3. 作为请求提交：单击“新操作”，然后输入以下信息：
      
      1. “基本属性”选项卡：
         
         • 操作名称：提交请求
         • 说明（可选）
         • URL：CA:00074_CA:00074:01/_ops/SubmitStartRequestForm
         • 方法：Post

      2. “输入参数”选项卡：

         字段	值
         正文	原始数据
         有效负载	复制并粘贴以下代码： 注意：负载基于配置用于执行工作流的表单。 <SubmitStartRequestFormRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:SubmitStartRequestFormRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <Name>CasaTestForm</Name> <Path>/mehni03</Path> <Arguments> <Argument> <Name>Var_0</Name> <Value>val0</Value></Argument><Argument> <Name>Var_1</Name> <Value>true</Value> </Argument> <Argument> <Name>Var_2</Name> <Value>val2</Value></Argument></Arguments></SubmitStartRequestFormRequest>

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            /pam-ops:SubmitStartRequestFormResponse[1]/StartRequestStatus[1]/Instance	实例 ID

   4. 获取请求状态：单击“新操作”，然后输入以下信息：
      
      1. “基本属性”选项卡：
         
         • 操作名称：获取请求状态
         • 说明（可选）
         • URL：CA:00074_CA:00074:01/_ops/QueryStartRequests
         • 方法：Post

      2. “输入参数”选项卡：

         字段	值
         正文	原始数据
         有效负载	复制并粘贴以下代码： 注意：“表单 ID”（例如：CasaTestForm_120）随 PAM 安装而有所变化。 <QueryStartRequestsRequest xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="p1:QueryStartRequestsRequest" xmlns:p1="http://ns.ca.com/2011/09/pam-ops" > <Instance>{{INSTANCE:CasaTestForm_120}}</Instance> <IsArchived>false</IsArchived></QueryStartRequestsRequest>

      3. “输出参数”选项卡：

         1. 单击“验证”，在对话框中生成输出。

         2. 选择以下参数：

            参数	用户可识别名称
            /pam-ops:QueryStartRequestsResponse[1]/StartRequestInstances[1]/StartRequestInstance[1]/State	进程状态

3. 保存并发布连接器。 Process Automation 连接器已创建，并可供使用。