fix: refactor switch action to fix #1927

[sbliven]

Description

This refactors the switch action considerably to support dataset and job properties in more circumstances, fixing #1927.

Configuration Changes:

• Remove scope from the switch action. property now references the full context. Scopes should be included in the property, eg request.jobParams or datasets[*].datasetlifecycle (note the wildcard json path, required for arrays).
• Add phase configuration to control whether the switch applies during validate, perform, or all phases.
• Rename performJob to perform in the log action to match the switch phase

Behavioral Changes:

• Fall through to the default case if the property doesn't match anything (this used to be an error)
• Datasets can be accessed in create jobs during the perform phase
• Job properties can be accessed in update jobs during the validate phase

Motivation

Previously the switch property always applied to both phases, and threw an error if the property was not found. The validate phase only was able to switch over request properties. This was particularly limiting for update operations, since the request DTO doesn't overlap much with the job, so it wasn't possible to access most properties (eg any datasets). This provides significantly more flexibility.

Fixes

• Allow switch action to work with more properties (Support switching on dataset properties in update actions #1927)

Changes:

• jobConfig.yaml should be updated. The switch and log actions have different options.

Tests included

• Included for each change/fix?
• Passing?

Documentation

• swagger documentation updated (required for API changes)
• official documentation updated

official documentation info

SciCatProject/documentation#75

[sbliven]

I am working on updating docs.
I may rename the phases based on discussion in #1927.
Otherwise it's ready for review

[despadam]

For the naming of the phases, I would still vote for validate / perform (or performJob if you would prefer to keep it as it currently is).
Regarding the documentation, are you referring to this PR?

[sbliven]

I like @despadam's suggestion of validate/perform phases. I've updated to use those.

SciCatProject/documentation#73 corresponds to #1914, which has already merged. I need to incorporate your changes and merge that. Afterwards I will add documentation of the #1931 changes.