Как прочитать проверки ячейки Excel с использованием Office JS?

Question

Как читать уже реализованные проверки данных с помощью office-js, я прочитал эту страницу, новые API доступны в бета-версии, сейчас я пытаюсь понять, как реализовать эту проверку в Excel?

Answer 1

Документы об API проверки данных доступны в ExcelJS_OpenSpec.

Также есть фрагмент Script Lab, который содержит несколько примеров проверки данных в Excel. Просто установите надстройку "Script Lab" (бесплатно: https://aka.ms/getscriptlab), затем откройте окно " Код Script Lab" в Excel, выберите " Образцы" в меню навигации и выберите образец " Проверка данных" (расположен внизу). списка образцов, под заголовком API предварительного просмотра).

Открыв фрагмент, вы можете просмотреть код на панели " Код", чтобы увидеть примеры проверки данных и протестировать / запустить фрагмент с помощью панели " Выполнить", чтобы увидеть проверку данных в действии. Например, следующая функция (из фрагмента) добавляет правило проверки, для которого требуется положительное число:

async function addPositiveNumberRequirement() {
    await Excel.run(async (context) => {
        const sheet = context.workbook.worksheets.getActiveWorksheet();
        const rankingRange = sheet.tables.getItem("NameOptionsTable").columns.getItem("Ranking").getDataBodyRange();

        // When you are developing, it is a good practice to
        // clear the dataValidation object with each run of your code.
        rankingRange.dataValidation.clear();

        let greaterThanZeroRule = {
            wholeNumber: {
                formula1: 0,
                operator: Excel.DataValidationOperator.greaterThan
            }
        };
        rankingRange.dataValidation.rule = greaterThanZeroRule;

        rankingRange.dataValidation.prompt = {
            message: "Please enter a positive number.",
            showPrompt: true,
            title: "Positive numbers only."
        };

        rankingRange.dataValidation.errorAlert = {
            message: "Sorry, only positive numbers are allowed",
            showAlert: true,
            style: "Stop",
            title: "Negative Number Entered"
        };

        await context.sync();
    });
}