osbImport

Imports (deploys) a jar file to the OSB Server and performs environment-specific property replacement if a customization/configuration file is present in the code repository.  In addition, the import will conditionally (controlled by an input) perform environment-specific property replacement on the files within the project.

Environment/Instance Properties

Property Name

Property Code

Required

Description

Weblogic Admin User

FDWLS_ADMIN_USER

Yes

The user for the Weblogic admin server.

Weblogic Admin Password

FDWLS_ADMIN_PASSWORD

Yes

The password for Weblogic.

Weblogic Admin Listen Address

FDWLS_ADMIN_LISTEN_ADDRESS

Yes

The listener address of the Weblogic admin server. (e.g., localhost)

Weblogic Admin Listen Port

FDWLS_ADMIN_LISTEN_PORT

Yes

The port of the Weblogic admin server. (e.g 7001)

OSB Extended Classpath

FDOSB_EXT_CLASSPATH

No

Allows the user to extend the classpath for this plugin call.

OSB Home

FDOSB_ORACLE_SB_HOME

Yes

The Oracle OSB home. (e.g., /u01/oracle/products/fmw/osb)

Oracle Weblogic Home (WL_HOME)

FDWLS_WEBLOGIC_HOME

Yes

Weblogic Home Directory. (e.g. /u01/oracle/products/fmw/wlserver)

Project Properties

Property Name

Property Code

Required

Description

OSB Project

FDOSB_PROJECT_NAME

Yes

OSB Project Name.

OSB Jar Name

FDOSB_JAR_NAME

Yes

Name of the jar file used to deploy the OSB project.

OSB Customization File

FDOSB_CUSTOMIZATION_FILE

No

The name of the customization/configuration file to be applied after the deployment of the project. The Customization file can either be a fully qualified path or a path relative to the FD_TEMP_DIR.

OSB Preserve environment variable valuesFDOSB_PRESERVE_ENV_VAR_VALUESNo

This property was added in version 4.0.3.8

This optional property sets the setPreserveExistingEnvValues value of the ALSBImportPlan. If it is left blank, setPreserveExistingEnvValues is not set.

Inputs

Input Name

Input Code

Required

Description

OSB Customization File

FDOSB_INP_CUSTOMIZATION_FILE

No

The name of the customization/configuration file to be applied after the deployment of the project. The Customization file can either be a fully qualified path or a path relative to the FD_TEMP_DIR.

This plugin input overrides project property value for OSB Customization File.

Activate Property ReplacementFDOSB_INP_ACTIVATE_PROPERTY_REPLACEMENTNoA flag to control whether property replacement will occur on the contents of the jar file.  This doesn't affect the property replacement of the customization file.

Outputs

Output Name

Required

Description




Artifacts

This operation consumes a deployable jar file artifact from the artifacts repository.

Endpoint Selection

This operation will select all available endpoints associated to the environment/instance.

Endpoint Execution

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

Customization/Configuration File

The customization/configuration files that were saved to the FD_ARTIFACTS_DIR will be copied to the FD_TEMP_DIR directory. Configuring the OSB Customization File input on the import operation or the OSB Customization File project property which can be either an absolute path to a customization/configuration file or a relative path of the copied configuration file based relative to the FD_TEMP_DIR directory.

  • If the file path is absolute, the file will be copied to the FD_TEMP_DIR directory and the Property Replacement will be run on the file.
  • If the file is relative to the FD_TEMP_DIR directory, file replacement will be run on it.

Project Jar File Content 

All files with the following suffix ("XMLSchema", "WSDL", "XSLT", "Xquery", "Service", "Pipeline", "ProxyService", "BusinessService", "SA") within the OSB project structure are pre-processed by the plugin to transform any defined replacement properties.

A wsdl file could have server host names or passwords in it and will vary from environment to environment.