4.1.4 Considering the linkage processing
It is necessary to define the processing for linking to cloud services as execution definitions. To define the processing, design the linkage processing as follows. For details on the definition items, see the description of the Execution definition window in 7. Operation.
-
In Execution start processing, set the command line for executing linkage processing.
-
In End confirmation processing, if the command in 1 is asynchronous and does not wait for the end, configure settings so that it waits until the end.
-
In Post-processing (normal end), if it is necessary to collect the results of the executed service, configure the settings.
-
In Post-processing (abnormal end), if it is necessary to suspend service execution if the command execution or end confirmation processing in 1 and 2 end abnormally, configure the settings.
In addition to the aforementioned design, it is necessary to consider the following, taking into account job operation in JP1/AJS3.
-
Parameters to be changed dynamically
-
Judgment of result
-
Designing job output
-
Trace information design
-
Job output design
Note that the design and verification results can be viewed in the Web screen called the Execution definition confirmation window. For details on the Execution definition confirmation window, see 7.1.9 Execution definition confirmation window.
The following details these items.
- Organization of this subsection
(1) Parameters to be changed dynamically
Parameters that are changed dynamically may be specified for service linkage jobs to be operated. Examples of such parameters include the following.
-
File names to be stored in a storage service, file paths to file sources
-
Workflow names of workflow services
-
Instance names for start or stop of virtual machines of computing services
-
Batch names used for batch execution of computing services
-
Function names used for server-less code execution services of computing services
Define these items for JP1/AJS3 - View jobs. Define these in JP1/AJS3 - View jobs. Regarding the things to be specified on the side of the job, consider the settings in Variable settings.
In addition, design the authentication information used to connect to cloud services in units of job execution. Specify the authentication definition that is used during job definition in JP1/AJS3 - View.
(2) Judgment of result
Consider a judgment condition for the result of a job executed on the host of the connection-destination service. Define these judgment criteria in End confirmation processing. Consider whether it is possible to perform judgment based on the standard output of each command.
(3) Designing job output
Consider and design standard output for using the execution result of service linkage jobs for subsequence jobs and what to be output to the result details screen of JP1/AJS3 - View or JP1/AJS3 - Web Console. Define the design content for job output in Job output processing.
(4) Trace information design
Consider and design trace information that is checked on the result details screen of JP1/AJS3 - View or JP1/AJS3 - Web Console in the event of an abnormal end of service linkage job execution, or is stored in the log for troubleshooting. Define the design content for trace information in Trace information settings.
(5) Verifying definitions
Before starting operation with the service linkage jobs described in 5. Management operation of service linkage jobs using the definitions configured in steps (1) to (4), you can verify on JP1/AJS3 for Cloud Service Applications how those definitions will be executed as jobs.
Before starting operation of the service linkage job, you can verify whether the linkage processing will be executed properly, based on the specific options specified in the command line used to execute the linkage processing and the execution results (such as command return codes and standard output). Specifically, you can verify the following.
-
Whether the specific values in the command line, after escaping the variables# specified in the execution command options and the options themselves, match the designed values
-
Whether the judgment on whether to continue the linkage processing, based on comparing the value of the comparison source variable# specified for judging the execution command result with the condition value, matches the design
-
Whether the judgment based on the return code of the execution command matches the design
-
Whether the standard output results obtained from the execution command match the designed output for the service linkage job (the contents of the job standard output and standard error output)
In addition, the above items are combined to execute service linkage jobs according to the flow described in 5. Management operation of service linkage jobs. This flow can be viewed as a flowchart. Please check in advance how the jobs will run by referring to the flowchart together with the variable information.
- #
-
For details on variables, see section 4.3.1 Variables used for the definition of service linkage job information. Note that, when checking the definitions, you can display a list of the variables used in the definitions and set arbitrary values to verify the definitions.