Skip to main content

Executing Operations

An operation is an action that is executed against a single asset. For example, to delete an asset you must execute the Delete operation on the asset. To close or inactivate a asset, you use the Inactivate operation.

You can use the Meta API to determine the operations that a particular asset supports

Prior to executing an operation against an asset in Digital.ai Agility, 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 theMetaModelobject. However, starting with the 15.0.0.0 release, that is no longer necessary. TheMetaModelobject is now available from thegetMetamethod of theServicesobject. For more advancedServicesconstructor overloads, see the Creating a Services Object topic.

Closing an Asset​

This example shows how to close an asset using the executeOperation method of the Servicesobject. Note the use of the getOperationmethod to get the operation to execute:

                IOperation closeOperation  = services.getMeta().getOperation("Story.Inactivate");
                Oid closeID = services.executeOperation(closeOperation, services.getOid("Story:7618"));

                Query query = new Query(closeID.getMomentless());
                IAttributeDefinition assetState = services.getMeta().getAttributeDefinition("Story.AssetState");
                query.getSelection().add(assetState);
                QueryResult result = services.retrieve(query);
                Asset closeStory = result.getAssets()[0];
                AssetState state = AssetState.valueOf(((Integer) closeStory.getAttribute(assetState).getValue()).intValue());

                System.out.println(closeStory.getOid());
                System.out.println(state.toString());

                /***** OUTPUT *****
                Story:7618
                Closed
                ******************/

Reopening an Asset​

This example shows how to reopen an asset using the executeOperation method of the Servicesobject:

                IOperation closeOperation  = services.getMeta().getOperation("Story.Reactivate");
                Oid closeID = services.executeOperation(closeOperation, services.getOid("Story:7618"));

                Query query = new Query(closeID.getMomentless());
                IAttributeDefinition assetState = services.getMeta().getAttributeDefinition("Story.AssetState");
                query.getSelection().add(assetState);
                QueryResult result = services.retrieve(query);
                Asset closeStory = result.getAssets()[0];
                AssetState state = AssetState.valueOf(((Integer) closeStory.getAttribute(assetState).getValue()).intValue());

                System.out.println(closeStory.getOid());
                System.out.println(state.toString());

                /***** OUTPUT *****
                Story:7618
                Active
                ******************/

Deleting an Asset​

This example shows how to delete an asset using the executeOperation method of the Servicesobject:

                IOperation deleteOperation = services.getMeta().getOperation("Story.Delete");
                Oid deletedOID = services.executeOperation(deleteOperation, services.getOid("Story:7618"));

                try {
                Query query = new Query(deletedOID.getMomentless());
                @SuppressWarnings("unused")
                QueryResult result = services.retrieve(query);
                } catch (ConnectionException e) {
                System.out.println(String.format("%s has been deleted", deletedOID.getMomentless()));
                }

                /***** OUTPUT *****
                Story:7618 has been deleted
                ******************/

The Delete operation returns the Oid, with the new Moment, of the deleted asset. Future current info queries will automatically exclude deleted assets from results.