Main Content

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

oslc.rm.Requirement

OSLC需求管理领域的需求资源

自 R2021a 起

    说明

    oslc.rm.Requirement 对象表示开放生命周期协作服务 (OSLC) 服务提供商的需求管理域中的需求资源。创建并配置oslc.Clientoslc.core.QueryCapability对象后,使用queryRequirements函数向服务提供者查询可用的需求资源。

    创建对象

    使用 createRequirement 函数创建一个 oslc.rm.Requirement 对象。

    属性

    全部展开

    需求资源的导航 URL,指定为字符数组。

    对需求资源的未提交更改的指示,指定为逻辑 10,其中:

    • 1 表示需求资源有未提交的变更。

    • 0 表示需求资源没有未提交的变更。

    数据类型: logical

    需求资源获取状态,指定为逻辑 10,其中:

    • 1 表示需求资源已获取。

    • 0 表示未获取所需资源。

    数据类型: logical

    需求标题,指定为字符数组。

    OSLC 需求资源标识符,指定为字符数组。

    对象函数

    addLink添加本地 OSLC 需求资源对象的链接
    addResourceProperty将资源属性添加到本地 OSLC 资源对象
    addTextProperty将文本属性添加到本地 OSLC 资源对象
    commit将本地更改发送给 OSLC 服务提供商
    fetch从 OSLC 服务提供商处检索完整资源数据
    getLinks从 OSLC 需求资源对象获取本地存储的可追溯性链接
    getProperty从 OSLC 资源对象获取文本属性的本地内容
    getRDF从 OSLC 资源对象获取资源 RDF/XML 数据
    getResourceProperty从 OSLC 资源对象获取资源属性的本地内容
    getSLRequirements获取与 OSLC 需求资源对象关联的导入引用需求
    remove从 OSLC 服务提供商中删除资源
    removeLink从本地 OSLC 需求资源对象中删除链接
    removeResourceProperty从本地 OSLC 资源对象中删除资源属性
    setProperty设置 OSLC 资源对象的文本属性的本地内容
    setRDF为本地 OSLC 资源对象设置 RDF 内容
    setResourceProperty从 OSLC 资源对象设置资源属性的本地内容
    setResourceUrl为本地 OSLC 资源对象设置资源 URL
    show在系统浏览器中查看 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。从服务提供商处检索需求资源的完整资源数据。检查 Title 属性。

    myReq = reqs(1);
    status = fetch(myReq,myClient)
    status = 
    
      StatusCode enumeration
    
        OK
    title = myReq.Title
    title =
    
        'Requirement 1'
    

    编辑需求标题并将变更提交给服务提供商。

    myReq.Title = 'My New Requirement Title';
    status = commit(myReq,myClient)
    status = 
    
      StatusCode enumeration
    
        OK

    使用show函数在系统浏览器中打开需求资源。

    show(myReq)

    此示例显示如何使用已配置的 OSLC 客户端提交新需求资源的创建请求。

    按照为需求管理域创建并配置 OSLC 客户端中所述创建并配置 OSLC 客户端myClient后,为需求资源类型创建一个创建工厂。

    myCreationFactory = getCreationFactory(myClient,'Requirement');

    使用创建工厂创建一个名为 My New Requirement 的新需求资源。从服务提供商处检索需求资源的完整资源数据并检查该资源。

    newReq = createRequirement(myCreationFactory,'My New Requirement');
    fetch(newReq,myClient);
    newReq
    newReq = 
    
      Requirement with properties:
    
        ResourceUrl: 'https://localhost:9443/rm/resources/_72lxMWJREeup0...'
              Dirty: 0
          IsFetched: 1
              Title: 'My New Requirement'
         Identifier: '1806'

    使用show函数在系统浏览器中打开需求资源。

    show(newReq)

    版本历史记录

    在 R2021a 中推出