本页采用了机器翻译。点击此处可查看最新英文版本。

getLinks

从 OSLC 需求资源对象获取本地存储的可追溯性链接

自 R2021a 起

全页折叠

    语法

    URLs = getLinks(reqResource)

    说明

    URLs = getLinks(reqResource) 返回与 reqResource 指定的需求或需求集合资源的 RDF/XML 元素 rdf:resource 的 j.0:Link 属性关联的资源 URL。有关 RDF/XML 元素的更多信息，请参阅万维网联盟网站上的 RDF 的 XML 语法和生命周期协作开放服务 (OSLC) 网站上的 QM 资源定义。

    示例

    示例

    全部折叠

    此示例显示如何添加和删除 OSLC 资源与 OSLC 需求之间的链接。

    按照为需求管理域创建和配置 OSLC 客户端中所述创建并配置 OSLC 客户端 myClient 后，为需求资源类型创建查询功能。向服务提供者提交可用的需求资源的查询请求。

    myQueryCapability = getQueryService(myClient,'Requirement');
reqs = queryRequirements(myQueryCapability)
    reqs = 

  1×30 Requirement array with properties:

    ResourceUrl
    Dirty
    IsFetched
    Title
    Identifier

    将其中一个需求分配给名为 myReq 的变量，将另一个需求分配给 linkReq。获取需求的完整资源属性。

    myReq = reqs(1);
linkReq = reqs(5);
fetch(myReq,myClient);
fetch(linkReq,myClient);

    添加从 linkReq 到 myReq 的链接。通过获取 myReq 的链接确认链接创建。

    addLink(myReq,linkReq)
links = getLinks(myReq)
    links =

  1×1 cell array

    {'https://localhost:9443/rm/CA_3d5ba3752e2c489b965a3ecceffb664a'}

    在服务提供方中，确定一个测试用例来链接到需求。识别测试用例的资源 URL 并将其分配给名为 URL 的变量。添加从 URL 到 myReq 的链接。通过获取 myReq 的链接确认链接创建。

    URL = 'https://localhost:9443/qm/_ibz6tGWYEeuAF8ZpKyQQtg';
addLink(myReq,URL)
links = getLinks(myReq)
    links =

  1×2 cell array

    {'https://localhost:9443/rm...'}    {'https://localhost:9443/qm...'}

    将变更提交给服务提供方。

    status = commit(myReq,myClient)
    status = 

  StatusCode enumeration

    OK

    获取更新需求 myReq 的完整资源属性。

    status = fetch(myReq,myClient)
    status = 

  StatusCode enumeration

    OK

    获取链接到 myReq 的资源 URL。

    links = getLinks(myReq)
    links =

  1×2 cell array

    {'https://localhost:9443/rm...'}    {'https://localhost:9443/qm...'}

    获取第一个链接资源的 URL 并将其分配给 URL。

    URL = links{1}
    URL =

    'https://localhost:9443/rm/CA_3d5ba3752e2c489b965a3ecceffb664a'

    在从 myReq 删除链接之前，请确认资源 URL 指向您要删除的需求。创建需求资源对象并设置资源 URL。获取需求的完整资源属性并检查需求。

    req = oslc.rm.Requirement;
setResourceUrl(req,URL);
status = fetch(req,myClient)
    status = 

  StatusCode enumeration

    OK

    req
    ans = 

  Requirement with properties:

    ResourceUrl: 'https://localhost:9443/rm/CA_3d5ba3752e2c489b965a...'
          Dirty: 0
      IsFetched: 1
          Title: '[SAFe] Lifecycle Scenario Template'
     Identifier: '1165'

    从 myReq 中删除链接并将更改提交给服务提供方。

    removeLink(myReq,URL)
status = commit(myReq,myClient)
    status = 

  StatusCode enumeration

    OK

    获取更新需求 myReq 的完整资源属性。

    status = fetch(myReq,myClient)
    status = 

  StatusCode enumeration

    OK

    通过获取链接到 myReq 的资源的 URL 来验证链接是否被删除。

    links = getLinks(myReq)
    links =

  1×1 cell array

    {'https://localhost:9443/qm/_ibz6tGWYEeuAF8ZpKyQQtg'}

    输入参数

    全部折叠

    OSLC 需求或需求集合资源对象，指定为 oslc.rm.Requirement 或 oslc.rm.RequirementCollection 对象。

    输出参量

    全部折叠

    与需求或需求集合资源相关联的资源的 OSLC 资源 URL，以元胞数组形式返回。

    版本历史记录

    在 R2021a 中推出

    另请参阅

    | | | | |