The xAssets API - Method : SpecialAssetMerge

Summary

Merge a list of assets into a single asset. A single asset is selected as the merge target, and the remaining assets in the list are merged onto it

Parameters

Parameter : sXML

A XML structure in the format required by the Asset Disposal API function SpecialBulkDisposal. This determines how the merged asset records are disposed of

Parameter : sArguments

AssetID which will be the template we are merging into (the PRIMARY asset)

StatusID we are disposing the other assets to

not used

mergeassetfields - flag signalling we have to walk through the asset records and update any fields which are NULL in the primary and have a value in another asset

transactions - flag signalling that purchase transactions have to be merged

specificationchilddata - flag signalling that specification detail data has to be merged

delete - flag signalling that the MERGE assets must be permanently deleted instead of disposed of

combine flag - 1 to add the quantities and procurement amounts, 0 to preserve the primary asset (1 to add assets together, 0 to solve duplicates)

list of fields which will receive static values, ^ separated

list of values for the fields listed in 8, ^ separated

spare

11+ onwards = assetid of each asset being merged into sarg(0). If sArguments(11) contains commas then that one parameter is used as a list

Returns

If successful, an empty string is returned. If an error occurred, the return value contains the error message.

Syntax and Examples

Restful syntax with Microsoft Visual Basic

Example 1 - Merge assets 3,4,5 and 6 into asset 2


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

SOAP Syntax with Microsoft Visual Basic

Example 1 - Merge assets 3,4,5 and 6 into asset 2



    Try

        ErrorMessage = ""

        Return w.WebSaveSpecial(_hash, _username, _db, _ip, "", "SpecialAssetMerge", {"6", "6", "", "1", "1", "1", "0", "1", "Notes", "Asset merged", "", "3,4,5,6"}, False, _dns, _port, _scheme, _nonce, _noncedate)

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

AMSX Syntax

Example 1 - Merge assets 3,4,5 and 6 into asset 2



    SaveSpecial "SpecialAssetMerge","", "6", "6", "", "1", "1", "1", "0", "1", "Notes", "Asset merged", "", "3,4,5,6"

XCS Syntax

Example 1 - Merge assets 3,4,5 and 6 into asset 2



    Dim ret as String = Server.SaveSpecial("SpecialAssetMerge","", "6", "6", "", "1", "1", "1", "0", "1", "Notes", "Asset merged", "", "3,4,5,6")
    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