Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Provides the ability to start a composite(s) on the SOA server.  This operation will handle all revisions for a given composite to ensure that the default revision doesn't change as revisions are started.  The default revision is always started and other revisions can be controlled by an "Start All Revisions" input.

...

Input Name

Input Code

Required

Description

Composites FileFDSOA_INP_COMPOSITES_FILENoPath, including file name, to file that contains the composites to startFile name (anywhere in temp directory) or absolute path to file with comma separated composite names.  See Special Considerations section below for additional details.
Composite Name ListFDSOA_INP_COMPOSITE_NAME_LISTNoComma separated list of composites to startcomposite names, overrides Composite File Name input.  Optionally, can prefix a partition on the composite name if there are more than one composite with the same name, (<partition:>composite1, composite2).  See Special Considerations section below for additional details.
Start All RevisionsFDSOA_INP_START_ALL_REVISIONSNoProvides the option Check to leave all composites stopped, with the exception of the default revision start all composite revisions.  If false then only default revision will be started (default value is Falsefalse).
Composite Revision

FDSOA_INP_REVISION

No

Provide specific composite revision to start (this is for backwards compatibility).  If set then Start All Revisions input will be ignored.  See Special Considerations section below for additional details.

Make Default Revision

FDSOA_MAKE_DEFAULT_REVISION

NoMake the newly started composite the default revision (this is for backwards compatibility)

If Composite Revision input is provided, that specific revision will be set as default.

  

Outputs

Output Name

Required

Description




  

Artifacts

This operation doesn't consume or produce any artifacts.

...

This operation will execute on any one of the selected endpoints and will be random in the determination of which one.


Special Considerations

This operation has two independent capabilities and shouldn't be utilized together as the single revision logic is executed first.  If Composite Revision input is set, the Composite Files and Composite Name List inputs will be ignored :

  • starting a single revision (this is the backwards compatibility capability)
    • utilizes "Composite Revision" and "Make Default Revision" inputs to control what revision to start and whether it should be the default revision
  • starting multiple composites/revisions
    • utilizes "Composites File" or "Composite Name List" and "Start All Revisions" inputs
      • if utilizing "Composite File", there can be several variations of file name;
        1. just a file name, will look in the temp directory for the given file name
        2. relative path, will only look for the relative path within the temp directory for the given file name
        3. absolute path, will only look at the absolute path for the given file
    • either input (Composite File or Composite Name List) provides a list of composite names to start that must use the following format: <partition:>composite1,composite2 (partition is optional)
    • the default revision is started first and then all non-default revisions will be started, if the "Start All Revisions" input is checked.  This will maintain the default revision and not allow SOA Suite to move the default revision to another revision.  If a composite is in two partitions, then specify the partition in the above format to direct the operation to the correct composite.