Autodesk Vault ProfessionalVault API

AddItemRevision Method

Autodesk.Connectivity.WebServices›ItemService

Creates a new Item.

Required Permissions

ItemCreate

Syntax

public override Item AddItemRevision(
   System.long categoryId
)
Public Overrides NotOverridable Function AddItemRevision( _
   ByVal categoryId As System.Long _
) As Item

Parameters

NameDescription
categoryIdThe category ID.

Return Value

The newly created Item. The Item is still in an editable state. Call a commit function, such as UpdateAndCommitItems to commit the changes.

Example

using Autodesk.Connectivity.WebServices;
using Autodesk.Connectivity.WebServicesTools;

class VaultSDKSample
{
    public void AddItem(WebServiceManager serviceManager)
    {
        Cat[] categories = serviceManager.CategoryService.GetCategoriesByEntityClassId("ITEM", true);
        long catId = -1;
        foreach (Cat category in categories)
        {
            if (category.SysName == "Document")
                catId = category.Id;
        }

        Item item = serviceManager.ItemService.AddItemRevision(catId);

        // set the needed information
        item.Title = "Test Item";
        item.Detail = "Test Item";

        // save the item revision
        serviceManager.ItemService.UpdateAndCommitItem(item, 0, false, null, null, null, null, null, null, 0);
    }
}
Imports Autodesk.Connectivity.WebServices

Class VaultSDKSample
    Private Sub AddItem(serviceManager As Autodesk.Connectivity.WebServicesTools.WebServiceManager)
        Dim categories As Cat() = serviceManager.CategoryService.GetCategoriesByEntityClassId("ITEM", True)
        Dim catId As Long = -1
        For Each category As Cat In categories
            If category.SysName = "Document" Then
                catId = category.Id
            End If
        Next

        Dim item As Item = serviceManager.ItemService.AddItemRevision(catId)

        ' set the needed information
        item.Title = "Test Item"
        item.Detail = "Test Item"

        ' save the item revision
        serviceManager.ItemService.UpdateAndCommitItem(item, 0, False, Nothing, Nothing, Nothing, _
            Nothing, Nothing, Nothing, 0)
    End Sub
End Class

See Also