Interstage AR Processing Server V1.0.1 リファレンスガイド

2.1.7 QValue

2.1.7.1 データ構造

属性	説明	値型	制約
qtypeName	QAttributeと同じ	同左	required。同一qentityId/qattributeNameでunique
qentityId	親となるQEntity.id	Long	required。同一qtypeName/qattributeNameでunique
qattributeName	親となるQAttribute.name	String	required。同一qtypeName/qentityIdでunique
stringValue	親となるQAttribute.qvalueType=STRINGの場合の値	String	左記の条件でnot null。0～1000文字
longValue	親となるQAttribute.qvalueType=LONGの場合の値	Long	左記の条件でnot null
floatValue	親となるQAttribute.qvalueType=FLOATの場合の値	Float	左記の条件でnot null
version	QTypeと同じ	同左	同左

注意

値=nullを表現する場合は、QValue.xxxValue=nullを登録するのではなく、QValue自体を登録しないようにしてください。。すなわち、QAttributeはあるがQValueはない、という状態で表現する必要があります。

2.1.7.2 主キーによる特定API

Method/URL

GET http://(server):(port)/(webapp)/qvalues/(qtypename)/(qentityid)/(qattributename)

リクエスト

パスパラメータ	説明
{qtypename}パスパラメータ	QAttributeと同じ
{qentityid}パスパラメータ	qentityId
{qattributename}パスパラメータ	qattributeName

レスポンス

ヘッダ/ボディ	説明
ETagヘッダ	QTypeと同じ
ボディ	JSON形式のQValueデータ

上記は正常時のレスポンスです。異常時の場合は例外情報が出力されます。

例

http://(server):(port)/(webapp)/qvalues/設備001/9223372036854775807/備考01

2.1.7.3 検索API

Method/URL

GET http://(server):(port)/(webapp)/qvalues?(パラメータ)...

リクエスト

クエリパラメータ	説明	値型	制約等
type	QTypeと同じ	同左	同左
limitRange	QTypeと同じ	同左	同左
qtypeNameRanges	QAttributeと同じ	同左	同左
qentityIdRanges	QEntityのidRangesと同じ	同左	同左
qattributeNameRanges	QAttributeのnameRangesと同じ	同左	同左
stringValueRanges	stringValue範囲配列 例)[{"start":"神奈川県_あ","end":"神奈川県_ん"}]	List<Range<String>>	100文字以下, 5配列以下
longValueRanges	longValue範囲配列 例)[{"start":1,"end":100}]	List<Range<Long>>	5配列以下
floatValueRanges	floatValue範囲配列 例)[{"start":0.1,"end":0.9}]	List<Range<Float>>	5配列以下
sortOrders	QTYPENAME=qtypeName昇順, QTYPENAME_DESC=qtypeName降順, QENTITYID=qentityId昇順, QENTITYID_DESC=qentityId降順, QATTRIBUTENAME=qattributeName昇順, QATTRIBUTENAME_DESC=qattributeName降順 例)["QTYPENAME","QENTITYID","QATTRIBUTENAME"]	List<Enum>	default=なし(不定), 5配列以下

レスポンス

ヘッダ/ボディ	説明
ボディ	QTypeと同じ。recordsは「List<QValue>」となる。

上記は正常時のレスポンスです。異常時の場合は例外情報が出力されます。

例

http://(server):(port)/(webapp)/qvalues?type=RECORDSANDCOUNT&limitRange={"start":1,"end":10}&qtypeNameRanges=[{"start":"パソコン001","end":"パソコン999"}]&qattributeNameRanges=[{"start":"備考01","end":"備考99"}]&qentityIdRanges=[{"start":100,"end":200},{"start":300,"end":400}]&stringValueRanges=[{"start":"神奈川県_あ","end":"神奈川県_ん"}]&sortOrders=["QTYPENAME","QENTITYID","QATTRIBUTENAME"]

2.1.7.4 登録API

Method/URL

POST http://(server):(port)/(webapp)/qvalues

リクエスト

ヘッダ/ボディ	説明
ボディ	JSON形式のQValueデータ

versionには値をセットする必要はありません。登録時、サーバで新規採番されます。

レスポンス

ヘッダ/ボディ	説明
ETagヘッダ	QTypeと同じ
ボディ	JSON形式の登録後QValueデータ

2.1.7.5 削除

Method/URL

DELETE http://(server):(port)/(webapp)/qvalues/(qtypename)/(qentityid)/(qattributename)

リクエスト

ヘッダ/パス/ボディ	説明
If-Matchヘッダ	QEntityと同じ
{ qtypename }パスパラメータ	QEntityと同じ
{ qentityid }パスパラメータ	qentityId
{ qattributename}パスパラメータ	qattributeName

レスポンス

ヘッダ/ボディ	説明
ボディ	QTypeと同じ