Prev Next

Updating Resources and Resource Features

Enterprise Architect supports a Resource and Resource Feature update service, through which Clients can update the properties of existing Resources and Resource Features of these types via HTTP POST:

  • Resources
         -  Packages
         -  Elements
         -  Connectors
  • Resource Features
         -  Package/Element/Diagram Discussions, Discussion Replies, Resource Allocations, Tests,
            Tagged Values, Maintenance Items and Project Management Items
         -  Element Attributes, Operations and Operation Parameters

As per the OSLC Specification, the Client has to perform these actions to update an OSLC Resource:

  • Fetch the RDF/XML representation of the Resource via HTTP GET
  • Update the representation
  • Use HTTP PUT to send the new representation to the Resource's URL

However, in Enterprise Architect, to update a Resource or Resource Feature the Client has to POST a representation of the Resource or Resource Feature in RDF XML format to the Update URL. If the POST is successful, the response will contain the URL of the updated Resource. An unsuccessful POST will generate an error response.

These are the steps involved in updating a Resource or Resource Feature in Enterprise Architect:

  • The Client fetches the RDF/XML representation of the Resource or Resource Feature to update via HTTP GET
  • The Client updates the Resource or Resource Feature properties in the RDF/XML representation
  • The Client POSTs the updated RDF/XML representation to the Resource or Resource Feature's Update URL

Refer to the tables in this topic for the information used to update each Resource and Feature. Also see the GUID Prefix Tables and Examples of  Resource Update RDF/XML topics.

Package

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/resource/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" GUID

                xmlns:dcterms="http://purl.org/dc/terms/"

                xmlns:foaf="http://xmlns.com/foaf/0.1/"

                xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <oslc_am:Resource>

          <!--Required Property-->

          <dcterms:identifier>GUID OF PACKAGE (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>NAME</dcterms:title>

          <dcterms:subject>KEYWORDS</dcterms:subject>

          <dcterms:creator>

               <foaf:Person>

                    <foaf:name>AUTHOR</foaf:name>

               </foaf:Person>

          </dcterms:creator>

          <dcterms:description>NOTES</dcterms:description>

          <ss:alias>ALIAS</ss:alias>

          <ss:status>STATUS</ss:status>

          <ss:complexity>COMPLEXITY</ss:complexity>     

          <ss:phase>PHASE</ss:phase>

          <ss:version>VERSION</ss:version>

          <ss:language>LANGUAGE</ss:language>

     </oslc_am:Resource>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/resource/

Element

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/resource/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/" 

                 xmlns:foaf="http://xmlns.com/foaf/0.1/"

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <oslc_am:Resource>

          <!--Required Property-->

          <dcterms:identifier>GUID OF ELEMENT (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>NAME</dcterms:title>

          <dcterms:subject>KEYWORDS</dcterms:subject>

          <dcterms:creator>

               <foaf:Person>

                    <foaf:name>AUTHOR</foaf:name>

               </foaf:Person>

          </dcterms:creator>

          <dcterms:description>NOTES</dcterms:description>

          <ss:alias>ALIAS</ss:alias>

          <ss:status>STATUS</ss:status>

          <ss:complexity>COMPLEXITY</ss:complexity>     

          <ss:phase>PHASE</ss:phase>

          <ss:version>VERSION</ss:version>

          <ss:language>LANGUAGE</ss:language>

     </oslc_am:Resource>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/resource/

Element Attribute

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/attribute/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                xmlns:dcterms="http://purl.org/dc/terms/"

                xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:attribute>

          <!--Required Properties-->

          <dcterms:identifier>GUID OF ATTRIBUTE (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

         <!--Required in a Security Enabled Model-->

         <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>ATTRIBUTE NAME</dcterms:title>

          <ss:classifiername>DATATYPE/CLASSIFIER NAME</ss:classifiername>

          <dcterms:description>NOTES</dcterms:description>

          <ss:alias>ALIAS</ss:alias>

          <ss:classifierresourceidentifier>GUID OF THE CLASSIFIER EA ELEMENT WITH PREFIX</ss:classifierresourceidentifier>

          <ss:defaultvalue>DEFAULT VALUE</ss:defaultvalue>

          <ss:scope>SCOPE</ss:scope>

          <ss:containment>CONTAINMENT</ss:containment>

          <ss:isstatic>IS STATIC</ss:isstatic>

          <ss:iscollection>IS COLLECTION</ss:iscollection>

          <ss:isordered>IS ORDERED</ss:isordered>

          <ss:isconst>IS CONST</ss:isconst>

          <ss:allowduplicates>ALLOW DUPLICATES</ss:allowduplicates>

          <ss:lowerbound>NUMERICAL VALUE</ss:lowerbound>

          <ss:upperbound>NUMERICAL VALUE</ss:upperbound>

          <ss:position>NUMERICAL VALUE</ss:position>

     </ss:attribute>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/attribute/

Element Operation

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/operation/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                xmlns:dcterms="http://purl.org/dc/terms/"

                xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:operation>

          <!--Required Property-->

          <dcterms:identifier>GUID OF OPERATION (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable  Properties-->

          <dcterms:title>OPERATION NAME</dcterms:title>

          <dcterms:description>NOTES</dcterms:description>

          <ss:alias>ALIAS</ss:alias>

          <ss:classifiername>DATATYPE/CLASSIFIER NAME</ss:classifiername>

          <ss:classifierresourceidentifier>GUID OF THE CLASSIFIER EA

ELEMENT</ss:classifierresourceidentifier>

          <ss:scope>SCOPE</ss:scope>

          <ss:concurrency>CONCURRENCY</ss:concurrency>

          <ss:isstatic>IS STATIC</ss:isstatic>

          <ss:isabstract>IS ABSTRACT</ss:isabstract>

          <ss:isreturnarray>IS RETURN ARRAY</ss:isreturnarray>

          <ss:isquery>IS QUERY</ss:isquery>

          <ss:issynchronized>IS SYNCHRONIZED</ss:issynchronized>

          <ss:isconst>IS CONST</ss:isconst>

          <ss:ispure>IS PURE</ss:ispure>

          <ss:position>NUMERICAL VALUE</ss:position>

          <ss:behavior>BEHAVIOR</ss:behavior>

     </ss:operation>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/operation/

Element Operation Parameter

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/operationparameter/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                xmlns:dcterms="http://purl.org/dc/terms/"

                xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:parameter>

          <!--Required Properties-->

          <dcterms:identifier>GUID OF OPERATION PARAMETER (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable  Properties-->

          <dcterms:title>OPERATION PARAMETER NAME</dcterms:title>

          <dcterms:description>NOTES</dcterms:description>

          <ss:classifiername>DATATYPE/CLASSIFIER NAME</ss:classifiername>

          <ss:classifierresourceidentifier>GUID OF THE CLASSIFIER EA ELEMENT</ss:classifierresourceidentifier>

          <ss:defaultvalue>DEFAULT VALUE</ss:defaultvalue>

          <ss:paramdirection>DIRECTION</ss:paramdirection>

          <ss:position>NUMERICAL VALUE</ss:position>

     </ss:parameter>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/operationparameter/

Connector

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/resourcelink/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/"

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <oslc_am:Resource>

          <!--Required Properties-->

          <dcterms:identifier>GUID OF THE SOURCE PACKAGE/ELEMENT WITH GUID PREFIX</dcterms:identifier>

          <ss:{connector type} rdf:ID="ID" rdf:resource="<protocol>://<server>:<port>/<model>/oslc/am/resource/<GUID OF TARGET PACKAGE/ELEMENT WITH GUID  PREFIX>/"/>

          </oslc_am:Resource>   

          <rdf:Description rdf:about="#ID">

          <dcterms:identifier>GUID OF CONNECTOR  (TO UPDATE) WITH GUID PREFIX></dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>CONNECTOR NAME</dcterms:title>

          <dcterms:description>NOTES</dcterms:description>

          <ss:direction>DIRECTION</ss:direction>      

     </rdf:Description>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/linktype/

Package/Element Discussion

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/discussion/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                xmlns:dcterms="http://purl.org/dc/terms/" 

                xmlns:foaf="http://xmlns.com/foaf/0.1/"

                xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:discussion>

          <!--Required Property-->

          <dcterms:identifier>GUID OF DISCUSSION (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <ss:status>DISCUSSION STATUS</ss:status>

          <ss:priority>DISCUSSION PRIORITY</ss:priority>     

     </ss:discussion>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/discussion/

Package/Element Resource Allocation

Type

Input

UML

<protocol>://<server>/<model_name>/oslc/am/pu/resourceallocation/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:resourceallocation>

          <!--Required Property-->

          <dcterms:identifier>GUID OF RESOURCE ALLOCATION (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <ss:resourcename>

               <foaf:Person>

                     <foaf:name>AUTHOR</foaf:name>

               </foaf:Person>

          </ss:resourcename>

          <ss:role>ROLE</ss:role>

          <ss:startdate>YYYY-MM-DD format</ss:startdate>

          <ss:enddate>YYYY-MM-DD format</ss:enddate>

          <ss:percentagecomplete>PERCENT COMPLETE</ss:percentagecomplete>

          <ss:expectedtime>EXPECTED TIME</ss:expectedtime>

          <ss:allocatedtime>ALLOCATED TIME</ss:allocatedtime>

          <ss:expendedtime>EXPENDED TIME</ss:expendedtime>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:resourceallocation>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/resourceallocation/

Package/Element Test

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/test/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/" 

                 xmlns:foaf="http://xmlns.com/foaf/0.1/"

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:test>

          <!--Required Property-->

          <dcterms:identifier>GUID OF TEST (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>TEST NAME</dcterms:title>

          <ss:classtype>CLASS TYPE</ss:classtype>

          <dcterms:type>TYPE</dcterms:type>

          <ss:status>STATUS</ss:status>

          <ss:lastrun>YYYY-MM-DD FORMAT</ss:lastrun>

          <ss:runby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:runby>

          <ss:checkedby>

               <foaf:Person>

                   <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:checkedby>

          <dcterms:description>DESCRIPTION</dcterms:description>

          <ss:input>INPUT</ss:input>

          <ss:acceptancecriteria>ACCEPTANCE CRITERIA</ss:acceptancecriteria>

          <ss:results>RESULTS</ss:results>

     </ss:test>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/test/

Package/Element Tagged Value

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/taggedvalue/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/"

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:taggedvalue>

          <!--Required Properties-->     

          <dcterms:identifier>GUID OF TAGGED VALUE (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <ss:value>TAG VALUE</ss:value>    

          <dcterms:description>TAG NOTES</dcterms:description>

     </ss:taggedvalue>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/taggedvalue/

Package/Element Change

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

Post RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:change>

          <!--Required Property-->

          <dcterms:identifier>GUID OF CHANGE (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER SECURITY GUID</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>CHANGE NAME</dcterms:title>

          <ss:requestedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:requestedby>

          <ss:requestedon>YYYY-MM-DD format</ss:requestedon>

          <ss:status>New/Verified/Complete</ss:status>

          <ss:priority>High/Medium/Low</ss:priority>

          <ss:completedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:completedby>

          <ss:completedon>YYYY-MM-DD format</ss:completedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:change>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/change/

Package/Element Defect

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/"

                 xmlns:foaf="http://xmlns.com/foaf/0.1/"

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:defect>

          <!--Required Property-->

          <dcterms:identifier>GUID OF DEFECT (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>DEFECT NAME</dcterms:title>

          <ss:reportedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:reportedby>

          <ss:reportedon>YYYY-MM-DD format</ss:reportedon>

          <ss:status>STATUS</ss:status>

          <ss:priority>PRIORITY</ss:priority>

          <ss:resolvedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:resolvedby>

          <ss:resolvedon>YYYY-MM-DD format</ss:resolvedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:defect>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/defect/

Package/Element Issue

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:issue>

          <!--Required Property-->

          <dcterms:identifier>GUID OF ISSUE (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>ISSUE NAME</dcterms:title>

          <dcterms:title>ISSUE NAME</dcterms:title>

          <ss:raisedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:raisedby>

          <ss:raisedon>YYYY-MM-DD format</ss:raisedon>

          <ss:status>STATUS</ss:status>

          <ss:priority>PRIORITY</ss:priority>

          <ss:completedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:completedby>

          <ss:completedon>YYYY-MM-DD format</ss:completedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:issue>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/issue/

Package/Element Task

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:task>

          <!--Required Property-->

          <dcterms:identifier>GUID OF TASK (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>TASK NAME</dcterms:title>

          <ss:requestedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:requestedby>

          <ss:requestedon>YYYY-MM-DD format</ss:requestedon>

          <ss:status>STATUS</ss:status>

          <ss:priority>PRIORITY</ss:priority>

          <ss:completedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:completedby>

          <ss:completedon>YYYY-MM-DD format</ss:completedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:task>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/task/

Package/Element Event

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:event>

          <!--Required Property-->

          <dcterms:identifier>GUID OF EVENT (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>EVENT NAME</dcterms:title>

          <ss:reportedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:reportedby>

          <ss:requestedon>YYYY-MM-DD format</ss:requestedon>

          <dcterms:type>TYPE</dcterms:type>

          <ss:priority>PRIORITY</ss:priority>

          <ss:resolvedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:resolvedby>

          <ss:resolvedon>YYYY-MM-DD format</ss:resolvedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:event>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/event/

Package/Element Decision

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:decision>

          <!--Required Property-->

          <dcterms:identifier>GUID OF DECISION (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>DECISION NAME</dcterms:title>

          <ss:owner>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:owner>

          <ss:date>YYYY-MM-DD format</ss:date>

          <ss:status>STATUS</ss:status>

          <ss:impact>IMPACT</ss:impact>

          <ss:author>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:author>

          <ss:effective>YYYY-MM-DD format</ss:effective>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:decision>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/decision/

Package/Element Document

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="http://www.sparxsystems.com.au/oslc_am#">

     <ss:document>

          <!--Required Properties-->

          <dcterms:identifier>GUID OF DOCUMENT (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>DOCUMENT NAME</dcterms:title>

          <ss:requestedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:requestedby>

          <ss:requestedon>YYYY-MM-DD format</ss:requestedon>

          <ss:status>STATUS</ss:status>

          <ss:priority>PRIORITY</ss:priority>

          <ss:completedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:completedby>

          <ss:completedon>YYYY-MM-DD format</ss:completedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:document>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/document/

Package/Element Feature

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/maintenanceitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:foaf="http://xmlns.com/foaf/0.1/"

                  xmlns:ss="http://www.sparxsystems.com.au/oslc_am#">

     <ss:mfeature>

          <!--Required Properties-->

          <dcterms:identifier>GUID OF FEATURE (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>FEATURE NAME</dcterms:title>

          <ss:requestedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:requestedby>

          <ss:requestedon>YYYY-MM-DD format</ss:requestedon>

          <ss:status>STATUS</ss:status>

          <ss:priority>PRIORITY</ss:priority>

          <ss:completedby>

               <foaf:Person>

                    <foaf:name>PERSON NAME</foaf:name>

               </foaf:Person>

          </ss:completedby>

          <ss:completedon>YYYY-MM-DD format</ss:completedon>

          <ss:version>VERSION</ss:version>

          <dcterms:description>NOTES</dcterms:description>

          <ss:history>HISTORY</ss:history>

     </ss:mfeature>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/mfeature/

Package/Element Effort

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/projectmanagementitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:effort>

          <!--Required Property-->

          <dcterms:identifier>GUID OF EFFORT (TO UPDATE) WITH GUID PREFIX</dcterms:identifier>

         <!--Required in a Security Enabled Model-->

         <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>EFFORT NAME</dcterms:title>

          <dcterms:type>TYPE</dcterms:type>

          <ss:time>NUMERICAL VALUE</ss:time>

          <dcterms:description>NOTES</dcterms:description>

     </ss:effort>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/effort/

Package/Element Risk

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/projectmanagementitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                  xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                  xmlns:dcterms="http://purl.org/dc/terms/" 

                  xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:risk>

          <!--Required Property-->

               <dcterms:identifier>GUID OF RISK (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>RISK NAME</dcterms:title>

          <dcterms:type>RISK TYPE</dcterms:type>

          <ss:weight>NUMERICAL VALUE</ss:weight>

          <dcterms:description>NOTES</dcterms:description>

     </ss:risk>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/risk/

Package/Element Metric

Type

Input

URL

<protocol>://<server>/<model_name>/oslc/am/pu/projectmanagementitem/

POST RDF/XML

<?xml version="1.0" encoding="UTF-8"?>

<rdf:RDF xmlns:oslc_am="http://open-services.net/ns/am#"

                 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"

                 xmlns:dcterms="http://purl.org/dc/terms/" 

                 xmlns:ss="https://sparxsystems.com.au/oslc_am#">

     <ss:metric>

          <!--Required Property-->

          <dcterms:identifier>GUID OF METRIC (TO UPDATE)  WITH GUID PREFIX</dcterms:identifier>

          <!--Required in a Security Enabled Model-->

          <ss:useridentifier>USER AUTHENTICATION TOKEN</ss:useridentifier>

          <!--Updateable Properties-->

          <dcterms:title>METRIC NAME</dcterms:title>

          <dcterms:type>METRIC TYPE</dcterms:type>

          <ss:weight>NUMERICAL VALUE</ss:weight>

          <dcterms:description>NOTES</dcterms:description>

     </ss:metric>

</rdf:RDF>

Resource Shape

<protocol>://<server>/<model>/oslc/am/rs/metric/

Notes

  • This facility is available through the Pro Cloud Server, with a valid license
  • This facility will not be available when the Pro Cloud Server connection to the Enterprise Architect model is configured as a read-only connection
  • In a Security Enabled model, you need to provide the User Authentication Token (via the 'ss:useridentifier' XML element) in the POST XML to create a Resource or Resource Feature
  • In a Security Enabled model that has the 'Require User Lock to Edit' option enabled, you can update a Resource/Resource Feature if:
         -  You have 'Lock Elements' permission and
         -  The Resource is not locked by another user
  • When a Resource/Resource Feature is updated via OSLC in a model that has Auditing enabled, the changes made to the model will not be logged
  • Enterprise Architect does not support modifying the Type of Tagged Value on Packages/Elements using the Tagged Value Update service (URL : <protocol>://<server>/<model_name>/oslc/am/pu/taggedvalue/)
  • OSLC Specification uses HTTP PUT to update Resource Properties whereas Enterprise Architect uses HTTP POST for updating Resource Properties

Learn more