GetById

Returns a custom XML part by its ID from the XML manager.

Syntax

expression.GetById(xmlPartId);

expression - A variable that represents a ApiCustomXmlParts class.

Parameters

Name	Required/Optional	Data type	Default	Description
xmlPartId	Required	string		The XML part ID.

Returns

ApiCustomXmlPart | null

Example

This example shows how to get a custom XML part by its ID.

• Code
• Result

// How to retrieve a custom XML part using its ID.

// Get an XML part by its ID.

let worksheet = Api.GetActiveSheet();
let xmlManager = worksheet.GetCustomXmlParts();
let xml = xmlManager.Add("<inventory><item>Book</item></inventory>");
let id = xml.GetId();
let retrievedXml = xmlManager.GetById(id);
if (retrievedXml) {
    worksheet.GetRange("A1").SetValue("Found XML part: " + retrievedXml.GetXml());
} else {
    worksheet.GetRange("A1").SetValue("XML part not found");
}