Oracle® Fusion Middleware

Oracle API Catalogコンセプト・ガイド

12cリリース1 (12.1.3.0)

E59447-02(原本部品番号:E55976-02)

2015年8月

Oracle API Catalogの評価または実装を行うユーザーを対象としたドキュメントです。このガイドでは、ガバナンス・インフラストラクチャ、ガバナンス対象アセット、アセット・タイプとタクソノミおよびアセット・ライフサイクルに関連する概念について説明します。

Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド 12cリリース1 (12.1.3.0)

E59447-02

Copyright © 2014, 2015, Oracle and/or its affiliates.All rights reserved.

原本著者: Oracle Corporation

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りがないことの保証はいたしかねます。誤りを見つけた場合は、Oracle社までご連絡下さい。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアはさまざまな情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc. の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc. の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 Oracle API Catalogについて

- 1.1 Oracle API Catalogの概要

- 1.2 Oracle API Catalogの機能の理解

- 1.2.1 サービスの収集

- 1.2.2 APIアセットへのメタデータの追加

- 1.2.3 APIアセットの公開

- 1.2.4 APIアセットの検出、理解および使用

- 1.3 Oracle API Catalogのユーザー・ロールの理解

- 1.4 次のステップ

2 Oracle API Catalogのスタート・ガイド

- 2.1 Oracle API Catalogのインストール

- 2.2 Oracle API Catalogの構成

- 2.3 Oracle API Catalogの使用

はじめに

『Oracle Fusion Middleware Oracle API Catalogコンセプト・ガイド』では、Oracle API Catalogの使用に関連する概念を説明します。

対象読者

このドキュメントは、Oracle API Catalogを導入するお客様または導入に興味があるお客様を対象としています。

ドキュメントのアクセシビリティについて

オラクル社のアクセシビリティへの取組みの詳細は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docaccを参照してください。

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細は、http://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoまたはhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs (聴覚障害者向け)を参照してください。

関連ドキュメント

詳細は、Oracle API Catalog 12cドキュメンテーション・セットの次のドキュメントを参照してください。

- 『Oracle Fusion Middleware Oracle API Catalogインストレーション・ガイド』

- 『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』

- 『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 Oracle API Catalogについて

この章では、Oracle API Catalog (OAC)の概要を示し、OACの使用に関する基本概念について説明します。

この章は次の項で構成されています。

- 第1.1項「Oracle API Catalogの概要」

- 第1.2項「Oracle API Catalogの機能の理解」

- 第1.3項「Oracle API Catalogのユーザー・ロールの理解」

- 第1.4項「次のステップ」

1.1 Oracle API Catalogの概要

開発の際に、企業のシステム・オブ・レコード(SoR)に加えて、アプリケーション・プログラミング・インタフェース(API)を使用するモバイル・アプリケーションが増えています。使用可能なAPIの数は日に日に増加しています。これらの使用が、モバイル・デバイスおよびコンピューティング・プラットフォーム(Web、タブレット、スマートフォン、テレビ、ビデオ・ゲーム機、自動車、およびその他の家庭用機器(モノのインターネット、Internet of Things))の数の増加につれて拡大しています。組織によって作成および使用されるAPIの数が増加しているため、これらのAPIの管理と可視化の重要性が高まっています。

Oracle API Catalog (OAC)を使用すると、組織がAPIのカタログを容易に作成して、アプリケーション開発のためにAPIを可視化できます。OACには、APIアセットの単純なメタモデルやOACへのデータ入力の自動化機能が含まれます。また、ユーザーがOACでAPIを検索し、APIの詳細を把握して自分のアプリケーションにAPIが適しているかどうかを評価することもできます。

1.2 Oracle API Catalogの機能の理解

この項では、Oracle API Catalogに含まれる機能の概要を説明します。この項には次のトピックが含まれます:

- 第1.2.1項「サービスの収集」

- 第1.2.2項「APIアセットへのメタデータの追加」

- 第1.2.3項「APIアセットの公開」

- 第1.2.4項「APIアセットの検出、理解および使用」

1.2.1 サービスの収集

OACに含まれるハーベスタを使用して、OACにAPIアセットを作成します。推奨されるベスト・プラクティスは、構築時にプロジェクトを収集することです。ハーベスタが、デプロイ済のサービスを調査して、プロジェクトで検出されたSOAサービスおよびService Busプロキシ(WSDLベースWebサービスとWADLベースRESTサービスの両方)を表すAPIアセットを作成します。

作成されたアセットがOracle API Catalogに収集されます。

OACでのサービス収集方法の詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』の自動収集の構成と使用に関する項を参照してください。

1.2.2 APIアセットへのメタデータの追加

APIアセットがハーベスタによって作成されると、キュレータが単純なエディタを使用してAPIアセットを編集し、APIの検出と理解に役立つメタデータを追加します。キュレータは、Oracle API Catalogに収集されたAPIアセットについて、名前の変更、説明の追加、キーワードのタグ付け、およびドキュメント参照の追加を行うことができます。このメタデータによって、開発者による各APIアセットの検出と理解が容易になります。

詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のOracle API CatalogでのAPIアセットのメタデータの編集に関する項を参照してください。

1.2.3 APIアセットの公開

APIメタデータを編集したら、キュレータはAPIを公開して、OACで開発者が表示できるようにします。

詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のAPIアセットの公開に関する項を参照してください。

1.2.4 APIアセットの検出、理解および使用

公開されたアセットは、Oracle API CatalogコンソールやOracle JDeveloper Oracle Enterprise Repositoryプラグインで使用できるようになります。開発者はOACを検索して、使用するAPIを検出できます。キュレータが提供したメタデータを表示して、APIの詳細を確認できます。

開発者は、使用できそうなAPIを見つけたら、そのAPIを自分のMy APIページに追加できます。My APIで、開発者はAPIの評価とレビューを行うことができます。これらの評価とレビューは他のOACユーザーが表示できます。

APIアセットの検出、理解および使用の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』を参照してください。

1.3 「Oracle API Catalogのユーザー・ロールの理解」

各OACユーザーにはロールが割り当てられます。このロールによって、各ユーザーが使用できるOACの機能とコンテンツが決定されます。OACには3つのロールが事前定義されています。

注意:
Oracle API Catalogには追加のロールを作成する機能はありません。

- 開発者: 開発者ロールのユーザーは、OACコンソールまたはOracle Enterprise Repository JDeveloperプラグインを使用して、OAC内の公開済APIを検索できます。開発者はAPIをよく理解するためにAPIメタデータを調べることができます。また、開発者はAPIに対する関心を宣言したり、APIの評価とレビューを送ったりすることができます。
開発者としてOracle API Catalogを使用する方法の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』を参照してください。

- キュレータ: APIアセットが作成されたら、キュレータはそれらを編集してメタデータを更新します。また、キュレータは、開発者が検出できるようにAPIを公開することもできます。
キュレータ・ロールを持つユーザーが実行できるライフサイクル・タスクの詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のアセットのライフサイクル管理タスクに関する項を参照してください。

- 管理者: 管理者ロールのユーザーはキュレータ・ロールと開発者ロールの機能に加え、アセットをOACに収集できます。また、このロールを持つユーザーはOACの管理者ページにアクセスできます。このページでは、このロールを持つユーザーが、システム設定の編集、新規ユーザーの作成、新規部署の作成、セッションの管理およびインポート/エクスポート・ツールの使用によって、OACのインフラストラクチャを管理できます。このロールを持つユーザーは、OACに含まれるセキュリティ機能も構成できます。
管理者ロールを持つユーザーが実行できるインフラストラクチャ管理タスクの詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のインフラストラクチャ管理タスクに関する項を参照してください。

管理者ロールを持つユーザーが実行できるセキュリティ構成タスクの詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のセキュリティ管理タスクに関する項を参照してください。

1.4 次のステップ

第2章「Oracle API Catalogのスタート・ガイド」を参照して、Oracle API Catalogの使用を開始します。

2 Oracle API Catalogのスタート・ガイド

この章では、Oracle API Catalogのインストール、構成および使用方法について説明します。

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

- Oracle API Catalogのインストール

- Oracle API Catalogの構成

- Oracle API Catalogの使用

2.1 Oracle API Catalogのインストール

まず、Oracle API Catalogをインストールし、OACをOracle Databaseインスタンスに接続し、OACをOracle WebLogic Serverインスタンスにデプロイします。

Oracle API Catalogのインストールの詳細は、『Oracle Fusion Middleware Oracle API Catalogインストレーション・ガイド』を参照してください。

2.2 Oracle API Catalogの構成

Oracle API Catalogがインストールされて稼働したら、管理者はOACインフラストラクチャやハーベスタを構成し、その他の管理アクティビティ(ユーザーや部署の作成など)を実行できます。

Oracle API Catalogの詳細は、『Oracle Fusion Middleware Oracle Enterprise Repository管理者ガイド』のインフラストラクチャ管理タスクに関する項を参照してください。

2.3 Oracle API Catalogの使用

OACのインストールと構成が済むと、キュレータがAPIアセットを収集し、アセットのメタデータを編集し、開発者が検出できるようにAPIをOACに公開します。

APIの収集と公開の詳細は、『Oracle Fusion Middleware Oracle API Catalog管理者ガイド』のアセットのライフサイクル管理タスクに関する項を参照してください。

その後、開発者がアプリケーションで使用するAPIをOACで検索します。各APIを評価して、フィードバックをキュレータやOACを使用する他の開発者に提供します。

APIアセットを検索してアプリケーションに組み込む方法の詳細は、『Oracle Fusion Middleware Oracle API Catalog開発者ガイド』を参照してください。

オラクル社の法律上の注意点について

コピーライトについて

Copyright © 1994-2015, Oracle and/or its affiliates.All rights reserved.

商標と登録商標について

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

制限付権利

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション（人的傷害を発生させる可能性があるアプリケーションを含む）への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性（redundancy）、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。オラクル社およびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

ドラフトのアルファ版およびベータ版ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。オラクル社およびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。