window.Asc.plugin.executeMethod("InsertAndReplaceContentControls", [args], callback)

Описание

Этот метод добавляет элемент управления содержимым с данными. Эти данные задаются с помощью js-кода для Генератора документов, или просто ссылкой на документ, к которому предоставлены соответствующие права доступа.

Использование

Использовать метод надо так:

window.Asc.plugin.executeMethod("InsertAndReplaceContentControls", [obj]);

Где obj - это массив из JSON:

[
    {
        "Props": {
            "Id": Number,
            "Tag": "{String}",
            "Lock": Number 
        },
        "Script": "var oDocument = Api.GetDocument();var oParagraph = Api.CreateParagraph();oParagraph.AddText('Hello world!');oDocument.InsertContent([oParagraph]);" 
    }
]

Каждый новый элемент в массиве будет создавать новый элемент управления содержимым.

[ {"Props": {...}, "Url": "http://"}, {"Props": {...}, "Url": "http://."}, {...}, {...}]

Ключ Props может иметь следующие значения:

• "Id" (например, {"Id": 2} ) - уникальный идентификатор для элемента управления содержимым. Его можно использовать для того, чтобы найти конкретный элемент управления содержимым и ссылаться на него в своем коде.
• "Tag" (например, {"Tag": "String"} ) - тег для элемента управления содержимым. Один тег может быть присвоен нескольким элементам управления содержимым для того, чтобы можно было ссылаться на них в своем коде.
• "Lock" (например, {"Lock": 0} ) - значение, которое определяет возможность удаления и редактирования для элемента управления содержимым. Значения могут быть следующими:

Кроме ключа Props должна быть пара вида "Ключ/Значение" с ключом Url или Script, определяющая данные, которые будут находиться в элементе управления содержимым. Если используется ключ Url, его значением должна быть ссылка на файл, к которому предоставлены соответствующие права доступа. Если используется ключ Script, его значением должен быть скрипт, который будет выполняться для того, чтобы сгенерировать данные в элементе управления содержимым.

Пример 1

{
    "Url": "https://example.com/script.docbuilder"
}

Пример 2

"Script": "var oDocument = Api.GetDocument();
var oParagraph=Api.CreateParagraph();
oParagraph.AddText('Helloworld!');
oDocument.InsertContent([oParagraph]);"

Возвращает

Метод возвращает данные, которые содержатся в созданном элементе управления содержимым (в формате JSON)

[
    {
        "Tag": "Document",
        "Id": 0,
        "Lock": 0,
        "InternalId": "1_713"
    }
]