이 가이드에서는 흐름 활동 탭에서 실행되지 않는 흐름 단계를 문제 해결하는 데 도움이 되는 맞춤 로그와 오류 메시지를 작성하는 방법을 설명합니다.
기본적으로 활동 탭에는 매니페스트 파일에 정의된 대로 실행되는 단계의 이름이 기록됩니다. 단계 실행 중에 발생한 상황을 이해하려면 단계에 대한 맞춤 로그도 작성해야 합니다. 사용자가 단계를 실행하는 동안 예기치 않은 동작이 발생하면 로그를 통해 발생한 상황을 파악할 수 있습니다.
유용한 로그 항목에는 두 가지 속성이 있습니다.
- 단계에서 생성되거나 업데이트된 리소스에 대한 하이퍼링크가 포함된 칩입니다. 예를 들어 단계에서 Google 문서를 만드는 경우 칩을 사용하여 생성된 Google 문서에 연결합니다.
- 단계가 실행되지 않은 이유와 문제를 해결하는 방법을 설명하는 자세한 오류 메시지입니다.
다음 코드 샘플은 단계의 onExecuteFunction()가 성공적인 실행과 오류를 활동 탭에 기록하는 방법을 보여줍니다.
Apps Script
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"
}
]
}
}
}
}
};
}
}