General information on the Editor API

// Prepares the xml.
var xml = '<p>Prepend me</p>';

ctx.activeDocument.insertXml( xml, {
    xpath: 'doc/story/text/superbyline',
    criteria: {
        [
            param: 'xsm-preserve',
            condition: 'equal',
            value: 'true'
        ]
    } },
    'prepend' );

// the xml will be inserted only in the first superbyline tag that satisfy xpath and the additional (optional) criteria


// Prepares the xml.
var xml = '<h1><?EM-dummyText lorem ipsum?></h1>';

ctx.activeDocument.insertXml( xml, {xpath: 'cursorPosition'});

// the xml will be inserted at the cursor position, replacing the current selection if not collapsed.

// Switch to channel
ctx.activeDocument.switchToChannel(channel);

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'channel',
            condition: 'equal',
            value: 'Globe-Print'
        ]
    }
};

// REPLACE XML content
ctx.activeDocumentV2.getXmlContent({xpathOptions}).then( content => {
    var newContent = '<summary id="U26664270086oOb"><p>New summary content</p></summary>';
    ctx.activeDocumentV2.replaceXmlContent({newContent, xpathOptions}).then(result => {
        console.log('content replaced')
    });
})

...
//

var xpathOptions = {
    xpath: 'cursorPosition'
};
var xmlContent = '<h1><?EM-dummyText lorem ipsum?></h1>';
activeDocumentV2.insertXmlContent({xmlContent, xpathOptions}).then(result => {
    console.log('content has been inserted');
}).catch(error => {
    console.log('content has not been inserted');
});

...
//

// Obtains the document selection
var sel = ctx.activeDocument.getSelection();

var selectedNode = sel.getNode();

// Perform actions on the selected node
// ...

// Obtains the document selection
var sel = ctx.activeDocument.getSelection();

var selectedXml = sel.getXmlContent();

// Perform actions on the selected node
// ...

// Obtains the document information.
var xml = '<p>Prepend me</p>';
var sel = ctx.activeDocument.getSelection();

sel.insertXml( xml, 'prepend' );

// Example with closestContainer
var xml = '<newsletter-widget><p>This is a new section part</p><p>Next paragraph content</p></newsletter-widget>';
var sel = ctx.activeDocument.getSelection();

sel.insertXml( xml, {insertionType: 'prepend', closestContainer: 'section'} );

// Obtains the document selection
var sel = ctx.activeDocument.getSelection();

var options = {};
// Uncomment this line if you want to include witespace nodes
// options.includeWhitespaceNodes = true;
var text = sel.getTextContent(options);

// ...

var sel = ctx.activeDocument.getSelection();
var selectedNode = sel.getNode();

if ( selectedNode.nodeType === ctx.activeDocument.CONSTANTS.DUMMY_TYPE ) {
    // It is a dummy text...
    sel.append('<p>New text here</p>');
}

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/text',
    criteria: {
       [
        param: 'channel',
        condition: 'equal',
        value: 'Globe-Print'
        ]
    }
};

// Obtains the node.
var node = ctx.activeDocument.getNode(xpathOptions);

// Perform actions on the found node
// ...
if (node) {
    var xmlContent = node.getXmlContent();

}

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'channel',
            condition: 'equal',
            value: 'Globe-Print'
        ]
    }
};

// Obtains the node.
var node = ctx.activeDocument.getNode(xpathOptions);

// Perform actions on the found node
// ...
if (node) {
    var repxml = '<summary id="U26664270086oOb"><p>New summary content</p></summary>';
    node.replaceXmlContent(repxml);
}

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/text',
    criteria: {
       [
        param: 'channel',
        condition: 'equal',
        value: 'Globe-Print'
        ]
    }
};

// Obtains the node.
var node = ctx.activeDocument.getNode(xpathOptions);

// Perform actions on the found node
// ...
if (node) {

    var options = {};
    // Uncomment this line if you want to include witespace nodes
    // options.includeWhitespaceNodes = true;

    var text = node.getTextContent(options);

    // ....

}

// Obtains the current selection.
var sel = ctx.activeDocument.getSelection();
var selectedNode = sel.getNode();

// Replace the text of the current node with simple text
selectedNode.replaceTextContent( 'Simple text' );

// Replace the text of the current node with an xml format
selectedNode.replaceTextContent('<a href="http://www.eidosmedia.com" title="Eidosmedia">Eidosmedia</a>', {'format': 'xml'});

// Obtains the current selection.
var sel = ctx.activeDocument.getSelection();
var selectedNode = sel.getNode();

// Perform actions on the found node
// ...
if (selectedNode) {
    var ctx = selectedNode.getContentInfo();

    var id = ctx.getId();
    var type = ctx.getType();
    var sysAttributes = ctx.getSysAttributes();
    var usageTickets = ctx.getUsageTickets();
}

// Obtains the current selection.
var sel = ctx.activeDocument.getSelection();
var selectedNode = sel.getNode();

// Perform actions on the found node
if (selectedNode) {
    var attributes = selectedNode.getAttributes();

    // ...
}

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'channel',
            condition: 'equal',
            value: 'Globe-Print'
        ]
    }
};

// Obtains the node by x path.
var node = ctx.activeDocument.getNode(xpathOptions);

// To obtain the node by selection uncomment the following lines
// var sel = editorApi.getSelection();
// var node = sel.getNode();

var attrOptions = {};
var attributes = [{'name': 'testattr', 'value': 'testvalue'}];
attrOptions.attributes = attributes;

// Perform actions on the found node
// ...
if (node) {
    node.setAttributes(attrOptions);
}

var editorApi = ctx.activeDocument;
var sel = editorApi.getSelection();
var node = sel.getNode();

var reference = path o loid of the objects to insert

const settings = {
        cover: true
        hardCrop: false
        tmx: null
        xtransform: null
}
node.setExternalReference( reference, settings );

// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'highlight',
            condition: 'equal',
            value: 'yes'
        ]
    }
};

// Obtains the node by x path.
var node = ctx.activeDocument.getNode(xpathOptions);

// To obtain the node by selection uncomment the following lines
// var sel = editorApi.getSelection();
// var node = sel.getNode();

var channels = ['Globe-Web'];

// Perform actions on the found node
// ...
if (node) {
    node.setChannels(channels);
}

// ***** activeDocument ******
// Obtains the current selection.
var sel = ctx.activeDocument.getSelection();

// get the node
var selNode = sel.getNode();

var xmlContent = node.getXmlContent();

// ***** activeDocumentV2 ******
// Obtains the XML of the current selection
ctx.activeDocumentV2.getXmlContent({useSelection: true}).then(result => {
    console.log(`V2 async result selection: ${result}`);
}).catch(error => {
    console.log(`V2 async error selection: ${error}`);
});

// ...

// ***** activeDocument ******
// Obtains the text
var textContent = ctx.activeDocument.getTextContent();

// ***** activeDocumentV2 ******
// Obtains the XML of the current selection
ctx.activeDocumentV2.getTextContent().then(result => {
    console.log(`V2 async result selection: ${result}`);
}).catch(error => {
    console.log(`V2 async error selection: ${error}`);
});

// ...

// ***** activeDocument ******
// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'channel',
            condition: 'equal',
            value: 'Globe-Print'
        ]
    }
};

// Obtains the node.
var node = ctx.activeDocument.getNode(xpathOptions);

// Perform actions on the found node
// ...
if (node) {
    var repxml = '<summary id="U26664270086oOb"><p>New summary content</p></summary>';
    node.replaceXmlContent(repxml);
}

// ***** activeDocumentV2 ******
// prepare the xpath options
var xpathOptions = {
    xpath: 'doc/story/summary',
    criteria: {
        [
            param: 'channel',
            condition: 'equal',
            value: 'Globe-Print'
        ]
    }
};

// REPLACE XML content
ctx.activeDocumentV2.getXmlContent({xpathOptions}).then( content => {
    var newContent = '<summary id="U26664270086oOb"><p>New summary content</p></summary>';
    ctx.activeDocumentV2.replaceXmlContent({newContent, xpathOptions}).then(result => {
        console.log('content replaced')
    });
})

// ...

// ***** activeDocument ******
ctx.activeDocument.saveDocument();

// ***** activeDocumentV2 ******
// Save the current document.
ctx.activeDocumentV2.saveDocument().then(result => {
    console.log(`save operation successfully excuted`);
}).catch(error => {
    console.log(`an error occurred saving the document`);
});

// ...

// ***** activeDocument ******
var newXmlContent = '<h1><?EM-dummyText lorem ipsum?></h1>';
var retValue = ctx.activeDocument.insertXml(newXmlContent, {xpath: 'cursorPosition'});

// ***** activeDocumentV2 ******
var xpathOptions = {
    xpath: 'cursorPosition'
};
var xmlContent = '<h1><?EM-dummyText lorem ipsum?></h1>';
activeDocumentV2.insertXmlContent({xmlContent, xpathOptions}).then(result => {
    console.log(`content has not been inserted`);
}).catch(error => {
    console.log(`content has not been inserted ${error}`);
});

// ...