{"type":"doc","content":[{"type":"paragraph","content":[{"text":"FlexDeploy provides dozens of out of the box plugins for building and deploying software using various technologies and middleware platforms. The FlexDeploy Plugin SDK allows customers or Flexagon partners to develop their own plugins. This guide provides the documentation for creating and managing these plugin implementations.","type":"text"}]},{"type":"paragraph","content":[{"text":"FlexDeploy plugins are implemented in Java or Docker image and are installed on the FlexDeploy server for use within workflows. These plugins are automatically distributed to the endpoints where they are defined to execute. A plugin consists of four components:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Implementation","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Java ","type":"text","marks":[{"type":"strong"}]},{"text":"(See ","type":"text"},{"text":"Plugin SDK API documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.com/plugin-sdk/6.5/"}}]},{"text":")","type":"text","marks":[{"type":"link","attrs":{"href":"http://todo"}}]},{"text":" ","type":"text"},{"text":"or","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Docker image","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Metadata","type":"text","marks":[{"type":"strong"}]},{"text":" describing its operations, properties, and other behavior","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Setup scripts","type":"text","marks":[{"type":"strong"}]},{"text":" (optional) to initialize the environment prior to execution","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Required FlexDeploy libraries for Java implementation ","type":"text","marks":[{"type":"strong"}]},{"text":"(","type":"text","marks":[{"type":"link","attrs":{"href":"http://flexagon.com//plugin-sdk-5.0.0/plugin-sdk-5.0.0.zip"}}]},{"text":"download here","type":"text","marks":[{"type":"link","attrs":{"href":"https://flexagon.com/plugin-sdk/6.5/sdk_libraries.zip"}}]},{"text":")","type":"text","marks":[{"type":"link","attrs":{"href":"http://yyy"}}]}]}]}]},{"type":"paragraph","content":[{"text":"See detailed instructions below.","type":"text"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc-zone","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"92201ed8-8517-44ff-8b55-de0baa7bbf35"},"schemaVersion":{"value":"1"},"title":"Table of Content Zone"}},"localId":"321f6fee-155b-4a0d-bc01-67e726309896"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"f7bd950a-f6f7-49d1-8463-d5a08ee66aaa"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"17eb6c75-f2d2-44c9-8c1c-6744f06ff1b4"}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Development Approach","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Decide on implementation type - Java or Docker, depending on your expertise.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Define plugin.xml and properties.xml files. This should help you describe operations that will be developed and project or environment/instance level properties used by each operation. You can also define plugin operation inputs as appropriate. At times, you can just use inputs without properties if it makes sense.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Developer plugin implementation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unit test plugin operations.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Package and verify on FlexDeploy server.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Plugin Implementation","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Java Plugin","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Plugin Lifecycle","type":"text"}]},{"type":"paragraph","content":[{"text":"Each plugin operation (e.g. build, deploy, start, stop) is implemented by extending AbstractPluginProvider. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Apache HTTP Server - AbstractPluginProvider implementation - build operation","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"public class Build\n extends AbstractPluginProvider\n{\n private static final String CLZ_NAM = Build.class.getName();\n private static final FlexLogger LOG = FlexLogger.getLogger(CLZ_NAM);\n\n public Build()\n {\n super();\n }\n\n @Override\n public void validate()\n throws FlexCheckedException\n {\n //TODO\n }\n\n @Override\n public PluginResult execute()\n throws FlexCheckedException\n {\n //TODO\n }\n\n @Override\n public void cleanup()\n {\n //TODO\n }\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the XML metadata which is packaged with the plugin, FlexDeploy will manage its lifecycle by invoking the methods implemented by the concrete class.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"public abstract void ","type":"text"},{"text":"validate","type":"text","marks":[{"type":"strong"}]},{"text":"() throws FlexCheckedException;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"public abstract PluginResult ","type":"text"},{"text":"execute","type":"text","marks":[{"type":"strong"}]},{"text":"() throws FlexCheckedException;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"public void ","type":"text"},{"text":"cleanup","type":"text","marks":[{"type":"strong"}]},{"text":"();","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"validate","type":"text","marks":[{"type":"em"}]},{"text":" method is responsible for validating that prerequisites are satisfied prior to performing the execution. As you will see later, the XML metadata identifies basic prerequisites (e.g. required fields) that will be enforced by the plugin framework. However, there may be more advanced validation which can be implemented within this method.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Apache HTTP Server - build operation","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" @Override\n public void validate()\n throws FlexCheckedException\n {\n String methodName = \"validate\";\n LOG.logInfoEntering(methodName);\n //Let's validate that if a relative path is given, it exists on the file system.\n String relativePath = getRelativePathToFiles();\n if (relativePath != \"\")\n {\n File file = new File(getWorkflowExecutionContext().getTempDirectory() + relativePath);\n if (!file.exists())\n {\n throw new FlexCheckedException(ApacheHttpProperties.FDAH_00001_INVALID_PATH, \"The given relative path, [\" + relativePath + \"] was not found in the FD_TEMP_DIR, or was not a relative path.\");\n }\n }\n LOG.logInfoExiting(methodName);\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"execute","type":"text","marks":[{"type":"em"}]},{"text":" method is responsible for performing the actual execution of the plugin operation.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Apache HTTP Server - build operation","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" @Override\n public PluginResult execute()\n throws FlexCheckedException\n {\n String methodName = \"execute\";\n LOG.logInfoEntering(methodName);\n String source = getWorkflowExecutionContext().getTempDirectory() + getRelativePathToFiles();\n String destination = getWorkflowExecutionContext().getArtifactsDirectory() + File.separator + ApacheHttpProperties.ARTIFACTS_ZIP;\n\n LOG.logInfo(\"Zipping {0} into an artifact at (1}.\", source, destination);\n int zipped = new FlexZipUtils(source, new File(destination)).zipFolder();\n getWorkflowExecutionContext().getOutputMap().put(ApacheHttpProperties.FDAH_FILE_COUNT, new PropertyValue(zipped, PropertyValue.PropertyTypeEnum.Integer, false));\n LOG.logInfo(methodName, \"Done!\");\n\n LOG.logInfoExiting(methodName);\n return PluginResult.createPluginResult(getWorkflowExecutionContext());\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"After performing the execution, the execute method is responsible for setting any outputs into the WorkflowExecutionContext and returning the result using the following code fragment.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":"return PluginResult.createPluginResult(getWorkflowExecutionContext());","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"cleanup","type":"text","marks":[{"type":"em"}]},{"text":" method is responsible for freeing any resources utilized by the plugin operation. Examples would be closing connections, deleting files, etc. Note that the cleanup method is provided as an empty implementation by the abstract class, and can be overridden by the concrete subclasses as needed.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Workflow Execution Context","type":"text"}]},{"type":"paragraph","content":[{"text":"The Workflow Execution Context provides information related to the current execution. This includes properties, inputs, the endpoint working directory (and its sub-directories), and other execution related information. The following table summarizes the working directory sub-directories and their purpose.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"bb90fb67-dca6-4ae5-aef9-1949cb8e7f8e"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Directory","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"WorkflowExecutionContext Method","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"Physical Endpoint Location","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Working Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getWorkingDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/work//","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"The temporary working area defined for the target endpoint.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Artifacts Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getArtifactsDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/artifacts","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Build operations which produce artifacts place those files here to have them automatically transferred back to the FlexDeploy server and version in the artifact repository. Deploy operations which consume artifacts will have those files delivered to this directory prior to execution on the endpoint.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Temp Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getTempDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/temp","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Temporary working area for a plugin operation execution.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Internal Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getInternalDirectroy()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/internal","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Internal working area for a plugin operation execution, which is not to be acessed or written to by workflow developers.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Reports Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getReportsDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/reports","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Files placed in the reports directory will be automatically be transferred back to the FlexDeploy server.","type":"text"}]},{"type":"paragraph","content":[{"text":"They are displayed in the execution summary.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Transfer Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getTransferDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/transfer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Files in the transer directory are automatically transferred back to the FlexDeploy server upon completion of execution, and likewise are transferred to the endpoint for the next workflow step. This provides a mechanism for sharing files between steps in a workflow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Test Results Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getTestResultsDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/test-results","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Testing framework plugin executions place an XML document representing the test results into this directory, and they will be automatically be transferred back to the FlexDeploy server.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the xsd for formatting information.","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"caeb7d38-2e73-4009-8c41-5e2f834849a5","collection":"contentId-10340184165","type":"file"}}]},{"type":"paragraph","content":[{"text":"Results are displayed in the execution results pages, insights, reporting, and other locations.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Scan Results Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getScanResultsDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/scan-results","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Scanning framework plugin executions place an XML document representing the scan results into this directory, and they will be automatically be transferred back to the FlexDeploy server.","type":"text"}]},{"type":"paragraph","content":[{"text":"See the xsd for formatting information.","type":"text"}]},{"type":"mediaGroup","content":[{"type":"media","attrs":{"id":"a74bcc76-d566-4e6b-bf53-a3c07bbb9b7a","collection":"contentId-10340184165","type":"file"}}]},{"type":"paragraph","content":[{"text":"Results are displayed in the execution results pages, insights, reporting, and other locations.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.66]},"content":[{"type":"paragraph","content":[{"text":"Object Results Directory","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[199.96]},"content":[{"type":"paragraph","content":[{"text":"getObjectResultsDirectory()","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[330.34]},"content":[{"type":"paragraph","content":[{"text":"/object-results","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[568.73]},"content":[{"type":"paragraph","content":[{"text":"Build and Deployment plugin operations for partial deployment implementations place XML documents into this directory for identifying the objects included in the build, and their execution status at deployment time.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The AbstractPluginProvider base class has a number of methods for retrieving inputs/properties by type, based on scope, and returning a default if it is not defined.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"See ","type":"text","marks":[{"type":"strong"}]},{"type":"inlineCard","attrs":{"url":"https://flexagon.com/plugin-sdk/6.0/flexagon/fd/core/plugin/AbstractPluginProvider.html"}},{"text":" for a current list of methods that can be used to access the properties and values that you need.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Logging","type":"text"}]},{"type":"paragraph","content":[{"text":"Logging can be performed in plugin implementations by using the FlexDeployLogger class. The logger is statically initialized using the following two lines of code. Note that in this example ","type":"text"},{"text":"Build","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"would be replaced by the actual class name of the current class.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"FlexDeployLogger initialization","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" private static final String CLZ_NAM = Build.class.getName();\n private static final FlexLogger LOG = FlexLogger.getLogger(CLZ_NAM);","type":"text"}]},{"type":"paragraph","content":[{"text":"Log messages can be added using any of the public methods available on FlexDeployLogger.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Logging methods","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://flexagon.com/plugin-sdk/6.0/flexagon/ff/common/core/logging/FlexLogger.html"}},{"text":" for a current list of methods that can be used. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Docker image plugin","type":"text"}]},{"type":"paragraph","content":[{"text":"A plugin can be implemented as a ","type":"text"},{"text":"Docker image","type":"text","marks":[{"type":"strong"}]},{"text":" (instead of Java implementation). In this case the ","type":"text"},{"text":"\"plugin.jar\"","type":"text","marks":[{"type":"strong"}]},{"text":" file contains ","type":"text"},{"text":"plugin.xml","type":"text","marks":[{"type":"strong"}]},{"text":" file only. The Docker image should be stored in a Docker repository accessible from an endpoint (Docker host or Kubernetes cluster) executing the plugin. The full name of the image including repository should be specified in ","type":"text"},{"text":"ImageName ","type":"text","marks":[{"type":"strong"}]},{"text":"element of ","type":"text"},{"text":"plugin.xml","type":"text","marks":[{"type":"strong"}]},{"text":" file.","type":"text"}]},{"type":"paragraph","content":[{"text":"An example of ","type":"text"},{"text":"plugin.xml ","type":"text","marks":[{"type":"strong"}]},{"text":"file for ","type":"text"},{"text":"FlexagonADFBuilderPlugin:","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Oracle ADF plugin - plugin.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n FlexagonADFBuilderPlugin\n Oracle ADF Builder plugin\n A plugin to build ADF application and projects.\n Build\n ADF\n 3\n docker \n flexdeploy/plugin-jdeveloper \n Flexagon\n 5.0.1.8\n \n \n applicationBuild\n Build JDeveloper application using Deployment Profile\n applicationBuild\n true\n false\n \n false\n \n \n false\n \n FDJDEV_INP_APP_SOURCE_FOLDER\n Application Source Folder\n false\n String\n 1\n 100\n Specify folder where source is checked out. (Leave it blank if you did not use any sub-folder to checkout/export source)\n false\n false\n \n \n \n FDJDEV_INP_APP_DEPLOY_PROFILE\n Application Deployment Profile\n false\n String\n 1\n 100\n Specify application deployment profile. (Default would be name of .jws file)\n false\n false\n \n \n \n FDJDEV_INP_APP_ARTIFACT_FOLDER\n Application Artifacts Folder\n false\n String\n 1\n 100\n Specify relative folder where .ear file will be generated. (Default would be deploy).\n false\n false\n \n \n \n FDJDEV_INP_APP_SYNC_JDBC_RESOURCES\n Synchronize JDBC Resources\n false\n Boolean\n 1\n 100\n Specify if EAR file should have generated weblogic jdbc xml files. (Default would be false, so by default EAR file will not have any weblogic jdbc xml files).\n false\n false\n \n \n FDJDEV_INP_OVERRIDE_FILE_PATTERN\n Override File Pattern(s)\n false\n String\n 1\n 100\n Specify FileName=OverrideFileName pattern. Matching files will be replaced by override files and Property replacement logic will be executed. For example, web.xml=fd-web.xml.\n false\n false\n \n \n FDJDEV_INP_SAVE_ARTIFACTS_EXTENSIONS\n Save Artifacts with Extension(s)\n false\n String\n 1\n 100\n Extensions to be copied to artifacts after build. For example ear, war, jar, mar etc. (Defaults to ear)\n false\n false\n ear,war,jar,mar,aar\n true\n ear\n \n \n \n \n \n \n \n \n \n \n \n \n projectBuild\n Build ADF project(s) using Deployment Profile\n projectBuild\n true\n false\n \n false \n \n \n false\n \n FDJDEV_INP_APP_SOURCE_FOLDER\n Application(JDev) Source Folder\n false\n String\n 1\n 100\n Specify folder where source is checked out. (Leave it blank if you did not use any sub-folder to checkout/export source)\n false\n false\n \n \n \n FDJDEV_INP_PROJECT_NAME\n JDeveloper Project Name\n false\n String\n 1\n 100\n Specify Project name to build. (Leave it blank if you want to build all projects)\n false\n false\n \n \n \n FDJDEV_INP_PROJECT_DEPLOY_PROFILE\n Project Deployment Profile\n false\n String\n 1\n 100\n Specify project deployment profile. (Leave it blank if you want to run all deployment profiles)\n false\n false\n \n \n FDJDEV_INP_SAVE_ARTIFACTS_EXTENSIONS\n Save Artifacts with Extension(s)\n false\n String\n 1\n 100\n Extensions to be copied to artifacts after build. For example ear, war, jar, mar etc. (Optional)\n false\n false\n ear,war,jar,mar,aar\n true\n \n \n \n FDJDEV_INP_APP_ARTIFACT_FOLDER\n Application Artifacts Folder\n false\n String\n 1\n 100\n Specify relative folder where .war or .jar files will be generated. (Default is deploy).\n false\n false\n \n \n FDJDEV_INP_OVERRIDE_FILE_PATTERN\n Override File Pattern(s)\n false\n String\n 1\n 100\n Specify FileName=OverrideFileName pattern. Matching files will be replaced by override files and Property Replacement logic will be executed. For example, web.xml=fd-web.xml.\n false\n false\n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"While executing a plugin operation on a Docker host, FlexDeploy runs the following command on the target endpoint:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Docker command structure","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"docker run -rm --env-file env.list --name STEP_NAME_WF_EXEC_ID -v ${FD_WORKING_DIR}:/fd_working_dir FULL_IMAGE_NAME:PLUGIN_VERSION FD_PLUGIN_OPERATION_TARGET\n","type":"text"}]},{"type":"paragraph","content":[{"text":"While executing a plugin operation on a Kubernetes cluster, FlexDeploy runs the following commands","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Kubectl command structure","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"kubectl create -f pod.json\nkubectl cp ${FD_WORKING_DIR} ${INTERNAL_POD_NAME}:/fd_working_dir\nkubectl exec -it ${INTERNAL_POD_NAME} -- ${FD_PLUGIN_OPERATION_TARGET}\nkubectl cp ${INTERNAL_POD_NAME}:/fd_working_dir ${FD_WORKING_DIR}\nkubectl delete pod ${INTERNAL_POD_NAME}","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that images utilizing an entrypoint will not have their entrypoints called by the Kubernetes framework. This is to allow time for the working directory to be copied before execution starts. ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"FlexDeploy passes into the Docker container or K8 Pod values of the following environment variables (through env.list for docker) or (pod.json for K8):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_WORKING_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ARTIFACTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TEMP_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_INTERNAL_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TEST_RESULTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_OBJECT_RESULTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TRANSFER_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_CODE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TARGET_GROUP_CODE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TARGET_GROUP_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PROJECT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN_INSTALL_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENDPOINT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENDPOINT_ADDRESS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN_OPERATION","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_RESULT_FILE_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All plugin operation inputs ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All properties (by Name from metadata) for current project and target","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The plugin execution working folder is mounted to the container as ","type":"text"},{"text":"/fd_working_dir ","type":"text","marks":[{"type":"strong"}]},{"text":"volume. ","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to return outputs the container must create a properties file ","type":"text"},{"text":"/fd_working_dir/${FD_RESULT_FILE_NAME} ","type":"text","marks":[{"type":"strong"}]},{"text":"containing output values. For example:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Example of result.dck file","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"FDJDEV_OUT_EAR_FILE_NAME=application.ear\nFDJDEV_OUT_IS_DOCUMENTING_BORING=YES\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the plugin operation finishes its execution, the corresponding Docker container or Kubernetes POD will be removed.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Plugin Metadata","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Plugin XML","type":"text"}]},{"type":"paragraph","content":[{"text":"The plugin XML metadata (plugin.xml) defines information about the plugin, its operations, and its behavior. This XML file is bundled with the plugin Java class files and is used to integrate into the FlexDeploy platform. ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"plugin XML metadata schema (XSD)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Details of various elements is described in table below.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"27ead9bc-9f9d-45e0-a7b6-80067a7e99b8"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Element","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The root element for this plugin definition.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the plugin, which appears on plugins page after upload.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"PluginDisplayName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The display name of the plugin, which appears on workflow page under workflow operations.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A description for this plugin, which is displayed on the plugins page after upload.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"TechnologyGroup","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the technology that is plugin is for, which is displayed on the plugins page after upload.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"SubTechnologyGroup","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the sub-technology that is plugin is for, which is displayed on the plugins page after upload.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Vendor","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the vendor which authored the plugin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Plugin type. Supported values are ","type":"text"},{"text":"java ","type":"text","marks":[{"type":"strong"}]},{"text":"and ","type":"text"},{"text":"docker. ","type":"text","marks":[{"type":"strong"}]},{"text":"Optional. Default is ","type":"text"},{"text":"java.","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ImageName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Full name of Docker image","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"MaxConfurrentThreads","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The number of concurrent threads which are allowed to execute plugin operations on any single endpoint. Default is -1, which means unlimited.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Version","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The version of the plugin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ResourceTypes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A list of server/component types which are applicable for the underlying technology. This helps identify the endpoint to run a particular operation on. (e.g. for WebLogic - NodeManager, AdminServer, ManagedServer).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Resource","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/ResourceTypes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A server/component types which is applicable for the underlying technology (e.g. NodeManager).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Operations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A list of operations supported by this plugin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"An operation supported by this plugin.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the plugin operation.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A description for the plugin operation.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Target","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"For ","type":"text"},{"text":"Java","type":"text","marks":[{"type":"strong"}]},{"text":", the package qualified name of the Java class which implements ","type":"text"},{"text":"PluginProvider","type":"text","marks":[{"type":"em"}]},{"text":" or extends ","type":"text"},{"text":"AbstractPluginProvider","type":"text","marks":[{"type":"em"}]},{"text":". For ","type":"text"},{"text":"Docker","type":"text","marks":[{"type":"strong"}]},{"text":", the command passed to image when the container is started.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"PropertyKeys","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The list of properties used by this plugin operation. See ","type":"text"},{"text":"Property Definitions","type":"text","marks":[{"type":"link","attrs":{"href":"http://xxx"}}]},{"text":" section for details.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"PropertyKey","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/PropertyKeys","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A reference to a property used by this plugin operation. See ","type":"text"},{"text":"Property Definitions","type":"text","marks":[{"type":"link","attrs":{"href":"http://xxx/"}}]},{"text":" section for details.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Inputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A list of inputs used by this plugin operation.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"AllowsUserDefined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Whether or not this plugin operation allows user defined inputs. User defined inputs are useful for low-level technology plugins (e.g. shell) where the user is essentially providing the implementation via source or scripting code.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"An input definition for this plugin operation.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the input. Must be alpha-numeric, and be free of whitespace or special characters (except underscore). This name may be used in shell scripts or Groovy scripts and therefore must adhere to these variable naming standards.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"DataType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The data type of the input. Must be one of ","type":"text"},{"text":"Boolean","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Double","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Integer","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"String","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The description of the plugin input, which is displayed on the plugin step editor of the workflow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"DisplayName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The display name of the plugin input, which is displayed on the plugin step editor of the workflow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"DefaultValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The default value for the plugin input if no value is specified by the user. This value will also be displayed by default on the plugin step editor of the workflow.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"IsDefaultValueExpression","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Identifies whether the default value for this input is an expression or a literal value, if specified.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"SubDataType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"An optional sub-datatype for this input. Valid options are ","type":"text"},{"text":"DIRECTORY","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"JDBCURL","type":"text","marks":[{"type":"em"}]},{"text":", and ","type":"text"},{"text":"URL","type":"text","marks":[{"type":"em"}]},{"text":". Setting the SubDataType adds additional validation when user enters value.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"IsRequired","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether this input is required or not. Required inputs are enforced by the plugin step editor and at runtime.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"IsEncrypted","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the input is encrypted or not. Encrypted values are masked on the editor, and their values are not displayed in log files.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"MinValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Identifies the minimum required value for this input, and is enforced by the plugin step editor and at runtime. This value is only applicable for Integer and Double input types.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"MaxValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Identifies the maximum required value for this input, and is enforced by the plugin step editor and at runtime. This value is only applicable for Integer and Double input types.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ListData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Provides a list of values for this input which may be selected by the user on the plugin step editor. When ListData is provided the plugin step editor will render the value using a drop down component.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"DisplayRows","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Defines the height of the input field on the plugin step editor.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"DisplayColumns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Defines the length of the input field on the plugin step editor.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"LengthPrecision","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Defines the required input length. Only applies to ","type":"text"},{"text":"String","type":"text","marks":[{"type":"em"}]},{"text":" datatype.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ValidatorScript","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"An optional Groovy script which is executed to determine whether this input's value is valid. The ","type":"text"},{"text":"Value","type":"text","marks":[{"type":"em"}]},{"text":" bind variable is set to the current value of this input, while every other input is available by it's name. The script must return true if validation passes, and false otherwise. When returning false, the variable ","type":"text"},{"text":"ValidationMessage","type":"text","marks":[{"type":"em"}]},{"text":" should be set to the message to display at runtime when validation fails.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"IsMultiselect","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Inputs/Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"ListData","type":"text","marks":[{"type":"em"}]},{"text":" attribute is provided, the ","type":"text"},{"text":"IsMultiselect","type":"text","marks":[{"type":"em"}]},{"text":" identifies whether the user can select more than one value. As such, the input component for this input on the plugin step editor behaves accordingly.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Outputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"A list of outputs returned by this plugin operation's execution.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"AllowsUserDefined","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Outputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Whether or not this plugin operation allows user defined outputs. User defined outputs are useful for low-level technology plugins (e.g. shell) where the user is essentially providing the implementation via source or scripting code.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Output","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/Outputs","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"The name of the output returned from this plugin operation.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"EndPointSpecification","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Defines the strategy used for determining the endpoint or endpoints on which a plugin operation will execute on.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Selection","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Defines which endpoints will be seleted as candidates to execute on.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"All","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Selection","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates that all endpoints associated to the target should be selected as execution candidates.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Resource","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Selection","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates that only endpoints having the given resource name should be selected as execution candidates.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Delegated","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Selection","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates that the endpoint selection is delegated to the workflow developer (within the plugin step editor). In this case, the plugin step editor will present options of ","type":"text"},{"text":"All","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Resource","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Execution","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Of the selected endpoint candidates, determines which one(s) to execute on.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Any","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Execution","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates to execute on one of the selected endpoints (at random).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"All","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Execution","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates to execute on all of the selected endpoints.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"Delegated","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation/EndPointSpecification/Execution","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Indicates that execution strategy is delegated to the workflow developer (within the plugin step editor). In this case, the plugin step editor will present options of ","type":"text"},{"text":"Any ","type":"text","marks":[{"type":"em"}]},{"text":"and ","type":"text"},{"text":"All","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ConsumesArtifacts","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Identifies whether this plugin operation consumes an artifact. Valid values are true, false, ","type":"text"},{"text":"DELEGATED","type":"text","marks":[{"type":"em"}]},{"text":". In the case of DELEGATED, the plugin step editor will present a checkbox for the workflow developer to determine. When a plugin operation consumes artifacts, the associated artifacts from the artifact repository are copied to the artifact directory within the working directory on the endpoint prior to execution.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[126.32]},"content":[{"type":"paragraph","content":[{"text":"ProducesArtifacts","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[358.26]},"content":[{"type":"paragraph","content":[{"text":"/PluginDefinition/Operations/Operation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[794.73]},"content":[{"type":"paragraph","content":[{"text":"Identifies whether this plugin operation produces an artifact. Valid values are true, false, ","type":"text"},{"text":"DELEGATED","type":"text","marks":[{"type":"em"}]},{"text":". In the case of DELEGATED, the plugin step editor will present a checkbox for the workflow developer to determine. When a plugin operation produces artifacts, the associated artifacts from the artifact directory on the endpoint are copied back to the server and stored in the artifact repository.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Properties Definition","type":"text"}]},{"type":"paragraph","content":[{"text":"The PropertyKeys in the plugin.xml file reference properties that are defined externally to the file itself. This is done so that multiple plugin operations, and even multiple plugins, are allow to share properties. The properties are defined in another XML file, conforming to a different schema, and are bundled with the plugin. The schema, a description of its elements, and a sample XML file are provided below.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Plugin XML Properties Schema (XSD)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Details of various elements is described in table below.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"efa13918-4efa-4e71-a032-6e6bdcad2fd3"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Element","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"XSD Line Number","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"background":"#f4f5f7","rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"PropertyList","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The root element for this properties definition.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The name of the properties definition.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"A plugin property definition.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"11","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The name of the property. Must be alpha-numeric, and be free of whitespace or special characters (except underscore). This name may be used in shell scripts or Groovy scripts and therefore must adhere to these variable naming standards.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"12","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"A description for the property.","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Scope","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"13","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The scope of the property. Must be one of ","type":"text"},{"text":"PROJECT","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"ENVINST","type":"text","marks":[{"type":"em"}]},{"text":" (target renamed from Environment Instance).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"DataType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"14","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The data type of the property. Must be one of ","type":"text"},{"text":"Boolean","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Double","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Integer","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"String","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"SubDataType","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"15","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"An optional sub-datatype for this property when the DataType is String. Valid options are DIRECTORY, JDBCURL, and URL. Setting the SubDataType adds additional validation when user enters value.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"IsRequired","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"16","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether this property is required or not. Required properties are enforced at runtime.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"IsEncrypted","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"17","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Indicates whether the property is encrypted or not. Encrypted values are masked when entered by the user, and their values are not displayed in log files.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"MinValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"18","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Identifies the minimum required value for this property, and is enforced at runtime. This value is only applicable for Integer and Double input types.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"MaxValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"19","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Identifies the maximum required value for this property, and is enforced at runtime. This value is only applicable for Integer and Double input types.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"ListData","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Provides a list of values for this property which may be selected by the user on the various properties pages. When ListData is provided the editor will render the value using a drop down component.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"DisplayRows","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"21","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Defines the height of the property field on the editor.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"DisplayColumns","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"22","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Defines the length of the property field on the editor.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Validators","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"23","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"RESERVED FOR FUTURE USE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"Validator","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property/Validators","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"26","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"RESERVED FOR FUTURE USE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"DisplayName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"30","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The display name of the plugin property, which is displayed on the editor where property values are entered.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"DefaultValue","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"31","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"The default value for the plugin property if no value is specified by the user. This value will also be displayed by default on the editor where values are entered.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"IsDefaultValueExpression","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"32","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Identifies whether the default value for this property is an expression or a literal value, if specified.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"IsAllowsVariant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"33","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"RESERVED FOR FUTURE USE","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"LengthPrecision","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"34","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"Defines the required property length. Only applies to ","type":"text"},{"text":"String","type":"text","marks":[{"type":"em"}]},{"text":" datatype.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[134.03]},"content":[{"type":"paragraph","content":[{"text":"IsMultiselect","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.12]},"content":[{"type":"paragraph","content":[{"text":"/PropertyList/Property","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[136.77]},"content":[{"type":"paragraph","content":[{"text":"35","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[806.47]},"content":[{"type":"paragraph","content":[{"text":"If the ","type":"text"},{"text":"ListData","type":"text","marks":[{"type":"em"}]},{"text":" attribute is provided, the ","type":"text"},{"text":"IsMultiselect","type":"text","marks":[{"type":"em"}]},{"text":" identifies whether the user can select more than one value. As such, the input component for this property on the various editors behave accordingly.","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Plugin Setup Scripts","type":"text"}]},{"type":"paragraph","content":[{"text":"A plugin is executed on an endpoint by a wrapper java program, which is launched by a wrapper shell script. This wrapper shell script optionally sources in a setup script which is provided by the plugin. This setup script may perform initialization activities for the plugin. The following are examples of useful activities.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Append to the classpath by exporting the ","type":"text"},{"text":"FLEXAGON_FD_PLUGIN_CLASSPATH","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Append additional JVM arguments to the Java invocation by exporting the ","type":"text"},{"text":"FLEXAGON_FD_JAVA_ARGS","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" variable.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Override the JAVA_HOME used to invoke Java by exporting ","type":"text"},{"text":"JAVA_HOME","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" variable (do not include bin folder).","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The setup scripts have the following variables available to them:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JAVA_HOME (as defined by enpoint defintion's JDK Home)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_BASE_WORKING_DIR (as defined by endpoint definition's Base Working Directory)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_WORKING_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ARTIFACTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TEMP_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_INTERNAL_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TEST_RESULTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_OBJECT_RESULTS_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TRANSFER_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_CODE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENVIRONMENT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TARGET_GROUP_CODE","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_TARGET_GROUP_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PROJECT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN_INSTALL_DIR","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENDPOINT_NAME","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_ENDPOINT_ADDRESS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FD_PLUGIN_OPERATION","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"All properties (by Name from metadata) for current project and target","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The unix setup.sh setup script is used when executing on an endpoint using an SSH connection. And this is true on Windows platforms as well, since cygwin is used in that case. The setup.bat setup script is used only when executing on an endpoint using a localhost connection (and only in the event that the FlexDeploy server is running on Windows).","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Plugin Unit Testing","type":"text"}]},{"type":"paragraph","content":[{"text":"To fully test your plugin you will ultimately need to upload it to a FlexDeploy Server. However, for unit testing purposes, it will be useful to test it a standalone testcase (e.g. using JUnit). To help provide the setup which is required to test your plugin, the MockWorkflowExecutionContext class is provided. This class manages manages some of the conext attributes that are otherwise handled by the FlexDeploy framwork. You will first need to satisfy the following prerequisites to test your plugin:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the FlexDeploy and 3rd party libaries to your classpath (i.e. adflibFlexFndCommonCore.jar, adflibFlexDeployCore.jar, commons-io-2.4.jar)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the following JVM arguments to your run configuration","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"flexagon.fd.install.root= (can be any directory on your local computer)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"flexagon.fd.repository.root= (can be any directory on yoour local computer)","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The following setup must be performed using the JUnit ","type":"text"},{"text":"@BeforeClass","type":"text","marks":[{"type":"em"}]},{"text":" annotated methed, which will create the necessary FlexDeploy folders:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit - @BeforeClass","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" @BeforeClass\n public static void prepTests()\n throws IOException\n {\n MockWorkflowExecutionContext context = new MockWorkflowExecutionContext();\n File file = new File(context.getTempDirectory() + File.separator + subFolder + File.separator + fileName1);\n file.getParentFile().mkdir();\n file.createNewFile();\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"Next is the implementation of a test case.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"JUnit - @Test","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"java"},"content":[{"text":" @Test\n public void test()\n throws FlexCheckedException\n {\n MockWorkflowExecutionContext context = new MockWorkflowExecutionContext();\n clearFolders(context);\n AbstractPluginProvider plugin = new Build();\n plugin.setWorkflowExecutionContext(context);\n File file = new File(context.getTempDirectory() + File.separator + \"TestFile1.txt\");\n try\n {\n file.createNewFile();\n }\n catch (Exception e)\n {\n Assert.fail(e.getLocalizedMessage());\n e.printStackTrace();\n }\n plugin.validate();\n plugin.execute();\n Assert.assertEquals(\"The wrong number of files were in the zip file.\", 2, plugin.getWorkflowExecutionContext().getOutputMap().get(ApacheHttpProperties.FDAH_FILE_COUNT).getValue());\n String outputPath = context.getWorkingDirectory() + File.separator + \"unZipped\";\n doDeploy(outputPath);\n //System.exit(6);\n File deployedFile = new File(outputPath + File.separator + fileName1);\n Assert.assertEquals(\"Deployed file in root folder is missing.\", true, deployedFile.exists());\n deployedFile = new File(outputPath + File.separator + subFolder);\n Assert.assertEquals(\"subFolder is missing.\", true, deployedFile.exists());\n deployedFile = new File(outputPath + File.separator + subFolder + File.separator + fileName1);\n Assert.assertEquals(\"File in subFolder is missing.\", true, deployedFile.exists());\n }\n\n public void doDeploy(String outputPath)\n throws FlexCheckedException\n {\n Deploy plugin = new Deploy();\n MockWorkflowExecutionContext context = new MockWorkflowExecutionContext();\n\n context.addProperty(ApacheHttpProperties.FDAH_PATH_TO_DOCUMENT_ROOT, outputPath, PropertyValue.PropertyTypeEnum.String, false);\n plugin.setWorkflowExecutionContext(context);\n plugin.validate();\n plugin.execute();\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"A full example is provided with the source code for the Apache Http Server plugin.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Packaging a Plugin Version for Delivery","type":"text"}]},{"type":"paragraph","content":[{"text":"After you have finished developing and unit testing your plugin, you are ready to package it up into a JAR file in preparation for loading onto a FlexDeploy server.","type":"text"}]},{"type":"paragraph","content":[{"text":"To do that, cd to the folder that contains the files, and execute the following command: ","type":"text"},{"text":"jar cvfM0 -.jar *","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"This will make \"-.jar\" which will contain the files and folders around it.","type":"text"}]},{"type":"paragraph","content":[{"text":" The JAR file has the following structure:","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Plugin JAR Structure","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"-.jar\n properties\n .xml (Plugin XML Properties Definition)\n lib\n adflibFlexFndCommonCore.jar (FlexDeploy library)\n adflibFlexDeployCore.jar (FlexDeploy library)\n commons-io-2.11.0.jar (Apache Commons IO library)\n .jar (your plugin classes packaged into a JAR - containing full package structure)\n bin\n setup.sh (optional)\n setup.bat (optional)\n plugin.xml (Plugin XML Metatdata)","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Reminder","type":"text"}]},{"type":"paragraph","content":[{"text":"Remember to update the plugin Version in the plugin.xml file when packaging.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Java Plugin Reference Example","type":"text"}]},{"type":"paragraph","content":[{"text":"A fully functional ","type":"text"},{"text":"plugin example","type":"text","marks":[{"type":"link","attrs":{"href":"http://flexagon.com/plugin-sdk-5.1.0/apache-http-server-plugin.jar"}}]},{"text":" for ","type":"text"},{"text":"Apache HTTP Server","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", including ","type":"text"},{"text":"source code","type":"text","marks":[{"type":"link","attrs":{"href":"http://flexagon.com/plugin-sdk-5.1.0/apache-http-server-plugin-source.zip"}}]},{"text":", is provided for reference throughout this documentation. This plugin provides four operations","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"build","type":"text","marks":[{"type":"strong"}]},{"text":" - packages web server content into a zip file artifact","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"deploy","type":"text","marks":[{"type":"strong"}]},{"text":" - deploys the zip file artifact produced during build to an Apache HTTP Server","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"start","type":"text","marks":[{"type":"strong"}]},{"text":" - starts an Apache HTTP Server","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"stop","type":"text","marks":[{"type":"strong"}]},{"text":" - stops an Apache HTTP Server","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Apache HTTP Server Plugin XML Metadata","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sample plugin.xml","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n FlexagonApacheHttpPlugin\n Apache HTTP\n A plugin to manage Apache Http Servers and deployment.\n Web Servers\n Apache Http Server\n Flexagon\n -1\n 0.7\n \n \n build\n Build an artifact to deploy to an Apache Http Server\n flexagon.fd.plugin.apache.http.operations.Build\n \n \n false\n \n FDAH_PATH_TO_FILES\n String\n Relative path to files inside the FD_TEMP_DIR to collect into a build artifact\n Path to Files\n false\n false\n false\n 1\n 120\n \n \n \n false\n \n \n \n \n \n \n \n \n \n false\n true\n \n \n deploy\n Deploy to Apache Http Server artifact\n flexagon.fd.plugin.apache.http.operations.Deploy\n \n FDAH_PATH_TO_DOCUMENT_ROOT\n \n \n false\n \n \n false\n \n \n \n \n \n \n \n \n \n true\n false\n \n \n stopServer\n Stop an Apache Http Server\n flexagon.fd.plugin.apache.http.operations.Stop\n \n \n false\n \n \n false\n \n \n \n \n \n \n \n \n \n false\n true\n \n \n startServer\n Start an Apache Http Server\n flexagon.fd.plugin.apache.http.operations.Start\n \n FDAH_START_TIMEOUT\n \n \n false\n \n \n false\n \n \n \n \n \n \n \n \n \n false\n true\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Apache HTTP Server Properties XML","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Apache HTTP Server - AHS_PROPERTY_LISTING.xml (filename is irrelevant)","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n FDAH_PLUGIN\n \n FDAH_PATH_TO_DOCUMENT_ROOT\n Path to the document root of the server, such as htdocs.\n ENVINST\n String\n\tDIRECTORY\n false\n true\n \n \n \n FDAH_START_TIMEOUT\n How many milliseconds to wait for the server to start before failing the workflow step. Defaults to 300000 (5 minutes)\n ENVINST\n Integer\n false\n true\n \n \n","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing Plugin on FlexDeploy","type":"text"}]},{"type":"paragraph","content":[{"text":"Once you have packaged your plugin into a JAR file, go to FlexDeploy and navigate to Administration → Plugins. Upload your JAR file, and activate the new version.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Best Practices","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the following best practices when defining the Plugin XML Metadata/Properties for your plugin:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prefix plugin ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"em"}]},{"text":" with vendor/customer name (e.g. ","type":"text"},{"text":"Acme","type":"text","marks":[{"type":"strong"}]},{"text":"ApacheHttpPlugin)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Vendor","type":"text","marks":[{"type":"em"}]},{"text":" to your vendor/customer name (e.g. ","type":"text"},{"text":"Acme","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Give some thought to how users may want to sort/filter plugin operations when you set the ","type":"text"},{"text":"TechnologyGroup","type":"text","marks":[{"type":"em"}]},{"text":" (e.g. ","type":"text"},{"text":"Web Servers","type":"text","marks":[{"type":"strong"}]},{"text":") and ","type":"text"},{"text":"SubTechnologyGroup ","type":"text","marks":[{"type":"em"}]},{"text":"(e.g. ","type":"text"},{"text":"Apache Http Server","type":"text","marks":[{"type":"strong"}]},{"text":")","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":". Review Flexagon plugins for reference.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Prefix the ","type":"text"},{"text":"Version","type":"text","marks":[{"type":"em"}]},{"text":" of the plugin with the version of FlexDeploy it is compatible with (e.g. ","type":"text"},{"text":"4.0.","type":"text","marks":[{"type":"strong"}]},{"text":"12). The minor version has be updated everytime a new jar is built and available to be loaded onto a server (whether internally or externally). The version must be unique for every plugin.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name plugin operations as ","type":"text"},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"(e.g. ","type":"text"},{"text":"stopServer","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"deployContent","type":"text","marks":[{"type":"strong"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name plugin inputs and plugin properties using _, and use all uppercase. (e.g. ","type":"text"},{"text":"FDAH_START_TIMEOUT","type":"text","marks":[{"type":"strong"}]},{"text":"). In this example, ","type":"text"},{"text":"FD","type":"text","marks":[{"type":"strong"}]},{"text":" is what Flexagon/FlexDeploy uses, and ","type":"text"},{"text":"AH","type":"text","marks":[{"type":"strong"}]},{"text":" is the technology prefix for Apache Http Server. This will help ensure names are consistent and greatly reduce the risk of duplicate names across vendors/plugins.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Give careful consideration to the scope of your inputs/properties. If an attribute is likely to be fixed for every project and target, then it makes sense to be an input such that it is set once in the workflow. On the other hand, is the property likely to be environment specific? Is it likely to be project specific?","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Limitations","type":"text"}]},{"type":"paragraph","content":[{"text":"The Plugin SDK has the following limitations:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Partial Deployment plugins are not supported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SCM plugins can be created, however, they will not have integration with the Configuration tab of the FlexDeploy Project.","type":"text"}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}