The xAssets API - Method : SpecialAssetClone

Summary

Clone an Asset. This makes a "deep" copy of an asset record, such that all child information (specification data, devices, software, transactions, service plans, maintenance) is copied.

Parameters

Parameter : sXMLIgnore

sXMLIgnore : This parameter is not used

Parameter : sArguments

AssetID to be cloned

Transaction Scaling Factor - use 1.0 to apply the same asset transactions to the clone as the original asset

"move" or "keep" for transaction splits

"CHILDREN" - just clone the children

If (3) = "CHILDREN" this is the assetid

ApplyDate - date the clone took place

Field1 - preset the below value into this field

Value1 - the value to set field1 to

Field2 ...

Returns

Returns the AssetID of the newly created asset which is a new clone of the AssetID provided

Syntax and Examples

Restful syntax with Microsoft Visual Basic

Example 1 - Clone asset number 3 and set the Notes field


There is no restful call for this API operation - use a SOAP method instead

SOAP Syntax with Microsoft Visual Basic

Example 1 - Clone asset number 3 and set the Notes field



    Try

        ErrorMessage = ""

        Return w.WebSaveSpecial(_hash, _username, _db, _ip, "", "SpecialAssetClone", {"3", "1", "keep", "", "", "12-Jun-2022 16:34:56", "Notes", "Notes field set during clone operation"}, False, _dns, _port, _scheme, _nonce, _noncedate)

    Catch ex As Exception
        ErrorMessage = ex.Message
        Return "
    End Try

AMSX Syntax

Example 1 - Clone asset number 3 and set the Notes field



    SaveSpecial "SpecialAssetClone","", "3", "1", "keep", "", "", "12-Jun-2022 16:34:56", "Notes", "Notes field set during clone operation"

XCS Syntax

Example 1 - Clone asset number 3 and set the Notes field



    Dim ret as String = Server.SaveSpecial("SpecialAssetClone","", "3", "1", "keep", "", "", "12-Jun-2022 16:34:56", "Notes", "Notes field set during clone operation")
    If ret = " Or ret.Substring(0, 8) = "special=" Then
        MsgBox("Save operation completed.", vbInformation, "Save Data")
    Else
        MsgBox("Save operation failed:" & ret, vbExclamation, "Save Data")
    End If

Download the Visual Studio API Samples Project

Return to the API Index Page