プライマリ・コンテンツに移動
Oracle® Fusion Middlewareインフラストラクチャ・コンポーネントWLSTコマンド・リファレンス
12c (12.2.1)
E69981-01
  ドキュメント・ライブラリへ移動
ライブラリ
製品リストへ移動
製品
目次へ移動
目次

前
 
次
 

5 Application Development Framework (ADF)のカスタムWLSTコマンド

この後の各項では、Oracle ADFのWLSTカスタム・コマンドおよび変数を詳細に説明します。内容は次のとおりです。

WLSTコマンド・カテゴリの概要

構成またはランタイムBeanの階層の移動、およびプロンプト表示の制御を行うには、ADFベースのURL接続WLSTコマンドを使用します。ADFMArchiveConfigオブジェクトの管理には、getADFMArchiveConfigコマンドを使用します。


注意:

ADF固有のWLSTコマンドをオンライン、オフライン、またはその両方でWLSTとともに使用することができます。オフラインのWLSTコマンドはMavenからはサポートされません。

ADF固有のWLSTコマンド

表5-1のコマンドを使用して、URLベースの接続を管理します。

表5-1 WLST構成用の参照コマンド

使用するコマンド 目的 WLST使用

adf_createFileUrlConnection


新しいADFファイル接続を作成します。

オンラインまたはオフライン

adf_createHttpUrlConnection


新しいADF URL接続を作成します。

オンラインまたはオフライン

adf_setURLConnectionAttributes


新たに作成されたADF接続または既存のADF接続の属性を設定または編集します。

オンラインまたはオフライン

adf_listUrlConnection


新しいURL接続をリストします。

オンラインまたはオフライン

getADFMArchiveConfig


指定されたアーカイブのADFMArchiveConfigオブジェクトにハンドルを戻します。

オンラインまたはオフライン

exportJarVersions


JARバージョンのCSV形式を現在のORACLE_HOMEから指定された場所にエクスポートします。

オフライン

exportApplicationJarVersions


指定されたアプリケーションのランタイムJARバージョンのCSV形式を指定された場所にエクスポートします。

オンライン

exportApplicationSelectedJarVersions


Versions.xmlファイルと連携して、選択したJARのJARバージョンのCSV形式を指定された場所にエクスポートします。

オンライン

createWebServiceConnection


ADFアプリケーションのWebサービス接続を作成します。

オンライン

listWebServiceConnection


ADFアプリケーションのWebサービス接続をリストします。

オンライン

deleteWebServiceConnection


ADFアプリケーションのWebサービス接続を削除します。

オンライン

listUpgradeHandlers


アプリケーションのすべてのアップグレード・ハンドラをリストします。

オンライン

upgradeADFMetadataApp


アプリケーションの登録済ADFメタデータをアップグレードします。

オンライン

upgradeADFMetadataAppHandlers


アプリケーションの、選択した登録済ADFメタデータをアップグレードします。

オンライン

upgradeADFMetadata


すべてのアプリケーションのすべての登録済ADFメタデータをアップグレードします。

オンライン

upgradeADFMetadataHandlers


すべてのアプリケーションの、選択した登録済ADFメタデータをアップグレードします。

オンライン


adf_createFileUrlConnection

WLST使用: オンラインまたはオフライン

説明

このコマンドを使用して、oracle.adf.model.connection.url.FileURLConnection接続クラスに基づいて新しい接続を作成します。

構文

adf_createFileURLConnection(appName, name, URL)
引数 定義
appName 接続を作成するアプリケーション名。
name 新しい接続の名前。
URL この接続に関連付けられるURL。

adf_createFileURLConnection('myapp','tempDir','/scratch/tmp')

adf_createHttpUrlConnection

WLST使用: オンラインまたはオフライン

説明

このコマンドを使用して、oracle.adf.model.connection.url.HttpURLConnection接続のtypeクラスに基づいて新しい接続を作成します。

構文

adf.createHttpURLConnection (appName, name, [URL], [authenticationType], [realm], [user], [password]
引数 定義
appName 接続を作成するアプリケーション名。
name 新しい接続の名前。
url (オプション) この接続に関連付けられるURL。
authenticationType (オプション) デフォルトはbasicです。
realm (オプション) この接続が認証を処理する場合は、これを設定する必要があります。デフォルトは「基本」モードです。
user (オプション)
password (オプション)

adf_createHttpURLConnection('myapp','cnn','http://www.cnn.com') 

adf_setURLConnectionAttributes

WLST使用: オンラインまたはオフライン

説明

このコマンドは、新たに作成されたADF接続または既存のADF接続の属性を設定または編集する際に使用します。

構文

adf_setURLConnectionAttributes(appname, connectionname, attributes)
引数 定義
appname 接続を作成するアプリケーション名。
connectionname 新しい接続の名前。
attributes キーと値のペアに設定される属性を含む配列。

adf_setURLConnectionAttributes ('myapp','cnn','ChallengeAuthenticationType:digest',
'AuthenticationRealm:XMLRealm'

adf_listUrlConnection

WLST使用: オンラインまたはオフライン

説明

このコマンドは、アプリケーションの接続をリストする際に使用します。

構文

adf_listURLConnection(appname)
引数 定義
appname アプリケーション名

adf_listURLConnection ('myapp')

getADFMArchiveConfig

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)
引数 定義
fromLocation 
完全パスを含むearファイルの名前。

setDatabaseJboSQLBuilder([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilder([value])
引数 定義
value 
jbo.SQLBuilder属性の値。有効な値は、Oracle(デフォルト)、OLite、DB2、SQL92、SQLServer、Customです。Customを指定した場合は、jbo.SQLBuilderClass属性も設定する必要があります。

getDatabaseJboSQLBuilder()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilder()

setDatabaseJboSQLBuilderClass([value])の構文は次のとおりです。

archiveConfigObject.setDatabaseJboSQLBuilderClass([value])
引数 定義
value 
jbo.SQLBuilderClass属性の値。

getDatabaseJboSQLBuilderClass()の構文は次のとおりです。

archiveConfigObject.getDatabaseJboSQLBuilderClass()

setDefaultRowLimit([value])の構文は次のとおりです。

archiveConfigObject.setDefaultRowLimit([value])
引数 定義
value 
rowLimit属性の値。

getDefaultRowLimit()の構文は次のとおりです。

archiveConfigObject.getDefaultRowLimit([value])

save([toLocation])の構文は次のとおりです。

archiveConfigObject.save([toLocation])
引数 定義
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')

exportJarVersions

WLST使用: オフライン。

説明

JARバージョンのCSV形式を、現在のORACLE_HOMEから指定された場所にエクスポートするために使用します。エクスポートされたJARバージョン情報は、Oracle OpenOfficeまたはMS Excelで開くことができます。

構文

exportJarVersions(path)
引数 定義
path
JARバージョンを抽出する場所。

この例は、JARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。CSVファイルのR/W権限を確認する必要があります。

wls:/offline>exportJarVersions('/tmp/export-MyApp-Versions.csv')

exportApplicationJarVersions

WLST使用: オンライン。

説明

指定されたアプリケーションのランタイムJARバージョンのCSV形式を指定された場所にエクスポートするために使用します。

構文

exportApplicationJarVersions(applicationName, path)
引数 定義
applicationName
JARバージョンをエクスポートするアプリケーション名
path
JARバージョンをエクスポートする場所。

この例は、MyAppランタイムJARバージョンを/tmp/export-MyApp-Versions.csvにエクスポートする方法を示します。CSVファイルのR/W権限を確認する必要があります。

wls:/DefaultDomain/serverConfig>exportApplicationJarVersions('MyApp',
'/tmp/export-MyApp-Versions.csv')

exportApplicationSelectedJarVersions

WLST使用: オンライン。

説明

選択したJARのJARバージョンのCSV形式を指定された場所にエクスポートするために使用します。

構文

exportApplicationSelectedJarVersions(applicationName, path, jarsLocation)
引数 定義
applicationName
JARバージョンをエクスポートするアプリケーション名。
path
JARバージョンを抽出する場所。
jarsLocation
選択したJARのオプションのリスト。指定しない場合、%WLSDOMAIN%/config/fmwconfig/Versions.xmlのデフォルトのJARランタイム・バージョンのリストがエクスポートされます。

Versions.xmlselectedJarsプロパティが空の場合、adfm.jaradf-richclient-impl-11.jaradf-controller.jaradf-pageflow-impl.jaradf-share-support.jarおよびmdsrt.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') 

createWebServiceConnection

WLST使用: オンライン。

説明

ADFアプリケーションのWebサービス接続の作成に使用します。

{serviceName: List of portName}形式でサービス名とポート名のセットを返します。

例: {'PolicyReferenceEchoBeanService': array(java.lang.String,['PolicyReferenceEchoBeanPort'])}

構文

createWebServiceConnection(appName, wsConnName, wsdlUrlStr, readerProps)
引数 定義
appName 
Webサービス接続を作成するADFアプリケーションの名前。
wsConnName 
新しいWebサービス接続の名前。
wsdlUrlStr 
サービスWSDL URL文字列の名前。
readerProps  
オプションの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')

listWebServiceConnection

WLST使用: オンライン。

説明

ADFアプリケーションに関連付けられているWebサービス接続をリストします。

構文

listWebServiceConnection(appName)
引数 定義
appName 
Webサービス接続をリストするADFアプリケーションの名前。

この例では、アプリケーションmyappのWebサービス接続をリストする方法を示します。

listWebServiceConnection('myapp')

deleteWebServiceConnection

WLST使用: オンライン。

説明

ADFアプリケーションに関連付けられているWebサービス接続の削除に使用します。

構文

listWebServiceConnection(appName, weConnName)
引数 定義
appName 
Webサービス接続を削除するADFアプリケーションの名前。
wsConnName 
削除するWebサービス接続の名前。

この例では、アプリケーションmyappからWebサービス接続mywsconnを削除する方法を示します。

deleteWebServiceConnection('myapp','mywsconn')

listUpgradeHandlers

WLST使用: オンライン。

説明

アプリケーションのすべてのアップグレード・ハンドラをリストするために使用されます。

構文

listUpgradeHandlers(applicationName)
引数 定義
applicationName
アップグレード・ハンドラをリストする対象のアプリケーション名。

次の例では、MyAppアップグレード・ハンドラがリストされます。

wls:/DefaultDomain/serverConfig>listUpgradeHandlers('MyApp')

upgradeADFMetadataApp

WLST使用: オンライン。

説明

アプリケーションのすべての登録済ADFメタデータをアップグレードするために使用されます。

構文

upgradeADFMetadataApp(applicationName,siteCC)
引数 定義
applicationName
ハンドラをアップグレードする対象のアプリケーション名。
siteCC
サイト・カスタマイゼーション・クラス名。

次の例では、アプリケーションのすべての登録済ADFメタデータがアップグレードされます。

wls:/DefaultDomain/serverConfig>upgradeADFMetadataApp('MyApp','oracle.apps.fnd.applcore.customization.SiteCC')

upgradeADFMetadataAppHandlers

WLST使用: オンライン。

説明

アプリケーションの、選択した登録済ADFメタデータをアップグレードするために使用されます。

構文

upgradeADFMetadataAppHandlers(applicationName,sitecc,handlers)
引数 定義
applicationName
ハンドラをアップグレードする対象のアプリケーション名。
siteCC
サイト・カスタマイゼーション・クラス名。
handlers
更新する登録済ハンドラ。

次の例では、アプリケーションの、選択した登録済ADFメタデータがアップグレードされます。

wls:/DefaultDomain/serverConfig>upgradeADFMetadataAppHandlers('MyApp','oracle.apps.fnd.applcore.customization.SiteCC','http://xmlns.oracle.com/adf/metadataUpgrade/bc4j/propertiesUpgrade')

upgradeADFMetadata

WLST使用: オンライン。

説明

すべてのアプリケーションのすべての登録済ADFメタデータをアップグレードするために使用されます。

構文

upgradeADFMetadata(siteCC)
引数 定義
siteCC
サイト・カスタマイゼーション・クラス名。

次の例では、すべてのアプリケーションのすべての登録済ADFメタデータがアップグレードされます。

wls:/DefaultDomain/serverConfig>upgradeADFMetadata('oracle.apps.fnd.applcore.customization.SiteCC')

upgradeADFMetadataHandlers

WLST使用: オンライン。

説明

すべてのアプリケーションの、選択した登録済ADFメタデータをアップグレードするために使用されます。

構文

upgradeADFMetadataHandlers(sitecc,handlers)
引数 定義
siteCC
サイト・カスタマイゼーション・クラス名。
handlers
更新する登録済ハンドラ。

次の例では、すべてのアプリケーションの、選択した登録済ADFメタデータがアップグレードされます。

wls:/DefaultDomain/serverConfig>upgradeADFMetadataHandlers('oracle.apps.fnd.applcore.customization.SiteCC','http://xmlns.oracle.com/adf/metadataUpgrade/bc4j/propertiesUpgrade')

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>