কার্যকলাপ এবং ত্রুটি লগ করুন

এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে কাস্টম লগ এবং ত্রুটি বার্তা লিখতে হয় যা ওয়ার্কস্পেস স্টুডিও অ্যাক্টিভিটি ট্যাবে ব্যর্থ পদক্ষেপের সমস্যা সমাধানে সহায়তা করে।

ডিফল্টরূপে, অ্যাক্টিভিটি ট্যাবটি তার ম্যানিফেস্ট ফাইলে বর্ণিত ধাপের নাম লগ করে। ধাপে দৌড়ানোর সময় কী ঘটেছিল তা বুঝতে সাহায্য করার জন্য, আপনার ধাপের জন্য কাস্টম লগও লিখতে হবে। যদি ব্যবহারকারীরা আপনার ধাপ চালানোর সময় অপ্রত্যাশিত আচরণের সম্মুখীন হন, তাহলে আপনার লগগুলি তাদের কী ঘটেছে তা বুঝতে সাহায্য করতে পারে।

একটি সহায়ক লগ এন্ট্রির দুটি বৈশিষ্ট্য রয়েছে:

• ধাপটি তৈরি বা আপডেট করা রিসোর্সের হাইপারলিঙ্ক সম্বলিত একটি চিপ। উদাহরণস্বরূপ, যদি আপনার ধাপটি একটি Google ডক তৈরি করে, তাহলে তৈরি করা Google ডকের সাথে লিঙ্ক করতে চিপটি ব্যবহার করুন।
• একটি ধাপ কেন সম্পন্ন হয়নি এবং কীভাবে সমস্যাটি সমাধান করা যায় তা বর্ণনা করে একটি বিস্তারিত ত্রুটি বার্তা।

নিচের কোড নমুনাটি দেখায় কিভাবে onExecuteFunctionCreateDocument() একটি সফল রান এবং একটি ত্রুটি অ্যাক্টিভিটি ট্যাবে লগ করতে পারে।

ম্যানিফেস্ট ফাইলটি এখানে:

JSON সম্পর্কে

{
  "timeZone": "America/Los_Angeles",
  "exceptionLogging": "STACKDRIVER",
  "runtimeVersion": "V8",
  "addOns": {
    "common": {
      "name": "Log and Error Demo",
      "logoUrl": "https://www.gstatic.com/images/branding/productlogos/gsuite_addons/v6/web-24dp/logo_gsuite_addons_color_1x_web_24dp.png",
      "useLocaleFromApp": true
    },
    "flows": {
      "workflowElements": [
        {
          "id": "log_and_error_demo",
          "state": "ACTIVE",
          "name": "Log and Error Demo",
          "description": "Display a log message when executed successfully, display a error message and retry execution instead.",
          "workflowAction": {
            "inputs": [
              {
                "id": "value1",
                "description": "value1",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "INTEGER"
                }
              }
            ],
            "outputs": [
              {
                "id": "result",
                "description": "execution result",
                "cardinality": "SINGLE",
                "dataType": {
                  "basicType": "STRING"
                }
              }
            ],
            "onConfigFunction": "onConfigFunctionCreateDocument",
            "onExecuteFunction": "onExecuteFunctionCreateDocument"
          }
        }
      ]
    }
  }
}

অ্যাপ্লিকেশন লজিক কোডটি এখানে:

অ্যাপস স্ক্রিপ্ট

function onConfigFunctionCreateDocument() {
  const firstInput = CardService.newTextInput()
    .setFieldName("value1")
    .setTitle("First Value") //"FieldName" must match an "id" in the manifest file's inputs[] array.
    .setHint("Input 1 to successfully execute the step, 0 to fail the step and return an error.")
    .setHostAppDataSource(
      CardService.newHostAppDataSource()
        .setWorkflowDataSource(
          CardService.newWorkflowDataSource()
            .setIncludeVariables(true)
        )
    );

  let cardSection = CardService.newCardSection()
    .addWidget(firstInput);

  return CardService.newCardBuilder()
    .addSection(cardSection)
    .build();
}

function onExecuteFunctionCreateDocument(event) {

  // true if the document is successfully created, false if something goes wrong.
  var successfulRun = event.workflow.actionInvocation.inputs["value1"].integerValues[0];
  console.log("The user input is: ", successfulRun);

  // If successful, return an activity log linking to the created document.
  if (successfulRun == 1) {
    let logChip = AddOnsResponseService.newTextFormatChip()
      .setTextFormatIcon(
        AddOnsResponseService.newTextFormatIcon()
          .setMaterialIconName("edit_document")
      )
      .setUrl("https://docs.google.com/document/d/{DOCUMENT}")
      .setLabel("Mock Document");

    let output = AddOnsResponseService.newVariableData()
      .addStringValue("Created Google Doc");

    const workflowAction = AddOnsResponseService.newReturnOutputVariablesAction()
      .addVariableData("result", output)
      // Set the user-facing error log
      .setLog(
        AddOnsResponseService.newWorkflowTextFormat()
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setText("Created Google Doc")
          )
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setTextFormatChip(logChip)
          )
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setText("Created doc detailing how to improve product.")
          )
      );

    let hostAppAction = AddOnsResponseService.newHostAppAction()
      .setWorkflowAction(workflowAction);

    return AddOnsResponseService.newRenderActionBuilder()
      .setHostAppAction(hostAppAction)
      .build();
  }
  // Otherwise, return an activity log containing an error explaining what happened and how to resolve the issue.
  else {
    let errorChip = AddOnsResponseService.newTextFormatChip()
      .setTextFormatIcon(
        AddOnsResponseService.newTextFormatIcon()
          .setMaterialIconName("file_open")
      )
      .setLabel("Mock Document");

    const workflowAction = AddOnsResponseService.newReturnElementErrorAction()
      .setErrorActionability(AddOnsResponseService.ErrorActionability.ACTIONABLE)
      .setErrorRetryability(AddOnsResponseService.ErrorRetryability.NOT_RETRYABLE)
      // Set the user-facing error log
      .setErrorLog(
        AddOnsResponseService.newWorkflowTextFormat()
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setText("Failed to create Google Doc.")
          )
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setTextFormatChip(errorChip)
          )
          .addTextFormatElement(
            AddOnsResponseService.newTextFormatElement()
              .setText("Unable to create Google Document because OAuth verification failed. Grant one of these authorization scopes and try again: https://www.googleapis.com/auth/documents, \nhttps://www.googleapis.com/auth/drive, \nhttps://www.googleapis.com/auth/drive.file")
          )
      );

    let hostAppAction = AddOnsResponseService.newHostAppAction()
      .setWorkflowAction(workflowAction);

    return AddOnsResponseService.newRenderActionBuilder()
      .setHostAppAction(hostAppAction)
      .build();
  }
}

সম্পর্কিত বিষয়

• একটি ধাপ তৈরি করুন
• ইনপুট ভেরিয়েবল
• একটি ইনপুট ভেরিয়েবল যাচাই করুন
• আউটপুট ভেরিয়েবল
• ওয়ার্কস্পেস স্টুডিও ইভেন্ট অবজেক্ট