Worker Output Configuration (Output Schema)

This document explains how developers should configure the output_schema.json file. This file defines the output data table structure (column headers) displayed to users after a Worker run.

Output Schema User Guide

output_schema.json defines the column headers of the result data table. By editing this file, you can control which fields are displayed in the output table and how they are labeled, helping users clearly understand the structure of the collected data.

Overall Structure

output_schema.json is a JSON array where each element defines one column in the output table.

Core Example

[
  {
    "name": "title",
    "type": "string",
    "description": "Title"
  },
  {
    "name": "publish_time",
    "type": "string",
    "description": "Time"
  },
  {
    "name": "category",
    "type": "string",
    "description": "Category"
  }
]

Field Details

Each column definition contains the following properties:

Property	Required	Description
name	Yes	Column identifier. Must match the key name used in push_data. Must be unique.
type	Yes	Data type of the column. Supported values: string, integer, boolean, array, object
description	No	Column description. Displayed as the column header label in the UI.

Relationship with SDK

The name field in output_schema.json must match the key names used when calling push_data in your script.

For example, with the above configuration, your script should push data like this:

Python

CoreSDK.Result.push_data(json.dumps({
    "title": "Example Title",
    "publish_time": "2024-01-01",
    "category": "News"
}))

Node.js

coresdk.result.pushData(JSON.stringify({
    title: "Example Title",
    publish_time: "2024-01-01",
    category: "News"
}));

Go

data, _ := json.Marshal(map[string]interface{}{
    "title":        "Example Title",
    "publish_time": "2024-01-01",
    "category":     "News",
})
coresdk.Result.PushData(ctx, string(data))

Relationship with set_table_header

output_schema.json and set_table_header both define the output table structure, but they serve different purposes:

• output_schema.json: Declared before the run. Defines the output columns displayed in the UI, giving users a clear preview of the data structure.
• set_table_header: Called at runtime within the script. Defines the table headers programmatically.

It is recommended to use output_schema.json as the primary way to define output structure, ensuring the UI displays the correct column layout before the script starts.

Configuration Tips

1. Match field names: Ensure name values in output_schema.json exactly match the keys used in push_data calls.
2. Write clear descriptions: Use description to provide meaningful column labels that help users understand the data.
3. Choose correct types: Set type accurately so the platform can render and export the data correctly.