集成与执行API

的托斯卡CI / CD集成允许您将188金宝搏app苹果下载软件Tricentis托斯卡到自己的CI / CD管道。你也可以把它与其他环境,例如环境中你没有托斯卡安装。

188金宝搏app苹果下载软件Tricentis托斯卡提供了不同的方式整合托斯卡CI / CD。本主题介绍如何直接与集成执行API的托斯卡服务器,这使你在CI / CD管道最大的灵活性。

先决条件

集成与托斯卡服务器执行API,你可以使用托斯卡分布式执行《超能。
如果你使用托斯卡服务器与一个HTTPS绑定,你必须有个人的API访问令牌从 188金宝搏app苹果下载软件用户管理。你需要标记的客户ID和客户的秘密执行API访问令牌。

理解事件

的集成托斯卡服务器执行API 工作年代与事件。一个事件的集合TestEvents您想要执行。你也可以让只有一个TestEvent事件。

定义如何托斯卡处理执行在运行时,您可以添加测试配置参数和事件特征。

使用测试配置参数(安全和)

测试配置参数通常定义环境信息,例如你想使用什么浏览器UI测试。你在事件定义的参数覆盖的参数设置单独的测试。这允许您调整您的测试运行,而无需重新配置多个测试。

假设你的事件有一个包含两个ExecutionLists TestEvent。你们俩都有设置测试配置参数ExecutionLists:每个人都应该在Chrome浏览器和其他在Firefox中运行。然而,在这个特殊的测试运行,你想跑都ExecutionLists Safari。代替你ExecutionLists重新配置,您可以设置浏览器事件参数。在运行时,托斯卡适用于这个参数代替ExecutionLists上的参数。

使用特征

特征定义哪些代理执行您的测试。这些特性的等效参数设置在服务器上和适用于托斯卡销售代理。

你在事件定义的特征覆盖TestEvents中定义你所拥有的。这允许您调整您的测试运行,而无需重新配置多个测试。

假设你的活动有两个TestEvents。一个指定任何执行代理需要2 GB的内存,其他指定执行代理需要4 GB。然而,这应该只运行在特定的执行代理有8 GB的内存。代替你TestEvents重新配置,您可以设置必要的特征在你的事件。在运行时,托斯卡应用这一特点TestEvents相反的。

请求概览

你可以发送下面的请求执行API:

请求执行API访问令牌。如果你使用托斯卡服务器使用HTTPS绑定,服务器只允许经过身份验证的请求。每个请求必须有标题的访问令牌。
触发一个事件的执行。执行这个请求的响应给你一个ID,您需要为所有其他请求。
检查状态的一个事件,例如是否仍在进展或已经完成。
得到你的结果。的执行API在JUnit返回结果格式。
获得高层的信息在测试你的事件:有多少人在进步,通过,失败,或被跳过,因为托斯卡不能处理它们。

探索在吹牛

如果你想尝试的事情在你的飞跃,这是没有问题。访问招摇过市,开始:

http:// <托斯卡服务器网关IP地址或主机名>:<网关端口> / automationobjectservice /得意/ index . html

注意:您只能达到通过HTTP昂首阔步。

请求一个执行API访问令牌

如果你使用托斯卡服务器HTTPS绑定,您需要验证您的请求。每个请求都必须包含一个执行API访问令牌。

得到执行API访问令牌,发送一个请求http (s): / / <托斯卡服务器网关IP地址或主机名>:<口> /图阿/连接/令牌。包括客户机ID和客户的秘密个人API访问令牌从 188金宝搏app苹果下载软件用户管理。

示例请求和旋度:

复制

curl——位置请求邮报“https://111.111.111:443图阿/连接/令牌”\
——页眉内容类型:应用程序/ x-www-form-urlencoded \
——data-urlencode grant_type = client_credentials \
——data-urlencode client_id =你的图阿个人访问令牌>的< clientId \
——data-urlencode ' client_secret = < clientSecret图阿个人访问令牌>的

触发执行

触发一个事件的执行,发送以下请求:

POST / api /执行/排队

确保你添加CSRF头X-188金宝搏app苹果下载软件Tricentis你的请求。

请求体

添加以下请求主体:

复制

{
“projectName”:“字符串”,
“executionEnvironment”:“字符串”,
“事件”:[
{
“eventId”:“字符串”,
“参数”:{
“additionalProp1”:“字符串”,
“additionalProp2”:“字符串”,
“additionalProp3”:“字符串”
},
“特征”:{
“additionalProp1”:“字符串”,
“additionalProp2”:“字符串”,
“additionalProp3”:“字符串”
}
}
),
“importResult”:没错,
“创造者”:“字符串”
}

添加以下值:

参数	描述
projectName	项目根目录名称的托斯卡项目活动所在地。
executionEnvironment	环境中您想要执行的事件。输入敏捷。
eventId	的名字TestEvent或者的价值财产UniqueId。您可以指定多个TestEvents,由逗号隔开。
参数	定义测试配置参数。例子: `“参数”:{ “浏览器”:“火狐”, “SynchronizationTimeout”:“1700”, “夏枯草”:“组合” }`
特征	定义哪些代理应该执行您的测试。例子: `“特征”:{ “记忆”:“2 gb”, “FirefoxInstalled”:“是的”, “UseRDP”:“真正的” }`
importResult	指定是否将结果导入托斯卡: 输入真正的在你ExecutionLists看到结果托斯卡。输入假只有JUnit的结果。
创造者	的名字谁触发执行。的敏捷监控显示这个名字;默认值是ToscaExecutionClient。

示例请求和旋度:

              curl——位置请求发布的https://111.111.111:443 automationobjectservice / api /执行/排队' \
——头\ application / json - type:
——头\ X-Trice188金宝搏app苹果下载软件ntis:好的
——头的授权:无记名<执行API访问令牌>“\
——data-raw”{
“ExecutionEnvironment”:“敏捷”,
:“ProjectName MyProjectRootName”,
“事件”:[“TestEvent 1”,“TestEvent 2”),
“ImportResult”:没错,
“创造者”:“MyClientX”
}'
             

成功的响应

如果请求成功,返回的响应执行ID。你需要这个ID对于所有其他请求。

有关反应的更多信息,请参见大摇大摆文档:

http:// <托斯卡服务器网关IP地址或主机名>:<网关端口> / automationobjectservice /得意/ index . html

检查事件的当前状态

检查事件的当前状态,发送以下请求:

执行GET / api /执行/ {ID} /状态

取代执行{ID}执行ID在回应你收到“触发执行”的要求。

确保你添加CSRF头X-188金宝搏app苹果下载软件Tricentis你的请求。

示例请求和旋度:

              curl——位置请求得到“https://111.111.111:443 automationobjectservice / api /执行/ 1 a2b3c /状态”\
——头\ X-Trice188金宝搏app苹果下载软件ntis:好的
——头的授权:无记名<执行API访问令牌>“\
             

成功的响应

如果请求成功,返回的状态事件的响应。

有关反应的更多信息,请参见大摇大摆文档:

http:// <托斯卡服务器网关IP地址或主机名>:<网关端口> / automationobjectservice /得意/ index . html

得到一个事件的结果

找出您的应用程序是否被测试表现如预期的那样,发送以下请求:

执行GET / api /执行/ {ID} /结果

取代执行{ID}执行ID在回应你收到“触发执行”的要求。

确保你添加CSRF头X-188金宝搏app苹果下载软件Tricentis你的请求。

示例请求和旋度得到完整的结果:

              curl——位置请求得到“https://111.111.111:443 automationobjectservice / api /执行/ 1 a2b3c /结果”\
——头\ X-Trice188金宝搏app苹果下载软件ntis:好的
——头的授权:无记名<执行API访问令牌>“\
             

示例请求和旋度部分结果在执行之前完成:

              curl——位置请求得到“https://111.111.111:443 automationobjectservice / api /执行/ 1 a2b3c /结果?部分\ = true”
——头\ X-Trice188金宝搏app苹果下载软件ntis:好的
——头的授权:无记名<执行API访问令牌>“\
             

成功的响应

如果请求成功,返回结果的响应在JUnit格式。

有关反应的更多信息,请参见大摇大摆文档:

http:// <托斯卡服务器网关IP地址或主机名>:<网关端口> / automationobjectservice /得意/ index . html

得到一个结果汇总为一个事件

一个事件可以包含多个TestEvents。你可以请求一个高级概览:有多少人在进步,通过,失败,或被跳过,因为托斯卡不能处理它们。为此,发送以下请求:

执行GET / api /执行/ {ID} /结果/总结

取代执行{ID}执行ID在回应你收到“触发执行”的要求。

确保你添加CSRF头X-188金宝搏app苹果下载软件Tricentis你的请求。

示例请求和旋度:

              curl——位置请求得到“https://111.111.111:443 automationobjectservice / api /执行/ 1 a2b3c /结果/总结' \
——头\ X-Trice188金宝搏app苹果下载软件ntis:好的
——头的授权:无记名<执行API访问令牌>“\
             

成功的响应

如果请求成功,响应返回的概述。

有关反应的更多信息,请参见大摇大摆文档:

http:// <托斯卡服务器网关IP地址或主机名>:<网关端口> / automationobjectservice /得意/ index . html