在Outlook Office加载项安装时创建文件夹的实现方法

核心思路 #

Outlook插件没有专门的「安装完成」事件，因此可以通过标记首次运行的方式，在插件第一次启动时执行文件夹创建逻辑。使用Office.context.roamingSettings存储运行标记，搭配Office.context.mailbox.folders.addAsync API完成文件夹创建。

具体实现步骤 #

• 检测首次运行状态：读取漫游设置中的标记，判断是否需要执行创建操作
• 调用API创建文件夹：指定文件夹名称和父目录，处理异步回调的成功/失败情况
• 更新运行标记：创建成功后写入标记，避免后续重复执行

完整示例代码 #

Office.initialize = function(reason) {
    // 插件初始化完成后触发检查逻辑
    checkAndCreateFolder();
};

async function checkAndCreateFolder() {
    const roamingSettings = Office.context.roamingSettings;
    const hasCreatedFolder = roamingSettings.get('hasCreatedFolder');

    // 仅首次运行时执行创建逻辑
    if (!hasCreatedFolder) {
        try {
            const targetFolderName = "插件专属文件夹";
            // 以根文件夹作为父目录，可替换为收件箱等其他目录
            const parentFolder = Office.context.mailbox.rootFolder;

            // 异步创建文件夹
            await new Promise((resolve, reject) => {
                parentFolder.folders.addAsync(targetFolderName, (result) => {
                    if (result.status === Office.AsyncResultStatus.Succeeded) {
                        console.log("文件夹创建成功：", result.value.displayName);
                        resolve(result.value);
                    } else {
                        console.error("创建失败：", result.error.message);
                        reject(result.error);
                    }
                });
            });

            // 更新标记并保存
            roamingSettings.set('hasCreatedFolder', true);
            roamingSettings.saveAsync((saveResult) => {
                saveResult.status === Office.AsyncResultStatus.Succeeded
                    ? console.log("运行标记保存成功")
                    : console.error("标记保存失败：", saveResult.error.message);
            });
        } catch (err) {
            console.error("创建流程出错：", err);
        }
    } else {
        console.log("文件夹已存在，无需重复创建");
    }
}

关键注意事项 #

• 权限配置：需在插件的manifest.xml中配置ReadWriteMailbox权限，确保API调用权限：

  <Permissions>ReadWriteMailbox</Permissions>
  

• 父目录选择：若需在收件箱下创建文件夹，可替换父目录为：

  const parentFolder = Office.context.mailbox.folders.getFolderById(Office.context.mailbox.inboxFolderId);
  

• 错误场景处理：需处理文件夹名称重复、用户权限不足等异常情况，避免插件运行异常

内容的提问来源于stack exchange，提问作者Waqar