5 Application Development Framework (ADF)カスタムWLSTコマンド
次の項目について説明します。
ADF WLSTコマンド・カテゴリの概要
構成またはランタイムBeanの階層の移動、およびプロンプト表示の制御を行うには、ADFベースのURL接続WLSTコマンドを使用します。getADFMArchiveConfig
コマンドを使用して、ADFMArchiveConfig
オブジェクトを管理します。
ノート:
ADF固有のWLSTコマンドをオンライン、オフライン、またはその両方でWLSTとともに使用することができます。オフラインのWLSTコマンドはMavenからはサポートされません。
ADF固有のWLSTコマンド
次の項のコマンドを使用して、URLベースの接続を管理します。
- adf_createFileUrlConnection
このコマンドは、新しいADFファイル接続を作成するために使用します。 - adf_deleteURLConnection
このコマンドは、ADF URL接続を削除するために使用します。 - adf_createHttpUrlConnection
このコマンドは、新しいADF URL接続を作成するために使用します。 - adf_setURLConnectionAttributes
このコマンドは、新しく作成したADF接続または既存のADF接続の属性を設定または編集するために使用します。 - adf_listUrlConnection
このコマンドは、新しいURL接続をリストします。 - getADFMArchiveConfig
このコマンドは、指定したアーカイブのADFMArchiveConfig
オブジェクトへのハンドルを戻すために使用します。 - exportJarVersions
このコマンドは、JARバージョンのCSV形式を現在のORACLE_HOME
から指定した場所にエクスポートするために使用します。 - exportApplicationJarVersions
このコマンドは、指定したアプリケーションのランタイムJARバージョンのCSV形式を指定した場所にエクスポートするために使用します。 - exportApplicationSelectedJarVersions
このコマンドは、選択したJARのJARバージョンのCSV形式をVersions.xml
ファイルと一緒に指定した場所にエクスポートするために使用します。 - createWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続を作成するために使用します。 - listWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続をリストします。 - deleteWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続を削除するために使用します。 - listUpgradeHandlers
このコマンドは、アプリケーションのすべてのアップグレード・ハンドラをリストします。 - upgradeADFMetadataApp
このコマンドは、アプリケーションの登録済ADFメタデータをアップグレードするために使用します。 - upgradeADFMetadataAppHandlers
このコマンドは、アプリケーションの選択した登録済ADFメタデータをアップグレードするために使用します。 - upgradeADFMetadata
このコマンドは、すべてのアプリケーションのすべての登録済ADFメタデータをアップグレードするために使用します。 - upgradeADFMetadataHandlers
このコマンドは、すべてのアプリケーションの選択した登録済ADFメタデータをアップグレードするために使用します。
adf_createFileUrlConnection
このコマンドは、新しいADFファイル接続を作成するために使用します。
WLSTでの使用: オンライン。
説明
このコマンドを使用して、oracle.adf.model.connection.url.FileURLConnection
接続クラスに基づいて新しい接続を作成します。
構文
adf_createFileURLConnection(appName, name, URL)
引数 | 定義 |
---|---|
|
接続が作成されるアプリケーション名 |
|
新しい接続の名前 |
|
この接続に関連するURL |
例
adf_createFileURLConnection('myapp','tempDir','/scratch/tmp')
親トピック: ADF固有のWLSTコマンド
adf_deleteURLConnection
このコマンドは、ADF URL接続を削除するために使用します。
WLSTでの使用: オンライン。
説明
ADF URL接続を削除するには、このコマンドを使用します。
構文
adf_deleteURLConnection(appName, name)
引数 | 定義 |
---|---|
|
接続を削除するアプリケーションの名前。 |
|
削除する接続の名前。 |
例5-1 例
adf_deleteURLConnection('myApp', 'mycompany')
親トピック: ADF固有のWLSTコマンド
adf_createHttpUrlConnection
このコマンドは、新しいADF URL接続を作成するために使用します。
WLSTでの使用: オンライン。
説明
このコマンドを使用して、oracle.adf.model.connection.url.HttpURLConnection
接続のtypeクラスに基づいて新しい接続を作成します。
構文
adf.createHttpURLConnection (appName, name, [URL], [authenticationType], [realm], [user], [password]
引数 | 定義 |
---|---|
|
接続が作成されるアプリケーション名 |
|
新しい接続の名前 |
|
(オプション)この接続に関連するURL |
|
(オプション)デフォルトは「基本」です。 |
|
(オプション)この接続は、認証のために使用する場合、これを設定する必要があります。デフォルトは「基本」です。 |
|
(オプション) |
|
(オプション) |
例
adf_createHttpURLConnection('myapp','cnn','http://www.cnn.com')
親トピック: ADF固有のWLSTコマンド
adf_setURLConnectionAttributes
このコマンドは、新しく作成したADF接続または既存のADF接続の属性を設定または編集するために使用します。
WLSTでの使用: オンライン。
説明
新しく作成したADF接続または既存のADF接続の属性を設定および編集するにはこのコマンドを使用します。
構文
adf_setURLConnectionAttributes(appname, connectionname, attributes)
引数 | 定義 |
---|---|
|
接続が作成されるアプリケーション名 |
|
新しい接続の名前 |
|
キーと値のペアに設定する属性を含む配列。 |
例
adf_setURLConnectionAttributes ('myapp','cnn','ChallengeAuthenticationType:digest', 'AuthenticationRealm:XMLRealm'
親トピック: ADF固有のWLSTコマンド
adf_listUrlConnection
このコマンドは、新しいURL接続をリストします。
WLSTでの使用: オンライン。
説明
このコマンドを使用して、アプリケーションの接続を示します。
構文
adf_listURLConnection(appname)
引数 | 定義 |
---|---|
|
アプリケーション名 |
例
adf_listURLConnection ('myapp')
親トピック: ADF固有のWLSTコマンド
getADFMArchiveConfig
このコマンドは、指定したアーカイブのADFMArchiveConfig
オブジェクトへのハンドルを戻すために使用します。
WLSTでの使用: オンラインまたはオフライン。
説明
指定されたアーカイブのADFMArchiveConfig
オブジェクトにハンドルを戻します。戻されるADFMArchiveConfig
オブジェクトのメソッドを使用して、アーカイブ内のアプリケーション構成を変更できます。
ADFMArchiveConfig
オブジェクトは、次のメソッドを提供します。
-
setDatabaseJboSQLBuilder([value])
- データベースのjbo.SQLBuilder
属性を設定します。 -
getDatabaseJboSQLBuilder()
-jbo.SQLBuilder
属性の現在の値を返します。 -
setDatabaseJboSQLBuilderClass([value])
- データベースのjbo.SQLBuilderClass
属性を設定します。値は、カスタム・ビルダー・クラスのフルネームです。 -
getDatabaseJboSQLBuilderClass()
-jbo.SQLBuilderClass
属性の現在の値を返します。 -
setDefaultRowLimit([value])
- デフォルトのrowLimit
属性を設定します。値は、行の長さ制限を指定します(デフォルトは-1)。 -
getDefaultRowLimit()
-rowLimit
属性の現在の値を返します。 -
save([toLocation])
-toLocation
を指定する場合、変更はターゲットのアーカイブ・ファイルに保存され、元のファイルは変更されません。これを指定しない場合、変更は元のファイル自体に保存されます。
構文
archiveConfigObject = ADFMAdmin.getADFMArchiveConfig(fromLocation)
引数 | 定義 |
---|---|
|
完全パスを含むearファイルの名前。 |
setDatabaseJboSQLBuilder([value])
の構文は次のとおりです。
archiveConfigObject.setDatabaseJboSQLBuilder([value])
引数 | 定義 |
---|---|
|
|
getDatabaseJboSQLBuilder()
の構文は次のとおりです。
archiveConfigObject.getDatabaseJboSQLBuilder()
setDatabaseJboSQLBuilderClass([value])
の構文は次のとおりです。
archiveConfigObject.setDatabaseJboSQLBuilderClass([value])
引数 | 定義 |
---|---|
|
|
getDatabaseJboSQLBuilderClass()
の構文は次のとおりです。
archiveConfigObject.getDatabaseJboSQLBuilderClass()
setDefaultRowLimit([value])
の構文は次のとおりです。
archiveConfigObject.setDefaultRowLimit([value])
引数 | 定義 |
---|---|
|
|
getDefaultRowLimit()
の構文は次のとおりです:
archiveConfigObject.getDefaultRowLimit([value])
save([toLocation])
の構文は次のとおりです。
archiveConfigObject.save([toLocation])
引数 | 定義 |
---|---|
|
変更が保存先ファイルの絶対パスを含む名前。 |
例
次の例では、jbo.SQLBuilder
属性がDB2に設定されています。
wls:/offline> archive = ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear') wls:/offline> archive.setDatabaseJboSQLBuilder(value='DB2') wls:/offline> archive.save()
次の例では、jbo.SQLBuilder
属性が削除されており、アプリケーションのデフォルトが使用されます。
wls:/offline> archive = ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear') wls:/offline> archive.setDatabaseJboSQLBuilder() wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')
次の例では、jbo.SQLBuilder
属性がCustomに、jbo.SQLBuilderClass
属性がクラスcom.example.CustomBuilderに設定されています。
wls:/offline> archive = ADFMAdmin.getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear') wls:/offline> archive.setDatabaseJboSQLBuilder('Custom') wls:/offline> archive.setDatabaseJboSQLBuilderClass('com.example.CustomBuilder') wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')
次の例では、rowLimit
属性が100に設定されています。
wls:/offline> archive = getADFMArchiveConfig(fromLocation='/tmp/testArchive.ear') wls:/offline> archive.setDefaultRowLimit(100) wls:/offline> archive.save(toLocation='/tmp/targetArchive.ear')
親トピック: ADF固有のWLSTコマンド
exportJarVersions
このコマンドは、JARバージョンのCSV形式を現在のORACLE_HOME
から指定した場所にエクスポートするために使用します。
WLSTでの使用: オフライン。
説明
JARバージョンのCSV形式を、現在のORACLE_HOME
から指定された場所にエクスポートするために使用します。エクスポートされたJARバージョン情報は、Oracle OpenOfficeまたはMS Excelで開くことができます。
構文
exportJarVersions(path)
引数 | 定義 |
---|---|
|
JARバージョンの抽出場所です。 |
例
この例は、JARバージョンを/tmp/export-MyApp-Versions.csv
にエクスポートする方法を示します。CSVファイルのR/W
権限を確認する必要があります。
wls:/offline>exportJarVersions('/tmp/export-MyApp-Versions.csv')
親トピック: ADF固有のWLSTコマンド
exportApplicationJarVersions
このコマンドは、指定したアプリケーションのランタイムJARバージョンのCSV形式を指定した場所にエクスポートするために使用します。
WLSTでの使用: オンライン。
説明
指定されたアプリケーションのランタイムJARバージョンのCSV形式を、指定された場所にエクスポートするために使用します。
構文
exportApplicationJarVersions
(application
Name,path
)
引数 | 定義 |
---|---|
|
JARバージョンをエクスポートするアプリケーションの名前です。 |
|
JARバージョンのエクスポート先です。 |
例
この例は、MyAppランタイムJARバージョンを/tmp/export-MyApp-Versions.csv
にエクスポートする方法を示します。CSVファイルのR/W
権限を確認する必要があります。
wls:/DefaultDomain/serverConfig>exportApplicationJarVersions('MyApp', '/tmp/export-MyApp-Versions.csv')
親トピック: ADF固有のWLSTコマンド
exportApplicationSelectedJarVersions
このコマンドは、選択したJARのJARバージョンのCSV形式をVersions.xml
ファイルと一緒に指定した場所にエクスポートするために使用します。
WLSTでの使用: オンライン。
説明
選択したJARのJARバージョンのCSV形式を、指定された場所にエクスポートするために使用します。
構文
exportApplicationSelectedJarVersions(applicationName, path, jarsLocation)
引数 | 定義 |
---|---|
|
JARバージョンをエクスポートするアプリケーション名。 |
|
JARバージョンの抽出場所です。 |
|
選択したJARのオプションのリスト。指定しない場合、
|
例
この例は、Versions.xml
ファイルのselectedJars
プロパティを使用してJARバージョンを/tmp/export-MyApp-Versions.csv
にエクスポートする方法を示します。この場合、jarsLocation
パラメータが指定されていないため、Versions.xml
ファイルのselectedJars
プロパティにリストされているライブラリがエクスポートされます。CSVファイルのR/W
権限を確認する必要があります。
wls:/offline>exportApplicationSelectedJarVersions('MyApp', '/tmp/export-MyApp-Versions.csv') Versions.xml <Diagnostics xmlns="xmlns.oracle.com/adf/diagnostics"> <Versions xmlns="xmlns.oracle.com/adf/diagnostics/versions" exportVersionsOnApplicationStartup="true" selectedJars="$ORACLE_HOME$/modules/oracle.adf.model_11.1.1/adfm.jar; $ORACLE_HOME$/modules/oracle.adf.view_11.1.1/adf-richclient-impl-11.jar; $ORACLE_HOME$/modules/oracle.adf.controller_11.1.1/adf-controller.jar; $ORACLE_HOME$/modules/oracle.adf.pageflow_11.1.1/adf-pageflow-impl.jar; $ORACLE_HOME$/modules/oracle.adf.share_11.1.1/adf-share-support.jar; $ORACLE_HOME$/modules/oracle.mds_11.1.1/mdsrt.jar" /> </Diagnostics>
この例は、jarsLocation
パラメータを使用してJARバージョンを/tmp/export-MyApp-Versions.csv
にエクスポートする方法を示します。この場合、jarsLocation
パラメータで明示的に渡されるライブラリがエクスポートされます。CSVファイルのR/W
権限を確認する必要があります。
wls:/offline>exportApplicationSelectedJarVersions('MyApp', '/tmp/export-MyApp-Versions.csv', '$ORACLE_HOME$/modules/oracle.adf.model_11.1.1/adfm.jar;$ORACLE_HOME$/modules/oracle.adf.view_11.1.1/adf-richclient-impl-11.jar')
親トピック: ADF固有のWLSTコマンド
createWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続を作成するために使用します。
WLSTでの使用: オンライン。
説明
ADFアプリケーションのWebサービス接続を作成するために使用します。
{serviceName
: List of portName
}形式でサービス名とポート名のセットを返します。
例: {'PolicyReferenceEchoBeanService': array(java.lang.String,['PolicyReferenceEchoBeanPort'])}
構文
createWebServiceConnection(appName, wsConnName, wsdlUrlStr, readerProps)
引数 | 定義 |
---|---|
|
Webサービス接続が作成されるADFアプリケーションの名前 |
|
新しいWebサービス接続の名前 |
|
サービスWSDLのURL文字列の名前 |
|
オプションのWSDLリーダー・プロパティ 次に例を示します。 '["wsdl.reader.proxy.host=proxy.my.com", "wsdl.reader.proxy.port=80"]' |
例
この例では、Webサービス接続mywsconn
およびWSDL URL文字列http://myserver/myservice?WSDL
でADFアプリケーションmyapp
のWebサービス接続を作成する方法を示します。
createWebServiceConnection('myapp','mywsconn','http://myserver/myservice?WSDL')
親トピック: ADF固有のWLSTコマンド
listWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続をリストします。
WLSTでの使用: オンライン。
説明
ADFアプリケーションに関連するWebサービス接続を一覧表示するために使用します。
構文
listWebServiceConnection(appName)
引数 | 定義 |
---|---|
|
Webサービス接続が一覧表示されるADFアプリケーションの名前 |
例
この例では、アプリケーションmyapp
のWebサービス接続をリストする方法を示します。
listWebServiceConnection('myapp')
親トピック: ADF固有のWLSTコマンド
deleteWebServiceConnection
このコマンドは、ADFアプリケーションのWebサービス接続を削除するために使用します。
WLSTでの使用: オンライン。
説明
ADFアプリケーションに関連するWebサービス接続を削除するために使用します。
構文
listWebServiceConnection(appName, weConnName)
引数 | 定義 |
---|---|
|
Webサービス接続が削除されるADFアプリケーションの名前 |
|
削除されるWebサービス接続の名前 |
例
この例では、アプリケーションmyapp
からWebサービス接続mywsconn
を削除する方法を示します。
deleteWebServiceConnection('myapp','mywsconn')
親トピック: ADF固有のWLSTコマンド
listUpgradeHandlers
このコマンドは、アプリケーションのすべてのアップグレード・ハンドラをリストします。
WLSTでの使用: オンライン。
説明
アプリケーションのすべてのアップグレード・ハンドラをリストするために使用されます。
構文
listUpgradeHandlers(application
Name)
引数 | 定義 |
---|---|
|
アップグレード・ハンドラをリストする対象のアプリケーション名。 |
例
次の例では、MyApp
アップグレード・ハンドラがリストされます。
wls:/DefaultDomain/serverConfig>listUpgradeHandlers('MyApp')
親トピック: ADF固有のWLSTコマンド
upgradeADFMetadataApp
このコマンドは、アプリケーションの登録済ADFメタデータをアップグレードするために使用します。
WLSTでの使用: オンライン。
説明
アプリケーションのすべての登録済ADFメタデータをアップグレードするために使用されます。
構文
upgradeADFMetadataApp(applicationName,siteCC)
引数 | 定義 |
---|---|
|
ハンドラをアップグレードする対象のアプリケーション名。 |
|
サイト・カスタマイゼーション・クラス名。 |
例
次の例では、アプリケーションのすべての登録済ADFメタデータがアップグレードされます。
wls:/DefaultDomain/serverConfig>upgradeADFMetadataApp('MyApp','oracle.apps.fnd.applcore.customization.SiteCC')
親トピック: ADF固有のWLSTコマンド
upgradeADFMetadataAppHandlers
このコマンドは、アプリケーションの選択した登録済ADFメタデータをアップグレードするために使用します。
WLSTでの使用: オンライン。
説明
アプリケーションの、選択した登録済ADFメタデータをアップグレードするために使用されます。
構文
upgradeADFMetadataAppHandlers(applicationName,sitecc,handlers)
引数 | 定義 |
---|---|
|
ハンドラをアップグレードする対象のアプリケーション名。 |
|
サイト・カスタマイゼーション・クラス名。 |
|
更新する登録済ハンドラ。 |
例
次の例では、アプリケーションの、選択した登録済ADFメタデータがアップグレードされます。
wls:/DefaultDomain/serverConfig>upgradeADFMetadataAppHandlers('MyApp','oracle.apps.fnd.applcore.customization.SiteCC','http://xmlns.oracle.com/adf/metadataUpgrade/bc4j/propertiesUpgrade')
親トピック: ADF固有のWLSTコマンド
upgradeADFMetadata
このコマンドは、すべてのアプリケーションのすべての登録済ADFメタデータをアップグレードするために使用します。
WLSTでの使用: オンライン。
説明
すべてのアプリケーションのすべての登録済ADFメタデータをアップグレードするために使用されます。
構文
upgradeADFMetadata(siteCC)
引数 | 定義 |
---|---|
|
サイト・カスタマイゼーション・クラス名。 |
例
次の例では、すべてのアプリケーションのすべての登録済ADFメタデータがアップグレードされます。
wls:/DefaultDomain/serverConfig>upgradeADFMetadata('oracle.apps.fnd.applcore.customization.SiteCC')
親トピック: ADF固有のWLSTコマンド
upgradeADFMetadataHandlers
このコマンドは、すべてのアプリケーションの選択した登録済ADFメタデータをアップグレードするために使用します。
WLSTでの使用: オンライン。
説明
すべてのアプリケーションの、選択した登録済ADFメタデータをアップグレードするために使用されます。
構文
upgradeADFMetadataHandlers(sitecc,handlers)
引数 | 定義 |
---|---|
|
サイト・カスタマイゼーション・クラス名。 |
|
更新する登録済ハンドラ。 |
例
次の例では、すべてのアプリケーションの、選択した登録済ADFメタデータがアップグレードされます。
wls:/DefaultDomain/serverConfig>upgradeADFMetadataHandlers('oracle.apps.fnd.applcore.customization.SiteCC','http://xmlns.oracle.com/adf/metadataUpgrade/bc4j/propertiesUpgrade')
親トピック: ADF固有のWLSTコマンド
MavenによるADF固有のWLSTコマンドの使用
ADF固有のWLSTコマンドは、Mavenとともに使用できます。
一連のADF固有のカスタムWLSTコマンドをロードするには、次に示すように、com.oracle.adf
groupIDおよびadf-wlst-dependencies
artifactIdをweblogic-maven-pluginのPOMの<build>セクションで指定する必要があります。
<?xml version="1.0" encoding="UTF-8"?> <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <modelVersion>4.0.0</modelVersion> <groupId>com.test</groupId> <artifactId>wlst-test</artifactId> <version>1.0-SNAPSHOT</version> <build> <plugins> <plugin> <groupId>com.oracle.weblogic</groupId> <artifactId>weblogic-maven-plugin</artifactId> <version>12.1.4-0-0</version> <executions> <execution> <phase>compile</phase> <goals> <goal>wlst-client</goal> </goals> <configuration> <fileName>${project.basedir}/misc/test.py</fileName> </configuration> </execution> </executions> <dependencies> <dependency> <groupId>com.oracle.adf</groupId> <artifactId>adf-wlst-dependencies</artifactId> <version>12.1.4-0-0</version> </dependency> </dependencies> </plugin> </plugins> </build> </project>