xia_composer.task.Task

class xia_composer.task.Task(**kwargs)

Bases: EmbeddedDocument

__init__(**kwargs)

Methods

__init__(**kwargs)
action(action_name[, acl, payload])	Doing an action of a document
assign_holder(holders_to_set, holder)	Assign holder
calculate_id()	Calculate document id from current attributes
collection_action(action_name[, acl, payload])	Doing a collection level action
dict_to_id(key_values)	Calculate document id from key_values
dict_to_id_list(key_values)	Calculate document id from key_values.
extract_output(full_text)	Extract the related data from full output text
from_db([_engine])	Transform database data to internal data
from_display(**kwargs)	Transform Display data to internal data
get_actions()	Get action supported by this document
get_all_fields()	Get All fields of current class
get_block_content(block_name, *[, params])	Get Block content from
get_display_data([lazy, catalog, show_hidden])	Get Display data (visualized form of data)
get_format_text()
get_guide_text()
get_holder()
get_meta_data()
get_raw_data()	Get Raw data (materialized form of data)
get_runtime_data()	Get Runtime data (calculated from raw data when runtime is activated)
get_sample()	Get a sample document data
id_to_dict(doc_id)	From document id to key
reviewable()	Review
set_holder(holder)
strip_explanation(output_text)	Stripping the explanation part of output text
to_db(*[, catalog, ignore_unknown, engine])	Translate the runtime data into raw data (materialized form of data)
validate()	Validate if all of the component of document follows the predefined rules
validate_output(output_text)	Validating Output

Attributes

OPERATORS
keyword_mapping
name
output_format
output_type
required_contexts
reviews
status
sub_name
target
task_type
title

action(action_name: str, acl=None, payload: Optional[dict] = None)

Doing an action of a document

Parameters

• action_name – The action name

• acl – Access Control List

• payload – Parameters of action

classmethod assign_holder(holders_to_set: list, holder)

Assign holder

Parameters

• holders_to_set (list) – The holder must be attached to the given list

• holder – Holder

calculate_id() → Optional[str]

Calculate document id from current attributes

Returns

Document id as string if having key field defined else None

classmethod collection_action(action_name, acl=None, payload: Optional[dict] = None)

Doing a collection level action

Parameters

• action_name – The action name

• acl – Access Control List

• payload – Parameters of action

classmethod dict_to_id(key_values: dict) → str

Calculate document id from key_values

Parameters

key_values (dict) – Key value dictionary

Returns

Document id as string

classmethod dict_to_id_list(key_values: dict) → list

Calculate document id from key_values. Accepting list as value. Output will always be list

Parameters

key_values (dict) – Key value dictionary

Returns

Document id as string

extract_output(full_text: str)

Extract the related data from full output text

Parameters

full_text – Output of GPT Engine

Returns

Result if format is correct. None if format is not good

classmethod from_db(_engine: Optional[Type[BaseEngine]] = None, **kwargs)

Transform database data to internal data

Parameters

• _engine – engine to be used for convert data

• **kwargs (object) – python dict got from system

Returns

python dict object

classmethod from_display(**kwargs)

Transform Display data to internal data

Parameters

**kwargs (object) – display object got from front end

Returns

python dict object

classmethod get_actions()

Get action supported by this document

Returns

Base]

Return type

dictionary[str

classmethod get_all_fields() → dict

Get All fields of current class

get_block_content(block_name: str, *, params: Optional[dict] = None) → str

Get Block content from

Parameters

• block_name – block part name of the task content text

• params – Parameters to be passed to render the output

Returns

Rendered block content

get_display_data(lazy: bool = True, catalog: Optional[dict] = None, show_hidden: bool = False)

Get Display data (visualized form of data)

Parameters

• lazy (bool) – Left the fields as is if they are not explicitly loaded

• catalog (dict) – The catalog of display field in the following format: * {field1: false, field2: false, field3: {sub-field1: true, sub-field2: true}} * field1, field2 is the top-level normal field * field3 is an embedded field/reference field/external field while sub-field1, sub-field2 is its fields * True or false will override the lazy setting, none means using lazy settings

• show_hidden (bool) – If hidden value should be shown or not

Returns

python dict object

Notes

We will return the detail form if it is possible

get_raw_data()

Get Raw data (materialized form of data)

Returns

python dict object

get_runtime_data()

Get Runtime data (calculated from raw data when runtime is activated)

Returns

python dict object

classmethod get_sample()

Get a sample document data

classmethod id_to_dict(doc_id: str) → dict

From document id to key

Parameters

doc_id (str) – Document ID

Returns

A dictionary who holds the key fields and the values

reviewable() → bool

Review

Returns

Could be reviewed or fixed

classmethod strip_explanation(output_text: str)

Stripping the explanation part of output text

Parameters

output_text (str) – task output

Returns

Essential part of task output

to_db(*, catalog: Optional[dict] = None, ignore_unknown: bool = False, engine: Optional[Type[BaseEngine]] = None)

Translate the runtime data into raw data (materialized form of data)

Parameters

• catalog (dict) – Data catalog to be parsed

• ignore_unknown (bool) – When a field is not defined in the document, should we send it back to the database

• engine – engine to be used for db data conversion

Returns

python dict object

validate()

Validate if all of the component of document follows the predefined rules

Returns

Always None. No exception raised means the validation passed

validate_output(output_text: str)

Validating Output

Parameters

output_text (str) – mission output

Returns

empty string if ok else Error Message