Currently the individual option settings in the Tag Source, the configuration values, can only be accessed by the logical functions:
IfVar "key" "value"
IfNotVar "key" "value"
where the key is used to access the setting which is compared to the given value.
This only works efficiently for values of type bool (logical) and for type strings with given choices to select from. There is no method available to read the other possible value types number and string (with arbitrary text input) in a websource script. A solution for a special, restricted case has been described by @rboss in An efficient method for assigning numeric inputs into %output%.
In my example I want to use a configuration value of type text, that allows me to enter a name that the script later can use as a name of a tag:
{
"type": "string",
"key": "Tag_Notes_Setting",
"title": "Tag field for notes",
"description": "Tag field to use for notes.",
"choices": ["none","COMMENT","NOTES","UNSYNCEDLYRICS"],
"default": "COMMENT"
},
For the user to provide a name not in my list of choices I had to use the above code without the choices, but then I see now way to read the value the user did enter.
Therefore I want to suggest the command:
SayVar "key"
that reads the (read only) configuration values and copies the value into an output buffer designated by the most recent outputto "NAME". This should work for any type and make it possible to really efficiently use all possible configuration options.