ReadYAML

MacroModule

genre	Other
author	Jan-Martin Kuhnigk
package	FMEstable/ReleaseMeVis
definition	ReadYAML.def
see also	LoadYAML
keywords	yaml, json, config, string, parse, python, object, edit, edityaml

Purpose

Converts a YAML (https://en.wikipedia.org/wiki/YAML) formatted string into a python object.

Usage

Just write or paste the YAML formatted string into the YAML String field and press update.

Details

Note that an empty string will result as an error as a None object cannot be transmitted as a python object.

Windows

Default Panel

Output Fields

outPythonObject

name: outPythonObject, type: MLBase

Python object (string, number, list, dict) representing the YAML input string, or None on error/empty string.

Parameter Fields

Field Index

[]: Trigger	Update: Trigger
Clear: Trigger	YAML String: String
doNotClearOnFailedUpdate: Bool
Has Valid Output: Bool
On Input Change Behavior: Enum
Output Object Datatype: String
Status Code: Enum
Status Message: String

Visible Fields

YAML String

name: inString_YAML, type: String

YAML formatted string to construct the python object from.

Output Object Datatype

name: outDatatype, type: String, persistent: no

Datatype of the toplevel python object read.

Update

name: update, type: Trigger

Initiates update of all output field values.

Clear

name: clear, type: Trigger

Clears all output field values to a clean initial state.

On Input Change Behavior

name: onInputChangeBehavior, type: Enum, default: Clear, deprecated name: shouldAutoUpdate,shouldUpdateAutomatically

Declares how the module should react if a value of an input field changes.

Values:

Title	Name	Deprecated Name
Update	Update	TRUE
Clear	Clear	FALSE

[]

name: updateDone, type: Trigger, persistent: no

Notifies that an update was performed (Check status interface fields to identify success or failure).

Has Valid Output

name: hasValidOutput, type: Bool, persistent: no

Indicates validity of output field values (success of computation).

Status Code

name: statusCode, type: Enum, persistent: no

Reflects module’s status (successful or failed computations) as one of some predefined enumeration values.

Values:

Title	Name
Ok	Ok
Invalid input object	Invalid input object
Invalid input parameter	Invalid input parameter
Internal error	Internal error

Status Message

name: statusMessage, type: String, persistent: no

Gives additional, detailed information about status code as human-readable message.

Hidden Fields

doNotClearOnFailedUpdate

name: doNotClearOnFailedUpdate, type: Bool, persistent: no

Prevents automated clear after update failed. This does not affect status fields. It enables the developer to analyze module’s state after failure.