| OracleR WebCenter Content Content Server開発者ガイド 11gリリース1(11.1.1) B66702-01 |
|
 前へ |
 次 |
ホーム > Content Server開発者ガイド > 統合のためのCOM APIの使用
| OracleR WebCenter Content Content Server開発者ガイド 11gリリース1(11.1.1) B66702-01 |
|
前へ |
次 |
ホーム > Content Server開発者ガイド > 統合のためのCOM APIの使用
この章では、Microsoft Component Object Model (COM)統合について説明します。Oracle WebCenter Content Serverは、COM環境内から機能をコールする機能を提供する、COMベースのAPIを使用します。
この章では、次の項目について説明します。
COMインタフェースを使用して、コンテンツ管理をMicrosoft環境およびアプリケーションと統合できます。コンテンツ・サーバー内のコンテンツおよびコンテンツ管理機能にアクセスするためのインタフェース・オプションとして、ActiveXコントロールおよびOCXコンポーネントが提供されています。さらに、COMインタフェースを通じてODMA対応アプリケーションと通信できます。
リモートのOracle WebCenter Content Serverインスタンスに接続し、コンテンツ・サーバー・サービスを実行するために、Object Linking and Embedding Control Extension (OCX)コントロールが提供されています。IdcClient OCXコントロールは、コンテンツ・サーバー内のコンテンツおよびコンテンツ管理機能にアクセスするために、Windows Visual Basic開発環境内で使用されます。
IdcClient OCXコントロールを使用してコンテンツ・サーバー・サービスをコールすることができます。IdcClient.ocxコントロールは、リモートのOracle WebCenter Content Serverインスタンスに接続し、標準的なサーバー機能を実行するために使用されます。
|
注意: IdcClient OCXコンポーネントを使用するには、Visual BasicまたはVisual C++開発環境が必要です。 |
IntradocClient OCXコンポーネントは、コンテンツ・サーバー内のコンテンツおよびコンテンツ管理機能にアクセスするために、Windows Visual Basic開発環境内で使用されます。OCX統合は、ビジュアル開発環境でサービスをコールするように、またはリモートのOracle WebCenter Content Serverインスタンスに接続するように設計されています。
IntradocClient OCXコンポーネントは、メソッド・コールを使用してアクセス可能な機能を提供します。メソッドはアクションを実行し、多くの場合、結果を返します。情報は、パラメータを使用してメソッドに渡されます。関数には、パラメータをとらないもの、パラメータを1つとるもの、複数のパラメータをとるものがあります。
IntradocClient OCXコンポーネントでは、コマンドの実行にユーザー名とパスワードが必要です。ユーザーには、コマンドを実行するための適切な権限が必要です。管理者アクセス・レベルを必要とするコマンドもあれば、書込み権限のみを必要とするコマンドもあります。
initおよびconnection管理メソッドを除き、すべてのメソッドは、通信のために、シリアル化されたHDAフォーマットを使用します。返された、シリアル化されたHDAフォーマットの文字列には、コマンドの成否に関する情報が含まれています。障害が発生した場合、StatusCodeは負の値になり、StatusMessageにエラーが示されます。
詳細は、Oracle WebCenter Contentサービス・リファレンス・ガイドを参照してください。このガイドには、IntradocClient OCX API仕様に関する情報も含まれており、プロパティ、メソッドおよびイベントの説明が記載されています。
IdcClientは、サービスの実行やファイル・パス情報の取得などのアクションをプログラムで実行できるようにするActiveXコントロールです。IdcClientコントロールは、Microsoft Internet Explorerブラウザのラッパーでもあります。
IdcClient OCXコントロールは、Unicode規格を使用するように設計されており、ほとんどの場合、UTF-8形式でOracle WebCenter Content Serverとデータを交換します。Unicodeは、1文字当たり2バイト(16ビット)のストレージを使用し、様々な言語(英語、日本語、アラビア語など)で使用される文字を表すことができます。英語のASCII(情報交換用米国標準コード)文字は1バイト(8ビット)しか必要としないため、ASCII文字では、各Unicode文字の上位バイトがゼロで表されます。
Unicode規格の詳細は、WebでUnicode Consortium(http://www.unicode.org)を参照してください。
|
重要: IdcClient OCXは、Microsoft Layer for Unicodeの上に構築されており、Microsoft Layer for Unicodeによって、UnicodeアプリケーションをWin9xプラットフォームで実行することが可能になります。9xプラットフォーム上でIdcClient OCXコントロールを配布するときは、unicows.dllも配布する必要があります。このコンパニオンDLLは、Windowsベースのシステム上には配布できません。 |
ほとんどの場合、メソッドは、通信のために、シリアル化されたHDAフォーマットを使用します。シリアル化されたHDAフォーマットは、通信のために使用されるJavaメソッドです。返された、シリアル化されたHDAフォーマットの文字列には、コマンドの成否に関する情報が含まれています。
IdcClient OCXコントロールは、メソッド・コールを使用して実行可能な機能を提供します。メソッドはアクションを実行し、多くの場合、結果を返します。情報は、パラメータを使用してメソッドに渡されます。関数には、パラメータをとらないもの、パラメータを1つとるもの、複数のパラメータをとるものがあります。たとえば、文字列として渡される2つのパラメータを持つ関数は、次のフォーマットを使用します。
Function(Parameter As String, Parameter As String) As String
ユーザーは、IdcClient OCXを使用して、サービスを実行するクライアント・アプリケーションを作成できます。OCXコントロールは、コマンドおよびパラメータを含む名前/値のペアを取得し、指定されたサービスをコールします。実行結果は、コール側プログラムに渡されます。
IdcClient OCXでは、コマンドの実行にユーザー名とパスワードが必要です。ユーザーには、コマンドを実行するための適切な権限が必要です。管理者アクセス・レベルを必要とするコマンドもあれば、書込み権限のみを必要とするコマンドもあります。
詳細は、Oracle WebCenter Contentサービス・リファレンス・ガイドを参照してください。
イベントは、ユーザーまたはサーバーがアクションを実行すると実行されます。次に例を示します。
IntradocBrowserPostイベントは、ユーザーがフォームをブラウザ内から送信するたびに実行されます。
IntradocServerResponseイベントは、サーバーがリクエストされたアクションを完了すると実行されます。
Visual Basic標準コントロールは、すべてのVisual Basic開発環境に共通のメソッドを提供します。また、IdcClient OCXコントロールは、この特定のコントロールに固有のプライベート・メソッドを提供します。これらのメソッドは、特性の設定ではなく、アクションの実行または開始に使用されます。
次に例を示します。
AboutBox()メソッドは、製品のバージョン情報を示す「バージョン情報」ボックスを起動します。
GoCheckinPageメソッドは、新しいコンテンツ・アイテムまたはコンテンツ・アイテムのリビジョンをチェックインします。
プロパティは、オブジェクトを記述またはフォーマットし、コードによって、またはVisual Basic開発環境でプロパティ・ウィンドウを使用して変更できます。プロパティは、オブジェクトの基本的な特性を記述します。
次に例を示します。
UserNameプロパティは、割り当てられたユーザー名を指定します。
WorkingDirプロパティは、ダウンロードされたファイルが格納される場所を指定します。
IdcClient OCXコントロールは、コンテンツ・サーバー内のコンテンツおよびコンテンツ管理機能にアクセスするために、Windows Visual Basic開発環境内で使用されます。OCX統合は、ビジュアル開発環境でサービスをコールするように、またはリモートのコンテンツ・サーバー・インスタンスに接続するように設計されています。
ほとんどの場合、メソッドは、通信のために、シリアル化されたHDAフォーマットを使用します。返された、シリアル化されたHDAフォーマットの文字列には、コマンドの成否に関する情報が含まれています。障害が発生した場合、StatusCodeは負の値になり、StatusMessageにエラーが示されます。返されたHDAにStatusCodeパラメータが含まれていない場合、サービス・コールが成功したことを示しています。
Microsoft Visual Basic開発環境で、IdcClient OCXコンポーネントを設定し、ビジュアル・インタフェースを作成できます。
Microsoft Visual Basic開発環境で、IdcClient OCXコンポーネントを設定するには、次の手順を実行します。
新規プロジェクトを作成します。
「プロジェクト」を選択し、「コンポーネント」を選択します。
システムでIdcClient.ocxファイルを参照し、「開く」をクリックします。
IdcClientモジュールがコンポーネント・コントロール・リストに追加されます。
IdcClient ActiveX Controlモジュールのチェック・ボックスが選択されていることを確認し、「OK」をクリックします。
IdcClient OCXコントロールが、コントロールのリストに入ります。
(オプション) Visual Basic開発環境を使用してユーザー独自のビジュアル・インタフェースを構築できます。または、第22.2.3.2項「ビジュアル・インタフェースの作成」に記載されている手順に従って基本的なビジュアル・インタフェースを構築できます。
ビジュアル・インタフェースを作成するための次の手順は、Visual Basicプロジェクトが作成されており、IdcClient OCXコントロールがコントロールのリストに入っていることを前提としています。詳細は、第22.2.3.1項「IdcClient OCXコンポーネントの設定」を参照してください。
基本的なビジュアル・インタフェースを構築するには、次の手順を実行します。
コントロールを選択し、それをVisual Basicフォーム上に描画します。
図22-1は、IdcClient OCXコントロールを示しています。
「プロパティ」ウィンドウのドロップダウン・リストから、IdcClient OCXを選択します。
「プロパティ」ウィンドウが表示されていない場合は、メイン・メニューから「表示」→プロパティ・ウィンドウを選択します。
IdcClient OCXコントロールの名前をIdcClientCtrlに変更します。
特定のインスタンスのiss_idc_cgi.dllを参照するようにHostCgiUrlを定義します。
次に例を示します。
http://testserver/intradoc-cgi/iss_idc_cgi.dll
図22-2では、HostCgiUrlの値としてこのURLが示されています。
フォームで、テキスト・ボックスを描画し、CgiUrlという名前を付けます。
「テキスト」フィールドに、表示されるテキストとしてHostCgiUrlの値(http://testserver/intradoc-cgi/iss_idc_cgi.dllなど)を入力します。
図22-3では、「テキスト」の値としてこのURLが示されています。
フォームで、テキスト・ボックスを描画し、コマンドという名前を付けます。
「テキスト」フィールドのエントリを消去(空白のままに)し、MultiLineをTrueに設定します。
図22-4では、MultiLineの値を示しています。
フォームで、テキスト・ボックスを描画し、レスポンスという名前を付けます。
「テキスト」フィールドのエントリを消去(空白のままに)します。
図22-5は、レスポンス・テキスト・ボックスのフィールド値を示しています。
フォームで、ボタンを描画し、SendPostCommandという名前を付けます。
「キャプション」フィールドに、表示されるテキストとして「Postコマンドの送信」と入力します。
図22-6は、SendPostCommandボタンに表示される「キャプション」の値を示しています。
フォームで、「表示」→コードを選択します。
ドロップダウン・リストから「SendPostCommand」→クリックを選択して、次のアクションを実行するようにコードを変更します。
Host Cgi URLの値を設定する。
コマンドを発行する。
(オプション) LFをCRLFに置換して、編集コントロールでの表示が読みやすくなるようにする。
レスポンスを表示する。
次のようにコードを変更します。
Dim R As String IdcClientCtrl.HostCgiUrl = CgiUrl.Text R = IdcClientCtrl.1.SendPostCommand(Command.Text) R = Replace(R, vbLf, vbCrLf Response.Text = R
図22-7は、コードの変更内容を示しています。
ドロップダウン・リストから「フォーム」→「ロード」を選択し、次の行を追加してOracle WebCenter Content Serverインスタンスのログイン・プロンプトを設定します。
IdcClientCtrl.UseBrowserLoginPrompt = True IdcClientCtrl.UseProgressDialog = True
図22-8は、変更後のコードを示しています。
(オプション) Cgi Url、「コマンド」、「レスポンス」など、適切な説明ラベルを追加します。
図22-9は、説明ラベルのあるフォームを示しています。
「実行」→「起動」を選択して、ビジュアル・インタフェースをテストします。
図22-10は、テストが成功した場合の結果を示しています。
「コマンド」フィールドに、書式設定済のコマンドを入力します。
図22-11は、ユーザーを追加するADD_USERコマンドを示しています。
ADD_USERサービスの詳細は、Oracle WebCenter Contentサービス・リファレンス・ガイドを参照してください。
「Postコマンドの送信」ボタンをクリックして、コマンドを実行します。返された結果が「レスポンス」フィールドに表示されます。
図22-12は、返された結果の一部を示しています。
Webブラウザで、Oracle WebCenter Content Serverに管理者としてログインします。
「管理」トレイで、「管理アプレット」を選択します。
「ユーザー管理」をクリックします。アプレットが起動し、追加されたユーザー(user99など)が表示されます。
イベントは、ユーザーまたはサーバーがアクションを実行すると実行されます。次のIdcClient OCXイベントを使用できます。
ファイルのダウンロード前に実行されます。
ダウンロード前に必要なサーバーのアクションおよび更新を開始します。
パラメータ
このイベントは、次のパラメータを渡します。
ByVal params As String
cancelDownload As Boolean
フォームがブラウザ内から送信されるたびに実行されます。
パラメータ
このイベントは、次のパラメータを渡します。
ByVal url As String
ByVal params As String
cancelPost As Boolean
ブラウザの状態が変わるたびに実行されます。
パラメータ
このイベントは、次のパラメータを渡します。
ByVal browserStateItem As String
ByVal enabled As Boolean
サーバーからの進行状況レポートの送信リクエストを実行します。このイベントが発生するのは、メソッドのコール後のみです。
パラメータ
このイベントは、次のパラメータを渡します。
ByVal statusData As String
ByVal isDone As Boolean
次のIdcClient OCXメソッドを使用できます。
アスタリスク(*)が付けられたメソッドは、ブラウザ・アクティビティとは関係なく、値を返すメソッドです。
|
重要: 特に示されていないかぎり、すべてのパラメータは必須です。 |
Sub AboutBox()
説明
製品のバージョン情報を示す「バージョン情報」ボックスを起動します。
このメソッドは、製品の「バージョン情報」ボックスを表示します。
コールを実行できない場合、メソッドは、FALSEを返します。
パラメータ
なし
Sub Back()
説明
前のHTMLページを表示します。
前の画面に戻ります。
このメソッドは、ユーザーに表示する、前のHTMLページをキャッシュされた情報から取得します。
パラメータ
なし
Function CancelRequest() As Boolean
説明
このメソッドは、現在アクティブなリクエストを取り消します。リクエストを取り消すことができない場合、または現在アクティブなリクエストがない場合は、FALSEを返します。
パラメータ
なし
出力
次のブール値を返します。
リクエストが取り消された場合は、TRUEを返します。
取消しリクエストを実行できない場合は、FALSEを返します。
Sub DoCheckoutLatestRev(docName As String, curID As String)
説明
コンテンツ・アイテムの最新のリビジョンをチェックアウトまたはロックします。
コンテンツ・アイテム名およびバージョン・ラベルが指定されると、このメソッドは、コンテンツ・アイテムの最新のリビジョンをチェックアウトします。
IntradocServerResponseイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
|
注意: curID値は、コンテンツ・アイテムのバージョン・ラベルです。生成されたコンテンツ・アイテムのリビジョンIDではありません。 |
この関数は、次の値を返します。
dIDおよびdDocNameを含むシリアル化されたHDA。
最新のリビジョンがチェックアウトできない場合、またはシステムに見つからない場合、FALSE。
パラメータとして渡されたデータ。
パラメータ
docName: ユーザーが割り当てたコンテンツ・アイテム名。
curID: 最新のリビジョンに対する一意の識別子。オプションです。
Function DownloadFile(command As String, filename As String) As String
説明
定義されたファイルをダウンロードします。
現在関連付けられているコマンドおよびファイル・タイプが指定されると、このメソッドは、変換後のファイルのファイル・ダウンロードを実行します(DownloadNativeFileと比較)。
IntradocBeforeDownloadイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
この関数では、次のように値が返されます。
ステータス・コードおよびステータス・メソッドを含むシリアル化されたHDA。
パラメータとして渡されたデータ。
指定されたファイルをダウンロードできない場合、FALSE。
パラメータ
command: 現在関連付けられているコマンド。
filename: ファイル形式。これは、PDFやHTMなど、サポートされる形式のファイル・タイプです。
Function DownloadNativeFile(id As String, docName As String, filename As String) As String
説明
定義されたネイティブ・ファイルをダウンロードします。
コンテンツ・アイテムのリビジョンID、コンテンツ・アイテム名およびファイル・タイプが指定されると、このメソッドは、ネイティブ・ファイルのファイル・ダウンロードを実行します(DownloadFileと比較)。
IntradocBeforeDownloadイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
|
注意: id値は、生成されたコンテンツ・アイテムのリビジョンIDです。コンテンツ・アイテムのバージョン・ラベルではありません。 |
この関数では、次のように値が返されます。
dIDおよびdDocNameを含むシリアル化されたHDA。
パラメータとして渡されたデータ。
指定されたファイルをダウンロードできない場合、FALSE。
パラメータ
id: 最新のリビジョンに対する一意の識別子。
docName: ユーザーが割り当てたコンテンツ・アイテム名。
filename: ファイル形式。これは、DOCやRTFなど、サポートされる任意の形式のファイル・タイプです。
Sub Drag([nAction])
説明
ドラッグ操作を開始、終了または取り消します。
Dragメソッドは、標準コントロールの実装と同様に処理されます。
詳細は、Visual BasicのAPIリファレンスを参照してください。
パラメータ
nAction: 実行するアクションを指定します。nActionを省略すると、nActionは1に設定されます。
Dragメソッドの設定は次のとおりです。
0: ドラッグ操作を取り消し、コントロールの元の位置を復元します。
1: (デフォルト)コントロールのドラッグを開始します。
2: ドラッグを終了します。つまり、コントロールをドロップします。
Sub EditDocInfoLatestRev(docName As String, curID As String, activateAction As String)
説明
最新のリビジョンに関するコンテンツ・アイテム情報を編集します。
ODMA関連です。
コンテンツ・アイテム名、バージョン・ラベルおよび現在アクティブなリクエストされたアクションが指定されると、このメソッドは、最新のリビジョンに関するコンテンツ・アイテム情報を編集します。
最新のリビジョンに関するコンテンツ・アイテム情報を編集できない場合、またはその情報がシステムに見つからない場合、この関数はFALSEを返します。
|
注意: curID値は、コンテンツ・アイテムのバージョン・ラベルです。生成されたコンテンツ・アイテムのリビジョンIDではありません。 |
パラメータ
curID: 最新のリビジョンに対する一意の識別子。
activateAction: ODMActivateに渡されます。これは、Idocスクリプトとして使用できます。オプションです。
docName: ユーザーが割り当てたコンテンツ・アイテム名。オプションです。
Sub Forward()
説明
次のHTMLページを表示します。
次の画面に移動します。
このメソッドは、ユーザーに表示する、次のHTMLページに関するキャッシュされた情報を取得します。
パラメータ
なし
Sub GoCheckinPage(id As String, docName As String, isNew As Boolean, params As String)
説明
新しいコンテンツ・アイテムまたはコンテンツ・アイテムのリビジョンをチェックインします。
コンテンツ・アイテムのリビジョンIDおよびコンテンツ・アイテム名が指定されると、この関数は、新しいコンテンツ・アイテムまたはコンテンツ・アイテムのリビジョンをチェックインします。
このメソッドは、コンテンツ・アイテムのチェックイン・ページを開き、一意のコンテンツ・アイテム識別子、ユーザーが割り当てたコンテンツ・アイテム名および割り当てられたコンテンツ・アイテムの任意のパラメータを関連するテキスト・フィールドに入力します。また、新しいコンテンツ・アイテムなのか、リビジョンなのかも指定します。
|
注意: id値は、生成されたコンテンツ・アイテムのリビジョンIDです。コンテンツ・アイテムのバージョン・ラベルではありません。 |
出力
この関数では、次のように値が返されます。
指定されたファイルをチェックインできない場合、FALSE。
dIDおよびdDocNameを含むシリアル化されたHDA。
パラメータとして渡されたデータ。
パラメータ(すべてオプション)
id: 最新のリビジョンに対する一意の識別子。
docName: ユーザーが割り当てたコンテンツ・アイテム名。
IsNew: チェックインされるコンテンツ・アイテムが新しいコンテンツ・アイテムなのか、リビジョンなのかを定義します。
TRUEの場合、新しい一意のコンテンツ・アイテムのバージョン・ラベルが割り当てられます。
デフォルトはTRUEです。
params: 「チェックイン」ページを事前入力するパラメータ。
Sub Home()
説明
定義されたホームページに戻ります。
ホーム画面に移動します。
HTMLページ・リクエストを実行し、定義されたホームページをユーザーに表示します。
パラメータ
なし
Function InitiateFileDownload(command As String, filename As String) As String
説明
ファイル・ダウンロードを開始します。
現在関連付けられているコマンドおよびファイル・タイプが指定されると、この関数は、ファイル・ダウンロードを開始します。このメソッドは、コンテンツ・アイテムの特定のレンディション、最新のリビジョンまたは最新リリースのリビジョンのファイル・ダウンロードを開始します。
IntradocServerResponseイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
パラメータ
command: 現在関連付けられているコマンド。
filename: ファイル形式。これは、PDFやHTMなど、サポートされる形式のファイル・タイプです。
出力
リクエストされた情報を含む、シリアル化されたHDAを返します。
パラメータとして渡されたデータを返します。
Function InitiatePostCommand(postData As String) As String
説明
postコマンドを開始します。
サービス・コールを開始します。割り当てられたpostデータが指定されると、このメソッドは、postコマンドを開始します。
IntradocServerResponseイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
パラメータ
postData: サービス・コマンドおよび必要なサービス・パラメータを含む、シリアル化されたHDA。
出力
リクエストされた情報を含む、シリアル化されたHDAを返します。
StatusCodeおよびStatusMessageを返します。
障害が発生した場合、StatusCodeは負の値になり、StatusMessageにエラーが示されます。
返されたHDAにStatusCodeパラメータが含まれていない場合、サービス・コールが成功したことを示しています。
Sub Move(Left As Single, [Top], [Width], [Height])
説明
オブジェクトを移動します。
Moveメソッドは、標準コントロールの実装と同様に処理されます。
詳細は、Visual BasicのAPIリファレンスを参照してください。
パラメータ
nLeft: オブジェクトの左端の水平座標を指定します。これは、単精度値です。
nTop: オブジェクトの上端の垂直座標を指定します。これは、単精度値です。
nWidth: オブジェクトの新しい幅を指定します。これは、単精度値です。
nHeight: オブジェクトの新しい高さを指定します。これは、単精度値です。
Sub Navigate(url As String
説明
URLパスを計算します。
完全なURLが指定されると、このメソッドは、シリアル化されたHDAからURLを計算し、文字列として値を返します。
この関数は、次の値を返します。
リクエストされた情報を含む、シリアル化されたHDA。
パラメータとして渡されたデータ。
パラメータ
url: 完全なURLパス。
Sub NavigateCgiPage(params As String)
説明
CGIパスを計算します。
定義されたコンテンツ・アイテムのパラメータが指定されると、このメソッドは、シリアル化されたHDAからCGIパスを計算し、文字列として値を返します。
パラメータ
params: 割り当てられたコンテンツ・アイテムのパラメータ。
Function SendCommand(params As String) As String
説明
サービス・リクエストをOracle WebCenter Content Serverに発行します。
定義されたコンテンツ・アイテムのパラメータが指定されると、この関数は、コンテンツ・アイテムの処理に関連するOracle WebCenter Content Serverからサービスを実行します。
パラメータ
params: CGI URLエンコードのパラメータ。
出力
リクエストされた情報を含む、シリアル化されたHDAを返します。
パラメータとして渡されたデータを返します。
Function SendPostCommand(postData As String) As String
説明
postコマンドを送信します。
サービス・コールを実行します。
IntradocBrowserPostイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
パラメータ
postData: サービス・コマンドおよび必要なサービス・パラメータを含む、シリアル化されたHDA。
出力
リクエストされた情報を含む、シリアル化されたHDAを返します。
StatusCodeおよびStatusMessageを返します。
障害が発生した場合、StatusCodeは負の値になり、StatusMessageにエラーが示されます。
返されたHDAにStatusCodeパラメータが含まれていない場合、サービス・コールが成功したことを示しています。
Sub SetFocus()
説明
コントロールにフォーカスを割り当てます。
SetFocusメソッドは、標準コントロールの実装と同様に処理されます。
詳細は、Visual BasicのAPIリファレンスを参照してください。
パラメータ
なし
Sub ShowDMS()
説明
コンテンツ・マネージャに関連付けられているHTMLページを開きます。
ODMA関連です。
コンテンツ・マネージャのアクセス・ページをブラウザに表示します。
パラメータ
なし
Sub ShowDocInfoLatestRev(docName As String, curID As String, activateAction As String)
説明
最新のリビジョンに関するコンテンツ・アイテム情報を表示します。
|
注意: curID値は、コンテンツ・アイテムのバージョン・ラベルです。生成されたコンテンツ・アイテムのリビジョンIDではありません。 |
パラメータ
docName: ユーザーが割り当てたコンテンツ・アイテム名。
curID: 最新のリビジョンに対する一意の識別子。オプションです。
activateAction: 現在アクティブな、リクエストされたアクション。オプションです。
Sub ShowWhatsThis()
説明
WhatsThisHelpIDプロパティを持つオブジェクトに対して指定された「説明の表示」ヘルプ・トピックを表示します。
ShowWhatsThisメソッドは、標準コントロールの実装と同様に処理されます。
詳細は、Visual BasicのAPIリファレンスを参照してください。
パラメータ
Object: 「説明の表示」ヘルプ・トピックを表示するオブジェクトを指定します。
Sub UndoCheckout(docName As String, curID As String)
説明
このサービスは、コンテンツ・アイテムのチェックアウトを元に戻します。
コンテンツ・アイテム名およびバージョン・ラベルが指定されると、このサービスは、コンテンツ・アイテムをシステムで検索し、チェックアウトを元に戻そうとします。コンテンツ・アイテムがシステムに存在しない場合、コンテンツ・アイテムがチェックアウトされていない場合、またはチェックアウトを元に戻すのに十分な権限がユーザーにない場合、サービスは失敗します。
IntradocServerResponseイベントを実行します。イベントは、メソッドの発生前に実行されます。詳細は、第22.2.4項「IdcClientのイベント」を参照してください。
|
注意: curID値は、コンテンツ・アイテムのバージョン・ラベルです。生成されたコンテンツ・アイテムのリビジョンIDではありません。 |
パラメータ
curID: 最新のリビジョンに対する一意の識別子。
docName: ユーザーが割り当てたコンテンツ・アイテム名。オプションです。
Sub ViewDocInfo(id As String)
説明
コンテンツ・アイテム情報ページに移動し、コンテンツ・アイテム情報をブラウザに表示します。
ブラウザ操作を実行します。
コンテンツ・アイテムのリビジョンIDが指定されると、このメソッドは、コンテンツ・アイテム情報をブラウザに表示します。
|
注意: id値は、生成されたコンテンツ・アイテムのリビジョンIDです。コンテンツ・アイテムのバージョン・ラベルではありません。 |
パラメータ
id: 最新のリビジョンに対する一意の識別子。
Sub ViewDocInfoLatestRev(docName As String, curID As String)
説明
コンテンツ・アイテム情報ページに移動し、最新のリビジョンに関するコンテンツ・アイテム情報を表示します。
コンテンツ・アイテム名およびバージョン・ラベルが指定されると、このメソッドは、最新のリビジョンに関するコンテンツ・アイテム情報を表示します。
|
注意: curID値は、コンテンツ・アイテムのバージョン・ラベルです。生成されたコンテンツ・アイテムのリビジョンIDではありません。 |
この関数は、次の値を返します。
dIDおよびdDocNameを含むシリアル化されたHDA。
パラメータとして渡されたデータ。
パラメータ
docName: ユーザーが割り当てたコンテンツ・アイテム名。
curID: 最新のリビジョンに対する一意の識別子。
Sub ZOrder([Position])
説明
グラフィカル・レベル内で、指定したフォームまたはコントロールをz-orderの前または後に配置します。
ZOrderメソッドは、標準コントロールの実装と同様に処理されます。
詳細は、Visual BasicのAPIリファレンスを参照してください。
パラメータ
nOrder: 他のオブジェクトに対する相対的なオブジェクトの位置を示す整数を指定します。nOrderを省略すると、設定は0になります。
ZOrderメソッドの設定は次のとおりです。
0: (デフォルト)オブジェクトはz-orderの前に配置されます。
1: オブジェクトはz-orderの後に配置されます。
各データ・アイテムまたは属性は、Visual Basicではプロパティとして実装されます。プロパティは、Visual Basic開発環境内ではオブジェクトのパブリック・インタフェースを通じて公開されます。これらの属性を使用すると、要素をさらに詳しく記述できます。
IdcClient OCXプロパティは次のとおりです。
ユーザー指定のコンテキスト値を指定します。この値は、Oracle WebCenter Content Serverによって配信されるWebページで、変数ClientControlledとしてIdocスクリプトで使用できるようになります。
値を文字列として返します。
パラメータは取りません。
ブラウザのログイン・プロンプトを使用できるようにします。ユーザー認証のダイアログ・ボックスを表示するかどうかを定義します。
TRUEに設定すると、ユーザー認証のダイアログ・ボックスが開きます。
デフォルト値はTRUEです。
次のブール値を返します。
ログインが成功した場合は、TRUE
ログインが拒否された場合は、FALSE
ユーザー進行状況ダイアログを使用できるようにします。ユーザー認証のダイアログ・ボックスを表示するかどうかを定義します。
TRUEに設定すると、ユーザー進行状況のダイアログ・ボックスが開きます。
デフォルトはTRUEです。
次のブール値を返します。
アクションが完了した場合は、TRUEを返します。
アクションが失敗した場合は、FALSEを返します。
Open Document Management Application (ODMA)は、デスクトップ・アプリケーションとファイル管理ソフトウェアをつなぐために使用される標準的なAPIです。コンテンツ・サーバーのためのODMA統合は、別な製品であるDesktopで使用可能です。ODMA統合製品を使用して、(ODMA準拠デスクトップ・アプリケーションのために)コンテンツ・サーバー内のコンテンツおよびコンテンツ管理機能にアクセスできます。
Microsoft Word、Corel WordPerfect、Adobe FrameMakerなどの任意のODMA準拠アプリケーションからWebリポジトリに直接ファイルを公開できます。ODMAをWeb中心に導入することで、情報をWebに直接チェックインおよび公開することができます。これは、従来のODMAクライアント/サーバー実装に対する大きな進歩です。従来の実装では、情報は、まずサーバーに公開され、直ちにWebで使用できるようにはなりません。
詳細は、ODMAまたはODMA/FrameMakerのオンライン・ヘルプを参照してください。
ODMAクライアントは、別な製品であり、コア製品とともには出荷されません。これは、情報をデスクトップ・アプリケーションからWebに直接チェックインまたは公開するために使用されます。ODMAクライアントは、従来のODMAクライアント/サーバー・モデルより優れています。従来のモデルでは、情報はサーバーに公開され、直ちにWebで使用できるようにはなりません。デスクトップ・アプリケーション内からODMAクライアントを使用して、たとえば次のような、Oracle WebCenter Content Serverと対話する多数のタスクを実行できます。
ファイルを保存し、それを直ちにOracle WebCenter Content Serverにチェックインする。
ファイルを保存して、後でチェックインする。
Oracle WebCenter Content Serverからファイルをチェックアウトする。
ファイルのメタデータ(コンテンツ情報)を更新する。
ファイルをローカルのファイル・システムに保存し、ODMAクライアント・システムを迂回する。
次のODMAインタフェースを使用できます。
ODMAクライアント・インタフェース: 最近使用したファイル・オプションが選択されているドキュメントの選択画面には、ODMAを通じて最近使用されたファイルのリストが表示されます。この画面は、通常の「開く」ダイアログ・ボックスの代わりに表示されます。この画面にファイルが表示されていない場合は、コンテンツ・サーバー内かローカルのファイル・システムでファイルを検索できます。
ODMAデスクトップ・シェル・インタフェース: クライアント・デスクトップ・シェルは、ドラッグ・アンド・ドロップのチェックイン機能を提供し、デスクトップ・アプリケーションの外部からODMAクライアントのドキュメントの選択画面にアクセスできるようにします。デスクトップ・シェルを通じて、次のことを実行できます。
デスクトップまたはWindowsエクスプローラ・ウィンドウからファイルを選択し、それをデスクトップ・シェルにドラッグしてコンテンツ・サーバーにチェックインする。
最近使用したファイルのリストまたはコンテンツ・サーバーからからファイルを選択して開く。
ODMAが有効なコンテンツ・サーバー・インタフェース: コンテンツ・サーバーの「コンテンツ情報」ページからODMAファイルを直接開いてチェックアウトすることができます。コンテンツ・サーバーからファイルを開くと、ファイルを編集したり、コンテンツ・サーバーに迅速にチェックインしたりできるように、ファイルはそのネイティブのアプリケーション内で開かれます。
|
注意: ODMA準拠アプリケーション内からファイルを開いてチェックアウトすることや、ファイルをチェックアウトせずにそのコピーを開くことも可能です。詳細は、ODMAのオンライン・ヘルプを参照してください。 |
