Etkinlikleri ve hataları günlüğe kaydetme

Bu kılavuzda, Akışlar Etkinlik sekmesinde çalıştırılamayan bir akış adımında sorun gidermeye yardımcı olan özel günlüklerin ve hata mesajlarının nasıl yazılacağı açıklanmaktadır.

Etkinlik sekmesi, varsayılan olarak manifest dosyasında tanımlandığı şekilde çalışan adımın adını günlüğe kaydeder. Bir adım çalıştırma sırasında ne olduğunu anlamanıza yardımcı olması için adımınızla ilgili özel günlükler de yazmanız gerekir. Kullanıcılar adımınızı çalıştırırken beklenmedik bir davranışla karşılaşırlarsa günlükleriniz ne olduğunu anlamalarına yardımcı olabilir.

Faydalı bir günlük girişinin iki özelliği vardır:

  • Adım tarafından oluşturulan veya güncellenen kaynağa yönelik bir köprü içeren çip. Örneğin, adımınız bir Google Dokümanı oluşturuyorsa oluşturulan Google Dokümanı'na bağlantı vermek için çipi kullanın.
  • Bir adımın neden çalıştırılamadığını ve sorunun nasıl çözüleceğini açıklayan ayrıntılı bir hata mesajı.

Aşağıdaki kod örneğinde, bir adımın onExecuteFunction() başarılı bir çalıştırmayı ve bir hatayı Etkinlik sekmesine nasıl kaydedebileceği gösterilmektedir:

Apps Komut Dosyası

function onExecuteFunctionCreateDocument(e) {

  // true if the document is successfully created, false if something goes wrong.
  var successfulRun = createDocument();

  // If successful, return an activity log linking to the created document.
  if (successfulRun == true) {
    return {
      "hostAppAction": {
        "workflowAction": {
          "returnOutputVariablesAction": {
            "variableValues": [
              {}
            ],
            "log": {
              "textFormatElements": [
                {
                  "text": "Created Google Doc"
                },
                {
                  "chip": {
                    "icon": {
                      "materialIconName": "edit_document"
                    },
                    "url": "https://docs.google.com/document/d/{DOCUMENT}",
                    "label": "{NAMEOFDOCUMENT}"
                  }
                },
                {
                  "text": "Created doc detailing how to improve product."
                }
              ]
            },
            "trigger_log": {
              "textFormatElements": [
                {
                  "text": "Email log "
                }
              ]
            }
          }
        }
      }
    };
  }

  // Otherwise, return an activity log containing an error explaining what happened and how to resolve the issue.
  else {
    return {
      "hostAppAction": {
        "workflowAction": {
          "returnElementErrorAction": {
            "errorActionability": "NOT_ACTIONABLE",
            "errorRetryability": "NOT_RETRYABLE",
            "error_log": {
              "textFormatElements": [
                {
                  "text": "Failed to create Google Doc"
                },
                {
                  "chip": {
                    "icon": {
                      "materialIconName": "document"
                    },
                    "label": "{NAMEOFDOCUMENT}"
                  }
                },
                {
                  "text": "Unable to create Google Document because OAuth verification failed. Grant one of these authorization scopes and try again: https://www.googleapis.com/auth/documents, https://www.googleapis.com/auth/drive, https://www.googleapis.com/auth/drive.file"
                }
              ]
            }
          }
        }
      }
    };
  }
}