Upload
others
View
12
Download
0
Embed Size (px)
Citation preview
IBM TRIRIGA Application Platform�� 3 �� 4.2
OSLC πXΓU
IBM
��
b���ΩT�Σ�Σ��ú�ºeA�\¬� 27��yn�zñ�ΩTC
���A�≤ IBM TRIRIGA Application Platform 3.5.0 ��ß≥�����P�qAúDs�ñt�ⁿ�C
© Copyright IBM Corporation 2014, 2015.
�²
� 1 � �� OSLC πXΩ�. . . . . . 1
� 2 � @� OSLC °O�πX . . . . . 3OSLC �≤ . . . . . . . . . . . . . . . 3
OSLC Ny . . . . . . . . . . . . . . 3A�ú���A�ú���� . . . . . . . . 4OSLC W��í . . . . . . . . . . . . 5OSLC @��Ω�. . . . . . . . . . . . 5Ω��¼ . . . . . . . . . . . . . . . 6�¼σ≤ . . . . . . . . . . . . . . 6
ETag . . . . . . . . . . . . . . . . 9OSLC � IBM TRIRIGA URI . . . . . . . 10
� 3 � �� OSLC Ω� . . . . . . . 11d� OSLC Ω�. . . . . . . . . . . . . 11�� GET � POST Φkd� . . . . . . . 11OSLC d��� . . . . . . . . . . . . 11
�� OSLC Ω�. . . . . . . . . . . . . 15��@�DnO²÷p�O² . . . . . . . 16
≤s OSLC Ω�. . . . . . . . . . . . . 16
HTTP PUT Φk . . . . . . . . . . . . 17HTTP PATCH Φk . . . . . . . . . . . 18
Rú OSLC Ω�. . . . . . . . . . . . . 19���≤�Gi�Ω� . . . . . . . . . . . 20
OSLC �≤Bz . . . . . . . . . . . . 20OSLC Gi�Ω�Bz . . . . . . . . . . 21
� 4 � �z OSLC Ω� . . . . . . . 23OSLC w� . . . . . . . . . . . . . . 23KX�≤ . . . . . . . . . . . . . . 23��KX . . . . . . . . . . . . . . 24
OSLC Oⁿ . . . . . . . . . . . . . . 24
� 5 � �°�� OSLC . . . . . . . 25HTTP {íX� OSLC í� . . . . . . . . . 25
n� . . . . . . . . . . . . . . . . 27�� . . . . . . . . . . . . . . . . . 28ú�í�σ≤�°� . . . . . . . . . . . 29IBM uW⌠pvn� . . . . . . . . . . . 29
© Copyright IBM Corp. 2014, 2015 iii
iv © Copyright IBM Corp. 2014, 2015
� 1 � �� OSLC πXΩ�
z�ú���{í�í��í��{íiH�� }±íRg�≤P@�A� (OSLC)
πX���@�Ω�C OSLC �uπ≤e÷@�B@�@�Ω�C zLϕ�Wμ�w
q�Wh�ΦkA��{íiH∩t@���{í�Ω�⌡μ��BnDB≤sBR
ú@�C
OSLC �sOnΘ}o����s�APO≤���nΘRg�uπ@��DB�D
°iB�����≤�{ÑΩ��ΦíC OSLC Wμ 2.0 �Σ���{í� OSLC
πXC Wμ�ΣL OSLC Ω�b Web Wi�C
OSLC πXb°O���{í��íú����{íºíF¿C OSLC ú����{í
�ΣΩ�Ω�izL��A�ú���xs��≤°O���{íC ≤Ω�Ω�i
�A°O���{íiHbΣΩ�Pú����{í�Ω�Ω�ºí����Czi
Htm���ú�ñ�⌠≤��{íRϕ OSLC °O���{íC
pA°O���{íiHΣ��Oú����{íñΩ�� URIA����� URI
nDd��GC w∩ IBM® TRIRIGA®AA�ú��ib http://yourserver/
oslc/sp ñΣ�C
OSLC nD� URI ��H URL sXC
© Copyright IBM Corp. 2014, 2015 1
2 © Copyright IBM Corp. 2014, 2015
� 2 � @� OSLC °O�πX
z� OSLC °O���{íiHtm�Σ�Γ�¼��¼Gd����CΩ���°
O���{íqú����{í�oC
U�í�°O���{íPú����{íºí�¼�C @� OSLC °O�A��{
íiHbú����{íñd����Ω��Od��Ω����C ����A°O�
��{íiHnDú����{íd�B≤s�RúΩ�C
����
OSLC �����(��,IBM TRIRIGAAnywhere)
����
OSLC �����(��,IBM TRIRIGA)
�� Factory
����
�������
����������� !"#��
OSLC �≤
A�ú��BΩ�� ETag ú�zL OSLC �� IBM TRIRIGA Ω���n���Ω
�C
OSLC Ny
w∩ IBM TRIRIGA OSLC Nyú�wqC
°O���{í
w∩Sw���n��ñíΩ��xñΩ��@���{íC
�� Factory�≤�� HTTP POST ��sΩ�� URIC
ú����{í
b OSLC �⌠�wqñ�@���{íA���{íiNΣΩ�Ω�zL��
A�ú���xs�Aú��°O���{íC IBM TRIRIGA O IBM
TRIRIGA Anywhere μ�í��{í�ú����{íC
ú��O²
�Oú����{í�@�O²AΣñ]t°O���{íPú����{í
ºí@�h� OSLC ¼��wqC
�� URI�≤s� OSLC ú����{í�� URIC
© Copyright IBM Corp. 2014, 2015 3
d�\α
�≤�¿d�Ω� URI �≥� URIC
Ω� b OSLC �⌠�wqñAi URI �O�⌠⌠Ω�½≤�A�C
Ω�í�[c (RDF)Nϕ Web WΩT�[cC
Ω��¼
wqΩ�eBw�Ω��¼P�H�sΩ���≤Ω�ºτ�Wh�TwM
μ�WμC
Ω��¼
b OSLC �⌠�wqñA@�bπX���{íºí���Ω��¼ApA
u@@�¼A�≤nDC
A�ú��
b OSLC �⌠�wqñA@�uπ�ú��zHKα≈��Ω��Ω�xs
�C
�¼σ≤
í�Ω��¼��Σib URI ñ���O²C
A�ú���A�ú����
A�ú��Ouπ�ú��z�Ω�xs���XC A�ú��Σ�iw∩πXtm�
�ⁿΩ�]pA�D°i�@����C
OSLC ú����{íñ�A�ú��]tiHzL��{íπX���°O���{
íΩ��Ω�Ω�C IBM TRIRIGA ñ�Ω�Ω�iHh���yÑú�C YnπX
°O���{í�ú����{íA°O�������Oú����{íñi��
A�ú��C
b IBM TRIRIGA ñAA�ú��iHO�í�A]iH�]t�h�����½≤�
��{í@��°C ziH��UCΦkb IBM TRIRIGA ñ��A�ú��G
v quπ > t�]w > πX > OSLC �z{í
v �� URIGhttp://yourserver/oslc/sp
��C�ΦkAú���A�ú��MμC UCdπ��u� URIGhttp://
yourserver/oslc/sp/EmployeeC
URI ⁿV RDF/XML μí�A�ú��σ≤C �¼σ≤BA�ú��BΩ��Ω�Ω
�Σ� RDF/XML μíC °O���{íiH��A�ú��ϕμPw��Ω�i
�H����A�Apd����C
OSLC A�ú��Σ� OSLC �� Factory �d�\α@�Ao�@��°O�ú�
URI ���jMA�ú��Σ��Ω�C A�ú��σ≤í�Fi�Ω��W��
í∩MAH���Ω��A�ú��Σ��@�C
bUC��dñAOSLC A�ú��q rdfs:member eñ��C⌠��A�ú��
σ≤π�u@@�� URIG
4 © Copyright IBM Corp. 2014, 2015
<rdf:RDF><rdf:Description rdf:about="http://yourserver/oslc/sp"><rdfs:member rdf:resource="http://yourserver/oslc/sp/WorkTask"></rdf:Description></rdf:RDF>
OSLC W��í
OSLC wq@δW��íC prefixDefinition eπ�A�ú���≤í���zΩ����r-W��í∩MC
e�W���H # � / ��C pAhttp://yourserver/ns/property#C
Uϕπ� OSLC W��í�dG
r� W��í
rdf http://www.w3.org/1999/02/22-rdf-syntax-ns#
oslc http://open-services.net/ns/core#
dcterms http://purl.org/dc/terms/
asset http://open-services.net/ns#
foaf http://xmlns.com/foaf/0.1/
rdfs http://www.w3.org/2000/01/rdf-schema#
rr http://jazz.net/ns/ism/registry#
spi http://jazz.net/ns/tririga
A�ú��σ≤ºA�p��UCK²π� OSLC � RDF W��íG
<oslc:ServiceProvider rdf:about="http://yourserver/oslc/sp/WorkTask"><oslc:prefixDefinition><oslc:PrefixDefinition><oslc:prefixBase rdf:resource="http://open-services.net/ns/core#"/><oslc:prefix>oslc</oslc:prefix>
</oslc:PrefixDefinition></oslc:prefixDefinition>
<oslc:prefixDefinition><oslc:PrefixDefinition><oslc:prefixBase rdf:resource="http://www.w3.org/1999/02/22-rdf-syntax-ns#"/><oslc:prefix>rdf</oslc:prefix>
</oslc:PrefixDefinition></oslc:prefixDefinition>
OSLC @���
OSLC A�ú��Σ��� Factory �d�\α@�AH�oA�ú��σ≤ñi��
Ω�C�� Factory �ú� oslc:creation �� URIAi��� HTTP POST ��
sΩ�C ziH�� oslc:queryBase d� URIA∩�A�ú���z�Ω��XC
zLd�����oΩ��AiH≤s�RúΩ�C
�� Factory @�
pGΩ�Σ���AhiH�@��� Factory @�C A�ú��σ≤�UCK²
π��� Factory @�BΩ��¼� URL ����¼º��Ω�@�� URLC
<oslc:creationFactory><oslc:CreationFactory><oslc:resourceType rdf:resource="http://jazz.net/ns/tririga#WorkTask"/><oslc:resourceShape rdf:resource="http://yourserver/oslc/shapes/WorkTask"/><oslc:creation rdf:resource="http://yourserver/oslc/so/WorkTask"/><oslc:label>Create WorkTask</oslc:label>
� 2 � @� OSLC °O�πX 5
<dcterms:title>OSLC creation factory for WorkTask</dcterms:title></oslc:CreationFactory></oslc:creationFactory>
......
d�\α@�
d� URI O oslc:queryBaseAUCd�nD <oslc:queryBase
rdf:resource="http://yourserver/oslc/spq/oslcwodetail"/> jMu@@�G
<oslc:queryCapability><oslc:QueryCapability><oslc:resourceType rdf:resource="http://jazz.net/ns/tririga#WorkTask"/><oslc:queryBase rdf:resource="http://yourserver/oslc/so/WorkTask"/><oslc:labelQuery>WorkTask</oslc:label><dcterms:taskname>OSLC query capability for WorkTask</dcterms:taskname>
</oslc:QueryCapability></oslc:queryCapability>
wq OSLC Ω��¼�AΩ����d�úzLA�ú��ú�C zL OSLC d�
\αiH��d�C
OSLC Ω��¼ IBM TRIRIGAu°i�z{ívñwq�°iwqC Ω��¼��
°i@�d�wqΩ�i��eC ⌡μd�\α�AY��o�eC
C�d�\αú]tW�d�≥��eAzi��ªN���hM��Ω�C zL
o��hAiHw²wq�P�¼�Lo�C d�\αñ�d�≥�μ��OdPd�
]ΣWwqFΩ���e�d�W�C �d�]pGwwq���≤LoC ziHb
d�ñ�� T R I R I G A ��ApA $ $ U S E R I D $ $B $ $ R E C O R D I D $ $ �
$$PARENT::SECTIONAME::FIELDNAME$$C d�≥�O@�MμAΩ��≤�AMμe]��≤C pAMyWorkTask d����ⁿú�oXd�nDº����u@@�M
μC
Ω��¼
Ω��¼Oú�ib¼�ñ��ºΩ�Ω��¼í��uΩ�í�[c (RDF)v��C
�¼]tΩ���MμC
ziHbΩ�ϕμ�uw²v��ñ�°Ω�� RDFC
Ω��¼bwqΩ�Ω��c�ΦíWP XML ⌡ �ⁿC
�¼σ≤
OSLC ñ��¼σ≤OHqlΦíd�Ω��[A]AΣ����÷YB���eC
pAu@@��¼σ≤�CXu@@�Ω���Ω�C
�¼σ≤[\��Ω�A]AΩúBqB��μ�u@@�C �¼σ≤��π��n
�� C Ω��¼σ≤iH]Al½≤�¼σ≤���C RDF/XML �@�¼σ≤�
μíC
Ω��¼π�w∩Ω�wq�eB�@���Ω�C
b IBM TRIRIGA ñA�� OSLCuΩ�vϕμ��s�Ω��A��ⁿw��B��
½≤���½≤d�A����∩����h��½≤d�C zLb IBM TRIRIGA ñ
��d�}lCbd�ñ��π�μ�Az�bwq�leC ziH��ϕμñ�
�J��μ��@AHqd�ñ�Jπ�μ@�Ω�eC �JBz{���N IBM
TRIRIGA μ�]�∩�� OSLC e�Ap�¬C ziHb�Jºß�∩μ��
6 © Copyright IBM Corp. 2014, 2015
iH�úeC dcterms:identifier e�b�JL{ñ��O² IDC pGzp�
≤sΩ�Ah triRecordIdSY μ�O�nμ�C
Uϕπ� IBM TRIRIGA μ��¼p≤∩M� OSLC e��¼G
IBM TRIRIGA μ��¼ OSLC �e��¼
¼L OslcPropertyValueType.Boolean
��½≤ OslcPropertyValueType.String
�� OslcPropertyValueType.String
��J� OslcPropertyValueType.Decimal
CΓ OslcPropertyValueType.String
��GLoCΓμ��AURI ���wsX�
URLC N # ��N� %23C
�εX OslcPropertyValueType.String
Θ� OslcPropertyValueType.String
Θ�M�í OslcPropertyValueType.String
�≥�í OslcPropertyValueType.String
]�J� OslcPropertyValueType.Decimal
v� OslcPropertyValueType.String
�¡�� OslcPropertyValueType.String
Mμ OslcPropertyValueType.String
X OslcPropertyValueType.Decimal
KX OslcPropertyValueType.String
t��¬ OslcPropertyValueType.String
σr OslcPropertyValueType.String
�í OslcPropertyValueType.String
UOM OslcPropertyValueType.String
Url OslcPropertyValueType.String
��Ω�ⁿVn���Ω�C ªú�í�÷Y�÷prΩC UO÷prΩ�dG
u�ΩúvBu�zv�uⁿú�vC z�iHN��Ω�sW�eC ∩Mw��
μ���z¼ qA��Ω�iH��B�∩�� C
d�Gu@@��¼σ≤
u@@��¼σ≤CXu@@����eB�����÷YC UC{íXπ�W
� WorkTask �u@@��¼σ≤�K²C �Ω��¼σ≤ñ]A 4 �eA²σ
≤iHCX≤heC
<rdf:RDFxmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"xmlns:oslc="http://open-services.net/ns/core#"xmlns:spi="http://jazz.net/ns/tririga/property#"xmlns:dcterms="http://purl.org/dc/terms/">
<oslc:ResourceShape rdf:about="http://yourserver/oslc/shapes/WorkTask"><oslc:property>
<oslc:Property><oslc:representation rdf:resource="http://open-services.net/ns/core#Either"/><oslc:readOnly>false</oslc:readOnly><oslc:occurs rdf:resource="http://open-services.net/ns/core#Exactly-one"/><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#string"/><dcterms:title rdf:datatype="http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral"
� 2 � @� OSLC °O�πX 7
>ID</dcterms:title><oslc:name>RecordInformation.triIdTX>/oslc:name><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/tririga/property#triIdTX"/>
</oslc:Property></oslc:property><oslc:property>
<oslc:Property><oslc:representation rdf:resource="http://open-services.net/ns/core#Either"/><oslc.readOnly>false</oslc:readOnly><oslc:occurs rdf:resource="http://open-services.net/ns/core#Exactly-one"/><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#dateTime"/><oslc:defaultValue>TIMESTAMP</oslc:defaultValue><dcterms:title rdf:datatype="http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral">Planned Start</dcterms:title><oslc:name>RecordInformation.triPlannedStartDT</oslc:name><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/tririga/property#triPlannedStartDT"/>
</oslc:Property></oslc:property><oslc:property>
<oslc:Property><oslc:representation rdf:resource="http://open-services.net/ns/core#Either"/><oslc:readOnly>true</oslc:readOnly><oslc:occurs rdf:resource="http//open-services.net/ns/core#Exactly-one"/><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#decimal"/><dcterms:title rdf:datatype="http//www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral">Actual Total Cost</dcterms:title><oslc:name>RecordInformation.triActualTotalCostNU</oslc:name><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/tririga/property#triActualTotalCostNU"/>
</oslc:Property></oslc:property><oslc:property>
<oslc:Property><oslc:representation rdf:resource="http://open-services.net/ns/core#Either"/><oslc:readOnly>false</oslc:readOnly><oslc:occurs rdf:resource="http//open-services.net/ns/core#Exactly-one"/><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#string"/><dcterms:title rdf:datatype="http//www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral">Task Name</dcterms:title><oslc:name>RecordInformation.triNameTX</oslc:name><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/tririga/property#trNameTX"/>
</oslc:Property></oslc:property><dcterms:title>WorkTask</dcterms:title>
</oslc:ResourceShape></rdf:RDF>
�rμ�G
b OSLC ñ�w∩�rμ�ú�p������C p���O�rºk�p����C
pG�rπ�q�π�BnAh���p�����Hq�π�Bn���C pG
π�Bn≥�AB�]w�qμ� (UOM)Ah�w]���� 2C pGw∩�rμ�
]wF UOMA²�w∩μ�]wπ�BnAh��� UOM π�Bn�p���C P
wp����A� qπ�Bnñ�r� 0 � #C
d�G�rμ�ñ�p���
UCdπ�p����� 3 ����GG
<oslc:property><oslc:Property><spi:scale> 3 </spi:scale><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#decimal"/><oslc:readOnly>false</oslc:readOnly><oslc:occurs rdf:resource="http://open-services.net/ns/core#Zero-or-one" /><dcterms:title rdf:datatype="http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral">Cost </dcterms:title><oslc:name> triCostNU </oslc:name><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/spi#triCostNU" /></oslc:Property></oslc:property>
Mμ� UOM �eG
ziH�°e\Mμ��qμ� (UOM) e����C
8 © Copyright IBM Corp. 2014, 2015
Mμ� UOM eπ�]tΩ� URI � oslc:allowedValues ��C URI ���
i�≤Mμ� UOM e�i��MμC
d�
UCdπ�]t oslc:allowedValues ���eAMßπ�q��ñ� URI ú
�e\�MμG
<oslc:property><oslc:Property><oslc:defaultValue>Japan Yen</oslc:defaultValue><oslc:readOnly>false</oslc:readOnly><oslc:valueType rdf:resource="http://www.w3.org/2001/XMLSchema#string"/><oslc:usage rdf:resource="http://jazz.net/ns/ism/datatypes/smarter_physical_infrastructure#uom" /><oslc:occurs rdf:resource="http://open-services.net/ns/core#Zero-or-one" /><oslc:name>exampleUOM</oslc:name><dcterms:title rdf:datatype="http://www.w3.org/1999/02/22-rdf-syntax-ns#XMLLiteral">exampleUOM</dcterms:title><oslc:allowedValues rdf:resource="http://yourserver/oslc/system/list/resourceName/spi:exampleUOM" /><oslc:propertyDefinition rdf:resource="http://jazz.net/ns/spi#exampleUOM" /></oslc:Property></oslc:property>
<rdf:RDF><oslc:allowedValues rdf:about="http://yourserver/oslc/system/list/resourceName/spi:exampleUOM"><oslc:allowedValues><oslc:allowedValues><oslc:allowedValue>US Dollars</oslc:allowedValue><oslc:allowedValue>Swedish Krona/Kronor</oslc:allowedValue><oslc:allowedValue>Brazilian Real</oslc:allowedValue><oslc:allowedValue>Russian Ruble</oslc:allowedValue><oslc:allowedValue>Norwegian Krone</oslc:allowedValue><oslc:allowedValue>New Zealand Dollars</oslc:allowedValue><oslc:allowedValue>United Kingdom Pounds</oslc:allowedValue><oslc:allowedValue>Thai Baht</oslc:allowedValue><oslc:allowedValue>Canadian Dollars</oslc:allowedValue><oslc:allowedValue>Egyptian Pound</oslc:allowedValue><oslc:allowedValue>Euro</oslc:allowedValue><oslc:allowedValue>Polish Zloty</oslc:allowedValue><oslc:allowedValue>Korea Won</oslc:allowedValue><oslc:allowedValue>Hungarian Forint</oslc:allowedValue><oslc:allowedValue>South Africa Rand</oslc:allowedValue><oslc:allowedValue>Switzerland Francs</oslc:allowedValue><oslc:allowedValue>Japan Yen</oslc:allowedValue><oslc:allowedValue>Australia Dollars</oslc:allowedValue><oslc:allowedValue>Israeli New Shekel</oslc:allowedValue><oslc:allowedValue>Danish Krone</oslc:allowedValue><oslc:allowedValue>Indian Rupees</oslc:allowedValue><oslc:allowedValue>clIndiaRupee</oslc:allowedValue></oslc:allowedValues></oslc:allowedValues></oslc:allowedValues></rdf:RDF>
ETagETag]ΩΘ���O HTTP �YA�≤τ��ß�]pAμ�í�m�O�π��s
�O²��C oX GET nD�A��� ETag @����YC ETag �e\�ß�
oX°≤ínDC
� 2 � @� OSLC °O�πX 9
úFΣ�≥�≤sΦk HTTP PUT � HTTP PATCHAOSLC �Σ�°≤í≤sC °
≤í≤s�� HTTP ΩΘ��� If-Match �Yτ��ß�O�π��s�Ω�ΩΘC
�Bz{��≤��ú�T�≤s� �vº¼pC pApGΓ��ß�ⁿJ�P�
�Ah OSLC �b����e ETag �YC
ETag �OΩ�e�≤s�Θ�M�íC�ß�xs ETag �Y��NΣ@�ß≥≤s
nD� HTTP If-Match �Y�í��eC °A��⌠ If-Match �Y�Pw�ß��
Ω�O����O�s��C pG°A�Pw�ß���O��Ah��e� HTTP 412
precondition failed ��C �ß�A��oΩ��úμ≥≤w≤s ETag �nDC
²pG°A�Pw�ß���O�s�Ah�Ω@≤sAúDΣ�⌠≤��τ��Ω
�w¡ε�C
�ß��iHúμnDA²ú�� If-Match �Y�N If-Match �Y�]� *]P�C
úμ�nDbyNW�Ñ≤b≤snDñS� If-Match �YC bΓ�ípñA≤sO
L°≤�CpG URI � �Ω�sbABΣú���τ��Ω�w¡ε�Ah�Ω@
≤sC
OSLC � IBM TRIRIGA URI�� OSLC s�� IBM TRIRIGA ���� URI O�@�C
z��UC URI P IBM TRIRIGA suG
OSLC �≤ í�
t��� http://yourserver/oslc
nJ http://yourserver/oslc/login
nX http://yourserver/oslc/logout
�� Factory http://yourserver/oslc/so
d�\α http://yourserver/oslc/spq
d���� http://yourserver/oslc/so
Ω��¼ http://yourserver/oslc/shapes
Yns�Ω��¼�A��� http://
yourserver/oslc/shapes/ResourceShapeName
A�ú�� http://yourserver/oslc/sp
10 © Copyright IBM Corp. 2014, 2015
� 3 � �� OSLC �
z�� HTTP Φkwq���p≤��Bd�B≤s�Rú OSLC Ω�C
IBM TRIRIGA w�M����Ω�í�C S�Aϕ�w�s�A���Lk��Bd
�B≤s�RúO²C
d� OSLC Ω�
ziH�� HTTP GET Φk� HTTP POST Φkd� OSLC Ω�C ziH�≤d
����ε���p≤jMΩ�C OSLC wq≥≤ SPARQL ����q¼d�yk
d�Ω�C
�� GET � POST Φkd�
d� OSLC Ω��AziH�� HTTP GET Φk� HTTP POST ΦkC
�� HTTP GET d� OSLC Ω��A�b URI ñⁿwd���C pG URI �r
��j≤ 2000Ah���� HTTP POST �úO HTTP GET iμd�C pG URI
�r��p≤ 2000 ²�M�°A�pGQn⌠�d����Σúb URI ñπ�Az
]iH�� HTTP POSTC
�� HTTP POST d��A�N HTTP �Y Content-Type ]� application/x-www-
form-urlencodedB�eú]t��� URIA�b HTTP nDσñⁿwd���C
d�G�� HTTP GET iμd�
UO�� HTTP GET iμd��dC ��d���úb URI ñπ�C
http://yourserver/oslc/spq/WorkTaskQuery?oslc.select=spi:triNameTX,spi:RCA{spi:triRCARemedyCL}&oslc.where=spi:RCA{spi:triRCARemedyCL="Clean"}&oslc.orderBy=%2Bspi:triNameTX
d�G�� HTTP POST iμd�
UO�� HTTP POST iμ�Pd��dC URI wYuC
http://yourserver1/oslc/spq/WorkTaskQuery
HTTP �σ
HTTP nDσ]t��d���C
oslc.select=spi:triNameTX,spi:RCA{spi:triRCARemedyCL}&oslc.where=spi:RCA{spi:triRCARemedyCL="Clean"}&oslc.orderBy=%2Bspi:triNameTX
OSLC d���
OSLC d���ú�p≤d� OSLC Ω��∩�C pAoslc.orderBy ��wqd��G���C ⁿΣ�� OSLC HTTP d���� oslc.propertiesBoslc.whereBoslc.orderByBoslc.selectBoslc.pageSize � pagenoC
© Copyright IBM Corp. 2014, 2015 11
pGeúbϕμ�@δ qñAz��H sectionname#fieldname μíⁿwe�
qW�C pAtriDetails#triTaskTypeCLC
oslc.properties ��
oslc.properties d���ⁿw OSLC Ω��eMμCeiHΩ��¡���
Ω�Cª�≤�oΩ��íϕ�kC oslc.properties ��úA�≤¼�Ω�C ¼�Ω�Oπ�ΣL OSLC Ω�@�¿�� OSLC Ω�C
d�GoXnD���
UCnDdⁿw�Gñ��� shortTitle � isTask ����G
http://yourserver/oslc/so/WorkTask/337?oslc.properties=oslc:shortTitle,spi:isTask
d�G��Ω�ñoXnD���
UCnDⁿwb�Gñ���ß���W��G
http://yourserver/oslc/so/WorkTask/13353622?oslc.properties=*,spi:triCustomerOrgTX{spi:triNameTX}
�nDúUC�GG
{spi:triNameTX: "WorkTask"spi:triStatusCL: "Draft"spi:triIdTX: "1027019"-spi:triCustomerOrgTX: {
spi:triNameTX: "Company 01"rdf:about: "http://yourserver/oslc/so/OrganizationRS/12877121"
}rdf:about: "http://yourserver/oslc/so/triWorkTaskRS/13353622"-trira:action: [10]
0: "triDelete"1: "triInvalidUploadHidden"2: "triIssue"3: "triBaseline"4: "triApplyTemplate"5: "triCopy"6: "triPlanHidden"7: "triSave"8: "triSaveAndClose"9: "triTemporaryTemplate"
-prefixes: {oslc: "http://open-services.net/ns/core#"rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#"trira: "http://jazz.net/ns/tririga#"dcterms: "http://purl.org/dc/terms/"
}}
oslc.where ��
oslc.where ��ⁿw�≤Lod��G�� WHERE lyCpAzQnd�b�í
d≥���BgL�z�π�u@@� OSLC Ω�MμCziH�� oslc.where �
�A���Ω�iμLoCpAziαQn���ⁿH�°iºgz�mWLo
H�C
OSLC WHERE lyΣ�UC≥�±�BΓlG
12 © Copyright IBM Corp. 2014, 2015
�� í�
= Ñ≤
v ″value″ = Ñ≤
v ″%value″ = ��≤
v ″value%″ = }l≤
v ″%value%″ = ]t
�NApGz��o� % �Γ�ΣJ URI
@�jM�@í�Ah��∩�iμsXA
pU��G
″%25value″
!= úÑ≤
< p≤
> j≤
<= p≤�Ñ≤
>= j≤�Ñ≤
pG�nLo���D��A�b�ºßΘJμr nullC
oslc.where ����D
Θ�H ISO 8601 μíϕ�C w∩Θ�M�íμ��¼ApGμ�π�Ds@ϕ�A
h�π�@ϕC
OSLC WμΣ� and @�¼Lϕ�íºí�¼LBΓlC ¼LBΓl or úⁿΣ�C
bUCdñA¼A�σr���AϕA]�¼Ae�Ω��¼�rΩC �q�S
��A]�ª�Ω��¼�p�Cπ��¼L�]ú�n�C pA
spi:status="Closed" and spi:quantity>10.5 and spi:active=trueAΣñ spi:active
�Ω��¼�u¼LvC
OSLC Wμ�� in BΓlAbμ@eñ⌠taΣ� orC pAYnd�¼A�uw
oXv�u@�ñv���u@@�A���d� spi:status in ["Issued","Active"]
d�GjMb�íd≥���Bw�π�u@@�
UClyCXbSw�íd≥���u@@�Ω�G
spi:status="Approved" and dcterms:created>"2003-07-07T09:50:00-04:00" and
dcterms:created<="2004-07-07T09:50:00-04:00".
�� oslc.orderBy ��ⁿw��
oslc.orderBy ��wqp≤∩d��G��C pAu@@�MμiH�Θ�� ID �
�C
Yn���Θ��W���w⌠�≥�í�ε���Cu@@�A���UC
oslc.orderBy ��G+dcterms:created,-spi:estimatedDurationC + ⁿ��W��A-
ⁿ��ε��C ��HrI jC UC oslc.orderBy ��L�A]�b OSLC d
�ykñS�w]��Gdcterms:created,-spi:estimatedDurationC eW����
�T� + � -C oslc.orderBy ���Σ��¼eApA
� 3 � �� OSLC � 13
dcterms:creator{+foaf:name}CbΩ� URL ñA+ � - ú�@�Cz��b URL ñ
∩� %2B � %2DC
d�G�������
ziH����Ω��μ�@����hA����O²���O²í���Ω
�C
pAiα�W� M1 � M2 �Γ�Dn½≤C M1 π�W� L1 � L3 �Γ��
�Ω�AM2 π���Ω� L2 � L4C pGH�W����Dn½≤�ú q��Ω
�Ah�G� M1BM2C pGH�ε����Dn½≤Ah�G� M2BM1C úLA
]�½≤�h���Ω�A�HϕzH�W��ε�����A]�����Ω�C L1
� L3 b M1 ��AL2 � L4 b M2 ��C
oslc.select ��
oslc.select ��nD�X¿�Ω��íΩ�ϕ�kC oslc.select ��@A�≤�XΩ�C zⁿwnbnDñ]A�eMμC z∩��eiHΩ��¡��
�Ω�C
d�G�íΩ�nD
oslc.select ��ú�πeW��HrI j�MμC oslc.prefix ��úⁿΣ�C
UCnDOíΩ�nD�dG
oslc.select=oslc:shortTitle,dcterms:creator
d�G�������e
�� oslc.select ��AziHq��Ω�ñ∩�eC Yn�����W�ÑΩTA�N SELECT »zíⁿw�G
oslc.select= oslc:shortTitle,dcterms:creator{foaf:name}C
foaf:Person Ω�Ob���e�ñⁿw�H��W�C YnqΩ�ñ�o��eA
ziH�� oslc.select=*C�P�ykiHbjM OSLC ��M��
oslc.properties ��C
d�G�������e
�� oslc.select ��AziHq��Ω�ñ∩�eC Yn���ß��W��ÑΩTA�N SELECT »zíⁿw�G
http://yourserver/oslc/spq/WorkTaskQC?oslc.select=*,spi:triCustomerOrgTX{spi:triNameTX}&oslc.where=spi:triCustomerOrgTX!="null"
� SELECT »zíú�UC��G
{-rdf:members: [1]
-0: {spi:triNameTX: "WorkTask"spi:triStatusCL: "Draft"spi:triIdTX: "1027019"-spi:triCustomerOrgTX: {
14 © Copyright IBM Corp. 2014, 2015
spi:triNameTX: "Company 01"rdf:about: "http://yourserver/oslc/so/Organization/12877121"
}rdf:about: "http://yourserver/oslc/so/WorkTask/13353622"-trira:action: [10]
0: "triDelete"1: "triInvalidUploadHidden"2: "triIssue"3: "triBaseline"4: "triApplyTemplate"5: "triCopy"6: "triPlanHidden"7: "triSave"8: "triSaveAndClose"9: "triTemporaryTemplate"
}rdf:about: "http://yourserver/oslc/spq/WorkTask"
-prefixes: {oslc: "http://open-services.net/ns/core#"rdf: "http://www.w3.org/1999/02/22-rdf-syntax-ns#"spi: "http://jazz.net/ns/tririga#"dcterms: "http://purl.org/dc/terms/"
}}
oslc.pageSize ��
oslc.pageSize ��ⁿw°A�N���C��G�CpAoslc.pageSize=20 �Pd
����C��G�� 20C
pageno ��
pageno ��ⁿw°A�N����C pApageno=3 �Pd�u��� 3 ��Ω
�C
�� OSLC �
ziH�� HTTP POST ΦkA�� OSLC Ω��ΩCMßziHPΣL��{
í@�Ω�A��� PUTBPATCH � MERGE Φk≤sΩ�C
÷≤o�@�
OSLC �ß��e�X�¼σ≤ñoGºΩ��¼� JSON σ≤C Ω��b JSON μ
í� HTTP nDσñ�e� OSLCAHTTP �Y Content-Type �]� MIME �¼
application/jsonC pGnD�QBzAh OSLC �ß��¼�]ts��Ω�º URI
��m HTTP �YC pGQnd�s��Ω��eAziHbnDñ]Ae�YA
�ⁿ�Qnd���eC W� Properties ��Ye���ⁿw�eC
�e��nD�AziHb HTTP nD�Yñ]Aμ÷ IDCμ÷ ID b���ß��
�{íñú��O�@�CnD¿�AOSLC �bΩ�wñxsμ÷ ID ¼AC p
Gzúμ�nD]tμ÷ IDAOSLC ��dΩ�wñO�sbμ÷C pGμ÷TΩ
sbAh OSLC ú�⌡μnDC ª�����AⁿXnD]�μ÷ ID sb��¿C
HUOwⁿwμ÷ ID ��YdG
Accept: application/rdf-xmltransactionid: 6001Content-Type: application/json;charset=utf-8
pGnD�QBzAh OSLC �ß��¼�UC��G
� 3 � �� OSLC � 15
201 CreatedLocation: http://yourserver/oslc/so/WorkTask/10269ETag: 1376596202470
pG�J�@Ah�@��OO²{μ¼A����@C pApGO²�{μ¼A
Ou≤ZvAhuxsvqO����@C ��O²ºß�Is�@C
bd��G� (oslc/spq) ñApG oslc.select ]AU�r� (*)A�bd���
Ω�� (oslc/os) ñApG�ú� oslc.properties ��Ah�G]AiHw∩C����O²⌡μ����@C �@�μí� ″tririga:action″:[″action1″,″action2″,...]C
OSLC nDiα]�U��]óAp��τ�B�O��vC pAOSLC �ß�
iα¼� 400 Bad Request ��Aß�]t����Ω�� HTTP σC
��@�DnO²÷p�O²
ziH��DnO²�����Ω�C
÷≤o�@�
ziHN÷p���O²sW�DnO²C ��Ω�Pw÷p�÷p�Ω�C
d�G��]tΓ���μμ�����μ
UCΦk��]tΓ���μμ� Ω����μΩ�C ��Ω��W�O
HasPOLineItemC
{"spi:action":"Create Draft (triCreateDraft)","spi:triNameTX":"oslcPO","trirldr:HasPOLineItem":[{"spi:action":"Create (triCreate)","spi:triNameTX":"POLineItem1"
},{"spi:action":"Create (triCreate)","spi:triNameTX":"POLineItem2"
}]
}
pGnD�QBzAh OSLC �ß��¼�UC��G
201 CreatedLocation: http://yourserver/oslc/so/PO/10269ETag: 1376596202470
≤s OSLC Ω�
ziH�� HTTP PUT ΦkN OSLC Ω�� HTTP POST �N� PATCH m½AH
í�≤s OSLC Ω�C
HTTP PUT ��nDñ�eπ�NΩ�ñ�Ω�C
x-method-override � PATCH � HTTP POST ��nDñ�e�N��Ω�eC
x-method-override � PATCH B PATCHTYPE � MERGE � HTTP POST qnDñ
MΣP°A�W��������Ω���C °O�Σ�����wA≤s�íJ��
Ω���C �����úq��Ω�eñRúC
16 © Copyright IBM Corp. 2014, 2015
�e≤snD�AziHb HTTP nD�Yñ]Aμ÷ IDC μ÷ ID b���ß�
��{íñú��O�@�C nD¿�AOSLC �bΩ�wñxsμ÷ ID ¼AC
pGzúμ�nD]tμ÷ IDAOSLC ��dΩ�wñO�sbμ÷C pGμ÷T
ΩsbAh OSLC ú�⌡μnDCª�����AⁿXnD]�μ÷ ID sb��
¿C HUOwⁿwμ÷ ID ��YdG
Accept: application/rdf-xmltransactionid: 6001Content-Type: application/json;charset=utf-8
HTTP PUT Φk
HTTP PUT @��≤π�N OSLC Ω�C PUT Φk�≤sσre���Ω�
eA��RúnDñú]A�⌠≤��Ω�eC
�� PUT Φk�N OSLC Ω��AUCWhA�G
v bnDσ≤ñⁿw���σreú�≤sC �ⁿw�nD@í��⌠≤σreú
�ⁿ��TvTC ²�ⁿ��[�Ω�º���Φ�⌠tvTC �WhP��
PATCH Φk≤sΩ���PC
v ����Ω�enDñ�∩�e��NC pGnDñú]AΩ�eAh�R
ú∩�Ω�C pG]AΩ�eAhª����N°A�ñ��C
v ��Ω�Lk�T≤sC ²ziH≤s��Ω��eA�e�ϕ�σre�≤
s�¼C �WhP�� PATCH Φk≤sΩ���PC
bUCdñAu@@�Ω��@�σre taskname �@�Ω�e partsC partseⁿV��Ω��≤�PΓ��≤O²�÷pC pG PUT nD]t taskname e²ú]t parts eAh�≤s@�W��Rú�≤Ω�C
d�G≤sσr�e
UCΦk�≤sσre tasknameG
PUT http://yourserver/oslc/so/WorkTask/123
{"dcterms:taskname": "Check-out Leaking – Modified for Test"
}
pGnD�QBzAh OSLC �ß��¼�UC��G
204 No ContentETag: 1376596202470
@�W��≤� Check-out Leaking – Modified for TestC ]�Φkñú]A partsΩ�A�H�Rú�≤O²C
d�G≤s��Ω��e
UCΦk�≤sΩ�e partsG
PUT http://yourserver/oslc/so/WorkTask/123
{uspi:partsv: [
{uspi:partsid": "0000000067",
� 3 � �� OSLC � 17
"spi:quantity": 5}
]}
pGnD�QBzAh OSLC �ß��¼�UC��G
204 No ContentETag: 1376596202470
w∩ ID � 0000000067 ��≤O²iμjMC pG���≤O²sbAh�≤sC
pGΣú����Ah���s��≤O²C �u@@�Ω����ΣL�≤Ω�ú�
RúC]�Φkñú]A taskname eA�H@�W�úOnD�@í�A�úⁿvTC
HTTP PATCH Φk
PATCH �≤ OSLC Ω��í≤sC PATCH ú�RúnDñú]A�⌠≤��Ω
�eC PATCH nD POST Φk�eAΣñ x-method-override �Y]� PATCHC
�� PATCH �N OSLC ��AUCWhA�G
v bnDσ≤ñⁿw���σreú�≤sC �ⁿw�nD@í��⌠≤σreú
�ⁿ��TvTC ²�ⁿ��[�Ω�º���Φ�⌠tvTC �WhP�� PUT
Φk�NΩ���PC
v ����Ω�enDñ�∩�e�≤s��NC pGnDñú]AΩ�eA
h∩����Ω�ú�ⁿ��TvTC pG]AΩ�eAhª����N�≤s°
A�ñ��C ΣLΩ�e� PATCH RúA²ú� MERGE RúC
v ��Ω�Lk�T≤sC ²ziH≤s��Ω��eA�e�ϕ�σre�≤
s�¼C �WhP�� PUT Φk�NΩ���PC
d�G≤sσr�e
UCΦk≤su@@��@�W�eG
POST http://yourserver/oslc/so/WorkTask/123x-method-override: PATCH
{"dcterms:taskname": "Check-out Leaking – Modified for Test"
}
P PUT ΦkúPA� PATCH Φkú�≤su@@��ΣLeC
d�G≤s��Ω��e
UCΦk≤sⁿw��≤O²�RúΣLΩ�G
POST http://yourserver/oslc/so/WorkTask/123x-method-override: PATCH
{"dcterms:taskname": "Check-out Leaking – Modified for Test",uspi:partsv: [
{uspi:partsid": "0000000067",
"spi:quantity": 5}
]}
18 © Copyright IBM Corp. 2014, 2015
�Φk�μ�P PUT Φk�ⁿCt�jM ID � 0000000067 ��≤O²CpG��
�≤O²sbAh�≤sC pGΣú����Ah���s��≤O²C �u@@�
Ω����ΣL�≤O²ú�RúC
d�G≤s�X��Ω��e
UCΦk�≤sΩ�AΣñ PATCHTYPE �Y]� MERGEG
POST http://yourserver/oslc/so/WorkTask/123x-method-override: PATCHPATCHTYPE: MERGE
{"dcterms:taskname": "Check-out Leaking – Modified for Test",uspi:partsv: [
{uspi:partsid": "0000000067",
"spi:quantity": 5}
]}
w∩ ID � 0000000067 ��≤O²iμjMCpG���≤O²sbAh�≤sC p
GΣú����Ah���s��≤O²C ]� PATCHTYPE �Y]� MERGEA�H
�u@@�Ω��ΣL�≤O²OdπC
d�G⌡μ°≤í≤s
pG ETag �� 1376596202470AUCΦk�≤sΩ�G
POST http://yourserver/oslc/so/WorkTask/123x-method-override: PATCHif-match: 1376596202470
pG ETag �� 1376596202470Ah�≤su@@�Ω�A���e HTTP 204 TºC
pG ETag �úO 1376596202470Ah°A��� HTTP 412 Precondition failed T
º��C�Tºq�Ω�ΣLY�Bz{�≤sABoXnD��ß����Ω�
��C �ß���b 123 Ω�W⌡μ GET Φk�os�Ω���C
UϕJ�C�≤sΦkM��úP�¼Ω���GC
Φk σr�e ��Ω� ��Ω�
PUT pG�ñeAh
eúⁿvTC
pG�ñeAh�
RúeC
pG�ñeAh
eúⁿvTC
PATCH pG�ñeAh
eúⁿvTC
pG�ñeAh
eúⁿvTC
pG�ñeAh
eúⁿvTC
MERGE pG�ñeAh
eúⁿvTC
pG�ñeAh
eúⁿvTC
pG�ñeAh
eúⁿvTC
Rú OSLC Ω�
zi�� HTTP DELETE ΦkRú OSLC Ω�C
bΩ�� URI W�g HTTP DELETEC pGΩ���½≤�¼AqΩ��{μ¼Aα
����¼AAh½≤�¼A��≤���C
� 3 � �� OSLC � 19
pGΩ���½≤�¼A�qΩ��{μ¼Aα����¼AAh½≤�¼Aú��
≤C ziH�∩��½≤H]Aq{μ¼A����¼Aα�C z]iH�� HTTP
PUT � HTTP PATCH �úO HTTP DELETE ≤sO²A����@W�H�oRúC
pGΩ��lO²AhRúΩ���RúlO²C pGΩ��÷p�O²AhRúΩ�
��Rú÷pA²÷p�O²úⁿvTC
���≤�Gi�Ω�
OSLC �ß�iHzL OSLC API ��B���≤s�≤�Gi�Ω�C
OSLC �≤Bz
OSLC ñ��≤Bz]ABz�≤�¡]��c��σ≤�AH�Bzσ≤�÷p
meta Ω�C
meta Ω��b AttachmentDescriptor Ω� RDF ñí�C AttachmentDescriptor Ω�P
�≤@H 1:1 �÷Y�÷pC
�� OSLC �≤
z��]tGi�e� HTTP POST Φk���≤C����h�≤ HTTP POST n
DC
UCdπ��≤���≤Hπ����≤v�� HTTP nDG
POST http://yourserver/oslc/os/oslcwodetail/_abcd123/attachmentsSlug: brokenpart.jpegContent-Type: image/jpegContent-Length: 18124x-document-description: A broken partx-document-meta: Attachment
[binary content]
UCdπ�∩nD���G
HTTP/1.1 201 CREATEDLocation: http://yourserver/oslc/os/oslcwodetail/_abcd123/attachments/1Link: <http://yourserver/oslc/os/oslcwodetail/_abcd123/attachments/meta/1>;rel="describes"Content-Length: 0
Slug �YⁿX�WC ziH���Y x-document-description í��≤C �í��
∩M��≤yzlΩ�� dcterms:descriptionC ziH�� x-document-meta �Yⁿ
X�≤xs�≤�Ω�¿W�C
≤s OSLC �≤
ziH��]tGi�e� HTTP PUT Φk≤s OSLC �≤C ����h�≤
HTTP PUT nDC
UCdπ��≤≤s�≤� HTTP nDG
PUT http://yourserver/oslc/os/oslcwodetail/_abcd123/attachments/1Slug: brokenpart2.jpegContent-Type: image/jpegContent-Length: 18124
20 © Copyright IBM Corp. 2014, 2015
x-document-description: A broken partx-document-meta: Attachment
[binary content]
UCdπ�∩nD���G
HTTP/1.1 204Content-Length: 0
Y�n≤s�≤�í�AziH∩ meta URI �� PATCH nDApUCd��G
PATCH http://yourserver/oslc/os/oslcwodetail/_abcd123/attachments/meta/1Content-Type: application/json
{udcterms:descriptionv: uBroken pipev
}
∩ OSLC �≤
�≤qOP�c�Ω��÷�Ω�ApAu@μ�ΩúC �≤]iHPl�Ω��
÷pCú��c�Ω��A�w]��ú�q�Σ�÷�≤�X���C pG°O�w
��≤��Ω��¿@CA@�����c�Ω��@í�A���UCd�μíG
/oslc/os/oslcwodetail?oslc.select=res1,res2,spi:attachments{*}
Rú OSLC �≤
YnRú OSLC �≤A���UCnDG
DELETE <attachment uri>
OSLC Gi�Ω�Bz
OSLC �ß�iH�� OSLC APIAd��≤sGi�Ω�C
OSLC Σ�UCΓ��¼�Gi�Ω�G
v TRIRIGA Gi�Ω��xsb dm_content ϕμñC C�Ω���ú��@�e
IDB�WH��e{Ω�� MIME �¼C Gi�μ�]te IDC
v v�Ω��xs�v��C v�μ�]tv���í⌠�C
d�Gi�Ω�
b OSLC d��O²��Ω��ñ��Gi�Ω��A��P URI @�e{C U
Cdπ�]tGi�Ω�ΩT� URIG
http://yourserver/oslc/so/supApp/168867/tririga:supBinary
�ß�iH�� URI ��Ω�Ω�C b URI � HTTP ��ñAσ]tq
dm_content ϕμ�eμ�ñ¬��eC Content-Type �Y]tGi�Ω�� MIME
�¼C
P�aAb OSLC d��O²��Ω��ñ��v�Ω��A��P URI @�e
{C UCdπ�]tv�ΩT� URI
http://yourserver/oslc/so/supApp/168867/tririga:supImage
� 3 � �� OSLC � 21
�ß�iH�� URI ��Ω�v�C b URI � HTTP ��ñAσ]tqv��
ñ¬��v�C Content-Type �YOrΩ image/ [Wv�����Wc¿� MIME
�¼C
≤sGi�Ω�
ziH��μW� HTTP nDA≤sC�Gi��v�eC UCdπ��≤≤
sGi��v�Ω�ºnD�μíG
http://localhost:8001/oslc/so/soID/property
bdñAsoID OGi��v�e��º�z¼½≤� IDC e��O�]��G
i��v�eC ª��r�@δeμíGsectionName-propertyNameAΣñ
sectionName �∩�� C
��� HTTP PUT ΦkAHTTP �Y�e�¼]tΩ�� MIME �¼ApU��G
v w∩Gi�eAqe�¼�Y�J� MIME �¼����Ω�� MIME �¼C
ziHzL∩�� Slug �Y�J�WC
v w∩v�eAe�¼��Ov��¼C �¼Ov��μíApAPNG �
JPGC �ú�WABv��¼��@��WC
22 © Copyright IBM Corp. 2014, 2015
� 4 � �z OSLC Ω�
IBM TRIRIGA w�w∩ OSLC A�ú��O��vΣ�Cz�� OSLC Oⁿú�
��⌠�αC
OSLC w�
OSLC A���O��vΣ� IBM TRIRIGA w�ú�C
���O
°O�nDiHú� base64 sXB�≤ OSLC HTTP �Yeñ� user:password �C
�TnJ�nX
pG°O���{í�n⌡μ�TnJⁿOA���UCnDG
GET http://yourserver/oslc/login?USERNAME=username&PASSWORD=password
pG°O���{í�n⌡μ�TnXⁿOA���UCnDG
GET http://yourserver/oslc/logout
�v
�v�εbΩ����½≤h�ú�C Ω�Ω��w�Bzh≥≤��{íw�tm�
oXnDº�������s�CBz OSLC Ω��AzLw�tm�⌠��⌠≤½≤
��úú]Ab∩ OSLC nD���ñC
KX�≤
�F²�ß����α≈�≤KXAz���� IBM TRIRIGAu��]w�v��½
≤A�� MyProfile OSLC Ω�C
YnΣ�KX�≤Az���� MyProfile Ω�AΣñ��wq Password eCziH��nwqΣLeΣ�ΣL]w��≤C
ziHzL��UC URIAs� OSLC ñ� MyProfile Ω�G
http://yourserver/oslc/so/MyProfile/userId
ú�ΘJ���� ID �≤A� URI @���{μ����]w�A]�úe\�
���°ΣL����]w�C ziHwq MyProfile Ω��d�\αA²d��Gu
���{���]w�C zLkwq MyProfile ���� FactoryC
zLkzL OSLCAq MyProfile Ω����Rú MyProfile ½≤C
�� PATCH ΦkP URI i�≤]w�C�bnDñ]AUC JSON rΩ�≤K
XG
{..."spi:Password":"password",...}
KX��σrμíBwí[KC
© Copyright IBM Corp. 2014, 2015 23
bKX�≤nDñ�� HTTP POST ΦkPUC�YG
- x-method-override: PATCH- PATCHTYPE: CHPWD
Nϕu��]w�v�Ω� ID �]wb tririgaweb.properties �ñApU��G
OSLC_MYPROFILE_RESOURCE=MyProfile
��KX
pGKXw��Ah°O���{íLks�KX�≤ URI �nX URI H��⌠≤
OSLC Ω�C
�����TºGH T T P s t a t u s 4 0 3 F o r b i d d e nC pGt�e
OSLC_MYPROFILE_RESOURCE wwqAh��� JSON ��Tº]A��°O��
�{í�KX�≤nD URI � URIC
KX�¡Whb TRIRIGA ñ�uπt�]wt�KX]wñ]wC
d�G��KX��
{oslc:Error:{spi:user:{rdf:resource: "http://yourserver/oslc/so/MyProfile/13417792"}oslc:message: "Password Expired"oslc:statusCode: 403oslc:extendedError: "OSLC0054"}
}
OSLC Oⁿ
ΘxiHO²b∩�αú���⌠�iα���ΩTC
b IBM TRIRIGAu�z�D�xvñ�zOⁿC nJßA∩�¡xOⁿ > OSLCCYn÷¼OⁿA�Mú OSLC �∩C p��÷ΩTA��\mIBM TRIRIGA Appli-
cation Platform 3 �z�D�x��ΓUnC
24 © Copyright IBM Corp. 2014, 2015
� 5 � �°�� OSLC
ϕzO IBM TRIRIGA � OSLC °O��AUCú�iH�Uz°� �DC
ϕ 1. °� OSLC �ú�C
�D ��
½sRW IBM TRIRIGA °iºßAΩ��¼
úAu@
pG½sRWbΩ��¼ñwq� I B M
TRIRIGA °iAª���Ω��¼A]�wq
�°iúAsbC w²d�\α�����
Factory �Az�����TºC@δ@kOb
°iW��≤�≤sΩ��¼C �BApG�
����½≤b IBM TRIRIGA °iñ�≤A
�bΩ��¼ñ]��≤sC °iñ�u�
��mv���O��Ω��¼�b��°
iC
�nΘx∩ OSLC Ω@ú� b IBM TRIRIGAu�z�D�xvñ�zO
ⁿC nJßA∩�¡xOⁿ > OSLCC Yn
÷¼OⁿA�Mú OSLC �∩C
p��÷ΩTA��\mIBM TRIRIGA Appli-
cation Platform 3 �z�D�x��ΓUnC
∩lb olsc.where ñYX pGNμ�±b oslc.where ��ñAh��
�L�� URLC º¼pb oslc.where �
F OSLC Servlet ºeo� Apache LoCª
úb IBM TRIRIGA �εC
HTTP {íX� OSLC í�
OSLC ���� HTTP ��X@���TºC pAΣú�⌠��q�� HTTP 404
��Ab OSLC ñAΣú�Ω����� 404 ��XC
�w]Aí�{���X∩M� HTTP {íXA²ziH��n∩MB�{íXC
UC HTTP ��X OSLC Ω@G
HTTP {íX OSLC í�
200 ¿\
201 ¿\C ��]t��C
204 Ω��Q≤sC S���ΩΘC
400 BznD�o��C ���iα≤nDe� URIC pAb°A�
�iαo���Φτ���C
401 �OóC
403 wTεC ���KXL�C
404 Σú�Ω��ú��Ω��¼L�C
405 HTTP ΦkLk�≤Ω�C
406 �nD�ϕ�kúⁿΣ�C
© Copyright IBM Corp. 2014, 2015 25
HTTP {íX OSLC í�
410 ���L�C
412 �ß�W�Ω�»�A��q°A�≤sC °≤í≤sóA]�Ω�t
@�����Bz{�≤sC
500 ��ΣL°A���C
TºΣ� IBM TRIRIGA Σ��yÑC
26 © Copyright IBM Corp. 2014, 2015
n�
�ΩTYw∩ IBM bⁿΩ�ú�ºú�PA��}oCIBM iαHΣLyÑú��Ω
�CúLAiα�nDz��yÑ�@≈ú��ú����αQ�ªC
bΣLΩa�a ñAIBM úúo�ú��σ≤�ú�ºU�ú�BA��\αC �
ó�ϕa� IBM ��NϕAH�oϕa eú��ú�MA�º�÷ΩTC o≈σ≤
bú� IBM �ú�B{í�A��Aúϕ��t�uα�� IBM ú�B{í�A�C
un�I� IBM º�z]úvA⌠≤\α�ϕºú�B{í�A��i�N IBM º
ú�B{í�A�CúLA⌠≤D IBM ºú�B{í�A�A�����μtd@
�º�⌠Mτ�d⌠C
�σ≤�í�ºDDeAIBM iα��ΣMQ�MQ���C ú��σ≤úNϕú
�o�MQ��vC ziHúX�vd�Aτ�H�G
IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US
Ynd��÷���r� (DBCS) ΩT�S\v¡�yA�p�zΩa/a � IBM
�z]úí�A���ΦíH�G
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
International Business Machines Corporation u�u{pvú��X��Aúú�⌠≤�
��q�ºO�AΣñ]ABú¡≤úIvBi����Sw �ºA���⌠tO
�C���� bSwμ÷WAú�\�ú���t��O�A]�Ao�n�ú@
wAXzC
�ΩTñiα�� NW���LΩW���C ]�AIBM �w��qF�N�qß
�eJs�ñC IBM H��∩i�/��≤�X���ú��ú��/�{íAút
μq�C
�ΩTñ⌠≤∩D IBM ⌠º�z��� AIBM ∩o�⌠úú�O�Co�⌠
W�e�D� IBM ú�e�@í�A�����o�⌠��μß IC
IBM oHU� IBM {�Aϕ�Φí���¼ Q�ßú��⌠≤ΩTA�L�∩ Q
�ßtdC
pG�{íº≥�vH�F (i) b�O���{íMΣL{í]]A�{í�ºíμ½
ΩTAH� (ii) �¼���μ½�ΩTA]��n�÷�ΩTA�ó�G
© Copyright IBM Corp. 2014, 2015 27
IBM Director of Licensing
IBM Corporation
North Castle Drive, MD-NC119
Armonk, NY 10504-1785
US
WzΩ�º�o�ΣAϕ°�PSϕn≤AbY�ípU��IOΦo��C
IBM ≥≤ IBM �ßXBIBM Ω�{í�vX�Φº⌠≤PÑX�°�Aú
��σ≤�ú���v{íPΣ��A���vΩ�C
����αΩ���ßd�e{�í�º�CΩ���α�GiαHSw�tm�
B@¼p�ºC
�σ≤�ú�ºD IBM ú�ΩTA�ú�����A�ΣoG�n��ΣL}�
DCIBM ����Lo�ú�A]LkT{o�D IBM ú��⌡μ�αB�e��⌠
≤∩ú��ΣLDiO��L�C �÷D IBM ú���α�D��ó�ú��
��C
÷≤ IBM �Φw� �ºn�AH�iα≤∩�MPAú�tμq�AB�Nϕ
�PD«C
�ΩTt�Θ��B@��ºΩ�M°idC �F�iαa[Hπí�Adñ
t��HBqB�P�ú��W�C �ÑW���ΩcAZ��ⁿΩ��H�°��
�ºW��A���XC
�@vG
�ΩTt��lyѺd��{íA�Hí�U@�¡xñº{í]p NC Q�ß
iH�FπoB��BPΓ�¼�Xd��{í�A��@�¡xº��{í�
���{íAH⌠≤�í�sB�∩�¼o�d{íAú�V IBM IOCo�
d��b��ípUπ��C G IBM úO��q�O�o���{íºia�B
A���\αCo�{ídHu{¼vú�ABL⌠≤O�C IBM ∩]��o�{
íd�ú�⌠≤l�ºútdC
o�d{í�⌠≤l¿G�C≈���⌠≤í�Aú����UCΦí�J�@vn�G
©] Q�ßqW��]���C
�{íºYzí�Yl IBM q�d{íC
© Copyright IBM Corp. _enter the year or years_.
��
IBMBIBM �x� ibm.com Y International Business Machines Corp. b�y\h��
�U�����U��C ΣLú��A�W�iαO IBM �ΣLq���C IBM
����sMμib Web �u�@vP��ΩTvñΣ�A⌠}� www.ibm.com/legal/
copytrade.shtmlC
Java™ ��� Java ¼��M�xO Oracle �/�Σ÷Y°������U��C
Linux Y Linus Torvalds bⁿΩ�/�ΣLΩa�a º��C
28 © Copyright IBM Corp. 2014, 2015
MicrosoftBWindowsBWindows NT P Windows �xO Microsoft qbⁿΩ�/�Σ
LΩa�a ���C
UNIX Y The Open Group bⁿΩ�/�ΣLΩa�a º�U��C
ΣLú��A�W�iαO IBM �ΣLq���C
ú�í�σ≤�°�
o�X�����\ivYϕ�UC°����C
A��
o�°�O∩ IBM ⌠�⌠≤��°���RC
�H��
Q�ßiH�FD����pH����so�X��A²��Od��MQN�
�C pGS� IBM ��σPNA Q�ßúα¼Bπ��lo�X���Σñ�
⌠≤í�C
����
≤�� IBM Od��vn�ºí�UA Q�ß�¡≤bqí½sBGo�X�
�C b�≥o IBM �TPNºUA Q�ßúαl�@o�X��A�½sBG
�i�o�X���Σ⌠≤í��z�°��íC
vQ
úD�\in��\A�h�X���⌠≤ΩTBΩ�BnΘ�ΣL�z]úv��
a�ΣLn�B�v�v¡AL�O���t�A�úπ�OC
IBM OdbPwX�����Nl�ΣQq�Pw�AϕϕuWzⁿ��AMP�B�
��º\iv�vQC
Q�ß���ϕu��A��k�kW (]A��ⁿΩ�Xfk�kW)A�αU
ⁿBXf�AXf�ΩTC
IBM ∩o�X���eAúú�⌠≤O�C o�X��O�u{¼vú�Aút⌠
≤���q�ºO�]]A²ú¡≤iΓ�B�AIv��XSw���O��C
IBM uW⌠pvn�
]AnΘYA� MΦ�]unΘ��� v�bAIBM Software nΘú�iα��
� Cookie �ΣL N¼�ú���ΩTAH�U∩@δ���ΘτBq¡q�P
@δ����¼�A�O�≤ΣL��Cb\hípUAunΘú�PA�vú�¼
�⌠≤�H�OΩTC ���í�unΘú�PA�vi≤Uz¼��H�OΩTC p
G�unΘú�PA�v�� Cookie ¼��H�OΩTAhUí��ú�PA�º
Cookie ����÷SwΩTC
�unΘú�PA�vú��� Cookie �ΣL N¼��H�OΩTC
n� 29
pGw∩�unΘú�PA�víp�tmi�z]@��ß�ú�zL Cookie �Σ
L Nq@δ���¼��H�OΩT�αOAz�xDQΦkHh∩A�≤��
Ω�¼�º⌠≤k��÷��A]A∩i�\i�⌠≤�DC
p���U� N]]A Cookie�HF�o� ���÷ΩTA��\ IBM �u⌠p
v°�v]⌠}� http://www.ibm.com/privacy�H� IBM �uuW⌠pvn�v]⌠
}� http://www.ibm.com/privacy/details��D�“Cookies, Web Beacons and Other Tech-
nologies”�@�AH� ″IBM Software Products and Software-as-a-Service Privacy State-
ment″]⌠}� http://www.ibm.com/software/info/product-privacy/�C
30 © Copyright IBM Corp. 2014, 2015
IBM®
Printed in Taiwan