Skip to main content
System StatusContact Support
VersionOne Community

Updating Assets

Updating assets through the Java SDK involves calling the Save method of the Services object. The process is that you first have to query for the asset to update, make the update in memory, then save the asset back to VersionOne.

Prior to updating an asset in VersionOne, you must first instantiate a V1Connector and Services object:

V1Connector connector = V1Connector
    .withInstanceUrl("<Server Base URI>")
    .withUserAgentHeader("AppName", "1.0")
    .withAccessToken("1.rWM8lKLk+PnyFxkEWVX5Kl2u6Jk=")
    .build();
   
IServices services = new Services(connector);

In versions of the SDK prior to the 15.0.0.0 release, you would also have to instantiate a connector for the MetaModel object. However, starting with the 15.0.0.0 release, that is no longer necessary. The MetaModel object is now available from the getMeta method of the Services object. For more advanced Services constructor overloads, see the Creating a Services Object topic.

Updating a Scalar Value Attribute

This example shows that updating a scalar attribute on an asset is accomplished by calling the setAttributeValue method on an asset, specifying the attribute definition of the attribute you wish to change and the new scalar value. This example updates the Name attribute on the Story with ID 7617:

Oid storyId = services.getOid("Story:7617");
        
Query query = new Query(storyId);
IAssetType storyType = services.getMeta().getAssetType("Story");
IAttributeDefinition nameAttribute = storyType.getAttributeDefinition("Name");
query.getSelection().add(nameAttribute);
QueryResult result = services.retrieve(query);
Asset story = result.getAssets()[0];
String oldName = story.getAttribute(nameAttribute).getValue().toString();
story.setAttributeValue(nameAttribute, "New Name");
services.save(story);

System.out.println(story.getOid().getToken());
System.out.println(oldName);
System.out.println(story.getAttribute(nameAttribute).getValue());
        
/***** OUTPUT *****
Story:7617:9244
My New Story
New Name
******************/

Updating a Single-Value Relation Attribute

This example shows that updating a single-value relation is accomplished by calling the setAttributeValue method on an asset, specifying the attribute definition of the attribute you wish to change and the ID for the new relation. This example updates the source of the Story with ID 7617:

Oid storyId = services.getOid("Story:7617");
        
Query query = new Query(storyId);
IAssetType storyType = services.getMeta().getAssetType("Story");
IAttributeDefinition sourceAttribute = storyType.getAttributeDefinition("Source");
query.getSelection().add(sourceAttribute);
QueryResult result = services.retrieve(query);
Asset story = result.getAssets()[0];
String oldSource = story.getAttribute(sourceAttribute).getValue().toString();
story.setAttributeValue(sourceAttribute, "StorySource:149");
services.save(story);

System.out.println(story.getOid().getToken());
System.out.println(oldSource);
System.out.println(story.getAttribute(sourceAttribute).getValue());

/***** OUTPUT *****
Story:7617:9245
NULL
StorySource:149
******************/

Updating a Multi-Value Relation Attribute

This example shows that updating a multi-value relation is accomplished by calling either the removeAttributeValue or addAttributeValue methods on an asset, specifying the attribute definition of the attribute you wish to change and the ID of the relation you wish to add or remove. This example updates one Member and removes another Member from the Story with ID 7617:

Oid storyId = services.getOid("Story:7617");
        
Query query = new Query(storyId);
IAssetType storyType = services.getMeta().getAssetType("Story");
IAttributeDefinition ownersAttribute = storyType.getAttributeDefinition("Owners");
query.getSelection().add(ownersAttribute);
QueryResult result = services.retrieve(query);
Asset story = result.getAssets()[0];
        
List<Object> oldOwners = new ArrayList<Object>();
oldOwners.addAll(Arrays.asList(story.getAttribute(ownersAttribute).getValues()));
story.removeAttributeValue(ownersAttribute, "Member:20");
story.addAttributeValue(ownersAttribute, "Member:2024");
services.save(story);
System.out.println(story.getOid().getToken());
Iterator<Object> iter = oldOwners.iterator();
        
while (iter.hasNext()) {
    Oid oid = (Oid) iter.next();
    System.out.println(oid.getToken());
}
        
for (Object o : story.getAttribute(ownersAttribute).getValues()) {
    Oid oid = (Oid) o;
    System.out.println(oid.getToken());
}

/***** OUTPUT *****
Story:7617:9247
Member:20
Member:2024
******************/
  • Was this article helpful?