将信息传递到Google文档中的服务器端功能添加

时间:2015-08-25 16:53:30

标签: javascript google-apps-script google-docs

我正在开发基于Google Quickstart tutorial的Google文档插件。我尝试更改教程中“添加”的工作流程以附加新页面,然后在该新页面上插入翻译而不是逐行工作流程。

我有一个脚本在单个文档中工作,但我很难将其移动到Add On架构。我认为这与将客户端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);
  }

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

1 个答案:

答案 0 :(得分:4)

从客户端Javascript

调用服务器端函数

google.run

您的语法错误
google.script.run(runTranslation)

应该是:

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

两个Handler方法从客户端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!)

中查看更多相关信息