使用 ONLYOFFICE 宏生成和插入词义

为您的文档添加清晰的定义可以显著提高文档的整体质量。使用 ONLYOFFICE 宏，这些任务的自动化变得轻而易举。在本文中，我们将向您展示如何创建一个宏，从外部 API 中提取单词定义并将其无缝插入到您的文档中。

访问 API

API Ninjas 是一种功能强大的 API 服务，它为开发人员提供各种免费 API，以便利用字典、语言翻译等功能增强应用程序。在本教程中，我们将使用提供单词定义的字典 API。您需要从 API Ninjas 注册一个 API 密钥才能访问他们的服务。

创建宏

我们的目标是创建一个宏，从外部 API 获取所选单词的值并检索其定义。然后，我们将把定义插入到文档中。

首先，我们初始化必要的变量：

const oDocument = Api.GetDocument();
const oRange = oDocument.GetRangeBySelect();
const word = oRange.GetText();

在这里，oDocument 变量代表当前文档，oRange 变量保存选定的文本范围，word 变量存储选定单词的值。

然后，我们使用 AJAX 向字典 API 提出请求。将 "your-api-key "替换为实际的 API 密钥：

    success: function(result) {
        console.log(result);
        const text = result.definition;
        // Continue to the next step...
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});

在这里，我们使用所选单词和 API 密钥向 API 端点发送 GET 请求。在成功回调中，我们从中提取定义属性。

获取定义后，我们将其插入文档：

 success: function(result) {
        console.log(result);
    const text = result.definition; 
    const oParagraph = Api.CreateParagraph();
    oParagraph.AddText(text);
    oDocument.InsertContent([oParagraph], { "KeepTextOnly": true });
    }

在本节中，我们使用 Api.CreateParagraph() 创建一个新段落，使用 oParagraph.AddText(text) 添加获取的文本，最后使用 oDocument.InsertContent() 将段落插入到 oDocument 中。

整个宏代码如下：

(function()
{
const oDocument = Api.GetDocument();
const oRange = oDocument.GetRangeBySelect();
const word = oRange.GetText();
$.ajax({
    method: 'GET',
    url: 'https://api.api-ninjas.com/v1/dictionary?word=' + word,
    headers: { 'X-Api-Key': 'your-api-key'},
    contentType: 'application/json',
    success: function(result) {
        console.log(result);
    const text = result.definition; 
    const oParagraph = Api.CreateParagraph();
    oParagraph.AddText(text);
    oDocument.InsertContent([oParagraph], { "KeepTextOnly": true });
    },
    error: function ajaxError(jqXHR) {
        console.error('Error: ', jqXHR.responseText);
    }
});
})();

现在，让我们运行宏，看看它是如何工作的！

点击以上图片免费观看视频 ⬆

我们衷心希望您发现这个宏是您工具包中的宝贵补充。使用 ONLYOFFICE 宏可以提高您的工作效率，为您提供高效的自动化解决方案。

当您沉浸于宏创建时，不要错过ONLYOFFICE API提供的机会。如果您有任何问题或创新想法，请通过评论或联系我们与我们分享。我们欢迎您的意见，并期待着与您的合作！祝您在探索中取得成功！

相关产品

最新文章

相关文章