Attività di log ed errori

Questa guida spiega come scrivere log e messaggi di errore personalizzati che aiutano a risolvere i problemi relativi a un passaggio del flusso che non viene eseguito nella scheda Attività dei flussi.

Per impostazione predefinita, la scheda Attività registra il nome del passaggio eseguito come definito nel file manifest. Per aiutarti a capire cosa è successo durante l'esecuzione di un passaggio, devi scrivere anche log personalizzati per il passaggio. Se gli utenti riscontrano un comportamento inatteso durante l'esecuzione del passaggio, i log possono aiutarli a capire cosa è successo.

Una voce di log utile ha due attributi:

  • Un chip contenente un link ipertestuale alla risorsa creata o aggiornata dal passaggio. Ad esempio, se il passaggio crea un documento Google, utilizza il chip per collegarti al documento Google creato.
  • Un messaggio di errore dettagliato che descrive il motivo per cui un passaggio non è stato eseguito e come risolvere il problema.

Il seguente esempio di codice mostra come il onExecuteFunction() di un passaggio può registrare un'esecuzione riuscita e un errore nella scheda Attività:

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"
                }
              ]
            }
          }
        }
      }
    };
  }
}