javascript - 将信息传递到 Google 文档附加组件中的服务器端功能

Question

我正在开发一个基于 Google 的 Google Docs 插件 Quickstart tutorial 。我正在尝试更改教程中附加组件的工作流程以附加新页面，然后在该新页面上插入翻译，而不是逐行工作流程。

我有一个在单个文档中工作的脚本，但我很难将其移动到附加架构。我认为这与将选择从客户端 JS 传递到进行翻译的服务器端脚本有关。

这是翻译脚本

function translate(origin, dest, savePrefs) {
  Logger.log('Starting the script');
  if (savePrefs == true) {
    var userProperties = PropertiesService.getUserProperties();
    userProperties.setProperty('originLang', origin);
    userProperties.setProperty('destLang', dest);
    Logger.log(origin,dest);
  }

  var doc = DocumentApp.getActiveDocument();
  var body = doc.getBody();

  // Add a page break for the translated material.
  body.appendPageBreak();

  // Get the number of elements in the document
  var elements = body.getNumChildren();
  Logger.log('Got the page elements');

  // Use the number to loop through each element in the document.
  for( var i=0;i<elements;i++) {
   var element = body.getChild(i).copy();
    var type = element.getType();
    Logger.log('Element Types were successful. Starting tests.');    

    // Test each type for a child element and run script based on the result
    // Images are nested in a paragraph as a child, so the second `if` makes
    // sure there is no image present before moving to the next paragraph.
    if( type == DocumentApp.ElementType.PARAGRAPH ){
      if(element.asParagraph().getNumChildren() != 0 && element.asParagraph().getChild(0).getType() == DocumentApp.ElementType.INLINE_IMAGE) {
        var img = element.asParagraph().getChild(0).asInlineImage().getBlob();
        body.appendImage(img);
      } else if(element.asParagraph().getNumChildren() !=0 && element.asParagraph().getChild(0).getType() == DocumentApp.ElementType.INLINE_DRAWING) {
        var drawing = element.asParagraph().copy();
        body.appendParagraph(drawing);
      } else {
        var text = element.asParagraph().getText();
        Logger.log(text);
        var spn = LanguageApp.translate(text, origin, dest);
        body.appendParagraph(spn);
      }
    } else if(type == DocumentApp.ElementType.TABLE) {
      element.asTable().copy();
      body.appendTable(element);
    } else if(type == DocumentApp.ElementType.LIST_ITEM) {
      var list = element.asListItem().getText();
      body.appendListItem(LanguageApp.translate(list, origin, dest));
    }
  }

客户端JS是:

$(function() {
    $('#run-translation').click(loadPreferences);
    google.script.run(runTranslation)
  });

function runTranslation() {
    this.disabled = true;
    var origin = $('input[name=origin]:checked').val();
    var dest = $('input[name=dest]:checked').val();
    var savePrefs = $('#save-prefs').is(':checked');
    google.script.run
      .runTranslation(origin, dest, savePrefs);
  }

如果我将翻译中使用的语言硬编码到服务器端脚本中，它就可以工作。但是，一旦我尝试使用单选按钮中的变量，它就不会运行。我在控制台中没有看到任何错误，并且无法从编辑器运行脚本来检查日志。我该如何调试这段代码？

Answer 1

从客户端 Javascript 调用服务器端函数

您遇到了 google.run 的小语法错误:

google.script.run(runTranslation)

应该是:

google.script.run
             .withFailureHander(failFunc) // Optional
             .withSuccessHander(succFunc) // Optional
             .serverFunction(optionalParams...);

这两个处理程序方法从客户端 JavaScript 分配回调函数，以便在服务器端函数成功或失败时调用。在这两种情况下，客户端函数都作为唯一的参数提供。

您想要与之通信的服务器端函数的呈现方式就好像它本身就是一个方法，并带有要跨界传递的可选参数。

对您来说最简单的情况是:

google.script.run
             .translate(origin, dest, savePrefs);

(您发布的代码中有 runTranslation，但服务器端函数名为 translate()...我认为这是正确的。)

现在，这可能不会解决您的所有问题，因此您明智地询问了调试...

在 Google Apps 脚本中调试异步客户端/服务器代码

提供的调试环境不足以调试这种客户端/服务器交换。与异步执行一起使用的调试器也存在弱点 - 您可以在 Not seeing logs from onEdit trigger 中阅读更多相关信息。 .

在这种情况下进行调试的最简单工具是将日志写入电子表格

/**
 * Write message and timestamp to log spreadsheet.
 * From: https://stackoverflow.com/a/32212124/1677912
 */
function myLog( message ) {
  var ss = SpreadsheetApp.openById( logSpreadsheetId );
  var logSheet = ss.getSheetByName("Log") || ss.insertSheet("Log");
  logSheet.appendRow([ new Date(), message );
}

您可以这样从客户端 Javascript 调用它:

google.script.run.myLog( "CLIENT: " + message );

这是一种基本方法，但您可以通过使用实用函数和 BetterLog 库对其进行更多扩展。在我的博客文章 Did you know? (You can log to a spreadsheet from client JavaScript!) 中查看更多相关信息