uCosminexus Portal Framework ポートレット開発ガイド
クライアントサイドデータ通信を実現する際には,データの保管場所として,userData領域とポータルクリップボードウィンドウを使用できます。
- <この項の構成>
- (1) データ保管領域の設定
- (2) userData領域
- (3) ポータルクリップボードウィンドウ
データ保管領域の設定は,PortalResources.propertiesファイルで行います。
クライアントサイドデータ通信機能では,次に示す方式でデータを格納できます。
- userData領域とポータルクリップボードウィンドウを併用する方式
- ポータルクリップボードウィンドウだけを使用する方式
データ格納方式は,PortalResources.propertiesファイルのjp.co.hitachi.soft.portal.csdc.datatype.userData項目で指定します。PortalResources.propertiesファイルの詳細は,マニュアル「uCosminexus Portal Framework システム管理者ガイド」を参照してください。
データの保管場所としてuserData領域とポータルクリップボードウィンドウを併用する場合,データの保管場所にuserData領域を使用するか,またはポータルクリップボードウィンドウを使用するかは,保管するデータが転送データサイズの指定値以内かどうかで決まります。
転送データサイズは,PortalResources.propertiesファイルのjp.co.hitachi.soft.portal.csdc.datasize.threshold項目で指定します。PortalResources.propertiesファイルの詳細は,マニュアル「uCosminexus Portal Framework システム管理者ガイド」を参照してください。保管するデータが,転送データサイズの指定値以内かどうかによって次のようになります。
- 保管するデータが転送データサイズの指定値以内の場合
userData領域を使用します。
- 保管するデータが転送データサイズの指定値を超える場合
ポータルクリップボードウィンドウを使用します。
なお,HTTPS環境でクライアントサイドデータ通信機能を使用している場合,転送データサイズが指定値を超えると,セキュリティに関する警告ダイアログボックスが2回表示されます。
userData領域は,クライアントサイドデータ通信を実現する際に使用するデータの保管場所です。コピー処理では,通常userData領域をデータの保管場所として使用します。
userData領域には文字列だけ格納できます。そのため,データ格納時には,ポートレットで指定したJavaScript連想配列オブジェクトはシリアライズされ,データ取得時には,userData領域から取得した文字列はデシリアライズされます。
userData領域へのデータの格納に失敗した場合,次のようになります。
- userData領域より格納するデータが大きいとき
ポータルクリップボードウィンドウを使用して,データ転送をします。
- 上記以外のとき(環境不正など)
警告を示すダイアログボックスが表示され,データ転送をしないで終了します。
ポータルクリップボードウィンドウは,HTML上で開かれる一般のウィンドウで,データを保管する場所としての機能だけを持ちます。
ポータルクリップボードウィンドウは,csdc.jsをインクルードするタイミングで開かれます。そのため,ポートレット開発者は,ポータルクリップボードウィンドウを開いたり閉じたりする処理を意識する必要はありません。
ポータルクリップボードウィンドウは,コピーしたデータを貼り付けるまで開かれている必要があります。エンドユーザの操作向上およびエンドユーザによって閉じられることを抑止するため,ポータルクリップボードウィンドウは,Window画面の表示領域外に表示されます(エンドユーザには見えないウィンドウとして表示します)。なお,ポータルクリップボードウィンドウが表示されていない状態でデータ転送をした場合には,再操作を促すダイアログボックスが表示されます。
ポータルクリップボードウィンドウが表示されている間,タスクバーには次のように表示されます。
図9-5 ポータルクリップウィンドウが表示されている間のタスクバー
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
All Rights Reserved. Copyright (C) 2009, 2013, Hitachi INS Software, Ltd.