oslc.core.QueryCapability

OSLC service provider query capability

Since R2021a

Description

Use oslc.core.QueryCapability object functions to query resources in an Open Services for Lifecycle Collaboration (OSLC) service provider. After creating and configuring an oslc.Client, you can create a query capability object for the service provider specified in the Client object.

Creation

Create an oslc.core.QueryCapability object by using getQueryService.

Properties

queryParameter — Additional query capability parameters

character array

Additional query parameters defined in query capability object, specified as a character array.

For more information, see Query Parameters in the OSLC Core Specification Version 2.0 Query Syntax.

Example: '?oslc.select=oslc_qm:testResult'

client — Associated OSLC Client

oslc.Client object

OSLC client associated with the query capability, specified as an oslc.Client object.

queryBase — Query capability resource URI

character vector

Query capability resource URI, specified as a character vector.

resourceShape — Resource URI for RDF representation of specified resource type

cell array

Resource URI for the RDF representation of the expected contents of the specified resource type, specified as a cell array.

Example: {'https://localhost:9443/rm/types/_4zFVsRL5EeuLWbFL3e4vrw'}

title — Query capability object title

character array

Query capability object title, specified as a character array.

resourceType — Resource type to query

cell array

Resource type to query the OSLC client for, specified as a cell array.

Object Functions

queryChangeRequests	Query OSLC service provider for change requests
queryRequirementCollections	Query OSLC service provider for requirement collections
queryRequirements	Query OSLC service provider for requirements
queryTestCases	Query OSLC service provider for test cases
queryTestExecutionRecords	Query OSLC service provider for test execution records
queryTestPlans	Query OSLC service provider for test plans
queryTestResults	Query OSLC service provider for test results
queryTestScripts	Query OSLC service provider for test scripts
setQueryParameter	Set query parameter for OSLC query service

Examples

Create All Available Query Capabilities for a Given Client

This example shows how to create all available query capabilities for a configured OSLC client.

After you have created and configured an OSLC client as described in Create and Configure an OSLC Client for the Requirements Management Domain, create all available query capabilities for the client myClient.

myQueryCapability = getQueryService(myClient)

myQueryCapability = 

  1×4 QueryCapability array with properties:

    queryParameter
    client
    queryBase
    resourceShape
    title
    resourceType

Examine the query capability resourceType to determine which query capability you want to use.

myQueryCapability(3).resourceType(2)

ans =

  1×1 cell array

    {'http://open-services.net/ns/rm#Requirement'}

Submit a Query Request with Query Capability

This example shows how to submit a query request with a configured OSLC client.

After you have created and configured an OSLC client myClient as described in Create and Configure an OSLC Client for the Requirements Management Domain, create a query capability for the requirement resource type.

myQueryCapability = getQueryService(myClient,'Requirement')

myQueryCapability = 

  QueryCapability with properties:

    queryParameter: ''
            client: [1×1 oslc.Client]
         queryBase: 'https://localhost:9443/rm/views?oslc.query=true&projectURL=http...'
     resourceShape: {0×1 cell}
             title: 'Query Capability'
      resourceType: {1×2 cell}

Submit a query request to the service provider for the available requirement resources.

reqs = queryRequirements(myQueryCapability)

reqs = 

  1×30 Requirement array with properties:

    ResourceUrl
    Dirty
    IsFetched
    Title
    Identifier

Assign the first returned requirement resource to the variable myReq, then fetch the full resource properties for myReq. Examine the Title property.

myReq = reqs(1);
status = fetch(myReq,myClient)

status = 

  StatusCode enumeration

    OK

title = myReq.Title

title =

    'Requirement 1'

Tips

• For information about query syntaxes, see Open Services for Lifecycle Collaboration Core Specification Version 2.0 Query Syntax on the OSLC website.

Version History

Introduced in R2021a