Main Content

slreq.find

要件、参照、およびリンク セットのアーティファクトの検索

ページ内をすべて折りたたむ

構文

myReqTbxObjects = slreq.find("Type",ObjectType)
myReqTbxObjects = slreq.find("Type",ObjectType,Name,Value)
myReqTbxObjects = slreq.find("Type",ObjectType,PropertyName,PropertyValue)
myReqTbxObjects = slreq.find("Type",ObjectType,PropertyOperator,PropertyValue)
myReqTbxObjects = slreq.find("Type",ObjectType,___,"-or",___)

説明

例

myReqTbxObjects = slreq.find("Type",ObjectType) は、ObjectType によって指定されたタイプの読み込まれた Requirements Toolbox™ オブジェクトを返します。

例

myReqTbxObjects = slreq.find("Type",ObjectType,Name,Value) は、Name と Value によって指定された要件タイプまたはリンク タイプを持つ、読み込まれた Requirements Toolbox オブジェクトを返します。

例

myReqTbxObjects = slreq.find("Type",ObjectType,PropertyName,PropertyValue) は、プロパティ値が PropertyName で指定されたプロパティの PropertyValue と等しい、読み込まれた Requirements Toolbox オブジェクトを返します。プロパティには、組み込みプロパティ、カスタム属性、またはステレオタイプ プロパティを指定できます。

例

myReqTbxObjects = slreq.find("Type",ObjectType,PropertyOperator,PropertyValue) は、プロパティ値 PropertyValue が PropertyOperator によって指定されたプロパティの関係条件を満たす、読み込まれた Requirements Toolbox オブジェクトを返します。

例

myReqTbxObjects = slreq.find("Type",ObjectType,___,"-or",___) は、少なくとも 1 つの条件に一致する、読み込まれた Requirements Toolbox オブジェクトを返します。

例

すべて折りたたむ

ライブ スクリプトを開く

この例では、要件を見つける方法を示します。

要件セット myAddRequirements を読み込みます。

rs = slreq.load("myAddRequirements");

読み込まれた要件を見つけます。

reqs = slreq.find("Type","Requirement")
reqs=1×4 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index
ライブ スクリプトを開く

この例では、機能要件を見つける方法を示します。

要件セット myAddRequirements を読み込みます。

rs = slreq.load("myAddRequirements");

読み込まれた機能要件を見つけます。

reqs = slreq.find("Type","Requirement","ReqType","Functional")
reqs=1×4 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index
ライブ スクリプトを開く

この例では、プロパティ値によって要件を見つける方法を示します。

要件セット myAddRequirements を読み込みます。

rs = slreq.load("myAddRequirements");

Index が 2 に設定されている、読み込まれた要件を見つけます。

req = slreq.find("Type","Requirement","Index",2);
ライブ スクリプトを開く

この例では、関係演算子を使用して、プロパティ値によって要件を見つける方法を示します。

要件セット myAddRequirements を読み込みます。

rs = slreq.load("myAddRequirements");

Index が 2 より大きい、読み込まれた要件を見つけます。

reqs = slreq.find("Type","Requirement","Index:>",2)
reqs=1×2 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index
ライブ スクリプトを開く

この例では、複数の条件を使用して、プロパティ値によって要件を見つける方法を示します。

要件セット myAddRequirements を読み込みます。

rs = slreq.load("myAddRequirements");

Index が 2 または 4 に設定されている、読み込まれた要件を見つけます。

req = slreq.find("Type","Requirement","Index",2,"-or","Index",4)
req=1×2 Requirement array with properties:
    Type
    Id
    Summary
    Description
    Keywords
    Rationale
    CreatedOn
    CreatedBy
    ModifiedBy
    IndexEnabled
    IndexNumber
    SID
    FileRevision
    ModifiedOn
    Dirty
    Comments
    Index
ライブ スクリプトを開く

この例では、指定したリンク先属性と一致するリンクを見つける方法を示します。

要件セット myAddRequirements を読み込みます。これにより、リンク セット myAdd も読み込まれます。その後、リンク セット myAdd を検索します。

slreq.load("myAddRequirements");
myLinkSet = slreq.find("Type","LinkSet","Name","myAdd");

関数 slreq.find を使用して、リンク先アーティファクトが myAddRequirements.slreqx であるリンクを検索します。

fp = which("myAddRequirements.slreqx");
myLinks = slreq.find("Type","Link","destination.artifact",fp);

find メソッドを使用して、概要が Input u であるリンク セット内のリンクを検索します。

myLinks = find(myLinkSet,"destination.summary","Input u");

入力引数

すべて折りたたむ

Requirements Toolbox オブジェクト タイプ。次のように指定します。

  • "ReqSet"

  • "Requirement"

  • "Reference"

  • "Justification"

  • "LinkSet"

  • "Link"

Requirements Toolbox オブジェクトのプロパティ名。string スカラーまたは文字ベクトルとして指定します。文字列は、次のいずれかのクラスのカスタム属性、ステレオタイプ プロパティ、または組み込みプロパティの名前でなければなりません。

ObjectType が "Link" として指定されている場合、PropertyName はリンク先属性にすることができます。次の string のいずれかとして指定します。

  • "destination.domain"

  • "desintation.artifact"

  • "destination.id"

  • "destination.summary"

リンク先属性は destination メソッドの出力の構造体フィールドに対応します。

Requirements Toolbox オブジェクトのプロパティ値。次のいずれかのデータ型として指定します。

  • string スカラー

  • 文字配列

  • boolean

  • datetime

  • single

  • double

  • int8

  • int16

  • int32

  • int64

  • uint8

  • uint16

  • uint32

  • uint64

  • enumeration

データ型は組み込みプロパティ、カスタム属性、またはステレオタイプ プロパティのタイプによって異なります。

正規表現を検索するには、構文 slreq.find("Type",ObjectType,PropertyOperator,PropertyValue) を使用し、入力 PropertyOperator に regexp を含めます。正規表現を含む string スカラーまたは文字ベクトルとして PropertyValue を指定します。詳細については、正規表現を参照してください。

Requirements Toolbox オブジェクトのプロパティ名と関係演算子または正規表現。string スカラーまたは文字ベクトルとして指定します。この引数はプロパティ名と関係演算子を 1 つの文字列または文字ベクトル内で組み合わせたもので、コロンで区切ります。たとえば、Index というプロパティと > 演算子を指定する場合の文字列は "Index:>" です。

プロパティ名は、カスタム属性、ステレオタイプ プロパティ、あるいは次のいずれかのクラスの組み込みプロパティの名前でなければなりません。

演算子は次のいずれかのオプションでなければなりません。

  • regexp

  • ==

  • ~=

  • >

  • >=

  • <

  • <=

関係演算子の詳細については、MATLAB の演算子と特殊文字を参照してください。

正規表現を検索するには、regexp 演算子を使用します。詳細については、正規表現を参照してください。

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。Name は引数名、Value は対応する値です。名前と値の引数は他の引数の後に表示されなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、名前と値をそれぞれコンマを使って区切り、Name を引用符で囲みます。

例: "ReqType","Functional"

要件タイプ。"Functional"、"Container"、または "Informational" として指定します。

例: "ReqType","Functional"

データ型: char | string

リンク タイプ。次のいずれかのタイプとして指定します。

  • "Relate"

  • "Implement"

  • "Verify"

  • "Derive"

  • "Refine"

  • "Confirm"

例: "LinkType","Relate"

データ型: char | string

出力引数

すべて折りたたむ

Requirements Toolbox オブジェクト。次のいずれかのオブジェクトのアレイとして返されます。

ヒント

  • 指定したプロパティと一致する正当化の子を見つけるには、slreq.Justification の find メソッドを使用します。

  • 指定したプロパティと一致する要件の子を見つけるには、slreq.Requirement の find メソッドを使用します。

  • 指定したプロパティと一致する参照要件の子を見つけるには、slreq.Reference の find メソッドを使用します。

  • 要件セット内の指定したプロパティと一致する要件を見つけるには、slreq.ReqSet. の find メソッドを使用します。

  • リンク セット内の指定したプロパティと一致するリンクを見つけるには、slreq.LinkSet の find メソッドを使用します。

  • リンク先属性でリンクを検索するには、ObjectType を "Link"、PropertyName をリンク先属性として指定します。リンク先属性は次の string のいずれかとして指定します。

    • "destination.domain"

    • "desintation.artifact"

    • "destination.id"

    • "destination.summary"

    たとえば、リンク先アーティファクトが myAdd.slreqx という要件セットであるリンクを見つけるには次のように入力します。

    fp = which("myAdd.slreqx");
myLinks = slreq.find("Type","Link","desintation.artifact",fp);

バージョン履歴

R2018a で導入

すべて展開する

参考

クラス