カスタム開発環境の作成

警告: サンプル アダプタを直接変更しないでください。変更する場合は、この章で説明する GenerateAdapterTemplate ユーティリティを使用して、アダプタのコピーを作成し、そのコピーに必要な変更を加えます。サンプル アダプタそのものを変更すると（あるいは GenerateAdapterTemplate を使用せずにコピーを作成すると）、予期しない、あるいはサポートされない動作を起こすことがあります。

サンプル アダプタ（サンプル アダプタを参照）を使いやすくするため、ADK には GenerateAdapterTemplate というコマンドライン ユーティリティが用意されています。このユーティリティを使用して、サンプル ツリーを複製し、新しいアダプタ開発ツリーを作成できます。

この章の内容は以下のとおりです。

• アダプタ設定ワークシート

• GenerateAdapterTemplate の使い方

 

---

アダプタ設定ワークシート

アダプタ設定ワークシートは、開発対象のアダプタに関する重要なデータを特定して、収集するための質問表のようなものです。実際のワークシートの内容は、アダプタ設定ワークシートに記載されています。

このワークシートは、EIS タイプ、ベンダ、バージョン、デプロイメントのロケールおよび地域言語、アダプタ論理名、アダプタがサービスをサポートするかどうか、といったアダプタの重要情報を確認する 20 の質問で構成されています。GenerateAdapterTemplate を実行すると、これらの情報を入力するように要求されます。入力した情報が処理されると、アダプタのカスタム開発ツリーが作成されます。

 

---

GenerateAdapterTemplate の使い方

この節では、GenerateAdapterTemplate の使用方法について説明します。必要な手順は次のとおりです。

• 手順 1. GenerateAdapterTemplate の実行

• 手順 2. ツリーの再構築

• 手順 3. アダプタの WebLogic Integration へのデプロイ

手順 1. GenerateAdapterTemplate の実行

このツールを使用する手順は次のとおりです。

1. WLI_HOME/adapters/utils ディレクトリからコマンドラインを開き、以下のいずれかのコマンドを実行します。

   • Windows NT の場合 : GenerateAdapterTemplate.cmd

   • UNIX の場合 : GenerateAdapterTemplate.sh

   システムから次のように応答があります。

   WLI_HOME/adapters/utils>generateadaptertemplate

   ***************************************************************

   Welcome! This program helps you generate a new adapter
   development tree by cloning the ADK's sample adapter development
   tree.

   Do you wish to continue? (yes or no); default='yes':

2. 〔Enter〕を押して [yes] を選択します。

   システムから次のように応答があります。

   Please choose a name for the root directory of your adapter development tree:

3. ユニークな覚えやすいディレクトリ名（dir_name）を入力し、〔Enter〕を押します。

   システムから次のように応答があります。

   created directory WLI_HOME/adapters/dir_name

   Enter the EIS type for your adapter:

   システム出力で指定したパス名で、dir_name は新しいディレクトリの名前です。

   注意: 既存のディレクトリ名を入力した場合、システムの応答は次のようになります。
   
   WLI_HOME/adapters/dir_name already exists, please choose
   a new directory that does not already exist!
   
   Please choose a name for the root directory of your adapter
   development tree:

4. アダプタを接続する EIS タイプの識別子を入力します。〔Enter〕を押します。

   システムから次のように応答があります。

   Enter a short description for your adapter:

5. 開発対象のアダプタの説明を簡潔に入力し、〔Enter〕を押します。

   システムから次のように応答があります。

   Enter the major version number for your adapter; default='1':

6. 〔Enter〕を押してデフォルトをそのまま使用するか、適切なバージョン番号を入力し、〔Enter〕を押します。

   システムから次のように応答があります。

   Enter the minor version number for your adapter; default='0':

7. 〔Enter〕を押してデフォルトをそのまま使用するか、適切なマイナー バージョン番号を入力し、〔Enter〕を押します。

   システムから次のように応答があります。

   Enter the vendor name for your adapter: 

8. ベンダ名を入力し、〔Enter〕を押します。

   システムから次のように応答があります。

   Enter an adapter logical name; default='default_name':

9. 〔Enter〕を押してデフォルトをそのまま使用するか、または使用したいアダプタ論理名を入力します。〔Enter〕を押します。このデフォルトのアダプタ論理名（「default_name」）は、WebLogic Integration で推奨されるフォーマットに従っています。
   vendor name_EIS-type_version-number.

   システムから次のように応答があります。

   Enter the Java package base name for your adapter 
   (e.g. sample adapter's is sample): Java パッケージ基本名

10. パッケージ形式に従って Java パッケージの基本名を入力し、〔Enter〕を押します。パッケージ形式の名前は、ドット区切りで、以下の文字列で構成されます。

    • 組織の Web サイトの URL で使用される拡張子（.com、.org または .edu など）。

    • 会社名。

    • 追加のアダプタ識別子。たとえば、com.your_co.adapter.EISのようになります。

    システムから次のように応答があります。

    The following information will be used to generate your new
    adapter development environment:
    EIS Type = 'SAP R/3'
    Description = 'description'
    Major Version = '1'
    Minor Version = '0'
    Vendor = 'vendor_name'
    Adapter Logical Name = 'adapter_logical_name'
    Java Package Base = 'com.java.package.base'
    Are you satisfied with these values? (enter yes or no or q to quit);
    default='yes':

11. データを確認し、問題がなければ〔Enter〕を押します。

    登録したビルド情報を表示することによって、システム応答します。

    注意: no と入力すると、4 に戻ります。q (終了) を入力すると、アプリケーションが終了します。

手順 1a : コンソール コード ページの指定（Windows のみ）

Windows システムの場合、以下のコード ページ リストからコンソールのコード ページの値を選択します。

437 - United States
850 - Multilingual (Latin I)
852 - Slavic (Latin II)
855 - Cyrillic (Russian)
857 - Turkish
860 - Portuguese
861 - Icelandic
863 - Canadian-French
865 - Nordic
866 - Russian
869 - Modern Greek
Enter your console's codepage; default='437':

コード ページが分からない場合は、コンソール プロンプトで tchcp と入力します。Windows のバージョンによって、このコマンドによりコンソールのコード ページの値が表示されます。

 

---

手順 2. ツリーの再構築

複製処理の終了後、新しいディレクトリに切り替え、ADK のビルド ツールである Ant を使用してツリー全体を再構築します。Ant の詳細については、Ant ベースのビルド プロセスを参照してください。

Ant を使用してツリーを再構築するには次の手順に従います。

1. WLI_HOME/adapters/ADAPTER/utils にある antEnv.cmd (Windows) または antEnv.sh (UNIX) を編集します。

2. 以下の変数を該当するパスに設定します。

   • BEA_HOME −ご使用の BEA 製品の最上位ディレクトリ。例 : c:/bea

   • WLI_HOME − WebLogic Integration ディレクトリの場所。

   • JAVA_HOME − Java Development Kit の場所。

   • WL_HOME − WebLogic Server ディレクトリの場所。

   • ANT_HOME − Ant ディレクトリの場所。通常、WLI_HOME/adapters/utils

   注意: この操作はインストーラによって自動的に行われますが、これらの設定にもとづいて Ant 処理が実行されることを認識しておいてください。
   
   UNIX システムの場合、WLI_HOME/adapters/utils の Ant ファイルに対し、すべての実行パーミッションを設定する必要があります。実行パーミッションを追加するには、以下のコマンドを入力します。
   chmod u+x ant.sh

3. コマンドラインから antEnv を実行し、シェルに必要な環境変数を設定します。

4. WLI_HOME/adapters/ADAPTER/project ディレクトリから ant release を実行して、アダプタを構築します。（ADAPTER を新しいアダプタの開発ルート名と変える。）

   ant release を実行すると、アダプタ用の Javadoc が生成されます。この Javadoc は、次の場所で表示できます。

   WLI_HOME/adapters/ADAPTER/docs/

   このファイルには、構築したアダプタを WebLogic Integration 環境でデプロイする場合の、それぞれの環境に即した指示が記載されています。具体的には、config.xml エントリと、既存パスの置換値が定義されます。さらに、このファイルでは、マッピング情報も定義されています。

   手順 3. アダプタの WebLogic Integration へのデプロイで説明するように、アダプタを簡単にデプロイするために、overview.html の内容を直接 config.xml にコピーします。

手順 3. アダプタの WebLogic Integration へのデプロイ

アダプタのデプロイは、手動でも WebLogic Server Administration Console からでも実行できます。詳細については、アダプタのデプロイを参照してください。