Cosminexus V9

ナビゲーション プラットフォーム 導入から運用まで

解説・手引・文法・操作書

3020-3-V40-20

目　　次

前書き

変更内容

はじめに

第1編　概要編

1.　ナビゲーション プラットフォームの概要

1.1　ナビゲーション プラットフォームとは

1.1.1　製品の特長

1.1.2　製品体系

1.1.3　構成ソフトウェア

1.2　導入から運用までの作業の概要

1.2.1　作業の流れ

1.2.2　ナビゲーション プラットフォームの環境ごとの作業内容

2.　ナビゲーション プラットフォームの機能

2.1　業務コンテンツの利用と作成

2.1.1　業務実行画面でできること

2.1.2　業務編集画面でできること

2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL

2.1.4　基本URLに指定できるパラメタ

2.1.5　ナビゲーション プラットフォームにログインするためのIDとパスワード

2.2　外部プログラムとの連携

2.2.1　システムプラグイン

2.2.2　ユーザプラグイン

第2編　構築編

3.　ナビゲーション プラットフォームのセットアップの準備

3.1　セットアップまでの流れ

3.2　システム構成

3.2.1　システム構成の検討

3.2.2　認証サーバ導入の検討

3.2.3　システム構成例

3.3　システム構築の前提条件

3.3.1　ナビゲーション プラットフォームで使用するマシンの推奨マシンスペック

3.3.2　ナビゲーション プラットフォームで使用できるユーザ認証の種類

3.3.3　ナビゲーション プラットフォームで使用できるWebブラウザ

3.3.4　Webブラウザを操作するときの注意事項

3.4　システムの見積もり

3.4.1　データベースサーバの容量の見積もり

3.4.2　ナビゲーション プラットフォームへの同時接続数の見積もり

3.4.3　中断再開プラグインを使用する場合の容量の見積もり

3.4.4　検索機能を使用する場合の容量の見積もり

3.4.5　メモリ使用量の見積もりに関する注意事項

3.5　ナビゲーション プラットフォームのインストール

3.5.1　インストール前に確認すること

3.5.2　新規インストール手順

3.5.3　ナビゲーション プラットフォームのディレクトリ構成

3.6　ナビゲーション プラットフォームのバージョンアップ

3.6.1　バージョンアップ前に確認すること

3.6.2　バージョンアップ手順

3.6.3　バージョンアップ後に確認すること

3.6.4　バージョンアップ前に退避したプラグインの更新手順

3.7　修正パッチの適用手順

3.8　ナビゲーション プラットフォームのアンインストール

3.9　ディレクトリサーバ（Active Directory）構築の流れ

3.9.1　Active Directoryをインストールする手順

3.9.2　Active Directory用のグループを作成する手順

3.9.3　Active Directoryで管理するユーザを作成する手順

3.9.4　Active Directory用の所属グループを設定する手順

3.9.5　ナビゲーション プラットフォームのディレクトリサーバとしてActive Directoryを使用する場合の制限事項

4.　ナビゲーション プラットフォームのセットアップ

4.1　セットアップ前に確認すること

4.2　Active Directoryによるユーザ認証を利用する場合のセットアップ準備

4.3　JP1/Baseによるユーザ認証を利用する場合のセットアップ準備

4.3.1　ナビゲーション プラットフォームで使用できるJP1資源グループ

4.3.2　ナビゲーション プラットフォームで使用できるJP1権限レベル

4.3.3　JP1資源グループとJP1権限レベルの組み合わせ

4.3.4　JP1ユーザの登録手順

4.3.5　サービス起動順序の設定手順

4.4　セットアップ手順

4.5　アンセットアップ前の注意点

4.6　アンセットアップ手順

4.7　トラブルシュート情報収集先定義ファイルの設定

4.8　検索機能を使用するための追加セットアップ

4.8.1　セットアップの準備（検索機能をセットアップする場合）

4.8.2　ナビゲーション プラットフォームの停止

4.8.3　組み込みデータベースの追加設定

4.8.4　ナビゲーション プラットフォームのプロパティの追加設定

4.8.5　システム環境変数の追加設定

4.8.6　クライアント環境定義の追加設定

4.8.7　ナビゲーション プラットフォームの起動

4.8.8　データベース接続の追加設定

4.8.9　J2EEアプリケーションへの検索画面取り込み

4.8.10　検索用データの初期登録

4.9　検索機能のアンセットアップ

4.9.1　アンセットアップの準備（検索機能をアンセットアップする場合）

4.9.2　ナビゲーション プラットフォームのユーザプロパティの設定解除

4.9.3　検索機能の削除

4.9.4　データベース接続の設定解除

4.9.5　ナビゲーション プラットフォームの停止

4.9.6　組み込みデータベースの設定解除

4.9.7　システム環境変数の設定解除

4.9.8　クライアント環境定義の設定解除

4.9.9　ナビゲーション プラットフォームの起動

4.10　セットアップ後の作業の流れ

4.11　ナビゲーション プラットフォームをセットアップ後にActive Directoryを構築する手順

4.12　ナビゲーション プラットフォームをセットアップ後にJP1/Baseによるユーザ認証を導入する手順

第3編　運用編

5.　ナビゲーション プラットフォームの運用

5.1　システムの起動と停止

5.1.1　システムの起動手順

5.1.2　システムの停止手順

5.2　バックアップとリストアの必要性

5.2.1　バックアップするタイミングとデータについて

5.2.2　リストアするタイミングとデータについて

5.3　データベースの運用

5.3.1　テーブルの再編成

5.3.2　データベースの状態確認

5.3.3　RDエリアの拡張

5.4　業務コンテンツの操作ログの設定

5.4.1　操作ログの内容

5.4.2　操作ログの出力先，面数，サイズ

5.5　監査ログとは

5.5.1　監査ログを取得するための設定

5.5.2　監査ログに出力される項目

5.5.3　監査ログが出力されるタイミング

5.5.4　監査ログの出力形式と出力例

5.5.5　監査ログの出力先，面数，サイズ

5.5.6　監査ログの見積もり

5.5.7　監査ログに出力されるメッセージ一覧

5.6　中断情報の運用

5.6.1　中断情報の再見積もり

5.6.2　中断情報の削除

5.7　Portal Managerでの設定の変更

5.7.1　編集環境または実行環境で設定を変更した場合

5.7.2　開発環境で設定を変更した場合

5.8　IPアドレスの変更手順

5.9　Active Directoryの接続パスワードを変更した場合の設定変更の流れ

5.9.1　統合ユーザ管理のコンフィグレーションファイル（ua.conf）の変更手順

5.9.2　uCosminexus Portal Framework設定の変更手順

5.9.3　EARファイルの更新手順

5.10　JP1製品と連携するための設定

5.10.1　JP1/IMの設定条件

5.10.2　JP1/AOの設定条件

5.10.3　JP1連携プラグインを使用するためのユーザプロパティファイルの設定

5.10.4　JP1イベント情報と業務コンテンツを関連づける

5.10.5　JP1イベント情報関連づけファイルの項目と形式

5.10.6　JP1製品からナビゲーション プラットフォームを呼び出すためのURL

6.　業務コンテンツの運用

6.1　業務コンテンツの作成から運用までに必要な作業

6.1.1　プラグインやカスタム画面を使用しない場合に必要な作業

6.1.2　プラグインやカスタム画面を使用する場合に必要な作業

6.2　編集環境が実行環境を兼ねる場合の業務コンテンツの運用

6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.1　アクセス権の種別と設定範囲（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.2　アクセス権の種別と実行できる操作（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.3　標準アクセス権限とは

6.3.4　アクセス権設定時の注意事項（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.5　旧バージョンのアクセス権との互換性

6.3.6　［アクセス権限］画面の項目（ディレクトリサーバによるユーザ認証を利用している場合）

6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）

6.4.1　アクセス権の種別と設定範囲（JP1/Baseによるユーザ認証を利用している場合）

6.4.2　アクセス権の種別と実行できる操作（JP1/Baseによるユーザ認証を利用している場合）

6.4.3　アクセス権設定時の注意事項（JP1/Baseによるユーザ認証を利用している場合）

6.4.4　JP1資源グループの運用時の注意事項

6.5　業務コンテンツのアクセス管理の流れ（ディレクトリサーバによるユーザ認証を利用している場合）

6.5.1　アクセス権グループを作成する手順

6.5.2　アクセス権グループの定義内容を変更する手順

6.5.3　アクセス権グループを削除する手順

6.5.4　アクセス権グループのエクスポートとインポート

6.5.5　アクセス権グループの作成例

6.6　業務コンテンツのエクスポートとインポート

6.6.1　業務コンテンツのエクスポート

6.6.2　業務コンテンツのインポート

6.7　開発環境で作成したファイルの適用

6.7.1　開発環境から受け取るファイル

6.7.2　開発環境から受け取ったファイルの適用

6.7.3　適用する前の状態への復元

6.8　検索用データの更新

6.9　業務コンテンツで使用する静的ファイルの管理

6.9.1　業務編集画面から静的ファイルを格納する場合のファイル管理

6.9.2　Webサーバのディレクトリに直接静的ファイルを格納する場合のファイル管理

6.9.3　業務コンテンツをエクスポートまたはインポートする場合の注意事項

第4編　リファレンス編

7.　プロパティ

7.1　設定が必要なプロパティファイル

7.2　プロパティファイルの記述形式

7.2.1　プロパティファイルを記述する際の注意事項

7.2.2　エスケープシーケンスの指定

7.3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定

7.3.1　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のプロパティ一覧

7.3.2　ユーザセットアッププロパティファイルの格納先

7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細

7.4　ユーザプロパティファイル（ucnp_user.properties）の設定

7.4.1　ユーザプロパティファイル（ucnp_user.properties）のプロパティ一覧

7.4.2　ユーザプロパティファイルの格納先

7.4.3　ユーザプロパティファイルのプロパティ詳細

7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定

7.5.1　ユーザメッセージプロパティファイルの格納先

7.5.2　ユーザメッセージプロパティファイルの記述例

8.　コマンド

8.1　コマンドの概要

8.1.1　コマンド一覧

8.1.2　全コマンド共通の注意事項

8.2　npaclexportコマンド（アクセス権グループのエクスポート）

8.3　npenvupdateコマンド（環境更新）

8.4　npexportコマンド（業務コンテンツのエクスポート）

8.5　npimportコマンド（業務コンテンツのインポート）

8.6　nppdntcmdコマンド（データベース環境変数の設定）

8.7　npsetenvコマンド（環境変数の設定）

8.8　npsetupコマンド（セットアップ）

8.9　npsnapshotlogコマンド（トラブルシュート情報の収集）

8.10　npstartコマンド（起動）

8.11　npstopコマンド（停止）

8.12　npunsetupコマンド（アンセットアップ）

8.13　npupdateearコマンド（EARファイルの更新）

8.14　npupdatesearchdataコマンド（検索用データの更新）

第5編　トラブルシューティング編

9.　トラブルシューティング

9.1　インストール，セットアップ中に発生するトラブル

9.1.1　正しくインストールされなかったというメッセージが表示された場合の対処

9.1.2　インストールに失敗したというメッセージが表示された場合の対処

9.1.3　インストール処理に時間が掛かる場合の対処

9.1.4　ファイアウォールでブロックされているというメッセージが表示された場合の対処

9.1.5　セットアップ後に起動エラーが発生する場合の対処

9.2　運用開始後に発生するトラブル

9.3　トレースファイルの出力先

付録

付録A　検索の対象となる項目

付録B　このマニュアルの参考情報

付録B.1　関連マニュアル

付録B.2　このマニュアルでの表記

付録B.3　英略語

付録B.4　KB（キロバイト）などの単位表記について

付録C　用語解説

索引

[他社商品名称に関する表示]

All Rights Reserved. Copyright (C) 2012, 2013, Hitachi, Ltd.

前書き

■ 対象製品

P-2443-4P94　 uCosminexus Navigation Platform　 09-60（適用OS：Windows Server 2008 x86，Windows Server 2008 x64※，Windows Server 2008 R2※，Windows Server 2012※）
P-2443-4R94　 uCosminexus Navigation Platform - User License　 09-60（適用OS：Windows Server 2008 x86，Windows Server 2008 x64※，Windows Server 2008 R2※，Windows Server 2012※）
P-2443-4U94　 uCosminexus Navigation Platform - Authoring License　 09-60（適用OS：Windows Server 2008 x86，Windows Server 2008 x64※，Windows Server 2008 R2※，Windows Server 2012※）
P-2443-4V94　 uCosminexus Navigation Developer　 09-60（適用OS：Windows Vista x86，Windows XP，Windows 7 x86，Windows 7 x64※，Windows 8 x86，Windows 8 x64※）

注※　WOW64環境だけで使用できます。

■ 輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。
なお、不明な場合は、弊社担当営業にお問い合わせください。

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
iOS は，Apple Inc.のOS名称です。
iPadは，Apple Inc.の商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
Safariは，Apple Inc.の商標です。
Wi-Fiは，米国におけるWi-Fi Allianceの登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
インテル，Intel，およびIntel Core は，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。

■ マイクロソフト製品のスクリーンショットの使用について

Microsoft Corporation のガイドラインに従って画面写真を使用しています。

■ マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記 | 製品名
Active Directory | Microsoft(R) Active Directory
Internet Explorer | Internet Explorer 6 | Microsoft(R) Internet Explorer(R) 6
Internet Explorer 7 | Windows(R) Internet Explorer(R) 7
Internet Explorer 8 | Windows(R) Internet Explorer(R) 8
Internet Explorer 9 | Windows(R) Internet Explorer(R) 9
Internet Explorer 10 | Windows(R) Internet Explorer(R) 10
Windows | Windows 7 | Windows 7 x86 | Microsoft(R) Windows(R) 7 Enterprise日本語版(32ビット版)
Microsoft(R) Windows(R) 7 Professional 日本語版(32ビット版)
Microsoft(R) Windows(R) 7 Ultimate 日本語版(32ビット版)
Windows 7 x64 | Microsoft(R) Windows(R) 7 Enterprise 日本語版(64ビット版)
Microsoft(R) Windows(R) 7 Professional 日本語版(64ビット版)
Microsoft(R) Windows(R) 7 Ultimate日本語版(64ビット版)
Windows 8 | Windows 8 x86 | Windows(R) 8 Enterprise 日本語版(32ビット版)
Windows(R) 8 Pro 日本語版(32ビット版)
Windows 8 x64 | Windows(R) 8 Enterprise 日本語版(64ビット版)
Windows(R) 8 Pro 日本語版(64ビット版)
Windows Server 2008 | Windows Server 2008 x86 | Microsoft(R) Windows Server(R) 2008 Enterprise 32-bit 日本語版
Microsoft(R) Windows Server(R) 2008 Standard 32-bit 日本語版
Windows Server 2008 x64 | Microsoft(R) Windows Server(R) 2008 Enterprise 日本語版
Microsoft(R) Windows Server(R) 2008 Standard 日本語版
Windows Server 2008 R2 | Microsoft(R) Windows Server(R) 2008 R2 Enterprise 日本語版
Microsoft(R) Windows Server(R) 2008 R2 Standard 日本語版
Windows Server 2012 | Microsoft(R) Windows Server(R) 2012 Datacenter 日本語版
Microsoft(R) Windows Server(R) 2012 Standard 日本語版
Windows Vista | Windows Vista x86 | Microsoft(R) Windows Vista(R) Business 日本語版(32ビット版)
Microsoft(R) Windows Vista(R) Enterprise 日本語版(32ビット版)
Microsoft(R) Windows Vista(R) Ultimate 日本語版(32ビット版)
Windows Vista x64 | Microsoft(R) Windows Vista(R) Business 日本語版(64ビット版)
Microsoft(R) Windows Vista(R) Enterprise 日本語版(64ビット版)
Microsoft(R) Windows Vista(R) Ultimate 日本語版(64ビット版)
Windows XP | Microsoft(R) Windows(R) XP Professional Operating System

■ 発行

2013年11月　3020-3-V40-20

■ 著作権

All Rights Reserved. Copyright (C) 2012, 2013, Hitachi, Ltd.

変更内容

変更内容（3020-3-V40-20）uCosminexus Navigation Platform 09-60，uCosminexus Navigation Platform - User License 09-60，uCosminexus Navigation Platform - Authoring License 09-60，uCosminexus Navigation Developer 09-60

追加・変更内容
変更個所

JP1連携プラグインをサポートしました。これに伴い，次に示すJP1製品と連携する業務コンテンツを作成できるようになりました。

JP1/IM-M

JP1/IM-V

JP1/IM-SS

JP1/AO

また，データベースサーバの容量の見積もりに関する説明を変更しました。
1.1.1(3)，2.1.1，2.1.3，2.2，2.2.1，3.2.3(5)，3.4.1(1)，3.4.1(3)，3.4.1(7)，3.6.1，5.10，7.4.1，7.4.3(56)，7.4.3(57)，7.4.3(58)，7.4.3(59)，7.4.3(60)，7.4.3(61)

業務編集画面および業務実行画面に，関連リンクを表示できるようになりました。
2.1.1，2.1.2，3.4.3(1)，4.3.2，6.3.2，付録A

操作ログに出力できる項目を追加しました。
2.1.4(2)，5.4.1，7.4.3(49)

JP1/Baseによるユーザ認証をサポートしました。これに伴い，JP1資源グループを利用して，業務コンテンツへのアクセスを管理できるようになりました。
2.1.5，3.2.1，3.2.3(5)，3.3.2，4.1，4.3，4.4，4.10，4.12，5.1.1，5.2.1，5.2.2，5.10，6.1，6.2，6.4，6.6，7.3.1，7.3.3(1)，7.3.3(3)，7.4.1，7.4.3(1)，7.4.3(2)，7.4.3(3)，8.2，8.4，8.5

処理が終了したプロセスノードにチェックマークを表示できるようになりました。これに伴い，中断情報の容量の見積もり手順および見積もり例を変更しました。
3.4.3(2)，3.4.3(3)，7.4.3(36)

09-60にバージョンアップする場合の注意事項を追加しました。
3.6.1，3.6.2

次のプロパティを追加しました。

ucnp.setup.server.jp1auth.virtual.hostname

ucnp.base.server.jp1auth.system.resource.group

ucnp.base.server.jp1auth.virtual.hostname

ucnp.base.client.node.checkmark.position

ucnp.base.client.flow.connector.color

ucnp.base.client.auditlog.enable

ucnp.base.server.auditlog.path

ucnp.base.server.auditlog.backup.number

ucnp.base.server.auditlog.size

ucnp.base.client.jp1imss.hostname

ucnp.base.client.jp1imss.portnum

ucnp.base.client.jp1ao.hostname

ucnp.base.client.jp1ao.portnum

ucnp.base.client.jp1ao.submittask.passwordfile.path

ucnp.base.client.jp1ev.association.enable

ucnp.base.client.editor.jp1plugin.toolpalette.display

3.6.2(3)，7.3.1，7.3.3(3)，7.4.1，7.4.3(2)，7.4.3(3)，7.4.3(36)，7.4.3(37)，7.4.3(52)，7.4.3(53)，7.4.3(54)，7.4.3(55)，7.4.3(56)，7.4.3(57)，7.4.3(58)，7.4.3(59)，7.4.3(60)，7.4.3(61)，7.4.3(74)

バージョンアップ前に退避したプラグインの更新手順を追加しました。
3.6.3，3.6.4

JP1/Auditで参照できる監査ログを取得できるようにしました。
5.4，5.5，7.4.1，7.4.3(52)，7.4.3(53)，7.4.3(54)，7.4.3(55)

次のプロパティの説明を変更しました。

ucnp.setup.server.ldap.directory.kind

ucnp.base.server.operationlog.format

7.3.3(1)，7.4.3(49)

次のプロパティのデフォルト値を変更しました。

ucnp.setup.server.docb.security.admin

ucnp.setup.server.ldap.hostname

ucnp.setup.server.ldap.port

ucnp.setup.server.ldap.java.naming.security.principal

ucnp.setup.server.ldap.java.naming.security.credentials

ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn

ucnp.setup.server.ldap.department.basedn

7.3.3(2)，7.3.3(4)，7.3.3(5)，7.3.3(6)，7.3.3(7)，7.3.3(8)，7.3.3(12)

関連線の色を変更できるようにしました。
7.4.1，7.4.3(37)

npsnapshotlogコマンドで取得する1次資料について説明を追加しました。
9.2

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，次に示すプログラムプロダクトの概要，機能，およびシステムへの導入から運用までの作業について説明したものです。

uCosminexus Navigation Platform

uCosminexus Navigation Platform - User License

uCosminexus Navigation Platform - Authoring License

uCosminexus Navigation Developer

このマニュアルでは，uCosminexus Navigation PlatformとuCosminexus Navigation Platform - User Licenseを総称してuCosminexus Navigation Platformと呼びます。また，上記の4製品を総称してナビゲーション プラットフォームと呼びます。

＜はじめにの構成＞

対象読者

読書手順

このマニュアルの画面や操作の説明で使用している記号

このマニュアルのコマンドおよびURLの説明で使用している記号

図中で使用する記号

対象読者

このマニュアルは，ナビゲーション プラットフォームをシステムに導入，運用するユーザを対象としています。ナビゲーション プラットフォームをシステムに導入，運用するユーザは，次に示す知識を持っていることを前提としています。

Windowsのシステム管理に関する知識

ディレクトリサーバ（Oracle Directory ServerまたはActive Directory）の基本的な知識

リレーショナルデータベースに関する基本的な知識

ナビゲーション プラットフォームをカスタマイズする場合，HTMLの基本的な知識

読書手順

このマニュアルは，利用目的に合わせて次の個所をお読みいただくことをお勧めします。

このマニュアルの画面や操作の説明で使用している記号

このマニュアルでは，次に示す記号を使用して画面や操作を説明しています。

記号 | 説明
＜　＞ | キーボードのキーを表します。
［　］ | ダイアログ名，メニュー項目名，ボタン名，および画面に表示されている項目名を表します。
［　］－［　］ | －の前に示したメニューから，－の後ろのメニューを選択することを表します。
文字列 | 文字列が斜体になっている項目は，可変の文字列を表します。

このマニュアルのコマンドおよびURLの説明で使用している記号

このマニュアルのコマンドおよびURLの説明で使用する記号について次に示します。

記号 | 説明
｜ | 横に並べられた複数の項目に対する項目間の区切りを示し，「または」を意味します。
[　] | この記号で囲まれている項目は省略してもよいことを示します。
△ | 半角スペースであることを示します。
… | 直前の値を繰り返すことを示します。

図中で使用する記号

このマニュアルの図中で使用する記号を，次のように定義します。

1.　ナビゲーション プラットフォームの概要

この章では，最初にナビゲーション プラットフォームの特長，製品体系，および構成ソフトウェアについて説明します。次に，ナビゲーション プラットフォームを導入・構築してから運用するまでに必要な作業の概要を説明します。

＜この章の構成＞

1.1　ナビゲーション プラットフォームとは

1.2　導入から運用までの作業の概要

1.1　ナビゲーション プラットフォームとは

ナビゲーション プラットフォームとは，業務の流れと操作手順を可視化するための製品です。分散した手順書を一つにまとめたり，個人が持っている知識・ノウハウを組織で共有したりして，正確かつ効率良く業務を実施できるようにします。

例えば，担当者の判断が必要とされる次のような業務に，ナビゲーション プラットフォームを導入すると，作業の効率・精度が上がることが期待できます。

お客様からの問い合わせ対応

帳票の処理

システムの運用管理，監視

システムの運用管理，監視の業務について考えてみると，障害や利用者からの問い合わせに対して，だれが対応しても速やかに問題を解決する必要があります。しかし，担当者のスキルや経験によって対応に差が出てしまうことも少なくありません。

このような業務にナビゲーション プラットフォームを適用すると，担当者の経験や勘に任されていた部分が可視化され，担当者によって作業の質や効率にばらつきが出るのを抑えられます。また，操作のログを記録できるため，どの作業にどれくらいの時間が掛かっているか，ミスの起きやすい作業は何かなど，業務の見直しや分析に役立てることもできます。

＜この節の構成＞

1.1.1　製品の特長

1.1.2　製品体系

1.1.3　構成ソフトウェア

1.1.1　製品の特長

ナビゲーション プラットフォームの特長を次に示します。

＜この項の構成＞

(1)　直感的な操作で業務を実行できる

(2)　プログラミングなしで画面を作成できる

(3)　外部プログラムと連携できる

(1)　直感的な操作で業務を実行できる

ナビゲーション プラットフォームでは，業務の流れをフローチャート形式で表示できます。また，フローチャートの各ステップに必要な作業を順番にガイド表示できます。ナビゲーション プラットフォームの利用者は，フローチャートに沿ってWebブラウザ上で操作するだけで，正確かつ効率良く業務を実行できます。

ナビゲーション プラットフォームの操作の概要を次に示します。

図1-1　ナビゲーション プラットフォームの操作の概要

ナビゲーション プラットフォームの画面に表示される業務情報のうち，フローチャートの部分を業務フロー，フローチャートの各ステップに必要な作業を説明する部分をガイドといいます。

(2)　プログラミングなしで画面を作成できる

ナビゲーション プラットフォームの画面に表示される業務情報（業務フローおよびガイド）のことを業務コンテンツといいます。業務コンテンツは，編集用の画面をWebブラウザ上で操作することで作成できます。編集用のパレットからパーツを選択して，業務フローおよびガイドに配置していきます。

業務の流れや作業手順に変更が発生しても，軽微な変更であれば，編集用の画面で業務フローの配置やガイドの説明を見直すことで手軽に対応できます。

(3)　外部プログラムと連携できる

ナビゲーション プラットフォームが提供するAPIを使用してユーザプラグインを開発すれば，Webサービスの呼び出しや業務データベースへのアクセスなど，任意の外部プログラムと連携できます。

また，ナビゲーション プラットフォームが提供する既成のシステムプラグインを利用すれば，画面上で簡単な設定をするだけで，JP1製品を使ったシステムとも連携できます。

システムプラグインで連携できるJP1製品

JP1/Integrated Manager - Manager 10-10以降（以降，JP1/IM-Mと呼ぶ）

JP1/Integrated Manager - View 10-10以降（以降，JP1/IM-Vと呼ぶ）

JP1/Integrated Manager - Service Support 10-10以降（以降，JP1/IM-SSと呼ぶ）

JP1/Automatic Operation 10-10以降（以降，JP1/AOと呼ぶ）

なお，JP1/IM-MとJP1/IM-Vを総称してJP1/IMと呼びます。

システムプラグインを使ってナビゲーション プラットフォームとJP1製品とが連携するケースの概要を次に示します。

図1-2　JP1製品との連携の概要

システムプラグインを使うことで，JP1製品が持つイベント情報を相互に引き継げるようになります。JP1製品の画面からナビゲーション プラットフォームの業務コンテンツを呼び出したり，業務コンテンツの操作結果のデータをJP1製品に引き継いでフィードバックしたりできるため，障害対応などの業務のスピードや正確さが増します。

このマニュアルでの参照個所

JP1製品と連携する場合は，次の個所も参照してください。

「4.3　JP1/Baseによるユーザ認証を利用する場合のセットアップ準備」

「5.10　JP1製品と連携するための設定」

「6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）」

また，JP1製品との連携に必要なプラグインパーツについては，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

1.1.2　製品体系

ナビゲーション プラットフォームで構築する環境は3種類あります。ナビゲーション プラットフォームを利用して業務を実行する実行環境，および業務コンテンツを作成する編集環境は必須です。また，プラグインを開発する場合，プラグインを開発する開発環境が必要です。

ここでは，3種類の環境に対応する製品について説明します。

＜この項の構成＞

(1)　実行環境で使用する製品

(2)　編集環境で使用する製品

(3)　開発環境で使用する製品

(1)　実行環境で使用する製品

実行環境で使用する製品を次に示します。

uCosminexus Navigation Platform

uCosminexus Navigation Platform - User License

このマニュアルでは，これらの製品を総称してuCosminexus Navigation Platformと表記します。

(2)　編集環境で使用する製品

編集環境で使用する製品を次に示します。

uCosminexus Navigation Platform - Authoring License

(3)　開発環境で使用する製品

開発環境で使用する製品を次に示します。

uCosminexus Navigation Developer

uCosminexus Navigation Developerは，uCosminexus Navigation Platform - Authoring Licenseの機能を含みます。したがって，開発環境が編集環境を兼ねることもできます。

1.1.3　構成ソフトウェア

ナビゲーション プラットフォームは，複数の構成ソフトウェアから成ります。製品と構成ソフトウェアの対応を次に示します。

表1-1　製品と構成ソフトウェアの対応

項番
構成ソフトウェア名
uCosminexus Navigation Platform
（実行環境）
uCosminexus Navigation Platform - Authoring License
（編集環境）
uCosminexus Navigation Developer
（開発環境）

1
uCosminexus Navigation Platform - Core Server
○
×
×

2
uCosminexus Navigation Developer - Core Server
×
○
○

3
uCosminexus Application Server
○
○
×

4
uCosminexus Developer
×
×
○

5
uCosminexus Portal Framework
○
○
○

6
DocumentBroker Version 3 Smart Document Management
○
○
○

（凡例）

○：含まれます。

×：含まれません。

1.2　導入から運用までの作業の概要

この節では，導入から運用までの作業の流れ，およびナビゲーション プラットフォームの環境ごとの作業内容について説明します。

＜この節の構成＞

1.2.1　作業の流れ

1.2.2　ナビゲーション プラットフォームの環境ごとの作業内容

1.2.1　作業の流れ

ナビゲーション プラットフォームを業務に導入してから運用するまでの間に必要な作業の流れを次に示します。

図1-3　導入（構築）から運用までの作業の流れ

図に示した作業の概要について説明します。

システム管理

システム管理の概要を説明します。

作業内容

システム管理の作業を次に示します。システム管理の詳細は，「第2編　構築編」および「第3編　運用編」を参照してください。

ナビゲーション プラットフォームのセットアップ
ナビゲーション プラットフォームをシステムにインストールしてセットアップします。また，前提ソフトウェアであるディレクトリサーバを構築します。

ナビゲーション プラットフォームの運用
ナビゲーション プラットフォームをセットアップしたシステムを運用します。

業務コンテンツの運用
編集環境で作成した業務コンテンツを実行環境に適用したり，開発環境で開発したプラグインやカスタム画面を編集環境と実行環境に適用したりします。

作業を実施する環境

実行環境，編集環境，開発環境のすべてで実施します。

作業を実施するユーザ

WindowsのAdministrator権限，およびナビゲーション プラットフォームのシステム管理者権限を持つユーザが実施します。

システム管理の作業を実施するユーザのことを，ナビゲーション プラットフォームのマニュアルではシステム管理者といいます。

業務コンテンツ作成

業務コンテンツ作成の概要を説明します。

作業内容

業務コンテンツ作成の作業を次に示します。業務コンテンツ作成の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

業務コンテンツの作成

作成した業務コンテンツの編集

作業を実施する環境

編集環境で実施します。編集環境へはWebブラウザ経由でアクセスします。

作業を実施するユーザ

業務コンテンツに対して管理者または編集者のアクセス権を持つユーザが実施します。

業務コンテンツに対して管理者のアクセス権を持つユーザのことを，ナビゲーション プラットフォームのマニュアルではコンテンツ管理者といいます。また，編集者のアクセス権を持つユーザのことは，コンテンツ編集者といいます。

開発

開発の概要を説明します。

作業内容

開発の作業を次に示します。開発の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

プラグインの開発と改修

カスタム画面の開発と改修

作業を実施する環境

開発環境で実施します。

作業を実施するユーザ

WindowsのAdministrator権限を持つユーザが実施します。

業務実行

業務実行の概要を説明します。

作業内容

業務コンテンツを操作しながら，業務を実行します。業務実行の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

作業を実施する環境

実行環境で実施します。実行環境へはWebブラウザ経由でアクセスします。

作業を実施するユーザ

業務を実行するユーザのことを，ナビゲーション プラットフォームのマニュアルでは利用者といいます。

1.2.2　ナビゲーション プラットフォームの環境ごとの作業内容

ナビゲーション プラットフォームの実行環境，編集環境，開発環境のそれぞれで実施する作業項目を次に示します。

表1-2　ナビゲーション プラットフォームの環境ごとの作業内容

項番 | 作業内容 | 実行環境 | 編集環境 | 開発環境
1 | システム管理 | ナビゲーション プラットフォームのセットアップ | ○ | ○ | ○
2 | ナビゲーション プラットフォームの運用 | ○ | ○ | ○
3 | 業務コンテンツの運用 | ○ | ○ | ○
4 | 業務コンテンツ作成 | 業務コンテンツの作成 | × | ○ | ○
5 | 業務コンテンツの編集 | × | ○ | ○
6 | 開発 | プラグインの開発と改修 | × | × | ○
7 | カスタム画面の開発と改修 | × | × | ○
8 | 業務実行 | ○ | ○ | △

（凡例）

○：実施できます。

△：動作テストとして実施できます。

×：実施できません。

2.　ナビゲーション プラットフォームの機能

ナビゲーション プラットフォームでは，業務コンテンツを利用したり，作成したりするための画面を提供しています。また，プラグインを使用することで，外部プログラムと連携したり，画面の機能を拡張したりできます。

この章では，これらの機能について説明します。

＜この章の構成＞

2.1　業務コンテンツの利用と作成

2.2　外部プログラムとの連携

2.1　業務コンテンツの利用と作成

業務コンテンツを利用するには，Webブラウザから業務実行画面を操作します。また，業務コンテンツを作成するには，Webブラウザから業務編集画面を操作します。

＜この節の構成＞

2.1.1　業務実行画面でできること

2.1.2　業務編集画面でできること

2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL

2.1.4　基本URLに指定できるパラメタ

2.1.5　ナビゲーション プラットフォームにログインするためのIDとパスワード

2.1.1　業務実行画面でできること

業務実行画面を次に示します。

図2-1　業務実行画面

業務実行画面では次のことができます。

業務フローを参照して，業務の手順を理解する

ガイドに表示される説明を参照しながら，業務を実行する

JP1イベント情報などのデータをナビゲーション プラットフォームの画面に表示しながら，業務を実行する（システムプラグインを使用する場合）

外部プログラムで必要なデータをナビゲーション プラットフォームの画面上で入力しながら，業務を実行する（ユーザプラグインを開発して連携する場合）

業務コンテンツを検索する（画面をカスタマイズする場合）

業務実行画面は，用途に合わせてカスタマイズできます。業務実行画面のカスタマイズ例を次に示します。

図2-2　業務実行画面のカスタマイズ例

ヘッダロゴ，部品の色・デザイン，メニュー領域，ヘッダのリンクを変更する
ユーザプロパティファイル（ucnp_user.properties）のプロパティを変更することで，ヘッダのロゴや業務フローに表示される部品の色・デザインを変更したり，メニュー領域を非表示にしたりできます。さらに，業務に関するヘルプをリンクとしてヘッダに表示させることもできます。
ユーザプロパティファイルの設定については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

メニュー領域をデフォルトから変更する
開発環境でカスタム画面を開発することで，メニュー領域に業務コンテンツを整理して表示したり，業務コンテンツの検索機能を追加したりできます。検索機能を使用する場合に，業務コンテンツのどの項目が検索の対象となるのかについては，「付録A　検索の対象となる項目」を参照してください。
開発環境でカスタム画面を開発する方法については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

Webサイトへのリンク集を表示する
業務の実行時によく参照するWebサイトがある場合，関連リンクを設定することで，Webサイトへのリンク集を表示できます。関連リンクの設定方法については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

参考

ナビゲーション プラットフォームのログイン画面も，ユーザプロパティファイル（ucnp_user.properties）の設定によってカスタマイズできます。

カスタム画面は，業務実行画面から独立した新規画面として開発することもできます。

2.1.2　業務編集画面でできること

業務編集画面を次に示します。

図2-3　業務編集画面

業務編集画面では次のことができます。

業務コンテンツを新規に作成する

作成した業務コンテンツを変更，複製，削除する

業務コンテンツにアクセス権を設定する

プラグインと業務コンテンツを関連づける（プラグインを使用する場合）

Webサイトへのリンク集を作成，表示する

参考

業務編集画面のメニュー領域はカスタマイズできませんが，ヘッダや業務フローなどのほかの領域は，業務実行画面と同様にユーザプロパティファイル（ucnp_user.properties）のプロパティを変更することで，カスタマイズできます。ユーザプロパティファイルの設定については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

ナビゲーション プラットフォームの画面とは別に検索機能を持つ新規画面を開発すれば，業務編集画面を表示した状態で，業務実行画面の業務コンテンツを検索できるようになります。検索機能を使用する場合に，業務コンテンツのどの項目が検索の対象となるのかについては，「付録A　検索の対象となる項目」を参照してください。また，新規画面の開発方法については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL

業務コンテンツを操作するために，Webブラウザからナビゲーション プラットフォームの画面にアクセスするときに必要なURLについて説明します。

ナビゲーション プラットフォームの画面にアクセスするためのURLは，基本URLとパラメタから構成されています。パラメタの指定は任意です。基本URLにパラメタを指定すると，特定の業務コンテンツに直接アクセスしたり，ナビゲーション プラットフォームを終了するときのボタンの種別を選択したりできます。

注意

JP1製品からナビゲーション プラットフォームを呼び出すために設定するURLには，ここで説明するURLは使用できません。「5.10.6　JP1製品からナビゲーション プラットフォームを呼び出すためのURL」を参照してください。

ディレクトリサーバを使用しないシステム構成の場合，基本URL中にあるシングルサインオンのパスワードのパラメタを指定する必要はありません。

＜この項の構成＞

(1)　業務実行画面にアクセスするための基本URL

(2)　業務編集画面にアクセスするための基本URL

(3)　カスタム画面（新規画面）にアクセスするための基本URL

(1)　業務実行画面にアクセスするための基本URL

次に示すURLを使用すると，［編集開始］メニューが表示されないため，利用者は業務コンテンツを変更できません。業務コンテンツを利用するだけのユーザ（業務編集画面を使用しないユーザ）には，ここで説明するURLを通知してください。

ナビゲーション プラットフォームのログイン画面からアクセスする場合

パラメタを指定するかどうかで，基本URLが異なります。パラメタの指定については，「2.1.4　基本URLに指定できるパラメタ」を参照してください。

パラメタを指定しないとき

http://ホスト名:ポート番号/ucnpBase/

パラメタを指定するとき

http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default/tab_id/-44Ob44O844Og55S76Z2i

Cosminexusの統合ユーザ管理フレームワークを利用してシングルサインオンする場合

http://ホスト名:ポート番号/ucnpBase/portal/screen/Home/action/PLoginUser?com.cosminexus.admin.auth.name=ユーザID&com.cosminexus.admin.auth.password=パスワード

注意事項

このURLで業務実行画面にアクセスする場合，POSTメソッドを指定することを推奨します。GETメソッドを指定した場合，ユーザIDおよびパスワードがクエリとしてURLの一部になるため，Webサーバのログなどに痕跡が残ってしまいます。

Cosminexusの統合ユーザ管理フレームワークを利用したシングルサインオンについては，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」を参照してください。

可変値について説明します。

ホスト名
ナビゲーション プラットフォームがインストールされているJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値（ナビゲーション プラットフォームがインストールされているWebサーバのポート番号）です。ユーザセットアッププロパティファイルについては，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

ユーザID
シングルサインオンに使用するユーザIDです。HTTPリクエストのcom.cosminexus.admin.auth.nameパラメタに設定しておく必要があります。

パスワード
シングルサインオンに使用するユーザIDに対応するパスワードです。HTTPリクエストのcom.cosminexus.admin.auth.passwordパラメタに設定しておく必要があります。

(2)　業務編集画面にアクセスするための基本URL

次に示すURLを使用すると，ログイン後に業務編集画面が表示されます。

ナビゲーション プラットフォームのログイン画面からアクセスする場合

http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default/tab_id/-44Ob44O844Og55S76Z2i?start_editor=true&open_editor=true

Cosminexusの統合ユーザ管理フレームワークを利用してシングルサインオンする場合

http://ホスト名:ポート番号/ucnpBase/portal/screen/Home/action/PLoginUser?com.cosminexus.admin.auth.name=ユーザID&com.cosminexus.admin.auth.password=パスワード&start_editor=true&open_editor=true

注意事項

このURLで業務編集画面にアクセスする場合，POSTメソッドを指定することを推奨します。GETメソッドを指定した場合，ユーザIDおよびパスワードがクエリとしてURLの一部になるため，Webサーバのログなどに痕跡が残ってしまいます。

Cosminexusの統合ユーザ管理フレームワークを利用したシングルサインオンについては，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」を参照してください。

可変値について説明します。

ホスト名
ナビゲーション プラットフォームがインストールされているJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値（ナビゲーション プラットフォームがインストールされているWebサーバのポート番号）です。ユーザセットアッププロパティファイルについては，「第4編　リファレンス」を参照してください。

ユーザID
シングルサインオンに使用するユーザIDです。HTTPリクエストのcom.cosminexus.admin.auth.nameパラメタに設定しておく必要があります。

パスワード
シングルサインオンに使用するユーザIDに対応するパスワードです。HTTPリクエストのcom.cosminexus.admin.auth.passwordパラメタに設定しておく必要があります。

(3)　カスタム画面（新規画面）にアクセスするための基本URL

次に示すURLを使用すると，ログイン後にカスタム画面（新規画面）が表示されます。

ナビゲーション プラットフォームのログイン画面からアクセスする場合

http://ホスト名:ポート番号/ucnpBase/portal/action/Plain/portlet/ucnp/pane/-44Ob44O844Og44Kw44Or44O844OX/layout_id/default/url/L2FkcG9ydGxldHMvdWNucC9qc3Avdmlldy9Sb290SWZyYW1lLmpzcA--?ucnpUserPage=カスタム画面用のJSPファイルのパス

Cosminexusの統合ユーザ管理フレームワークを利用してシングルサインオンする場合

http://ホスト名:ポート番号/ucnpBase/portal/screen/Home/action/PLoginUser?com.cosminexus.admin.auth.name=ユーザID&com.cosminexus.admin.auth.password=パスワード&ucnpUserPage=カスタム画面用のJSPファイルのパス

注意事項

このURLでカスタム画面にアクセスする場合，POSTメソッドを指定することを推奨します。GETメソッドを指定した場合，ユーザIDおよびパスワードがクエリとしてURLの一部になるため，Webサーバのログなどに痕跡が残ってしまいます。

Cosminexusの統合ユーザ管理フレームワークを利用したシングルサインオンについては，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」を参照してください。

可変値について説明します。

ホスト名
ナビゲーション プラットフォームがインストールされているJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値（ナビゲーション プラットフォームがインストールされているWebサーバのポート番号）です。ユーザセットアッププロパティファイルについては，「第4編　リファレンス」を参照してください。

カスタム画面用のJSPファイルのパス
カスタム画面用のJSPファイルのパスを，開発環境のポータルプロジェクトのディレクトリからの相対パスで指定します。パスの先頭には「/」を追加してください。
編集環境および実行環境の場合，指定する値についてはカスタム画面を開発したユーザに確認してください。

ユーザID
シングルサインオンに使用するユーザIDです。HTTPリクエストのcom.cosminexus.admin.auth.nameパラメタに設定しておく必要があります。

パスワード
シングルサインオンに使用するユーザIDに対応するパスワードです。HTTPリクエストのcom.cosminexus.admin.auth.passwordパラメタに設定しておく必要があります。

2.1.4　基本URLに指定できるパラメタ

基本URLにパラメタを指定する場合の形式，および指定できるパラメタの種類について説明します。

＜この項の構成＞

(1)　基本URLに指定できるパラメタの形式

(2)　基本URLに指定できるパラメタの一覧

(3)　パラメタを指定したURLの例

(1)　基本URLに指定できるパラメタの形式

基本URLに指定するときの形式

基本URL?パラメタ名1=パラメタの値[[&パラメタ名2=パラメタの値]…]

基本URLとパラメタは「?」で，パラメタとパラメタは「&」で連結します。「&」で連結することで，複数のパラメタを指定できます。

基本URLの末尾にパラメタを追加すると，ログイン後に最初に表示する画面を変更できます。また，プラグインやカスタム画面と連携できるようになります。

なお，次の場合は基本URLにすでにパラメタが含まれているため，基本URLとパラメタの接続には「?」でなく「&」を指定してください。

業務編集画面にアクセスする場合

カスタム画面にアクセスする場合

Cosminexusの統合ユーザ管理フレームワークを利用してシングルサインオンする場合

(2)　基本URLに指定できるパラメタの一覧

基本URLに指定できるパラメタを次に示します。指定できるパラメタの種類は画面ごとに異なります。

表2-1　基本URLに指定できるパラメタ

パラメタ名
パラメタの値
説明
使用可否

業務実行画面
業務編集画面
カスタム画面（新規画面）

contentId
業務コンテンツID
指定したIDを持つ業務コンテンツを直接開きます。
業務コンテンツIDの大文字と小文字は区別されます。業務コンテンツIDは業務編集画面のメニューから取得します。業務編集画面のメニューについては，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。
また，業務実行画面に［URL取得］メニューが表示されている場合，メニューを選択すると，contentIdに業務コンテンツIDが指定されたURLを取得できます。業務実行画面に［URL取得］メニューを表示させるには，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.geturl.link.displayプロパティに「true」を指定する必要があります。ユーザプロパティファイル（ucnp_user.properties）については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。
○
○
×

open_editor
true
ログイン後に業務編集画面を直接開きます。
このパラメタを省略すると，ログイン後に業務実行画面が表示されます。［編集開始］メニューをクリックすることで業務編集画面へ遷移します。
このパラメタは，実行環境では使用できません。
×
○
×

start_editor
true
［編集開始］メニュー／［編集終了］メニューを表示します。このパラメタを指定すると，業務実行画面と業務編集画面を切り替えられるようになります。
このパラメタは，実行環境では使用できません。
○
○
×

ucnpCloseBtn※1
close_only
画面を閉じるボタンの種別を指定します。
「close_only」を指定すると，クリックしてもログアウトをしないで画面を閉じる，［閉じる］ボタンが表示されます。
○
○
×

logout_close
画面を閉じるボタンの種別を指定します。
「logout_close」を指定すると，クリックしたときにログアウトをしてから画面を閉じる，［閉じる］ボタンが表示されます。
○
○
×

logout
画面を閉じるボタンの種別を指定します。
「logout」を指定すると，クリックしたときにログアウトをしてからログイン画面に遷移する，［ログアウト］ボタンが表示されます。
○
○
×

ucnpOptions※2
ユーザプラグインで利用する値
パラメタの値をプラグインの処理で利用します。URIで使用できない文字をパラメタの値として使用する場合は，必要に応じてURLエンコードした値を指定してください。プラグインで利用する値は，プラグインを開発したユーザに問い合わせてください。
また，このパラメタの値をプラグインで利用する方法の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。
このパラメタに指定できる文字および長さは次のとおりです。

指定できる文字

ASCII文字。ただし，ASCIIコード0x00～0x1Fおよび0x7Fの文字は除きます。

指定できる値の長さ

文字列長（URLエンコードした文字列長）が1,024文字以内の文字列。1,024文字を超えた場合，トレースファイルにKDCZ10306-Wメッセージが出力され，1,024文字を超えた文字列が無効となります。

○
×
×

ucnpUserData
カスタム画面（新規画面）で利用する値
パラメタの値をカスタム画面（新規画面）の処理で利用します。
利用する値は，新規画面を開発したユーザに問い合わせてください。また，このパラメタの値を新規画面で利用する方法の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。
×
×
○

ucnpUserPage
カスタム画面（新規画面）用のJSPファイルのパス
ログイン後にカスタム画面（新規画面）を表示します。
JSPファイルのパスは，ナビゲーション プラットフォームで使用するポータルプロジェクトのディレクトリ以下の相対パスで指定します。パスの先頭には「/」を追加してください。
×
×
○

（凡例）

○：使用できます。

×：使用できません。

注※1

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.close.button.settingプロパティでも，画面を閉じるボタンの種類を設定することができます。また，ユーザプロパティファイルでは，ボタンを表示しないように設定することもできます。URLのパラメタとユーザプロパティファイルの両方でボタンの種類を指定した場合は，URLのパラメタでの指定が有効になります。

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.confirm.page.unload.enableプロパティに「true」を指定している場合で，このパラメタを使用するときは，ユーザメッセージプロパティファイル（ucnp_message_user.properties）のKDCZ00146-Wの内容も見直してください。ユーザメッセージプロパティファイル（ucnp_message_user.properties）の詳細については，「7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定」を参照してください。

注※2

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.operationlog.formatプロパティで，ucnpOptionsパラメタの値を操作ログに出力する設定にしている場合は次の点に注意してください。

操作ログの区切り文字として使用している文字をucnpOptionsパラメタに指定するときは，ucnp.base.server.operationlog.formatプロパティのフォーマットを見直すことを推奨します。

ucnpOptionsパラメタに指定できない値を指定したときは，操作ログファイルが破損するおそれがあります。このため，動作は保障されません。

(3)　パラメタを指定したURLの例

(a)　特定の業務コンテンツの業務編集画面（［閉じる］ボタンあり）にアクセスするためのURL

パラメタの指定例を次に示します。

URLに指定するパラメタの組み合わせ例

http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default?open_editor=true&ucnpCloseBtn=logout_close&contentId=業務コンテンツのID

2.1.5　ナビゲーション プラットフォームにログインするためのIDとパスワード

ナビゲーション プラットフォームにシステム管理者としてログインするためのIDは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.docb.security.adminプロパティの指定値（デフォルトはuser1）です。

ユーザ認証にActive Directoryを使用している場合は，ucnp.setup.server.docb.security.adminプロパティの指定値に対応するパスワードが必要になります。わからないときは，Active Directoryの管理者にパスワードを確認してください。なお，ユーザ認証を利用していない環境でセットアップしている場合は，パスワードの入力は不要です。

ユーザ認証にJP1/Baseを使用している場合は，次の条件を満たすJP1ユーザのIDとパスワードが必要になります。JP1ユーザのIDとパスワードはJP1/Baseの管理者に確認してください。

JP1/Baseに登録されている

ナビゲーション プラットフォームにアクセスする権限が与えられている

2.2　外部プログラムとの連携

外部プログラムと連携してデータの入出力を制御する業務コンテンツを作成するには，プラグインが必要です。ナビゲーション プラットフォームで使用できるプラグインには，次の種類があります。

システムプラグイン（プログラム開発が不要）

ユーザプラグイン（プログラム開発が必要）

JP1製品以外の外部プログラムやデータベースなどとデータをやり取りしたい場合は，ユーザプラグインの開発が必要です。また，入力データを一時保存する機能を追加したい場合も，ユーザプラグインが必要になります。

＜この節の構成＞

2.2.1　システムプラグイン

2.2.2　ユーザプラグイン

2.2.1　システムプラグイン

システムプラグインとは，ナビゲーション プラットフォームが提供しているプラグインパーツであり，プログラム開発は不要です。システムプラグインには，次の種類があります。

データストアプラグイン

JP1連携プラグイン

なお，このマニュアルでは，データの入出力を制御するプラグインを総称して，入出力プラグインと呼ぶ場合もあります。

＜この項の構成＞

(1)　データストアプラグインの処理と動作イメージ

(2)　JP1連携プラグインの処理と動作イメージ

(1)　データストアプラグインの処理と動作イメージ

データストアプラグインを使用すると，業務コンテンツ内のデータの入出力を制御して，利用者が入力または選択した値をほかのノードに引き継いで表示することができます。データストアプラグインを使用した業務コンテンツの例を次に示します。

図2-4　データストアプラグインを使用した業務コンテンツの例

この例では，各ノードにデータストアプラグインを配置しておくことで，1.と2.の入力データが3.に引き継がれて出力・表示されます。

(2)　JP1連携プラグインの処理と動作イメージ

JP1連携プラグインを使用すると，外部システムにあるJP1製品とナビゲーション プラットフォームの業務コンテンツを連携できます。JP1製品と連携した場合の業務の流れを次に示します。

図2-5　JP1製品と連携した場合の業務の流れ

この図は，次のような業務の流れを表しています。

JP1/IMの画面で障害の発生を確認する

障害への対処方法を調べるためにJP1/IMまたはJP1/IM-SSの画面から業務コンテンツを呼び出す

業務コンテンツを操作することで，障害への対処が完了する
業務コンテンツからJP1/AOの画面を呼び出すことで，さらに効率的な対処ができる場合もあります。

障害への対処が完了したという情報がJP1/IMの画面に反映される

なお，JP1製品以外の外部プログラムやデータベースなどとデータをやり取りしたい場合は，ユーザプラグインの開発が必要です。

2.2.2　ユーザプラグイン

ユーザプラグインとは，ナビゲーション プラットフォームが提供するAPIを使用して開発するプラグインです。ユーザプラグインには，次の種類があります。

入出力プラグイン
システムプラグインでは制御できない，任意の外部プログラムとの間のデータの入出力を制御します。

中断再開プラグイン
利用者が業務実行画面で入力した情報を一時保存して，業務を再開したときに一時保存した情報を復元するためのプラグインです。中断再開プラグインを開発すると，利用者が業務の途中にほかの業務を参照したり，ログアウトしたりしても，一時保存した状態から業務を再開できるようになります。

＜この項の構成＞

(1)　入出力プラグイン（ユーザプラグイン）の処理と動作イメージ

(2)　中断再開プラグイン（ユーザプラグイン）の動作イメージ

(1)　入出力プラグイン（ユーザプラグイン）の処理と動作イメージ

入出力プラグイン（ユーザプラグイン）の概要を次に示します。

図2-6　入出力プラグイン（ユーザプラグイン）の概要

入出力プラグイン（ユーザプラグイン）と連携すると，次のような処理ができます。

業務フローの工程と工程の間で，データの受け渡しをする

ガイドに入力した値をデータベースへ登録する

例えば，次のような流れの業務があるとします。

契約内容の変更

変更内容の確認

1. 契約内容の変更でガイドに入力した値を，2. 変更内容の確認でガイドに表示させたい場合に，入出力プラグイン（ユーザプラグイン）とガイドを関連づけます。入出力プラグイン（ユーザプラグイン）とガイドを関連づけた場合の業務実行画面の動作イメージを次に示します。

図2-7　入出力プラグイン（ユーザプラグイン）とガイドを関連づけた場合の業務実行画面の動作イメージ

入出力プラグイン（ユーザプラグイン）を使用するには，プラグインを開発することのほかに，業務編集画面で入出力プラグインとガイドを関連づける操作が必要です。この作業の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

(2)　中断再開プラグイン（ユーザプラグイン）の動作イメージ

中断再開プラグインを使用した場合の業務実行画面の動作イメージを次に示します。

図2-8　中断再開プラグインを使用した場合の業務実行画面の動作イメージ

利用者は，業務実行画面の右上にある［一時保存］ボタンをクリックすることで，入力した情報を保存できます。業務を再開するときは，次に示す情報（中断情報）が復元されます。

一時保存したときに実行していた工程
一時保存したときに実行していた工程が，実行中の工程として復元されます。また，実行中の工程が表示されるように，業務フローが自動的にスクロール※1されます。

直接遷移できる工程※2
クリックして直接遷移できる工程の状態が復元されます。

ガイドに入力した情報
各工程のガイドに入力した情報が復元されます。

注※1

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.autoscrollプロパティがtrueの場合に，自動的にスクロールされます。

注※2

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.directjump.enableプロパティがtrueの場合に，直接遷移できるノードが表示されます。

中断再開プラグインを使用するには，プラグインを開発することのほかに，次の作業が必要です。なお，括弧内には，詳細についての参照先を示しています。

中断情報の容量を見積もる（「3.4.3　中断再開プラグインを使用する場合の容量の見積もり」を参照）

次のユーザプロパティを設定する（「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照）

必須：ucnp.base.client.suspend.enable（中断再開プラグインの使用有無）

任意：ucnp.base.client.viewer.confirm.discardinput.enable（入力情報の破棄確認ダイアログの表示有無）

任意：ucnp.base.client.suspend.confirm.load.enable（業務再開の確認ダイアログの表示有無）

業務コンテンツまたはユーザを追加，変更したときに，中断情報を運用する（「5.6　中断情報の運用」を参照）

3.　ナビゲーション プラットフォームのセットアップの準備

この章では，ナビゲーション プラットフォームのインストール手順とアンインストール手順，およびディレクトリサーバ構築の流れを説明します。インストール前に確認・検討する必要があることやバージョンアップについても説明します。

＜この章の構成＞

3.1　セットアップまでの流れ

3.2　システム構成

3.3　システム構築の前提条件

3.4　システムの見積もり

3.5　ナビゲーション プラットフォームのインストール

3.6　ナビゲーション プラットフォームのバージョンアップ

3.7　修正パッチの適用手順

3.8　ナビゲーション プラットフォームのアンインストール

3.9　ディレクトリサーバ（Active Directory）構築の流れ

3.1　セットアップまでの流れ

ナビゲーション プラットフォームには，業務コンテンツを作成するための編集環境および開発環境と，業務コンテンツを公開するための実行環境があります。

ここでは，各環境のセットアップまでの流れを説明します。括弧内は，詳細についての参照先を示しています。

必須：システム構成の検討，確認（3.2）

必須：前提条件の確認（3.3）

必須：データベースサーバの容量の見積もり（3.4.1）

必須：ナビゲーション プラットフォームへの同時接続数の見積もり（3.4.2）

任意：中断再開プラグインを使用する場合の容量の見積もり（3.4.3）

任意：検索機能を使用する場合の容量の見積もり（3.4.4）

必須：ナビゲーション プラットフォームの新規インストール（3.5.1，3.5.2）

任意：ディレクトリサーバの構築（3.9）

3.2　システム構成

ナビゲーション プラットフォームのシステムは，次の要素から構成されています。

ナビゲーション プラットフォームをセットアップするサーバマシン

Webブラウザ経由でナビゲーション プラットフォームの画面にアクセスするクライアントマシン

ユーザ認証用のサーバマシン

参考

ユーザ認証用の製品およびWebブラウザはナビゲーション プラットフォームに同梱されていません。別途用意してください。

サーバマシンおよびクライアントマシンの推奨スペック，使用できるWebブラウザとユーザ認証用の製品については，「3.3　システム構築の前提条件」を参照してください。

＜この節の構成＞

3.2.1　システム構成の検討

3.2.2　認証サーバ導入の検討

3.2.3　システム構成例

3.2.1　システム構成の検討

ナビゲーション プラットフォームをセットアップするサーバマシンには，実行環境（業務実行画面），編集環境（業務編集画面），および開発環境の3種類があります。編集環境または開発環境で作成した業務コンテンツに対して，利用者がアクセスするサーバマシンが実行環境です。そのため，システム構成を決める場合は，次のような点を検討する必要があります。

プラグインやカスタム画面の開発が必要かどうか

業務コンテンツを作成するユーザの人数

業務コンテンツをメンテナンス（変更）するユーザの人数

業務コンテンツを操作する利用者の人数

業務コンテンツをiPadで操作するかどうか

業務コンテンツを作成または変更してから公開するまでの時間

JP1製品と連携するかどうか（JP1連携プラグインの利用有無）

このような点を考慮した場合の例については，「3.2.3　システム構成例」を参照してください。

3.2.2　認証サーバ導入の検討

認証サーバの導入は任意です。利用者数が少なく，特定の利用者しかいない場合は，認証サーバのない構成にすることもできます。不特定多数の利用者が業務コンテンツを利用する場合は，認証サーバを導入してユーザ管理することを推奨します。

3.2.3　システム構成例

ナビゲーション プラットフォームのシステム構成例のパターンを次に示します。

参考

ここで紹介する構成例に当てはまらない構成にしたい場合は，弊社までお問い合わせください。なお，このマニュアルで説明する，ナビゲーション プラットフォームをセットアップするサーバマシンの構成は，開発環境，編集環境，および実行環境をそれぞれ1台のマシンで構成すること（「(4)　開発環境がある場合」の構成）を前提としています。

iPad向け業務コンテンツとそれ以外の業務コンテンツでは，最適な状態で利用するための設定値が異なるユーザプロパティがあります。そのため，業務コンテンツをiPadで操作する利用者がいる場合は，iPadでの表示に最適な設定で構築した，専用の実行環境を用意することを推奨します。

＜この項の構成＞

(1)　編集環境が実行環境を兼ねる場合

(2)　編集環境と実行環境を分ける場合

(3)　複数の実行環境がある場合

(4)　開発環境がある場合

(5)　JP1製品と連携する場合

(6)　各環境に含まれる機能

(1)　編集環境が実行環境を兼ねる場合

図3-1　システム構成例（編集環境が実行環境を兼ねる場合）

編集環境と実行環境を1台のサーバマシンで運用する場合，編集環境で作成した業務コンテンツを実行環境にエクスポートする作業が不要になるため，利用者が最新の業務コンテンツにアクセスできます。一方，同時にアクセスする利用者が多いとサーバの負荷が大きくなる，編集中の業務コンテンツを利用者に見せないようにグループ設定が必要になるなどの注意点もあります。

(2)　編集環境と実行環境を分ける場合

図3-2　システム構成例（編集環境と実行環境を分ける場合）

編集環境と実行環境を別のサーバマシンで運用する場合，編集環境で作成した業務コンテンツをエクスポートし，実行環境にインポートする必要があります。最新の業務コンテンツが実行環境で利用できるようになるまでに時間が掛かりますが，編集中の業務コンテンツが間違って利用者に公開されてしまう問題を防止できるため，安全です。

(3)　複数の実行環境がある場合

図3-3　システム構成例（複数の実行環境がある場合）

「(2)　編集環境と実行環境を分ける場合」の構成を応用して，実行環境を複数のサーバマシンで運用することもできます。この構成の場合，サーバの負荷軽減が期待でき，システムの可用性も高まります。なお，実行環境が複数ある場合，編集環境で作成した業務コンテンツをエクスポートし，すべての実行環境にインポートする必要があります。

(4)　開発環境がある場合

図3-4　システム構成例（開発環境がある場合）

ユーザプラグインを使用した高度な業務コンテンツを作成する場合は，ユーザプラグインを開発するための開発環境が必要です。開発環境で開発されたユーザプラグインは，まず編集環境へデプロイします。さらに，編集環境で作成した業務コンテンツを実行環境にインポートするタイミングで，実行環境にもユーザプラグインをデプロイする必要があります。

(5)　JP1製品と連携する場合

図3-5　システム構成例（JP1製品と連携する場合）

JP1連携プラグインを使用するためには，JP1/Baseによるユーザ認証が必須です。

複数の編集環境または実行環境がある場合は，各環境にJP1/Baseをインストールする必要がありますが，認証サーバは1台を共用できます。「図3-5　システム構成例（JP1製品と連携する場合）」の図の場合，編集環境のJP1/Baseを認証サーバとしているため，実行環境のJP1/Baseは編集環境の認証サーバを利用してユーザ認証を実行します。

ナビゲーション プラットフォームが利用できるJP1/Baseのバージョンなどについては，「3.3.2　ナビゲーション プラットフォームで使用できるユーザ認証の種類」を参照してください。また，JP1/Baseのユーザ認証機能および認証サーバの詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

(6)　各環境に含まれる機能

ナビゲーション プラットフォームは，開発環境，編集環境，実行環境のそれぞれに，アプリケーションサーバ，Webサーバ，DocumentBrokerサーバ，および組み込みデータベースとしての機能が含まれます。各機能について説明します。

アプリケーションサーバ

Webブラウザからのユーザ操作を処理し，データベースなどの業務システムに反映させます。

Webサーバ

Webブラウザからの要求に応じてHTMLデータなどを送信します。

DocumentBrokerサーバ

ナビゲーション プラットフォームで作成する業務コンテンツやアクセス権の情報を管理します。

組み込みデータベース

ナビゲーション プラットフォームで作成する業務コンテンツやアクセス権の情報を格納します。なお，このマニュアルでは，DocumentBrokerサーバと組み込みデータベースをまとめて文書管理サーバということもあります。

3.3　システム構築の前提条件

ナビゲーション プラットフォームのシステムを構築するときの前提条件について説明します。

＜この節の構成＞

3.3.1　ナビゲーション プラットフォームで使用するマシンの推奨マシンスペック

3.3.2　ナビゲーション プラットフォームで使用できるユーザ認証の種類

3.3.3　ナビゲーション プラットフォームで使用できるWebブラウザ

3.3.4　Webブラウザを操作するときの注意事項

3.3.1　ナビゲーション プラットフォームで使用するマシンの推奨マシンスペック

ナビゲーション プラットフォームを運用するために推奨するマシンスペックと設定を次に示します。

サーバマシンの推奨スペック※

CPU：インテル Core2 Duo　3GHz以上

メモリ：2GB以上

ハードディスク：10GB以上

クライアントマシンの推奨スペック※

CPU：インテル Core2 Duo　3GHz以上

メモリ：1GB以上

ハードディスク：1GB以上

注※

ここに示したマシンスペックには，ナビゲーション プラットフォームの運用に必要なスペック以外は含まれていません。最終的なマシンスペックを決定するときは，推奨スペックにOS稼働などに必要なスペックを追加してください。

推奨する設定

各マシンの画面の色は24ビット以上を推奨します。24ビット未満の場合，画面の色にむらが出る場合があります。

各マシンのシステムフォントのサイズは「標準」に設定してください。システムフォントのサイズを「標準」以外に設定している場合，予期しない個所で文字列が改行されるなど，正常に表示されないおそれがあります。

3.3.2　ナビゲーション プラットフォームで使用できるユーザ認証の種類

ユーザ認証を利用している環境でナビゲーション プラットフォームを運用する場合，ディレクトリサーバまたはJP1/Baseの認証サーバが必要になります。なお，ナビゲーション プラットフォームは，ユーザ認証を利用しない環境でも運用できます。

＜この項の構成＞

(1)　ディレクトリサーバによるユーザ認証

(2)　JP1/Baseによるユーザ認証

(1)　ディレクトリサーバによるユーザ認証

ディレクトリサーバによるユーザ認証で使用できるディレクトリサーバを次に示します。

推奨：Active Directory（Windows Server 2008の機能レベル）

Oracle Directory Server Enterprise Edition 11.0
Oracle Directory Serverによるユーザ認証を使用する場合，ディレクトリサーバの構築手順についてはOracle Directory Serverのドキュメントを参照してください。

ポイント

ユーザ認証を利用しない環境で運用する場合は，ログイン画面でのパスワードの入力が不要になります。業務コンテンツを作成したり削除したりする権限の有無は，ログイン時に入力したユーザIDによって決まります。システム管理者以外のユーザにも業務コンテンツを編集させたい場合の対処を次に示します。

システム管理者用のユーザIDを複数のユーザで共有する
システム管理者用のユーザIDは，セットアップ時に作成するプロパティファイルで指定できます。該当するプロパティの詳細については，「7.3.3(2)　システム管理者ID（ucnp.setup.server.docb.security.admin）」を参照してください。

システム管理者がアクセス権グループを作成して，ほかのユーザのユーザIDにコンテンツ管理者とコンテンツ編集者の権限を与える
権限の種類やアクセス権グループの作成手順については，「6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）」と「6.5　業務コンテンツのアクセス管理の流れ（ディレクトリサーバによるユーザ認証を利用している場合）」を参照してください。

(2)　JP1/Baseによるユーザ認証

JP1/Baseによるユーザ認証を使用する場合は，次の製品が必要です。

JP1/Base 10-10以降
ナビゲーション プラットフォームをインストールしたサーバマシンに，JP1/Base 10-10以降もインストールしてください。サーバマシンが複数ある場合は，それぞれのサーバマシンにJP1/Base 10-10以降が必要になります。ただし，認証サーバとして設定が必要なサーバマシンは1台だけです。複数のサーバマシンが1台の認証サーバを利用できます。
JP1連携プラグインを使用するときは，JP1/Baseによるユーザ認証が必須となります。また，JP1ユーザにJP1権限とJP1資源グループを設定することで，業務コンテンツへのアクセス権を設定することもできます。JP1権限とJP1資源グループについては，「6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）」を参照してください。

3.3.3　ナビゲーション プラットフォームで使用できるWebブラウザ

ナビゲーション プラットフォームの画面にアクセスするクライアントマシンで使用できるWebブラウザとOSの組み合わせを次に示します。なお，Webブラウザには，必ず最新の更新プログラムを適用してください。

表3-1　使用できるWebブラウザとOS

Webブラウザ名 | OS
Internet Explorer 6 | Windows XP
Internet Explorer 7 | Windows XP
Windows Vista
Internet Explorer 8 | Windows XP
Windows Vista
Windows 7
Internet Explorer 9 | Windows Vista
Windows 7
Internet Explorer 10 | Windows 7
Windows 8
モバイル用のSafari（以降，Mobile Safariと呼ぶ） | iOS 6.1

注　Internet Explorerの場合，Internet Explorer 8以降のご利用を推奨します。

3.3.4　Webブラウザを操作するときの注意事項

Webブラウザの設定と操作に関する注意事項を示します。また，OSがWindows VistaまたはWindows 7の場合に固有の注意事項についても説明します。

＜この項の構成＞

(1)　Internet Explorerの設定に関する注意事項

(2)　Internet Explorerの操作に関する注意事項

(3)　Internet Explorer 6を使用する場合の注意事項

(4)　Internet Explorer 7を使用する場合の注意事項

(5)　Internet Explorer 8またはInternet Explorer 9を使用する場合の注意事項

(6)　Windows Vista以降のOSを使用する場合の注意事項

(7)　Mobile Safariの設定に関する注意事項

(8)　Mobile Safariの操作に関する注意事項

(1)　Internet Explorerの設定に関する注意事項

更新プログラムは，最新のものを適用してください。

ナビゲーション プラットフォームを使用するときは，Webブラウザの文字サイズを「中」以下に設定することを推奨します。文字サイズを「中」より大きくすると，Webブラウザに表示される文字が欠けるおそれがあります。

Webブラウザのインターネット一時ファイルの設定は「自動的に確認する」を推奨します。「自動的に確認する」以外に設定すると，画像が正常に表示されないおそれがあります。

Webブラウザの［互換表示］ボタンは無効にしてください。有効にすると，画面の表示が崩れることがあります。

Webブラウザの操作中に，一部のスクリプトが動作しない場合があります。この場合は，必要に応じてWebブラウザの［インターネットオプション］の［セキュリティ］の設定を確認し，ナビゲーション プラットフォームのURLを「信頼済みサイト」に追加してください。ただし，この設定によってセキュリティレベルが下がるため，注意してください。

Webブラウザの［インターネットオプション］の［セキュリティ］の次の項目は，「有効にする」に設定してください。これらの設定を有効にしておかないと，ナビゲーション プラットフォームの画面の表示や機能が一部不正になります。

「バイナリビヘイビアーとスクリプトビヘイビアー」

「アクティブスクリプト」

「スクリプトによる貼り付け処理の許可」

インラインフレームパーツで指定した外部のWebサイトが表示されない場合があります。表示されるかどうかは，指定した外部のWebサイトの設定によって異なります。

(2)　Internet Explorerの操作に関する注意事項

同じPCから複数のアカウントでナビゲーション プラットフォームにログインしないでください。

ナビゲーション プラットフォームの操作では，Webブラウザの［戻る］ボタンを使用しないでください。最新の情報が表示されない場合があります。

業務実行中に＜F5＞キーやWebブラウザの［更新］ボタンを使用して画面を更新しないでください。保存していない入力途中のデータが破棄されるなど，正常に動作しないおそれがあります。

テキストボックスに1,025文字以上の文字列を入力した場合，入力した文字列が部分的に表示されない場合があります。テキストボックスの最大入力文字数は，1,024文字以下を目安に設定することを推奨します。

Webブラウザを操作中に次のメッセージが表示された場合，［キャンセル］ボタンをクリックして実行を続けてください。［OK］ボタンをクリックして中断した場合，正常に動作しないことがあります。
「このページのスクリプトが，Internet Explorerの実行速度を遅くしています。スクリプトを実行し続けると，コンピュータが反応しなくなる可能性があります。スクリプトを中断しますか？」

Webブラウザを操作中に次のメッセージが表示された場合，［Webページの回復］ボタンをクリックしないで，処理が終了するまで待ってください。［Webページの回復］ボタンをクリックして処理を中断した場合，正常に動作しないことがあります。
「ホスト名は応答していません。」

メッセージダイアログに表示されるメッセージが画面の下をはみ出して，［OK］ボタンをクリックできない状態になった場合，次のどちらかの操作でメッセージダイアログを閉じてください。

メッセージダイアログの［×］ボタンをクリックする。

メッセージダイアログにフォーカスが当たっていることを確認して，＜Enter＞キーまたは＜Esc＞キーを押す。

Webブラウザの印刷プレビュー画面を［×］ボタンで閉じた場合は，印刷しようとした画面が閉じなくなることがあります。この場合は，印刷しようとした画面を［×］ボタンで閉じてください。

業務編集画面または業務実行画面を閉じる場合は，［×］ボタンではなく［閉じる］ボタンまたは［ログアウト］ボタンを使用してください。ログアウトしないでWebブラウザを閉じると，キャッシュデータおよび保存していないデータは破棄されます。ただし，Webブラウザの印刷プレビューを表示したあとで［閉じる］ボタンをクリックすると，画面に何も表示されなくなり，Webブラウザが閉じなくなることがあります。この場合は，［×］ボタンでWebブラウザを閉じてください。

同じWebブラウザから繰り返しナビゲーション プラットフォームを操作した場合，Windowsから次の警告メッセージが表示されることがあります。
「仮想メモリ不足 システムの仮想メモリが少なくなってきています。Windowsが正しく動作するために，仮想メモリ ページ ファイルのサイズを増やしてください。詳細はヘルプを参照してください。」
メッセージが表示された場合は，Webブラウザを閉じて，再起動してください。

(3)　Internet Explorer 6を使用する場合の注意事項

配置した順序とは関係なく，次のパーツは常にほかのパーツよりも前面に表示されます。

ドロップダウンパーツ

インラインフレームパーツのドロップダウン

HTMLパーツのドロップダウン

業務編集画面でドロップダウンパーツを削除すると，画面がちらつく場合があります。

業務編集画面のガイド領域をホイールマウスでスクロールすると，ドロップダウンパーツが正しく表示されない場合があります。この場合は，いったん別のノードを選択するなどして，画面を切り替えてください。なお，ドロップダウンパーツの表示が正しくない状態でも，業務実行画面での操作には影響はありません。

業務編集画面では，インラインフレームパーツのドロップダウンおよびHTMLパーツのドロップダウンを操作しないでください。操作すると，パーツの編集に失敗することがあります。

(4)　Internet Explorer 7を使用する場合の注意事項

ズーム機能を使用して画面の表示内容を拡大すると，スクロールバーに文字が重なる場合があります。

(5)　Internet Explorer 8またはInternet Explorer 9を使用する場合の注意事項

ズーム機能を使用して画面の表示内容を拡大すると，スクロールバーに文字が重なる場合があります。

インラインフレームパーツで指定した外部のWebサイトが表示されない場合があります。表示されるかどうかは，指定した外部のWebサイトの設定によって異なります。

ブラウザの［互換表示］ボタンは無効にしてください。有効にすると，画面の表示が崩れるおそれがあります。

(6)　Windows Vista以降のOSを使用する場合の注意事項

ナビゲーション プラットフォームは，Windows Vistaから拡張された文字（JIS X0213）に含まれる，Unicodeの補助文字には対応していません。

ナビゲーション プラットフォームが対応していない文字を次に示します。

基本多言語面（BMP）以外の文字

UnicodeのコードポイントU+10000～U+10FFFFの文字

UTF-16エンコーディングのサロゲート・ペアで表される文字

(7)　Mobile Safariの設定に関する注意事項

［JavaScript］は［オン］に設定してください。

［プライベートブラウズ］は［オフ］に設定してください。［プライベートブラウズ］が［オン］の状態でナビゲーション プラットフォームにログインしたあとに，［オフ］に変更した場合は，いったんログアウトしてログインし直す必要があります。

［Cookieを受け入れる］は［訪問先のみ］に設定することを推奨します。［常に］を設定するとセキュリティレベルが下がります。

(8)　Mobile Safariの操作に関する注意事項

Mobile Safariで参照している業務実行画面に［印刷］メニューが表示されていたとしても，［印刷］メニューをクリックしたときの動作は保証されません。

操作中に10秒以上応答がない場合は，ページをリロードして操作をやり直してください。

通信中にエラーが発生したというメッセージやセッションが無効であるというメッセージが表示された場合は，メッセージに従って操作をやり直してください。操作をやり直しても問題が解決しないときは，ネットワークの接続状態を確認してください。Wi-Fiをいったんオフにしてから再度オンにすると，ネットワークの接続状態が正常に回復することもあります。

Mobile Safariをバックグラウンドで実行している場合，または業務コンテンツを操作中にiPadがスリープモードになった場合などは，セッションが切れることがあります。セッションが切れると操作途中のデータは失われます。また，業務コンテンツを操作中に，ほかの業務コンテンツを参照したり，ナビゲーション プラットフォーム以外のページを表示したりした場合も，操作途中のデータは失われます。
なお，システム構築時の設定によっては，業務実行画面に［一時中断］ボタンが表示されています。［一時中断］ボタンをクリックしてログアウトしておけば，セッションが切れたり，ほかのページを表示したりしても，ボタンをクリックした時点までの操作のデータは保存されています。

テキストボックスおよびテキストエリアに表示されている文字列を，カット＆ペーストまたはコピー＆ペーストすることはできません。

ソフトウェアキーボードが表示された状態では，次の操作をしないでください。

テキストボックスまたはテキストエリアを長押しする。

ソフトウェアキーボード以外の領域をスクロールさせる。

ソフトウェアキーボード以外の領域をタップする。

ソフトウェアキーボードが表示された状態でこれらの操作を実行すると，その後テキスト入力ができなくなります。再度テキスト入力をするには，ソフトウェアキーボードをいったん閉じてから再表示してください。

テキストボックスおよびテキストエリアに半角英数字を入力する場合，先頭の文字は自動的に大文字になります。先頭の文字を小文字にしたい場合は，＜Shift＞キーを解除してください。

テキストボックスおよびテキストエリアに絵文字を入力すると，文字化けするおそれがあります。

オートコレクト機能によって表示される修正候補の単語は，選択しないでください。修正候補の単語をタップすると，その後テキスト入力ができなくなります。再度テキスト入力をするには，ソフトウェアキーボードをいったん閉じてから再表示してください。

ソフトウェアキーボード以外の領域をタップしても，ソフトウェアキーボードが非表示にならない場合は，ソフトウェアキーボード右下の端にあるボタンをタップしてください。

3.4　システムの見積もり

ナビゲーション プラットフォームの運用に必要な，データベースサーバの容量，ナビゲーション プラットフォームへの同時接続数，および中断再開プラグインを使用する場合の容量の見積もり方法について説明します。また，検索機能を使用する場合に必要なデータベースサーバの容量を見積もる方法についても説明します。

＜この節の構成＞

3.4.1　データベースサーバの容量の見積もり

3.4.2　ナビゲーション プラットフォームへの同時接続数の見積もり

3.4.3　中断再開プラグインを使用する場合の容量の見積もり

3.4.4　検索機能を使用する場合の容量の見積もり

3.4.5　メモリ使用量の見積もりに関する注意事項

3.4.1　データベースサーバの容量の見積もり

ナビゲーション プラットフォームで運用する業務コンテンツの規模に応じて，データベースサーバの容量を見積もります。

＜この項の構成＞

(1)　見積もりに必要な情報の準備

(2)　ガイドパーツの容量の見積もり

(3)　プラグインの容量の見積もり

(4)　1業務コンテンツの容量の見積もり

(5)　RDエリアのセグメント数の見積もり

(6)　HiRDBファイルシステム領域の容量の見積もり

(7)　データベースサーバの容量見積もり例

(1)　見積もりに必要な情報の準備

データベースサーバの容量を見積もるには，次の情報が必要です。

業務コンテンツの数

1業務コンテンツの容量

システムで作成できる業務コンテンツの数は最大500個です。また，1業務コンテンツの容量を算出するには，次の情報が必要です。複数の業務コンテンツを運用する場合，標準的な業務コンテンツをモデルケースに選んでください。

表3-2　1業務コンテンツの容量の算出に必要な情報

項番 | 分類 | 算出に必要な情報 | 説明
1 | ノード | 1業務コンテンツ当たりのノード数 | プロセスノード，ターミナルノード，および分岐合流ノードの合計です。※1
2 | ドロップダウンパーツ | 1ガイド当たりのドロップダウンパーツ数 | 1業務コンテンツに複数のガイドがある場合，各ガイドの平均値を求めてください。
3 | 1ドロップダウンパーツ当たりのラベル数※2 | ドロップダウンの選択項目の数です。1ガイドに複数のドロップダウンパーツがある場合，各ドロップダウンパーツの平均値を求めてください。
4 | 1ラベル当たりの文字数※2（単位：バイト） | 全ラベルの平均値を求めてください。
5 | ドロップダウンの親子関係の有無 | ドロップダウンの親子関係については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。
6 | 固定テキストパーツ | 1ガイド当たりの固定テキストパーツ数 | 1業務コンテンツに複数のガイドがある場合，各ガイドの平均値を求めてください。
7 | 1固定テキストパーツ当たりの表示文字数（単位：バイト） | 1ガイドに複数の固定テキストパーツがある場合，平均値を求めてください。
8 | その他のガイドパーツ | 1ガイド当たりのその他のガイドパーツ数 | ドロップダウンパーツ・固定テキストパーツ以外のガイドパーツの数です。1業務コンテンツに複数のガイドがある場合，各ガイドの平均値を求めてください。
9 | ユーザプラグイン※3 | 1業務コンテンツに適用するユーザプラグインとJP1連携プラグインの総数 | ユーザプラグインおよびJP1連携プラグインの総数です。データストアプラグインは含みません。
10 | 入力パラメタ数 | 1業務コンテンツに適用するユーザプラグインとJP1連携プラグインの平均値を求めてください。
11 | 出力パラメタ数

注※1

画像を配置しているプロセスノードは，画像パーツとして見積もります。この表では項番8として見積もってください。

注※2

ドロップダウンパーツのラベル，および1ラベル当たりの文字数の考え方を次に示します。

注※3

09-00からバージョンアップする場合は，プラグインの数を実際の2倍と仮定して見積もりし直してください。

以降では，準備した情報を基にデータベースサーバの容量を見積もる手順，および見積もり例について説明します。

参考

ナビゲーション プラットフォームをセットアップすると，データベースサーバの容量は自動的に4,679MBに設定されます。4,679MBのデータベースサーバで運用できる業務コンテンツの規模の目安を次の表に示します。

項番 | 分類 | 算出に必要な情報 | 値
1 | ノード | 1業務コンテンツ当たりのノード数 | 20
2 | ドロップダウンパーツ | 1ガイド当たりのドロップダウンパーツ数 | 5
3 | 1ドロップダウンパーツ当たりのラベル数 | 10
4 | 1ラベル当たりの文字数（単位：バイト） | 55
5 | ドロップダウンの親子関係の有無 | なし
6 | 固定テキストパーツ | 1ガイド当たりの固定テキストパーツ数 | 15
7 | 1固定テキストパーツ当たりの表示文字数（単位：バイト） | 60
8 | HTMLパーツ | 1ガイド当たりのHTMLパーツの数 | 3
9 | 1HTMLパーツ当たりのHTMLソース文字列のバイト数 | 7,400
10 | 1HTMLパーツ当たりの検索キーワード文字列のバイト数 | 1,200
11 | その他のガイドパーツ | 1ガイド当たりのその他のガイドパーツ数 | 15
12 | ユーザプラグイン | 1業務コンテンツに適用するユーザプラグインとJP1連携プラグインの総数 | 40
13 | 入力パラメタ数 | 20
14 | 出力パラメタ数 | 20

業務コンテンツの規模がこの表よりも小さい場合，セットアップ後のデータベースの拡張は不要です。したがって，(2)以降の見積もりも不要になります。

(2)　ガイドパーツの容量の見積もり

1業務コンテンツの容量を見積もるために，1業務コンテンツ当たりのガイドパーツの容量を見積もります。ガイドパーツの容量は，次の計算式で算出してください。

ガイドパーツの容量＝(4,000＋ドロップダウンパーツの容量＋固定テキストパーツの容量＋HTMLパーツの容量＋その他のガイドパーツの容量)×ノード数 （単位：バイト）

業務コンテンツで使用しないガイドパーツがある場合，その容量は0で計算してください。ドロップダウンパーツの容量，固定テキストパーツの容量，およびその他のガイドパーツの容量を見積もる方法を次に示します。

(a)　ドロップダウンパーツの容量

ドロップダウンに親子関係がない場合

ドロップダウンパーツの容量は，次の計算式で算出してください。

ドロップダウンパーツの容量＝(700＋2×(100＋1ラベル当たりの文字数)×1ドロップダウンパーツ当たりのラベル数)×1ガイド当たりのドロップダウンパーツ数 （単位：バイト）

ドロップダウンに親子関係がある場合

ドロップダウンパーツの容量は，次の計算式で算出してください。

ドロップダウンパーツの容量＝(700＋(700＋2×(100＋1ラベル当たりの文字数)×1ドロップダウンパーツ当たりのラベル数)×1ドロップダウンパーツ当たりのラベル数)×1ガイド当たりのドロップダウンパーツ数 （単位：バイト）

(b)　固定テキストパーツの容量

1固定テキストパーツ当たりの表示文字数が300バイト以下の場合

固定テキストパーツの容量は，次の計算式で算出してください。

固定テキストパーツの容量＝1,300×1ガイド当たりの固定テキストパーツ数 （単位：バイト）

1固定テキストパーツ当たりの表示文字数が300バイトより大きい場合

固定テキストパーツの容量は，次の計算式で算出してください。

固定テキストパーツの容量＝(1,000＋1固定テキストパーツ当たりの表示文字数)×1ガイド当たりの固定テキストパーツ数 （単位：バイト）

(c)　HTMLパーツの容量

1HTMLパーツ当たりのHTMLソース文字列のバイト数が7,400バイト以下の場合

HTMLパーツの容量は，次の計算式で算出してください。

HTMLパーツの容量＝9,900×1ガイド当たりのHTMLパーツの数（単位：バイト）

1HTMLパーツ当たりのHTMLソース文字列のバイト数が7,400バイトより大きい場合

HTMLパーツの容量は，次の計算式で算出してください。

HTMLパーツの容量＝（2,500＋1ガイド当たりのHTMLソース文字列のバイト数）×1ガイド当たりのHTMLパーツの数（単位：バイト）

(d)　その他のガイドパーツの容量

その他のガイドパーツの容量は，次の計算式で算出してください。

その他のガイドパーツの容量＝1,300×1ガイド当たりのその他のガイドパーツ数 （単位：バイト）

(3)　プラグインの容量の見積もり

1業務コンテンツの容量を見積もるために，1業務コンテンツ当たりのプラグインの容量を見積もります。プラグインの容量は，次の計算式で算出してください。

プラグインの容量＝(2,200＋(1,500×入力パラメタ数)+(900×出力パラメタ数))×(1業務コンテンツに適用するユーザプラグインとJP1連携プラグインの総数＋ノード数)＋(600×1ノードに配置するガイドパーツ数×ノード数)（単位：バイト）

(4)　1業務コンテンツの容量の見積もり

1業務コンテンツの容量は，次の計算式で算出してください。

1業務コンテンツの容量＝86,200＋ガイドパーツの容量＋プラグインの容量（単位：バイト）

(5)　RDエリアのセグメント数の見積もり

RDエリアのセグメント数は，次の計算式で算出してください。

RDエリアのセグメント数＝↑1業務コンテンツの容量÷8,192↑×業務コンテンツ数×1.4

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

(6)　HiRDBファイルシステム領域の容量の見積もり

HiRDBファイルシステム領域の容量は，次の計算式で算出してください。

HiRDBファイルシステム領域＝↑(RDエリアのセグメント数×8,192)÷1,024÷1,024↑×1.3 （単位：MB）

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

(7)　データベースサーバの容量見積もり例

次に示す見積もり条件を基に，データベースサーバの容量を見積もる例を示します。

見積もり条件

業務コンテンツ数は500である。

1業務コンテンツの容量を見積もるのに必要な情報は次のとおりである。

項番 | 分類 | 算出に必要な情報 | この例での設定値
1 | ノード | 1業務コンテンツ当たりのノード数 | 20
2 | ドロップダウンパーツ | 1ガイド当たりのドロップダウンパーツ数 | 5
3 | 1ドロップダウンパーツ当たりのラベル数 | 10
4 | 1ラベル当たりの文字数（単位：バイト） | 55
5 | ドロップダウンの親子関係の有無 | なし
6 | 固定テキストパーツ | 1ガイド当たりの固定テキストパーツ数 | 15
7 | 1固定テキストパーツ当たりの表示文字数（単位：バイト） | 60
8 | HTMLパーツ | 1ガイド当たりのHTMLパーツの数 | 3
9 | 1HTMLパーツ当たりのHTMLソース文字列のバイト数 | 7,400
10 | 1HTMLパーツ当たりの検索キーワード文字列のバイト数 | 1,200
11 | その他のガイドパーツ | 1ガイド当たりのその他のガイドパーツ数 | 15
12 | ユーザプラグイン | 1業務コンテンツに適用するユーザプラグインとJP1連携プラグインの総数 | 40
13 | 入力パラメタ数 | 20
14 | 出力パラメタ数 | 20

見積もり例

ガイドパーツの容量の見積もり例

(4,000＋19,000＋19,500＋29,700＋19,500)×20＝1,834,000バイト

ドロップダウンパーツの容量
(700＋(2×(100＋55)×10))×5＝19,000バイト

固定テキストパーツの容量
1,300×15＝19,500バイト

HTMLパーツの容量
9,900×3＝29,700バイト

その他のガイドパーツの容量
1,300×15＝19,500バイト

プラグインの容量の見積もり例

(2,200＋(1,500×20)+(900×20))×(40+20)+(600×(5+15+3+15)×20)＝3,468,000バイト

1業務コンテンツの容量の見積もり例

86,200＋1,834,000＋3,468,000＝5,388,200バイト

RDエリアのセグメント数の見積もり例

↑5,388,200÷8,192↑×500×1.4＝460,600

HiRDBファイルシステム領域の容量の見積もり例

↑(460,600×8,192)÷1,024÷1,024↑×1.3＝4,679MB

3.4.2　ナビゲーション プラットフォームへの同時接続数の見積もり

ナビゲーション プラットフォームでは，利用するユーザ数の増加に伴い，リソースへのアクセスも増えます。運用中のリソース不足を防ぐために，ナビゲーション プラットフォームへ同時に接続するユーザ数に応じて，システム構築時の設定値を決めてください。

システム構築時の設定値を決めるには，次の情報が必要です。

同時ログイン数（同時に画面を開いているユーザ数）

同時実行数（同時に画面を操作するユーザ数）

ナビゲーション プラットフォームへの同時接続数に応じてユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定値が変わる項目，およびそれぞれの設定値を次に示します。

表3-3　同時接続数に応じて設定値が変わる項目

項番 | 項目 | 設定値※
同時ログイン数
1～10 | 11～250
同時実行数
1～4 | 5～10
1 | データベースサーバへの最大同時接続数 | 10 | 22
2 | DocumentBrokerサーバのサービスプロセス数 | 1 | 2
3 | DocumentBrokerサーバのDBコネクションプール数 | 4 | 5
4 | アプリケーションサーバの最大同時実行スレッド数 | 4 | 10

注※

同時ログイン数と同時実行数とで，選択する設定値の列が異なる場合，設定値が大きい方の列に合わせてください。

例えば，同時ログイン数が10人，同時実行数が8人の場合，同時実行数に合わせて，右の列を設定値とします。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の次のプロパティに，ナビゲーション プラットフォームの同時接続数に応じた値を設定してください。番号は表3-3の項番と対応しています。なお，デフォルト値のままでセットアップした場合，同時ログイン数が1～10の場合の設定値となります。

ucnp.setup.server.db.middle.pd_max_usersプロパティ（データベースサーバへの最大同時接続数）

ucnp.setup.server.docb.processプロパティ（DocumentBrokerサーバのサービスプロセス数）

ucnp.setup.server.docb.dbconnection.pool.countプロパティ（DocumentBrokerサーバのDBコネクションプール数）

ucnp.setup.server.cosminexus.webserver.connector.ajp13.max_threadsプロパティ（アプリケーションサーバの最大同時実行スレッド数）

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）については，「7.3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定」を参照してください。

3.4.3　中断再開プラグインを使用する場合の容量の見積もり

中断再開プラグインを使用する場合は，中断情報を管理する外部記憶装置（データベースなど）を準備します。中断情報を管理する外部記憶装置は任意ですが，ナビゲーション プラットフォームの組み込みデータベースとは別に，中断情報に必要な容量を確保する必要があります。

ここでは，中断情報の管理単位について説明します。また，中断情報の容量を見積もる方法および見積もり例について説明します。

＜この項の構成＞

(1)　中断情報の管理単位

(2)　中断情報の容量の見積もり手順

(3)　中断情報の容量見積もり例

(1)　中断情報の管理単位

外部記憶装置に保存する中断情報の管理単位を決定します。

次の図に，利用者および業務コンテンツごとに一つの中断情報を管理する例を示します。この例では，ユーザIDと業務コンテンツIDをユニークにして，各利用者が業務ごとに一つの中断情報を保持できるようにしています。

図3-6　利用者と中断情報の関係

ナビゲーション プラットフォームが提供するAPIを利用して中断再開プラグインを開発した場合，中断情報の削除は次のタイミングで実行されます。

利用者が業務実行画面で［完了］ボタンをクリックしたとき（業務完了時）
完了した業務コンテンツに関する，業務を完了したユーザの中断情報が削除されます。

業務コンテンツを作成するユーザが業務編集画面で業務コンテンツを編集して［保存］ボタンをクリックしたとき
編集した業務コンテンツに関する，すべてのユーザの中断情報が削除されます。

業務コンテンツを作成するユーザが［関連リンクの設定］画面で関連リンクを編集して更新したとき
関連リンクを編集した業務コンテンツに関する，すべてのユーザの中断情報が削除されます。

業務コンテンツを作成するユーザが業務編集画面で業務コンテンツを削除したとき
削除した業務コンテンツに関する，すべてのユーザの中断情報が削除されます。

利用者が業務実行画面で業務を再開しようとして，整合性エラーが発生したとき
中断情報を保存した時点から業務コンテンツが更新されていると，整合性エラーが発生します。このとき，選択した業務コンテンツに関する，業務コンテンツを選択したユーザの中断情報が削除されます。

ドロップダウンの選択項目を一括設定するCSVファイルで業務コンテンツを更新したとき
業務編集画面で次の操作を実行したときに，CSVファイルの内容が業務コンテンツに反映されて，その業務コンテンツに関するすべてのユーザの中断情報が削除されます。

業務コンテンツを表示する（業務編集画面のメニュー領域で業務コンテンツを選択する，基本URLにコンテンツIDを指定して業務編集画面を開く，または［関連リンクの設定］画面で［更新］ボタンをクリックしたタイミングで自動的に業務コンテンツが開く）

［業務コンテンツの複製］画面で，業務コンテンツを複製する

［関連リンクの設定］画面を開く

［関連リンクの設定］画面で，関連リンクの内容を更新する

プラグインを開発するユーザが業務編集画面でプラグインパーツを更新したとき
更新した業務コンテンツに関する，すべてのユーザの中断情報が削除されます。

(2)　中断情報の容量の見積もり手順

中断情報のデータサイズは次の手順で見積もります。

業務コンテンツの種類ごとに，中断情報1件当たりのデータサイズを見積もります。

各業務コンテンツで同時に保存する中断情報の最大数を見積もります。

手順1，2から必要なデータサイズを見積もります。

中断情報1件当たりのデータサイズは次の計算式で算出してください。

中断情報1件当たりのデータサイズ＝60＋70×(ガイドパーツ数＋データストアプラグインのパラメタ数)（単位：KB）

(3)　中断情報の容量見積もり例

次に示す見積もり条件を基に，中断情報の容量を見積もる例を示します。

見積もり条件

ガイドパーツが50個ある業務コンテンツAと，ガイドパーツが100個ある業務コンテンツBがある。

業務コンテンツAに関連づけられているデータストアプラグインのパラメタ数は30個である。

業務コンテンツBに関連づけられているデータストアプラグインのパラメタ数は60個である。

業務コンテンツAおよび業務コンテンツBは，中断情報をユーザ単位に保存する。

業務コンテンツAは1,000ユーザが利用し，業務コンテンツBは30ユーザが利用する。

見積もり例（データサイズ）

（60＋70×(50+30)）×1,000＋（60＋70×(100+60)）×30＝5,997,800KB≒5.8GB

3.4.4　検索機能を使用する場合の容量の見積もり

検索機能を使用する場合は，ナビゲーション プラットフォームの組み込みデータベースに検索機能用のテーブルを追加する必要があります。ここでは，検索機能を使用する場合のデータベースサーバの容量を見積もる方法について説明します。

注意

ここで説明する内容は，ナビゲーション プラットフォームのセットアップが一とおり完了していることが前提です。

＜この項の構成＞

(1)　見積もりに必要な情報の準備

(2)　RDエリアのセグメント数の見積もり

(3)　HiRDBファイルシステム領域の容量の見積もり

(1)　見積もりに必要な情報の準備

業務コンテンツのセグメント数を確認します。セグメント数を確認する手順を次に示します。

次のコマンドを実行して，データベースの状態を確認します。

pddbst -r LOB_CONTENTS01 -k phys -f -u 認可識別子 -p パスワード

可変値

認可識別子

データベース管理者権限を持つユーザ名を指定します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.idプロパティに指定したユーザ名です。デフォルト値は「ADMIN」です。

パスワード

認可識別子のパスワードを指定します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.passwordプロパティに指定したパスワードです。デフォルト値は「UCNPPASS」です。

戻り値

0：正常終了

4：警告終了（指定不正，または解析処理スキップ）

8：異常終了

コマンド実行例

pddbst -r LOB_CONTENTS01 -k phys -f -u ADMIN -p UCNPPASS

コマンドの実行結果を基に，業務コンテンツのセグメント数を確認します。
コマンドの実行結果の例を次に示します。赤い枠で囲んだ「Max Sum Segment」の部分が，業務コンテンツのセグメント数です。

(2)　RDエリアのセグメント数の見積もり

検索用データのセグメント数，および検索用データのインデックスのセグメント数を見積もります。セグメント数は，次の計算式で算出してください。

検索用データのセグメント数

検索用データのセグメント数＝↑0.04×業務コンテンツのセグメント数↑

検索用データのインデックスのセグメント数

検索用データのインデックスのセグメント数＝↑0.8×業務コンテンツのセグメント数↑

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

(3)　HiRDBファイルシステム領域の容量の見積もり

次に示すHiRDBファイルシステム領域の容量を見積もります。

検索用データが格納されるHiRDBファイルシステム領域

検索用データのファイルシステム領域＝↑検索用データのセグメント数×22×8,192÷1,024÷1,024↑（単位：MB）

検索用データのインデックスが格納されるHiRDBファイルシステム領域

検索用データのインデックスのファイルシステム領域＝↑検索用データのインデックスのセグメント数×1.1×8,192÷1,024÷1,024↑（単位：MB）

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

3.4.5　メモリ使用量の見積もりに関する注意事項

次の条件に当てはまる場合，ナビゲーション プラットフォームのセットアップ後に，JavaVMのメモリ使用量を1,024MB以上に変更してください。

ナビゲーション プラットフォームの実行環境で，同時実行数を5～10に変更した場合

ユーザが作成したプラグインを利用する場合

ナビゲーション プラットフォームのメモリ使用量は，J2EEサーバ起動パラメタで変更できます。実行環境では，［起動パラメタの設定］画面の「メモリ使用量」の［初期サイズ］と［最大サイズ］に，同じ値を指定することを推奨します。

変更手順については，マニュアル「Cosminexus V9 アプリケーションサーバ 運用管理ポータル操作ガイド」の起動パラメタの設定に関する説明を参照してください。

また，JavaVMのメモリチューニングについては，マニュアル「Cosminexus V9 アプリケーションサーバ システム設計ガイド」を参照してください。

3.5　ナビゲーション プラットフォームのインストール

ここでは，ナビゲーション プラットフォームを新規にインストールする手順，およびインストール後のディレクトリ構成について説明します。

なお，ナビゲーション プラットフォームをバージョンアップする場合で，バージョンアップ前の環境を移行し，バージョンアップ後もそのまま使用したいときには，「3.6.2　バージョンアップ手順」を参照してください。

＜この節の構成＞

3.5.1　インストール前に確認すること

3.5.2　新規インストール手順

3.5.3　ナビゲーション プラットフォームのディレクトリ構成

3.5.1　インストール前に確認すること

マシンにログインするユーザ

インストールとセットアップは，必ずWindowsの管理者権限があるユーザで実施してください。Windows XP以外のOSの場合は，［管理者として実行］を選択して操作を開始する必要があります。

マシンの条件

IPv4をサポートしている必要があります。その他のスペックについては，「3.3.1　ナビゲーション プラットフォームで使用するマシンの推奨マシンスペック」のサーバマシンのスペックを参照してください。

ディスクの空き容量

ナビゲーション プラットフォームをインストールするディスクには，10GB以上の空き容量が必要です。

ディスクの空き容量は，余裕を持って確保することを推奨します。必要最低限の空き容量しかない場合，運用を開始してすぐに容量が不足してしまうなどのトラブルが発生するおそれがあります。

Windows Firewallのサービスの状態

Windows Firewallのサービスが起動していることを確認します。Windows Firewallのサービスが停止していると，インストール処理が中断してしまいます。

インストール先のディレクトリ

インストール先のディレクトリには，次に示す条件があります。条件を満たさない場合，動作は保証されません。

ディレクトリには，次の文字だけを使用し，50文字以内になるようにしてください。
半角英数字（A～Z，a～z，0～9）
半角スペース
半角アンダースコア（_）
半角ハイフン（-）
半角ピリオド（.）

パス区切り文字には「¥」を使用します。「¥¥」は使用できません。

Windows Server 2008 R2（x64）またはWindows Server 2008（x64）でデフォルトのディレクトリにインストールする場合は，上記のインストール先のディレクトリに使用できる文字に加えて，半角丸括弧も使用できます。

ネットワークドライブまたはドライブの直下をインストール先に指定しないでください。

ディレクトリ名の先頭または末尾には半角スペースを含めないでください。

インストール先ディレクトリのパスに半角スペースを含める場合，パスの先頭から半角スペース直前までのパスと同じパスを持つファイルまたはディレクトリとは，共存できません。例えば，「C:¥Program」というディレクトリが存在する場合，「C:¥Program Files」をインストール先ディレクトリに指定することはできなくなります。

半角ピリオド（.）で始まるディレクトリを含めないでください。

3.5.2　新規インストール手順

ここでは，日立総合インストーラを使用して新規にナビゲーション プラットフォームをインストールする手順を説明します。開発環境，編集環境，および実行環境にナビゲーション プラットフォームをインストールします。なお，統合インストーラを使うと，ナビゲーション プラットフォームの構成ソフトウェアも一括してインストールできます。

注意

インストール操作は，Windowsの管理者権限がある状態で実施する必要があります。Windows XP以外のOSの場合は，［管理者として実行］を選択して操作を開始してください。

1台のマシンにはuCosminexus Navigation Developer，uCosminexus Navigation Platform - Authoring License，またはuCosminexus Navigation Platformのどれか一つだけをインストールしてください。複数の製品を1台のマシンにインストールすることはできません。

このマニュアルでは，構成ソフトウェアのうち，uCosminexus Navigation Platform - Core ServerおよびuCosminexus Navigation Developer - Core Serverのインストール手順を説明します。ほかの構成ソフトウェアのインストール手順については，各構成ソフトウェアのドキュメントを参照してください。

CD-ROMを挿入し，HCD_INST.EXEを実行します。

［続行］ボタンをクリックして，日立総合インストーラから統合インストーラを起動します。
インストール製品一覧画面に，対応する製品の構成ソフトウェアが表示されます。

インストールしたい構成ソフトウェアを選択します。
構成ソフトウェアを一括してインストールする場合は，［全選択］ボタンをクリックしてください。
構成ソフトウェアは，すべてを必ずインストールしてください。構成ソフトウェアについては，「1.1.3　構成ソフトウェア」を参照してください。

設定内容を確認し，［インストール実行］ボタンをクリックしてインストールを開始します。
ナビゲーション プラットフォームに必要なソフトウェアが順番にインストールされます。

インストール開始画面で［次へ］ボタンをクリックします。
インストール先の選択画面が表示されます。

インストール先を指定します。
デフォルトのインストール先ディレクトリは次のとおりです。

64ビット版OSの場合

OSのインストールドライブ:¥Program Files(x86)¥Hitachi¥uCNP

32ビット版OSの場合

OSのインストールドライブ:¥Program Files¥Hitachi¥uCNP

特に必要がないかぎり，デフォルトで表示されるディレクトリをインストール先とすることを推奨します。別のディレクトリにインストールしたい場合は，［参照］ボタンをクリックしてディレクトリを選択してください。

［次へ］ボタンをクリックします。
ユーザ情報の設定画面が表示されます。

ユーザ名および会社名を入力し，［次へ］ボタンをクリックします。
プログラムフォルダの選択画面が表示されます。

スタートメニューのプログラムに登録するプログラムフォルダを選択します。
デフォルトは，製品の種類に関係なく「uCosminexus Navigation Platform」です。
別のフォルダにしたい場合は，任意のフォルダ名を入力するか，または既存のフォルダリストからディレクトリを選択します。

［次へ］ボタンをクリックします。
インストールの開始画面が表示されます。

インストール情報を確認します。
現在の設定内容が表示されます。設定を変更したい場合は，［戻る］ボタンをクリックして，設定を変更してください。
［次へ］ボタンをクリックすると，インストールの進捗状況が表示されます。
インストールが完了すると，インストールが完了したことを知らせるダイアログが表示されます。

インストール完了の画面を確認し，画面を閉じます。

サーバマシンを再起動します。

必要に応じて，修正パッチを適用します。
修正パッチの適用手順については，「3.7　修正パッチの適用手順」を参照してください。

注意事項

インストールをキャンセルしたり，処理中にエラーが発生したりした場合，ナビゲーション プラットフォームが不完全な状態でインストールされてしまうことがあります。その場合は，インストールを最初からやり直すか，いったん「3.8　ナビゲーション プラットフォームのアンインストール」に従ってアンインストールしてから再度インストールを実施してください。

3.5.3　ナビゲーション プラットフォームのディレクトリ構成

ナビゲーション プラットフォームの構成ソフトウェアをすべてデフォルトのインストール先にインストールした場合のディレクトリ構成を次に示します。

OSのインストールドライブ:¥Program Files¥Hitachi
　├Cosminexus
　├CosmiPortal
　├ECMPKG
　│　└PP
　│　　└hirdb_e_EP0
　└uCNP

このマニュアルでは，これらのディレクトリを次のように表記します。なお，この表ではOSをCドライブにインストールしたものとしています。

表3-4　マニュアルでの表記と実際のディレクトリとの対応

マニュアルでの表記
実際のディレクトリ

Cosminexusインストールディレクトリ
uCosminexus Application ServerまたはuCosminexus Developerのインストールディレクトリです。

デフォルトのインストール先

C:¥Program Files¥Hitachi¥Cosminexus

uCosminexus Portal Frameworkインストールディレクトリ
uCosminexus Portal Frameworkのインストールディレクトリです。

デフォルトのインストール先

C:¥Program Files¥Hitachi¥CosmiPortal

DocumentBroker Smart Document Managementインストールディレクトリ
DocumentBroker Smart Document Managementのインストールディレクトリです。

デフォルトのインストール先

C:¥Program Files¥Hitachi¥ECMPKG

HiRDBインストールディレクトリ
DocumentBroker Smart Document Managementの組み込みデータベースのインストールディレクトリです。

デフォルトのインストール先

C:¥Program Files¥Hitachi¥ECMPKG¥PP¥hirdb_e_EP0

ナビゲーション プラットフォームインストールディレクトリ
uCosminexus Navigation Platform - Core ServerまたはuCosminexus Navigation Developer - Core Serverのインストールディレクトリです。

デフォルトのインストール先

C:¥Program Files¥Hitachi¥uCNP

注意

64ビット版OSの場合，デフォルトの状態だとナビゲーション プラットフォームの構成ソフトウェアは「C:¥Program Files (x86)」以下のディレクトリにインストールされます。「C:¥Program Files」以下のディレクトリにインストールすると，コマンドなどの動作は保証されません。

3.6　ナビゲーション プラットフォームのバージョンアップ

ここでは，運用中のナビゲーション プラットフォームと同じまたは新しいバージョンのナビゲーション プラットフォームを上書きインストールしてバージョンアップする場合の手順を説明します。

バージョンアップを実行すると，バージョンアップ前の環境を移行でき，バージョンアップ後もそのまま使うことができます。

なお，09-00より前のナビゲーション プラットフォームをバージョンアップする手順については，弊社までお問い合わせください。

＜この節の構成＞

3.6.1　バージョンアップ前に確認すること

3.6.2　バージョンアップ手順

3.6.3　バージョンアップ後に確認すること

3.6.4　バージョンアップ前に退避したプラグインの更新手順

3.6.1　バージョンアップ前に確認すること

バージョンアップの前に，次のことを実施してください。

バージョンアップ後のログイン時のスクリプトエラーを防止するため，Webブラウザのキャッシュはクリアしておいてください。

次に，バージョンアップをするための条件を示します。

バージョンアップ前の環境のバージョンが09-00以降である。
バージョンアップ前の環境のバージョンが09-00の場合は，簡易セットアップで構築された環境である必要があります。また，バージョンアップ前の環境のバージョンが09-50以降の場合は，各バージョンに対応するマニュアルで説明している手順でセットアップおよびカスタマイズした環境だけが引き継げます。

バージョン09-60に合わせたデータベースサーバの容量の見積もりを実施している。
バージョンアップ前の環境のバージョンが09-00の場合は，バージョン09-00時点のモデルケースのプラグイン数を2倍にして，再度見積もりを実施してください。

Windows Firewallのサービスが起動している。

ナビゲーション プラットフォームが起動または停止している。もしくは，未セットアップの状態である。

J2EEサーバ，Webサーバのプロパティ変更をCosminexus Management Server経由でしている。

同じマシン内で環境を移行する。
別マシンへの環境の移行はできません。

ナビゲーション プラットフォームをインストールしたユーザでコマンドを実行する。

サーバのディスクに十分な空き容量がある。

3.6.2　バージョンアップ手順

ナビゲーション プラットフォームをバージョンアップする手順を示します。

注意

バージョンアップ操作に当たっては，次の点に注意してください。

バージョンアップ操作は，バージョンアップ前のナビゲーション プラットフォームをインストールしたユーザ（システム管理者）が実施する必要があります。Windows XP以外のOSの場合は，［管理者として実行］を選択して操作を開始してください。

バージョンアップ操作の途中で手順に記載されていない操作を実施すると，バージョンアップ後のナビゲーション プラットフォームが正常に動作しないおそれがあります。

上書きインストール後は必ずnpenvupdateコマンド（環境更新）で環境を更新してください。npenvupdateコマンド（環境更新）を省略した場合，バージョンアップ後の動作は保証されません。

バージョンアップ操作では，各種設定ファイルの内容が変更されます。バージョンアップ後，設定ファイルの内容に不都合な点がある場合は，弊社にお問い合わせください。

バージョンアップ前の環境でデータベースを拡張している場合は，バージョンアップ後のデータベースサーバの容量見積もりと拡張を再度実施します。
容量見積もりについては「3.4.1　データベースサーバの容量の見積もり」を，拡張については「5.3.3　RDエリアの拡張」を参照してください。
なお，検索機能用のデータベースの拡張は不要です。

新しいバージョンのCD-ROMを挿入し，HCD_INST.EXEを実行します。

［続行］ボタンをクリックして，日立総合インストーラから統合インストーラを起動します。

次の順序でナビゲーションプラットフォームおよびインストール済みのすべての構成ソフトウェアを上書きインストールします。
1.　uCosminexus Navigation Platform - Core ServerまたはuCosminexus Navigation Developer - Core Server
2.　構成ソフトウェア

参考事項

uCosminexus Navigation Platform - Core ServerまたはuCosminexus Navigation Developer - Core Serverの上書きインストールを実行すると，その後のバージョンアップ処理で必要となるファイルのバックアップ，サービス停止などが自動的に実施されます。

サーバマシンを再起動します。
バージョン09-50より前のバージョンからバージョンアップした場合は，一部のユーザプロパティのデフォルト値が変更されます。
新しいデフォルト値については，「(1)　バージョン09-50でデフォルト値が変更されたユーザプロパティ」を参照してください。

必要に応じてユーザプロパティファイルを見直して，バージョンアップ前の環境で使用していた指定値に変更します。

注意事項

バージョンアップ前の環境でActive Directoryによるユーザ認証を利用していた場合や，重複する名称の業務コンテンツを作成していた場合は，指定値を変更しないと以降の手順でエラーが発生することがあります。

npenvupdateコマンド（環境更新）を実行して，バージョンアップ前の環境設定情報をバージョンアップ後に反映します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npenvupdate

npenvupdateコマンド（環境更新）が正常に終了すると，一部のユーザセットアッププロパティの値も変更されます。また，追加または削除されるユーザセットアッププロパティもあります。
値が変更されるユーザセットアッププロパティと変更後の値については，「(4)　バージョンアップによって値が変更されるユーザセットアッププロパティ」を参照してください。追加または削除されたユーザセットアッププロパティについては，「(5)　バージョン09-50で追加または削除されたユーザセットアッププロパティ」を参照してください。

参考事項

このコマンドの処理には時間が掛かります。正常に終了したというメッセージが出力されるまで，しばらくお待ちください。

必要に応じてユーザプロパティファイルを更新して，ナビゲーション プラットフォームを再起動します。
バージョンアップで追加されたユーザプロパティの設定値を変更したい場合は，サンプルファイルからプロパティをコピーして追加してください。

コピー元ファイル

ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnp_setup_user.properties

コピー先ファイル

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnp_setup_user.properties

なお，どのバージョンからバージョンアップするかによって，次の内容を参照してください。

バージョン09-50より前のバージョンからのバージョンアップの場合

「(2)　バージョン09-50で追加されたユーザプロパティ」および「(3)　バージョン09-60で追加されたユーザプロパティ」を参照してください。

バージョン09-50からのバージョンアップの場合

「(3)　バージョン09-60で追加されたユーザプロパティ」を参照してください。

参考事項

次に示すユーザプロパティは，バージョン09-50以降では使用できません。

ucnp.base.server.command.adminid

ucnp.base.client.editor.menu.list.permission.enable

必要に応じてトラブルシュート情報収集先対象定義ファイルを編集します。

編集するトラブルシュート情報収集先対象定義ファイルの格納ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnpsystorusnapshotconf.conf

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnpsystorusnapshotlog.conf

必要に応じて，修正パッチを適用します。
修正パッチの適用手順については，「3.7　修正パッチの適用手順」を参照してください。

Webブラウザのキャッシュをクリアします。

バージョンアップ後のナビゲーション プラットフォームに正常にアクセスできるかどうかを確認します。

アクセスするURL

http://ホスト名:ポート番号/ucnpBase/

ホスト名
J2EEサーバマシンのホスト名またはIPアドレス

ポート番号
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値

＜この項の構成＞

(1)　バージョン09-50でデフォルト値が変更されたユーザプロパティ

(2)　バージョン09-50で追加されたユーザプロパティ

(3)　バージョン09-60で追加されたユーザプロパティ

(4)　バージョンアップによって値が変更されるユーザセットアッププロパティ

(5)　バージョン09-50で追加または削除されたユーザセットアッププロパティ

(1)　バージョン09-50でデフォルト値が変更されたユーザプロパティ

バージョン09-50でデフォルト値が変更されたユーザプロパティを次に示します。プロパティの設定内容の詳細は，「7.4.3　ユーザプロパティファイルのプロパティ詳細」を参照してください。

表3-5　旧バージョンとデフォルト値が異なるユーザプロパティ一覧

項番 | プロパティ名 | 旧デフォルト値 | 新デフォルト値
1 | ucnp.base.client.menu.group.default | 空文字 | !editing
2 | ucnp.base.server.geturl.link.display | false | true
3 | ucnp.base.client.contentsname.uniquecheck.enable | false | true
4 | ucnp.base.client.operationlog.enable | false | true
5 | ucnp.base.server.operationlog.size | 8192 | 10240
6 | ucnp.base.server.operationlog.format | {0}¥t{3}¥t{5}¥t{6}¥t{7}¥t{8}¥t{9}¥t{10} | {0}¥t{1}¥t{2}¥t{3}¥t{4}¥t{5}¥t{6}¥t{7}¥t{8}¥t{9}¥t{10}¥t{11}¥t{12}¥t{13}
7 | ucnp.base.client.menu.frame.width | 190 | 250
8 | ucnp.base.client.flow.frame.width | 500 | 450
9 | ucnp.base.client.guide.frame.width | 500 | 540
10 | ucnp.base.client.back.button.width | 60 | 100
11 | ucnp.base.client.next.button.width | 60 | 130
12 | ucnp.base.client.complete.button.width | 60 | 130
13 | ucnp.base.server.acl.group.type | org | group※1
14 | ucnp.base.server.trace.size※2 | 4096 | 32768

注※1　次の場合は，指定値を「org」にする必要があります。

バージョンアップ前の環境がActive Directoryによるユーザ認証を使用している場合

バージョンアップ後の環境がOracle Directory Serverによるユーザ認証を使用している場合で，組織単位で業務コンテンツにアクセス権を設定したいとき

注※2

このプロパティの指定値をデフォルトから変更する場合は，バージョンアップ後はバージョンアップ前よりトレースの出力量が増えることを考慮してください。

(2)　バージョン09-50で追加されたユーザプロパティ

バージョン09-50で追加されたユーザプロパティを次に示します。プロパティの設定内容の詳細は，「7.4.3　ユーザプロパティファイルのプロパティ詳細」を参照してください。

ucnp.base.server.command.legacy

ucnp.base.server.print.link.display

(3)　バージョン09-60で追加されたユーザプロパティ

バージョン09-60で追加されたユーザプロパティを次に示します。プロパティの設定内容の詳細は，「7.4.3　ユーザプロパティファイルのプロパティ詳細」を参照してください。

ucnp.base.server.jp1auth.system.resource.group

ucnp.base.server.jp1auth.virtual.hostname

ucnp.base.client.node.checkmark.position

ucnp.base.client.flow.connector.color

ucnp.base.client.auditlog.enable

ucnp.base.server.auditlog.path

ucnp.base.server.auditlog.backup.number

ucnp.base.server.auditlog.size

ucnp.base.client.jp1imss.hostname

ucnp.base.client.jp1imss.portnum

ucnp.base.client.jp1ao.hostname

ucnp.base.client.jp1ao.portnum

ucnp.base.client.jp1ao.submittask.passwordfile.path

ucnp.base.client.jp1ev.association.enable

ucnp.base.client.editor.jp1plugin.toolpalette.display

(4)　バージョンアップによって値が変更されるユーザセットアッププロパティ

09-50より前のバージョンからバージョンアップすることによって値が変更されるユーザセットアッププロパティを次に示します。プロパティの設定内容の詳細は，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。

表3-6　バージョンアップによって値が変更されるユーザセットアッププロパティ一覧

項番 | プロパティ名 | バージョン09-50より前のデフォルト値 | バージョン09-50以降のデフォルト値
1 | ucnp.setup.server.portal.manager.http.port | 38080 | 24710
2 | ucnp.setup.server.portal.manager.ajp13.port | 38007 | 24711

(5)　バージョン09-50で追加または削除されたユーザセットアッププロパティ

バージョン09-50で追加または削除されたユーザセットアッププロパティを次に示します。プロパティの設定内容の詳細は，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。

追加されたユーザセットアッププロパティ

ucnp.setup.server.portal.manager.rmi.naming.port

ucnp.setup.server.portal.manager.naming.port

削除されたユーザセットアッププロパティ

ucnp.setup.server.portal.manager.shutdown.port

3.6.3　バージョンアップ後に確認すること

バージョンアップの完了後に，次のことを実施してください。

バージョンアップ前の環境で作成した業務コンテンツにHTMLパーツが含まれている場合，バージョンアップ後にHTMLパーツの表示内容が変わることがあります。HTMLパーツを含む業務コンテンツは，バージョンアップ後に表示内容を確認し，必要に応じて設定を変更してください。
HTMLパーツの設定手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

バージョンアップ前の環境で作成した業務コンテンツにプラグインパーツが含まれている場合，既存のプラグインパーツとバージョンアップ後に追加したプラグインパーツとで，動作が異なる場合があります。
バージョンアップ前のプラグインとの違いについての詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」の旧バージョンで開発したプラグインを使用する場合の注意事項についての説明を参照してください。

バージョンアップ後はログの出力量が増加するため，必要に応じてログの設定を見直してください。npenvupdateコマンド（環境更新）の実行によって最大面数とファイルサイズの上限値が変更されるログを次に示します。
DocumentBrokerのトレースファイル
DocumentBroker Runtimeのクライアント共用トレースファイル
CosminexusのPRFトレース
CosminexusのJavaVMの保守情報およびガーベージコレクションのログ
CosminexusのJavaVMの明示管理ヒープ機能のイベントログ
CosminexusのHWS用リダイレクタの保守用トレースログ

バージョンアップ前に作成および退避したプラグインがある場合は，build.xmlファイルおよびucnpsdkversion.propertiesファイルを手動で更新する必要があります。更新手順については「3.6.4　バージョンアップ前に退避したプラグインの更新手順」を参照してください。

3.6.4　バージョンアップ前に退避したプラグインの更新手順

バージョンアップ時には，ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥pluginディレクトリ下のファイルだけが更新されるため，バージョンアップ前に作成および退避したプラグインがある場合は，build.xmlファイルおよびucnpsdkversion.propertiesファイルを手動で更新する必要があります。

バージョンアップ前に退避したプラグインを更新する手順を示します。

バージョンアップ前に退避したプラグインのbuild.xmlファイルとucnpsdkversion.propertiesファイルを，任意のディレクトリにバックアップします。

build.xmlファイルのパス

退避したプラグインの格納ディレクトリ¥プラグインID¥build.xml

ucnpsdkversion.propertiesファイルのパス

退避したプラグインの格納ディレクトリ¥プラグインID¥ucnpsdkversion.properties

バージョンアップ前に退避したプラグインを，次のディレクトリにコピーします。
ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥plugin¥プラグインID

テンプレートのbuild.xmlファイルをバージョンアップ前に退避したプラグインのbuild.xmlファイルに上書きコピーします。

コピー元：

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥plugintemplates¥build.xml

コピー先：

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥plugin¥プラグインID¥build.xml

手順3.で上書きしたファイルを編集して，次に示す内容をすべて変更します。

変更前の文字列 | 変更後の文字列
@userplugin.name@ | 変更するプラグインのプラグイン名
@userplugin.id@ | 変更するプラグインのプラグインID

09-00より前に作成したプラグインで，手順1.でバックアップしたbuild.xmlファイルにユーザライブラリのクラスパスを直接記載している場合，記載しているライブラリファイルを次のディレクトリにコピーします。
ナビゲーション プラットフォーム インストールディレクトリ¥usrlib¥sys
ディレクトリが存在しない場合，手動でディレクトリを作成してコピーしてください。

ucnpsdkversion.propertiesファイルを上書きコピーします。

コピー元：

ナビゲーション プラットフォーム インストールディレクトリ¥lib¥ucnpsdkversion.properties

コピー先：

ナビゲーション プラットフォーム インストールディレクトリ¥pluginSDK¥plugin¥プラグインID¥ucnpsdkversion.properties

バージョンアップ前に退避したプラグインごとに手順1.から手順6.の操作を繰り返し，build.xmlファイルおよびucnpsdkversion.propertiesファイルを更新します。

プラグインに対して，バージョンアップ後の環境で次の作業を実施します。

プロジェクトのインポート

アプリケーション属性ファイル（application.xml）の編集

プラグインのビルド

Webサーバリダイレクトの設定

J2EEアプリケーションのインポートと開始

業務コンテンツへの関連づけ

プラグインを組み込んだJ2EEアプリケーション（ucnp.ear）の配布

これらの作業によって，退避したプラグインの更新が完了します。
作業の詳細については，「6.7　開発環境で作成したファイルの適用」およびマニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

3.7　修正パッチの適用手順

修正パッチとは，製品リリース後に提供される改良版のことです。ナビゲーション プラットフォームのインストールが完了したら，ソフトウェアサポートサービスのWebサイトから最新の修正パッチを入手して，適用してください。なお，ソフトウェアサポートサービスのWebサイトにアクセスできない環境の場合は，製品CD-ROMと同じ箱に格納されている修正パッチCD-ROMを利用してください。

3.8　ナビゲーション プラットフォームのアンインストール

ナビゲーション プラットフォームのアンインストールの手順を次に示します。構成ソフトウェアのアンインストール方法については，各製品のマニュアルを参照してください。

npstopコマンド（停止）でシステムを停止します。

npunsetupコマンド（アンセットアップ）を使用して，アンセットアップします。

HiRDBのサービス（HiRDB/EmbeddedEdition _EP0）を停止します。

アンインストールするためのダイアログボックスを表示させます。

Windows XPの場合
Windowsのスタートメニューから［コントロール パネル］－［プログラムの追加と削除］をダブルクリックします。
［プログラムの追加と削除］ダイアログボックスが表示されます。

Windows XP以外の場合
Windowsのスタートメニューから［コントロール パネル］－［プログラムと機能］をダブルクリックします。
［プログラムと機能］ダイアログボックスが表示されます。

アンインストールする製品を選択します。
DocumentBroker Version 3 Smart Document Managementをアンインストールする場合は，「DocumentBroker Version 3 Smart Document Management」を選択してください。ただし，次のものは選択しないでください。

Document Filter for Text Search Version 3

DocumentBroker Text Search Index Loader Version 3

HiRDB XML Extension Version 8 _EP0

［削除］ボタンをクリックします。
アンインストールするかどうかを確認するダイアログが表示されます。
なお，アンインストールする製品によっては，［変更と削除］ボタンをクリックします。

［次へ］ボタンをクリックします。
アンインストールが実行されます。
アンインストールを中止したい場合は，アンインストールするかどうかを確認するダイアログで［キャンセル］ボタンをクリックします。
アンインストールが完了すると，アンインストール完了画面が表示されます。

注意

セットアップ時に作成した作業ファイル，システム運用中に生成されたログファイルなどは，アンインストール後も残ります。必要に応じて手動で削除してください。

アンインストール処理中にほかのユーザがファイルやディレクトリにアクセスしていると，それらのファイルやディレクトリを削除できません。この場合，OSを再起動する必要があるというメッセージが表示されることがあります。

構成ソフトウェアは，個別にアンインストールしないでください。

3.9　ディレクトリサーバ（Active Directory）構築の流れ

ここでは，ディレクトリサーバとしてActive Directoryを使用する場合の構築手順を説明します。

Active Directoryを使用したディレクトリサーバを構築する流れを次に示します。アクセス権グループを使用する場合は，手順2.および手順4.の作業を必ず行ってください。

Active Directoryをインストールします。

Active Directory用のグループを作成します。

Active Directoryで管理するユーザを作成します。

Active Directory用の所属グループを設定します。

構築済みのActive Directoryを使用する場合，再構築の必要はありません。

＜この節の構成＞

3.9.1　Active Directoryをインストールする手順

3.9.2　Active Directory用のグループを作成する手順

3.9.3　Active Directoryで管理するユーザを作成する手順

3.9.4　Active Directory用の所属グループを設定する手順

3.9.5　ナビゲーション プラットフォームのディレクトリサーバとしてActive Directoryを使用する場合の制限事項

3.9.1　Active Directoryをインストールする手順

ナビゲーション プラットフォームで前提としている機能レベル（Windows Server 2008）に従って，Active Directoryをインストールしてください。

インストール手順の詳細については，Active Directoryのドキュメントを参照してください。

3.9.2　Active Directory用のグループを作成する手順

ナビゲーションプラットフォームでアクセス権を割り当てるために利用するグループを作成します。既存のグループも利用できます。

グループを作成する手順の詳細については，Active Directoryのドキュメントを参照してください。

3.9.3　Active Directoryで管理するユーザを作成する手順

Cosminexusの統合ユーザ管理機能でディレクトリサーバに接続するために，次のユーザを作成してください。

ディレクトリサーバ接続用ユーザ
ディレクトリサーバ接続用ユーザは削除しないでください。

システム管理者
セットアップ時にユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.docb.security.adminプロパティで指定したシステム管理者を作成します。システム管理者のユーザIDは，半角英数字で30文字以内にしてください。

ナビゲーション プラットフォームにログインするユーザ
コンテンツ管理者，コンテンツ編集者，および利用者のユーザを作成します。

ユーザの作成手順を次に示します。

Windowsのスタートメニューから［管理ツール］－［Active Directory ユーザーとコンピューター］を選択します。

役割の一覧から［Users］を右クリックし，［新規作成］－［ユーザ］を選択します。
［新しいオブジェクト - ユーザ］画面が表示されます。

「姓」「名」「フルネーム」「ユーザーログオン名」「ユーザーログオン名(Windows2000より前)」を入力します。
「ユーザーログオン名(Windows2000より前)」はナビゲーション プラットフォームを利用する際にユーザIDとして利用するため，半角英数字だけを入力してください。

［次へ］ボタンをクリックします。
ユーザのパスワード入力画面が表示されます。

「パスワード」「パスワードの確認入力」を入力します。
そのほかのチェックボックスはすべてオフにします。

［次へ］ボタンをクリックします。
ユーザ作成確認画面が表示されます。

［完了］ボタンをクリックします。

3.9.4　Active Directory用の所属グループを設定する手順

システム管理者および利用者の所属グループを設定する手順を次に示します。

なお，ナビゲーション プラットフォームでグループ単位のアクセス権を使用しない場合，この手順は不要です。

注意

プライマリグループは利用できません。グループに割り当てたアクセス権をユーザに適用したい場合は，プライマリグループ指定が該当グループにならないように設定してください。

また，ナビゲーション プラットフォームで使用できるのは，グループ名が半角英数字のグループだけです。グループ名に全角文字を含むグループは設定しないでください。

Windowsのスタートメニューから［管理ツール］－［Active Directory ユーザーとコンピューター］をダブルクリックします。

役割の一覧から［Users］を選択して，ユーザの一覧を表示します。

所属グループを設定するユーザを右クリックして［プロパティ］メニューを選択します。
［ユーザ名のプロパティ］画面が表示されます。

［所属するグループ］タブで，［追加］ボタンをクリックします。
作成済みのActive Directory用のグループ名を入力して，［OK］ボタンをクリックします。

ほかのシステム管理者または利用者に所属グループを設定する場合は，手順2.～4.を繰り返します。

3.9.5　ナビゲーション プラットフォームのディレクトリサーバとしてActive Directoryを使用する場合の制限事項

ナビゲーション プラットフォームのディレクトリサーバとしてActive Directoryを使用する場合，組織単位でのアクセス権の設定はできません。

4.　ナビゲーション プラットフォームのセットアップ

この章では，ナビゲーション プラットフォームのセットアップとアンセットアップ，およびセットアップ後に必要な作業について説明します。

＜この章の構成＞

4.1　セットアップ前に確認すること

4.2　Active Directoryによるユーザ認証を利用する場合のセットアップ準備

4.3　JP1/Baseによるユーザ認証を利用する場合のセットアップ準備

4.4　セットアップ手順

4.5　アンセットアップ前の注意点

4.6　アンセットアップ手順

4.7　トラブルシュート情報収集先定義ファイルの設定

4.8　検索機能を使用するための追加セットアップ

4.9　検索機能のアンセットアップ

4.10　セットアップ後の作業の流れ

4.11　ナビゲーション プラットフォームをセットアップ後にActive Directoryを構築する手順

4.12　ナビゲーション プラットフォームをセットアップ後にJP1/Baseによるユーザ認証を導入する手順

4.1　セットアップ前に確認すること

マシンにログインするユーザの権限

インストールとセットアップは，必ずWindowsの管理者権限があるユーザ（ナビゲーション プラットフォームのインストールを実行したユーザ）で実施してください。Windows XP以外のOSの場合は，［管理者として実行］を選択して操作を開始する必要があります。

ディスクの空き容量

セットアップには，インストール時と同等のディスク空き容量が必要になります。再セットアップの場合も「3.5.1　インストール前に確認すること」のディスクの空き容量を参照して，十分な空き容量が残っていることを確認してください。

インストールディレクトリ

ナビゲーション プラットフォームインストールディレクトリおよびセットアップ対象のソフトウェアのインストールディレクトリの下にある，ディレクトリおよびファイルを，移動，編集，または削除しないでください。

ポート番号

デフォルト値でセットアップをする場合，ナビゲーション プラットフォームは，80，801，900，8007，8080，14000，20058，20295，22200，23152，24710～24713，28005，28009，28080，28099のポート番号を使用します。これらのポート番号が，ほかのアプリケーションによって使用されていないかどうかを確認してください。

ほかのアプリケーションが該当のポート番号を使用中の場合は，そのアプリケーションのポート番号の設定を変更するか，セットアップ時にナビゲーション プラットフォームのポート番号をデフォルトから変更する必要があります。

ポート番号の指定については，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。

上書きされるデータ

npsetenvコマンド（環境変数の設定）で指定した値が，システム環境変数にすでに登録されている場合は，環境変数の値が上書きされます。

また，npsetupコマンド（セットアップ）を実行すると，既存の環境のユーザプロパティファイルが上書きされます。セットアップ済みの環境をアンセットアップしてから再セットアップする場合は，必要に応じてユーザプロパティファイルのバックアップを取得してください。

ユーザ認証の有無と方法

JP1製品と連携する場合は，JP1/Baseによるユーザ認証を利用している環境でセットアップする必要があります。開発環境の場合は，ユーザ認証は不要ですが，編集環境または実行環境の場合は，ナビゲーション プラットフォームにログインするユーザを，認証して管理するかどうかを決めます。また，ユーザ認証を実施してログインするユーザを管理する場合は，管理に使用するディレクトリサーバなどの種類をあらかじめ決めてください。ナビゲーション プラットフォームで使用できるユーザ認証については，「3.3.2　ナビゲーション プラットフォームで使用できるユーザ認証の種類」を参照してください。

ユーザ認証を利用している環境をセットアップするには，デフォルトのプロパティ指定値を変更する必要があります。ユーザ認証の種別を指定するプロパティについては，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。

4.2　Active Directoryによるユーザ認証を利用する場合のセットアップ準備

ユーザ認証にActive Directoryを利用する場合，まずユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ldap.directory.kindプロパティの指定値をデフォルトから「AD」に変更する必要があります。

次に，Active Directoryの管理者に問い合わせるなどして，次の情報を収集してください。括弧内は，対応するユーザセットアッププロパティファイルのプロパティ名です。

Active Directoryのサーバ名（ucnp.setup.server.ldap.hostname）

Active Directoryに接続するときに使用するポート番号（ucnp.setup.server.ldap.port）

Active Directoryの認証者のユーザDN（ucnp.setup.server.ldap.java.naming.security.principal）

Active Directoryの認証者のパスワード（ucnp.setup.server.ldap.java.naming.security.credentials）

Active Directoryのユーザ検索を開始するベースDN（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn）
認証の対象となるユーザが配下にあり，Active Directoryによって検索できる値である必要があります。

Active Directoryのグループ検索時を開始するベースDN（ucnp.setup.server.ldap.group.basedn）
ナビゲーション プラットフォームのアクセス権の設定で使用するグループが配下にあり，Active Directoryによって検索できる値である必要があります。

デフォルト値以外を指定したい場合，または設定内容を明示する必要がある場合は，括弧内に示したプロパティの指定値も変更してください。各プロパティの指定値の詳細については，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。

4.3　JP1/Baseによるユーザ認証を利用する場合のセットアップ準備

プロパティの設定

ユーザ認証にJP1/Baseを利用する場合，まずユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ldap.directory.kindプロパティの指定値をデフォルトから「JP1Auth」に変更する必要があります。

JP1/Baseの準備

次に，JP1/Baseをインストール，セットアップします。セットアップ完了後は，JP1/Baseを起動状態にしておき，JP1資源グループとJP1権限レベルを設定します。

JP1/Baseによるユーザ認証を利用する場合，JP1資源グループでアクセス範囲を管理し，JP1権限レベルで操作内容を管理します。業務コンテンツを作成するユーザや業務コンテンツの公開範囲など，業務コンテンツの運用に応じて，各ユーザにどのようなアクセス権（JP1/Baseで設定するJP1資源グループとJP1権限レベル）を与えるのかを検討してください。

JP1/Baseのインストール，セットアップ，各種の設定や登録の手順については，マニュアル「JP1/Base 運用ガイド」を参照してください。

注意

JP1製品とナビゲーション プラットフォームの業務コンテンツを連携させる場合，連携するJP1製品が使用するJP1/Baseとナビゲーション プラットフォームが使用するJP1/Baseのユーザ認証圏を同じにしておく必要があります。ユーザ認証圏が異なると，連携できません。

＜この節の構成＞

4.3.1　ナビゲーション プラットフォームで使用できるJP1資源グループ

4.3.2　ナビゲーション プラットフォームで使用できるJP1権限レベル

4.3.3　JP1資源グループとJP1権限レベルの組み合わせ

4.3.4　JP1ユーザの登録手順

4.3.5　サービス起動順序の設定手順

4.3.1　ナビゲーション プラットフォームで使用できるJP1資源グループ

ナビゲーション プラットフォームで使用できるJP1資源グループには，次の2種類があります。

システム全体を対象に設定するJP1資源グループ（必須）

業務コンテンツ単位で設定するJP1資源グループ（任意）

＜この項の構成＞

(1)　システム全体に設定するJP1資源グループとは

(2)　システム全体に設定するJP1資源グループの名称について

(3)　業務コンテンツごとに設定するJP1資源グループとは

(4)　業務コンテンツごとに設定するJP1資源グループの名称について

(1)　システム全体に設定するJP1資源グループとは

システム全体に設定するJP1資源グループとは，ナビゲーション プラットフォームのシステム（環境）ごとに一つだけ設定するJP1資源グループです。このJP1資源グループ内で設定されたJP1権限レベルは，そのシステム全体のすべての操作に適用されます。

(2)　システム全体に設定するJP1資源グループの名称について

システム全体のJP1資源グループの名称は，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.jp1auth.system.resource.groupプロパティで指定します。また，ucnp.base.server.jp1auth.system.resource.groupプロパティで指定していなくても，「*」という名称はシステム全体のJP1資源グループと見なされます。

システム全体のJP1資源グループの名称を決めるときには，複数の環境があるかどうかを考慮してください。

例えば，編集環境と実行環境が分かれている，実行環境が複数ある，といったケースでは，環境ごとにシステム全体のJP1資源グループを設定することもできます。次のような場合は，環境ごとにシステム全体のJP1資源グループの名称を変えると，運用しやすくなります。

環境によって管理するユーザが違う

同じユーザに対して環境ごとに異なる権限を与えたい

環境が複数あっても，同一ユーザに対してはすべての環境で同じ権限を与えればよい場合は，システム全体のJP1資源グループの名称は全環境で共通にすることを推奨します。

(3)　業務コンテンツごとに設定するJP1資源グループとは

業務コンテンツごとに設定するJP1資源グループは，設定された業務コンテンツに対して有効です。このJP1資源グループ内で設定されたJP1権限レベルは，設定された業務コンテンツに対してだけ適用されます。業務コンテンツ単位のJP1資源グループは，1個の業務コンテンツに対して最大10種類設定できます。

なお，業務コンテンツ単位のJP1資源グループを一つも設定していない業務コンテンツには，システム全体のJP1資源グループが適用されます。

(4)　業務コンテンツごとに設定するJP1資源グループの名称について

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.jp1auth.system.resource.groupプロパティで指定した名称，または「*」という名称以外の名称を指定します。

使用できる文字は，64文字以内の半角英数字と半角アンダースコア「_」だけです。大文字と小文字は区別されます。

4.3.2　ナビゲーション プラットフォームで使用できるJP1権限レベル

ナビゲーション プラットフォームで使用できるJP1権限レベルには，次に示す3種類があります。

UCNP_Admin
JP1権限レベルがUCNP_Adminのユーザを「コンテンツ管理者」と呼びます。

UCNP_Editor
JP1権限レベルがUCNP_Editorのユーザを「コンテンツ編集者」と呼びます。

UCNP_User
JP1権限レベルがUCNP_Userのユーザを「利用者」と呼びます。

それぞれのJP1権限レベルで実行できるナビゲーション プラットフォームの操作を次の表に示します。

表4-1　JP1権限レベルと実行できる操作の対応

項番 | 操作内容 | JP1権限レベル
UCNP_Admin | UCNP_Editor | UCNP_User
1 | 業務コンテンツの追加 | ○ | × | ×
2 | 業務コンテンツの複製 | ○ | × | ×
3 | 業務コンテンツの削除 | ○ | × | ×
4 | 業務コンテンツの編集※1 | ○ | ○ | ×
5 | 業務コンテンツの参照※2 | ○ | ○ | ○
6 | 業務コンテンツの名称変更 | ○ | × | ×
7 | 業務コンテンツのグループ変更 | ○ | × | ×
8 | 業務コンテンツへのアクセス権の設定（資源の設定） | ○ | × | ×
9 | 業務コンテンツに設定されているJP1資源グループの確認 | ○ | ○ | ×
10 | 関連リンクの設定 | ○ | ○ | ×

（凡例）

○：操作できます。

×：操作できません。

注※1

編集とは，業務編集画面で業務コンテンツを表示して，表示した業務コンテンツ対して実施できる操作（業務フロー領域・ガイド領域の作成や印刷など）を指します。

注※2

参照とは，業務実行画面で業務コンテンツを表示して，表示した業務コンテンツ対して実施できる操作（印刷やURL取得など）を指します。

4.3.3　JP1資源グループとJP1権限レベルの組み合わせ

ユーザがナビゲーション プラットフォームのどの操作を実行できるかは，JP1資源グループとJP1権限レベルの組み合わせによって決まります。

ポイント

1ユーザに対して複数のJP1資源グループを設定することもできます。システム全体のJP1資源グループと業務コンテンツ単位のJP1資源グループの両方を設定してもかまいません。

なお，名称が「*」のJP1資源グループに対してナビゲーション プラットフォームのJP1権限レベルを設定すると，システム全体のJP1資源グループに対する設定と見なされます。

以降にユーザが実行できる操作と，そのユーザに設定するJP1資源グループとJP1権限レベルの組み合わせを示します。

＜この項の構成＞

(1)　すべての操作を実行できるユーザ（システム管理者）

(2)　業務コンテンツの新規作成，特定の業務コンテンツの編集・削除ができるユーザ（コンテンツ管理者）

(3)　すべての業務コンテンツの編集だけができるユーザ（コンテンツ編集者）

(4)　特定の業務コンテンツの編集だけができるユーザ（コンテンツ編集者）

(5)　すべての業務コンテンツを参照して実行だけできるユーザ（利用者）

(6)　特定の業務コンテンツを参照して実行だけできるユーザ（利用者）

(1)　すべての操作を実行できるユーザ（システム管理者）

この組み合わせで登録されたJP1ユーザは，ナビゲーション プラットフォームのすべての操作を実行できます。

JP1資源グループ

システム全体

JP1権限レベル

UCNP_Admin

(2)　業務コンテンツの新規作成，特定の業務コンテンツの編集・削除ができるユーザ（コンテンツ管理者）

この組み合わせで登録されたJP1ユーザは，新規に作成した業務コンテンツに対して，自分が所属するJP1資源グループを設定できます。また，自分が所属するJP1資源グループが設定されている業務コンテンツに対して，UCNP_AdminのJP1権限レベルの操作を実行できます。

JP1資源グループ

業務コンテンツ単位

JP1権限レベル

UCNP_Admin

(3)　すべての業務コンテンツの編集だけができるユーザ（コンテンツ編集者）

この組み合わせで登録されたJP1ユーザは，すべての業務コンテンツに対して，UCNP_EditorのJP1権限レベルの操作を実行できます。

JP1資源グループ

システム全体

JP1権限レベル

UCNP_Editor

(4)　特定の業務コンテンツの編集だけができるユーザ（コンテンツ編集者）

この組み合わせで登録されたJP1ユーザは，自分が所属するJP1資源グループが設定されている業務コンテンツに対して，UCNP_EditorのJP1権限レベルの操作を実行できます。

JP1資源グループ

業務コンテンツ単位

JP1権限レベル

UCNP_Editor

(5)　すべての業務コンテンツを参照して実行だけできるユーザ（利用者）

この組み合わせで登録されたJP1ユーザは，すべての業務コンテンツに対して，UCNP_UserのJP1権限レベルの操作を実行できます。

JP1資源グループ

システム全体

JP1権限レベル

UCNP_User

(6)　特定の業務コンテンツを参照して実行だけできるユーザ（利用者）

この組み合わせで登録されたJP1ユーザは，自分が所属するJP1資源グループが設定されている業務コンテンツに対して，UCNP_UserのJP1権限レベルの操作を実行できます。

JP1資源グループ

業務コンテンツ単位

JP1権限レベル

UCNP_User

4.3.4　JP1ユーザの登録手順

JP1/Baseのセットアップが完了したら，ナビゲーション プラットフォームにアクセスするユーザをJP1ユーザとして登録します。

JP1ユーザ名には，30文字以内の半角英数字が使用できます。また，JP1ユーザ名に対応するパスワードは，6文字以上32文字以下のASCIIコードの文字で登録してください。ただし，次の記号や制御文字コードは使用できません。

¥　"　:　タブ・スペース　0x00～0x1F　0x7F

JP1ユーザ名とパスワードに使用できる文字，およびJP1ユーザの登録手順の詳細については，マニュアル「JP1/Base 運用ガイド」を参照してください。

4.3.5　サービス起動順序の設定手順

JP1/Baseによるユーザ認証を利用する場合，常にナビゲーション プラットフォームより前にJP1/Baseを起動しておく必要があります。そのため，JP1/Baseの起動順序定義ファイルを利用して，次の順序でサービスが起動するように設定してください。

JP1/Base

TPBroker

起動順序定義ファイルの使い方については，マニュアル「JP1/Base 運用ガイド」のサービスの起動順序および終了順序の設定に関する説明を参照してください。

4.4　セットアップ手順

ここでは，ナビゲーション プラットフォームのセットアップの手順を説明します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のサンプルファイルを次に示すディレクトリにコピーして編集します。

コピー元ファイル（サンプルファイル）

ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnp_setup_user.properties

コピー先ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥conf

参考

ユーザセットアッププロパティファイルの設定内容や各プロパティのデフォルト値などについては，「7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細」を参照してください。なお，ユーザ認証を使用しない場合は，ディレクトリサーバに関するプロパティはサンプル記載値のままとしてください。

npsetenvコマンド（環境変数の設定）を実行して，セットアップに必要なシステム環境変数を設定します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsetenv

マシンを再起動します。

npsetupコマンド（セットアップ）を実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsetup

次のソフトウェアがセットアップされます。

uCosminexus Navigation Platform - Core ServerまたはuCosminexus Navigation Developer - Core Server

uCosminexus Application Server

uCosminexus Portal Framework

DocumentBroker Version 3 Smart Document Management

エラーが発生した場合は，表示されたメッセージに従った対処を実施したあとに，いったんアンセットアップしてから再度セットアップを実行する必要があります。メッセージについてはマニュアル「Cosminexus V9　ナビゲーション プラットフォーム　メッセージ」を，アンセットアップについては「4.6　アンセットアップ手順」を参照してください。
Windowsファイアウォールによる警告メッセージが表示された場合は，［アクセスを許可する］ボタンをクリックして，ブロックを解除してください。

ログイン画面を表示します。
Webブラウザで次のURLを指定して，ナビゲーション プラットフォームのログイン画面が表示できることを確認します。

http://ホスト名:ポート番号/ucnpBase/

ホスト名

J2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号

Webサーバのポート番号です。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値になります。

ログインID

ユーザセットアッププロパティファイルのucnp.setup.server.docb.security.adminプロパティの指定値を入力してください。デフォルト値は「user1」です。

ログインパスワード

Active Directoryによるユーザ認証を使用している場合は，Active Directoryで設定したユーザごとのパスワードを入力してください。JP1/Baseによるユーザ認証を使用している場合は，JP1/Baseに登録したJP1ユーザ名とパスワードを入力してください。ユーザ認証を使用しない設定でセットアップした場合は，ログイン時にパスワード入力は不要です。

必要に応じてユーザプロパティファイル（ucnp_user.properties）を編集し，システムを再起動します。
ユーザプロパティファイル（ucnp_user.properties）およびユーザメッセージプロパティファイル（ucnp_message_user.properties）で設定できる内容については，「7.1　設定が必要なプロパティファイル」を参照してください。
なお，システムを再起動しないと編集したプロパティファイルが有効にならないため，注意してください。再起動手順については，「5.1　システムの起動と停止」を参照してください。

検索機能を使用する場合は，「4.8　検索機能を使用するための追加セットアップ」を参照して必要な手順を実施してください。

注意

セットアップ後の注意事項を説明します。セットアップ後の作業の流れについては，「4.10　セットアップ後の作業の流れ」を参照してください。

セットアップ時に編集したユーザセットアッププロパティファイル（ucnp_setup_user.properties）は，セットアップ済みの環境をアンセットアップするまで変更しないでください。アンセットアップする前に変更した場合，動作は保証されません。

ナビゲーション プラットフォームおよび構成ソフトウェアのログファイルまたは設定ファイルの格納ディレクトリをデフォルトから変更した場合は，トラブルシュート情報収集先定義ファイル（ucnpsnapshotlog.conf，ucnpsnapshotlog.2.conf）を編集する必要があります。編集方法の詳細は，「4.7　トラブルシュート情報収集先定義ファイルの設定」を参照してください。

npsetupコマンド（セットアップ）でセットアップを実施した場合は，次の表に示す作業以外の環境変更を実施しないでください。これ以外の作業を実施した場合，動作は保証されません。

表4-2　環境構築後に実施できる作業

項番
実施できる作業
備考

1
プラグインの追加
プラグインの開発手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。
開発したプラグインを追加する手順については，「6.7　開発環境で作成したファイルの適用」を参照してください。

2
画面の表示内容のカスタマイズ
画面の表示内容のカスタマイズ方法については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

3
リポジトリの変更
Portal Managerを使用して変更してください。ただし，ポータルプロジェクトは変更しないでください。

4.5　アンセットアップ前の注意点

ナビゲーション プラットフォームを停止してからnpunsetupコマンド（アンセットアップ）を実行してください。

npsetupコマンド（セットアップ）でセットアップしたシステムに対して，システムの設定変更やファイルの追加などを実施している場合，動作は保証されません。

アンセットアップを実施すると，業務コンテンツのデータはすべて削除されます。また，アンセットアップ後に再度セットアップを実施すると，ユーザセットアッププロパティファイル以外のプロパティファイルは上書きされて，デフォルト値に戻ります。

アンセットアップ後，再度セットアップを実施してナビゲーション プラットフォームを引き続き利用する場合は，既存の環境のバックアップを取得しておいてください。

4.6　アンセットアップ手順

ナビゲーション プラットフォームのアンセットアップ手順を次に示します。

npstopコマンド（停止）でシステムを停止します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstop

npunsetupコマンド（アンセットアップ）でアンセットアップを実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npunsetup

ナビゲーション プラットフォームの構成ソフトウェアがアンセットアップされます。

必要に応じて，業務コンテンツで使用していた静的ファイルを削除します。
npunsetupコマンドでは，静的ファイルは削除されません。アンセットアップ後に静的ファイルを残したくない場合は，手動でファイルを削除してください。

アンセットアップに失敗したときは，失敗の原因を取り除いてから，再度npunsetupコマンドを実行してください。

4.7　トラブルシュート情報収集先定義ファイルの設定

トラブルシュート情報収集先定義ファイルとは，ナビゲーション プラットフォームで発生した問題を解決するために必要となるトラブルシュート情報の出力先を定義したファイルです。

ナビゲーション プラットフォームおよび構成ソフトウェアの，ログファイルまたは設定ファイルの格納ディレクトリをデフォルトから変更した場合は，npsnapshotlogコマンドを実行する前に，トラブルシュート情報収集先定義ファイルを編集しておく必要があります。

ナビゲーション プラットフォームのトラブルシュート情報収集先定義ファイルには，次の2種類があります。

1次資料に出力するトラブルシュート情報の出力先を定義したファイル
ucnpsnapshotlog.conf
ucnpsystorusnapshotconf.conf
ucnpsystorusnapshotlog.conf

2次資料に出力するトラブルシュート情報の出力先を定義したファイル
ucnpsnapshotlog.2.conf

トラブルシュート情報収集先定義ファイルを編集する手順を次に示します。

注意事項

トラブルシュート情報収集先定義ファイルを編集するときは，変更後の記述を追記します。最終行より前にあるデフォルトの記述は，変更しないでください。デフォルトの記述を変更または削除すると，バージョンアップ後のトラブルシュート情報収集先定義ファイルに異常が発生するおそれがあります。

トラブルシュート情報収集先定義ファイルに記述するパスの区切り文字には半角スラッシュ（/）を使用してください。

ucnpsnapshotlog.conf，ucnpsystorusnapshotconf.conf，ucnpsystorusnapshotlog.conf，およびucnpsnapshotlog.2.confの内容を確認します。

格納ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥conf

格納ディレクトリにこれらのファイルがない場合は，「ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf」に格納されているファイルをコピーしてください。

ucnpsnapshotlog.conf，ucnpsnapshotlog.2.confの最終行（When you edit, please add description below.）のあとに，Cosminexusのトラブルシュート情報に関する記述を追加します。
記述規則，snapshotログ収集対象，デフォルトの格納ディレクトリなどについては，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 保守／移行編」およびマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」を参照してください。

追加例

Cosminexus Component ContainerのHWS用リダイレクタログ出力ディレクトリを「C:¥redirect」に変更した場合は，ucnpsnapshotlog.confファイルの最終行に次の記述を追加します。

C:/redirect/hws_redirect.*¥.log

ucnpsnapshotlog.conf，ucnpsystorusnapshotlog.conf，ucnpsystorusnapshotconf.confの最終行（When you edit, please add description below.）のあとに，Cosminexus以外のトラブルシュート情報に関する記述を追加します。

追加例

デフォルトが「uCosminexus Portal Frameworkインストールディレクトリ¥log」のディレクトリを「C:¥¥ CosmiPortal¥¥log」に変更した場合は，ucnpsnapshotlog.confおよびucnpsystorusnapshotlog.confの最終行に次の記述を追加します。手順2.の場合と記述方法が異なるので注意してください。

C:/CosmiPortal/log/.+

C:/CosmiPortal/log/.+/.+

C:/CosmiPortal/log/.+/.+/.+

なお，次に示すディレクトリは，ナビゲーション プラットフォームのセットアップ時の設定またはプロパティファイルの指定によって変更できるため，デフォルトから変更がないかどうか必ず確認してください。

ナビゲーション プラットフォームのトレースファイルの出力先ディレクトリ
ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.pathプロパティの指定値を確認します。

ナビゲーション プラットフォームで使用するポータルプロジェクトのディレクトリ
ポータルプロジェクトのディレクトリ下のWEB-INF¥confディレクトリがsnapshotログ収集の対象となります。
ポータルプロジェクトのディレクトリは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティの指定値を確認します。

uCosminexus Portal Frameworkのトレース出力ディレクトリ
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティの指定値を確認します。

4.8　検索機能を使用するための追加セットアップ

検索機能を使用する場合，追加セットアップが必要です。ここでは，検索機能を使用するための追加セットアップについて説明します。追加セットアップの流れは次のとおりです。

ナビゲーション プラットフォームの停止

組み込みデータベースの追加設定

ナビゲーション プラットフォームのプロパティの追加設定

環境変数の追加設定

ナビゲーション プラットフォームの起動

データベース接続の追加設定

J2EEアプリケーションへの検索画面取り込み

検索用データの初期登録

追加セットアップの前に

追加セットアップの前に，ナビゲーション プラットフォームのセットアップが完了していることを確認してください。また，次の作業を実施してください。

データベース容量の見積もり（詳細は3.4.4を参照）

ディスク空き容量の確認
追加セットアップをするには，「3.4.1　データベースサーバの容量の見積もり」で見積もったデータベース容量（運用開始後に拡張している場合は，拡張した容量も加えてください）の2倍のディスク空き容量が必要です。

追加セットアップに必要な情報の確認

データベースサーバのホスト名
「localhost」です。

データベースサーバのポート番号
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.portプロパティの値です。

RDエリアの格納先
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.rdarea.dirプロパティの値です。

組み込みデータベースの認可識別子およびパスワード
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.idプロパティおよびucnp.setup.server.db.user.passwordプロパティの値です。

作業ディレクトリの作成
作業ディレクトリは，データベースの設定に必要なファイルなどを格納するために必要です。作成場所は任意です。

追加セットアップが完了したら

開発環境で開発したカスタム画面（検索機能あり）を，編集環境または実行環境に適用してください。適用方法については，「6.7　開発環境で作成したファイルの適用」を参照してください。

参考

以降の説明に出てくる「ナビゲーション プラットフォームのJ2EEサーバ名」とは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.ejbserver.nameプロパティの値です。

なお，デフォルトの値から変更していない場合は，「ナビゲーション プラットフォームのJ2EEサーバ名」は「MyJ2EE」です。

＜この節の構成＞

4.8.1　セットアップの準備（検索機能をセットアップする場合）

4.8.2　ナビゲーション プラットフォームの停止

4.8.3　組み込みデータベースの追加設定

4.8.4　ナビゲーション プラットフォームのプロパティの追加設定

4.8.5　システム環境変数の追加設定

4.8.6　クライアント環境定義の追加設定

4.8.7　ナビゲーション プラットフォームの起動

4.8.8　データベース接続の追加設定

4.8.9　J2EEアプリケーションへの検索画面取り込み

4.8.10　検索用データの初期登録

4.8.1　セットアップの準備（検索機能をセットアップする場合）

追加セットアップの作業を始める前に，コマンドプロンプトの準備をします。まず，コマンドプロンプトから次に示すnppdntcmdコマンド（データベース環境変数の設定）を実行してください。

ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

以降で説明する追加セットアップの手順でコマンドを実行する場合は，nppdntcmdコマンドを実行した，このコマンドプロンプトを使用する必要があります。

4.8.2　ナビゲーション プラットフォームの停止

ナビゲーション プラットフォームの停止手順を次に示します。

npstopコマンド（停止）を実行します。
ナビゲーション プラットフォームが停止されます。npstopコマンド（停止）の詳細は，「8.11　npstopコマンド（停止）」を参照してください。

コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースを開始します。

pdstart

組み込みデータベースは開始状態にしておく必要があるため，この手順は省略しないでください。

4.8.3　組み込みデータベースの追加設定

ここでは，組み込みデータベースに追加で設定する項目について説明します。

＜この項の構成＞

(1)　組み込みデータベースのプラグインの定義情報の登録

(2)　HiRDBファイルシステム領域の作成

(3)　RDエリアの作成

(4)　システム定義の追加

(5)　テーブルの作成

(1)　組み込みデータベースのプラグインの定義情報の登録

組み込みデータベースのプラグインの定義情報を登録する手順を次に示します。

コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースのプラグインの定義情報を組み込みデータベースに登録します。

set PDUSER="データベースの認可識別子"/"パスワード"
pdplgrgst "HiRDBインストールディレクトリ¥plugin¥_phdxml¥etc¥_phdxml.adt" "HiRDBインストールディレクトリ¥plugin¥_phdxml¥etc¥_phdxml.pic"
pdplgrgst "HiRDBインストールディレクトリ¥plugin¥_phjxml¥etc¥_phjxml.idx" "HiRDBインストールディレクトリ¥plugin¥_phjxml¥etc¥_phjxml.pic"

(2)　HiRDBファイルシステム領域の作成

RDエリアを格納するためのHiRDBファイルシステム領域を作成する手順を次に示します。

RDエリアを格納するHiRDBファイルシステム領域を作成します。
コマンドプロンプトから次のコマンドを実行してください。

pdfmkfs -n 検索用データが格納されるHiRDBファイルシステム領域の容量※ -l 10 -k DB -e 100 -i "RDエリア格納先¥ucnp_search_user"
pdfmkfs -n 検索用データのインデックスが格納されるHiRDBファイルシステム領域の容量※ -l 10 -k DB -e 100 -i "RDエリア格納先¥ucnp_search_lob"

注※　セットアップ後に一度もデータベースを拡張していない場合は，1400を指定します。

(3)　RDエリアの作成

RDエリアを作成する手順を次に示します。

RDエリア作成用制御文ファイル（create_search_rdarea.txt）のサンプルを次に示すディレクトリにコピーします。

コピー元ファイル

ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup¥create_search_rdarea.txt

コピー先ディレクトリ

作業ディレクトリ

コピーしたRDエリア作成用制御文ファイルを編集します。
RDエリア作成用制御文ファイルの記述例を次に示します。

create rdarea UCNP_SEARCH_RD_DATA for user used by PUBLIC
 page 8192 characters
 storage control segment 20 pages
 file name "RDエリア格納先¥ucnp_search_user¥search_data"
   initial 検索用データのセグメント数※ segments
;
create rdarea UCNP_SEARCH_RD_XMLIDX for LOB used by PUBLIC
 page 8192 characters
 storage control segment 1 pages
 file name "RDエリア格納先¥ucnp_search_lob¥index_xml"
   initial 検索用データのインデックスのセグメント数※ segments
;
create rdarea UCNP_SEARCH_RD_CONTENTIDIDX for user used by PUBLIC
 page 8192 characters
 storage control segment 20 pages
 file name "RDエリア格納先¥ucnp_search_user¥index_contentid"
   initial 60 segments
;

注※　セットアップ後に一度もデータベースを拡張していない場合は，検索用データのセグメント数には8100を，検索用データのインデックスのセグメント数には162000を指定します。

コマンドプロンプトから次のコマンドを実行し，検索機能用のテーブルを格納するRDエリアを作成します。

pdmod -a "作業ディレクトリ¥create_search_rdarea.txt"

注　作業ディレクトリのパスは，絶対パスで指定してください。

(4)　システム定義の追加

システム共通定義およびシングルサーバ定義に検索機能用の定義を追加する手順を次に示します。

組み込みデータベースを停止します。
コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースを停止してください。

pdstop

システム共通定義ファイル（pdsys）に検索機能用の定義を追加します。
システム共通定義ファイル（pdsys）の格納ディレクトリを次に示します。

HiRDBインストールディレクトリ¥CONF

システム共通定義ファイル（pdsys）に次の記述を追加してください。

pdplugin -n _phdxml
pdplugin -n _phjxml
pdbuffer -a gucnpsearch01 -r UCNP_SEARCH_RD_DATA -n 50000
pdbuffer -a gucnpsearch02 -r UCNP_SEARCH_RD_XMLIDX -n 100
pdbuffer -a gucnpsearch03 -b UCNP_SEARCH_RD_XMLIDX -n 50000
pdbuffer -a gucnpsearch04 -r UCNP_SEARCH_RD_CONTENTIDIDX -n 100

シングルサーバ定義ファイル（sds01）に検索機能用の定義を追加します。
シングルサーバ定義ファイル（sds01）の格納ディレクトリを次に示します。

HiRDBインストールディレクトリ¥CONF

シングルサーバ定義ファイル（sds01）に次の記述を追加してください。

pdplgprm -n _phjxml -s 136

プラグイン用シングルサーバ定義のサンプル（phdxml_sds01）を次に示すディレクトリにコピーします。

コピー元ファイル

ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup¥phdxml_sds01

コピー先ディレクトリ

HiRDBインストールディレクトリ¥plugin¥_phdxml¥conf

コピー後は，ファイル名を「sds01」に変更してください。

プラグイン用シングルサーバ定義のサンプル（phjxml_sds01）を次に示すディレクトリにコピーします。

コピー元ファイル

ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup¥phjxml_sds01

コピー先ディレクトリ

HiRDBインストールディレクトリ¥plugin¥_phjxml¥conf

コピー後は，ファイル名を「sds01」に変更してください。

組み込みデータベースを開始します。
コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースを開始してください。

pdstart

(5)　テーブルの作成

検索用データを格納するテーブルを作成する手順を次に示します。

コマンドプロンプトから次のコマンドを実行して，検索用データを格納するテーブルを作成します。

set PDUSER="データベースの認可識別子"/"パスワード"
pddef < "ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup¥create_search_table.txt"

4.8.4　ナビゲーション プラットフォームのプロパティの追加設定

すべての環境（実行環境，編集環境，および開発環境）のユーザプロパティファイル（ucnp_user.properties）をそれぞれ編集して，ucnp.base.server.search.enableプロパティに「true」を指定します。ユーザプロパティファイル（ucnp_user.properties）については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

4.8.5　システム環境変数の追加設定

システム環境変数「UCNP_SEARCH_LIB」に次の値を設定してください。

設定値

HiRDBインストールディレクトリ¥CLIENT¥UTL¥pdjdbc2.jar;HiRDBインストールディレクトリ¥plugin¥_phdxml¥jcnv¥XMLConverter.jar;

コマンドプロンプトをいったん閉じて，再度起動してください。

4.8.6　クライアント環境定義の追加設定

組み込みデータベースのクライアント環境定義ファイル（HiRDB.ini）に環境変数を設定します。環境変数の設定手順を次に示します。

クライアント環境定義ファイル（HiRDB.ini）のサンプルを次に示すディレクトリにコピーします。

コピー元ファイル

ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup¥HiRDB.ini

コピー先ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥conf

必要に応じて，コピーしたクライアント環境定義ファイル（HiRDB.ini）を編集します。
検索機能で設定する環境変数を次に示します。

表4-3　検索機能で設定する環境変数と設定値

項番
環境変数名
設定値
説明

1
PDHOST
localhost
組み込みデータベースのホスト名を指定します。

2
PDNAMEPORT
ucnp.setup.server.db.portプロパティの値
組み込みデータベースのポート番号を指定します。
デフォルトでは22200です。

3
PDCWAITTIME
60
クライアントがデータベースサーバへ要求をしてから，応答が戻ってくるまでのクライアントの最大待ち時間（単位：秒）を指定します。なお，この値は通常変更する必要はありません。

4.8.7　ナビゲーション プラットフォームの起動

npstartコマンド（起動）を実行します。
ナビゲーション プラットフォームが起動されます。npstartコマンド（起動）の詳細は，「8.10　npstartコマンド（起動）」を参照してください。

4.8.8　データベース接続の追加設定

ここでは，検索機能に必要なデータベース接続の追加設定の手順を説明します。

注意

Windows XP以外のOSでリソース定義の追加，およびリソース参照の設定をする場合は，編集するファイルをダブルクリックで開かないでください。エディタを［管理者として実行］で起動してからファイルを編集する必要があります。

＜この項の構成＞

(1)　リソースアダプタの設定

(2)　J2EEサーバの設定

(3)　リソース定義の追加

(4)　リソース参照の設定

(1)　リソースアダプタの設定

リソースアダプタの属性ファイルを編集後に，Cosminexus Management Serverの運用管理ポータルを使用して，リソースアダプタの設定を変更します。手順を次に示します。

リソースアダプタの属性ファイル（uCNP_DB_Connector_for_HiRDB_Type4.xml）を任意のディレクトリにコピーします。

属性ファイルの格納ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥setup

コピーしたリソースアダプタの属性ファイルを編集します。
変更する個所は太字で示します。

データベースサーバのポート番号

デフォルトの設定の場合，ポート番号は22200です。

<config-property>
 <description xml:lang="en"></description>
 <config-property-name>description</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
 <config-property-value>ポート番号</config-property-value>
</config-property>

データベースサーバのインストールディレクトリ

<config-property>
 <description xml:lang="en"></description>
 <config-property-name>environmentVariables</config-property-name>
 <config-property-type>java.lang.String</config-property-type>
 <config-property-value>PDCLTPATH=C:¥Program Files¥Hitachi¥ECMPKG¥PP¥hirdb_e_EP0¥SPOOL;PDSQLOPTLVL=PRIOR_NEST_JOIN,PRIOR_OR_INDEXES,RAPID_GROUPING,DETER_WORK_TABLE_FOR_UPDATE,APPLY_ENHANCED_KEY_COND,FORCE_PLURAL_INDEXES;PDCWAITTIME=240;PDUAPERLOG=4096;PDBLKF=100;PDSWATCHTIME=0;</config-property-value>
</config-property>

データベースの認可識別子とパスワード

識別子のデフォルト値は「ADMIN」，パスワードのデフォルト値は「UCNPPASS」です。デフォルト値から変更しているときは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.id，ucnp.setup.server.db.user.passwordプロパティの値を確認してください。

<property>
 <property-name>User</property-name>
 <property-type>String</property-type>
 <property-value>データベースの認可識別子</property-value>
</property>
<property>
 <property-name>Password</property-name>
 <property-type>String</property-type>
 <property-value>認可識別子に対応するパスワード</property-value>
</property>

コネクションプーリング設定

コネクションプーリングの設定は，ナビゲーション プラットフォームへの同時接続数によって変わります。「3.4.2　ナビゲーション プラットフォームへの同時接続数の見積もり」を参照して，アプリケーションサーバの最大同時スレッド数と同じ値を指定してください。

<property>
 <property-name>MaxPoolSize</property-name>
 <property-type>int</property-type>
 <property-value>最大値</property-value>
 <property-default-value>10</property-default-value>
</property>
<property>
 <property-name>MinPoolSize</property-name>
 <property-type>int</property-type>
 <property-value>最小値</property-value>
 <property-default-value>10</property-default-value>
</property>

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

マシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［停止］アンカーをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［リソース］－［リソースアダプタ］をクリックし，［インポート］タブを表示します。

［DB Connector］ラジオボタンを選択します。

プルダウンメニューから「DBConnector_HiRDB_Type4_CP.rar」を選択します。

［Connector属性ファイル名］ラジオボタンを選択して，手順2.で編集した属性ファイル（uCNP_DB_Connector_for_HiRDB_Type4.xml）のパスを指定します。

［実行］ボタンをクリックします。

(2)　J2EEサーバの設定

Cosminexus Management Serverの運用管理ポータルを使用して拡張パラメタを設定します。手順を次に示します。

運用管理ポータルの画面で［論理サーバの環境設定］アンカーをクリックし，論理サーバの環境設定画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックします。

［コンテナ］－［J2EE］タブをクリックします。

［拡張パラメタ］欄にJ2EEコンテナで使用するオプションを入力して，［追加］ボタンをクリックします。

add.class.path=HiRDB インストールディレクトリ/CLIENT/UTL/pdjdbc2.jar

同じマシンにHiRDB/Single Serverが存在する環境では，業務コンテンツのプラグインがHiRDB/Single Serverを使用していることがあります。ナビゲーション プラットフォームの組み込みデータベースよりもHiRDB/Single Serverのバージョンの方が新しい場合は，「HiRDBインストールディレクトリ」の部分をプラグインが使用しているHiRDB/Single Serverのインストールディレクトリに読み替えてください。
なお，組み込みデータベースのバージョンは，「DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥hirdb_e_EP0¥READMESV.TXT」で確認してください。

［有効］チェックボックスを選択して，［適用］ボタンをクリックします。

右上にある［設定情報の配布］アンカーをクリックします。
［設定情報の配布］画面が表示されます。

ナビゲーション プラットフォームのJ2EEサーバ名の［配布］チェックボックスを選択して，［選択して配布］ボタンをクリックします。

［論理サーバの起動／停止］アンカーをクリックして，［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックします。

［起動／停止］タブをクリックして表示された画面で，［停止］ボタンをクリックします。

J2EEサーバが停止したことを確認したら，再度［起動／停止］タブをクリックして，表示された画面の［起動］ボタンをクリックします。

運用管理ポータルの画面で［論理サーバのアプリケーション管理］アンカーをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［リソース］－［リソースアダプタ］をクリックします。

［接続テスト］ボタンをクリックして，実行結果が「成功」となることを確認してから，［開始］ボタンをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックします。

アプリケーション名「ucnp」の［開始］ボタンをクリックします。

(3)　リソース定義の追加

次のディレクトリに格納されているweb.xmlファイルを編集して，ポータルプロジェクトへリソース定義を追加します。

格納ディレクトリ

ポータルプロジェクトディレクトリ¥WEB-INF

追加する定義のリソース参照が「jdbc/uCNP_HiRDB_Type4」の場合の記述例を次に示します。

<resource-ref>
  <res-ref-name>jdbc/uCNP_HiRDB_Type4</res-ref-name>
  <res-type>javax.sql.DataSource</res-type>
  <res-auth>Container</res-auth>
</resource-ref>

この記述をweb.xmlファイルの末尾に記述されている「</web-app>」の直前に追加してください。

(4)　リソース参照の設定

次のディレクトリに格納されているcosminexus.xmlファイルを編集して，リソース参照の設定をします。

格納ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥base¥dd¥META-INF

リソース参照の名称が「jdbc/uCNP_HiRDB_Type4」，リソースアダプタ表示名が「uCNP_DB_Connector_for_HiRDB_Type4」の場合の記述例を次に示します。

<resource-ref>
  <res-ref-name>jdbc/uCNP_HiRDB_Type4</res-ref-name>
  <linked-to>uCNP_DB_Connector_for_HiRDB_Type4</linked-to>
</resource-ref>

この記述をcosminexus.xmlファイルの末尾に記述されている「</war>」の直前に追加してください。

4.8.9　J2EEアプリケーションへの検索画面取り込み

ここでは，検索画面をナビゲーション プラットフォームのJ2EEアプリケーションに取り込む手順を説明します。

開発環境，実行環境，および編集環境で必要な作業は次のとおりです。

＜この項の構成＞

(1)　開発環境で必要な作業

(2)　実行環境，および編集環境で必要な作業

(1)　開発環境で必要な作業

開発環境で必要な作業を次に示します。

ナビゲーション プラットフォームで提供しているAPIを使用して，JSPファイルを作成します。

プラグインのビルドを実施して，検索画面を取り込んだJ2EEアプリケーションを作成します。

J2EEアプリケーションをインポートして開始します。

プラグインのビルド手順，およびJ2EEアプリケーションのインポートと開始については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

(2)　実行環境，および編集環境で必要な作業

実行環境，および編集環境では，ナビゲーション プラットフォームのJ2EEアプリケーションを，開発環境で作成したJ2EEアプリケーションに更新します。

J2EEアプリケーションの更新手順については次の説明を参照してください。

「6.7.2(1)　EARファイルの更新」

「6.7.2(2)　J2EEアプリケーションの削除」

「6.7.2(5)　J2EEアプリケーションのインポートと開始」

4.8.10　検索用データの初期登録

組み込みデータベースの検索機能用のテーブルに，作成済みの業務コンテンツの検索用データを初期登録します。まだ業務コンテンツがない環境に検索機能をセットアップする場合，この手順は不要です。

検索用データの登録手順を次に示します。

検索用データを登録します。
コマンドプロンプトから次に示すコマンドを実行し，検索用データを登録してください。

"ナビゲーション プラットフォームインストールディレクトリ¥bin¥npupdatesearchdata.bat" -u データベースの認可識別子 -p パスワード

注意

ここで業務コンテンツを初期登録したあとに，業務コンテンツが追加・変更・削除された場合は，検索用データを更新する必要があります。検索用データの更新については，「6.8　検索用データの更新」を参照してください。

4.9　検索機能のアンセットアップ

この節では，検索機能を削除するためのアンセットアップについて説明します。アンセットアップの流れは次のとおりです。

ナビゲーション プラットフォームのユーザプロパティの設定解除

検索機能の削除

データベース接続の設定解除

ナビゲーション プラットフォームの停止

組み込みデータベースの設定解除

環境変数の設定解除

ナビゲーション プラットフォームの起動

検索機能をアンセットアップする前に

ナビゲーション プラットフォームのJ2EEアプリケーションを，カスタム画面（検索機能あり）を適用する前の状態に復元してください。詳細は「6.7.3　適用する前の状態への復元」を参照してください。

＜この節の構成＞

4.9.1　アンセットアップの準備（検索機能をアンセットアップする場合）

4.9.2　ナビゲーション プラットフォームのユーザプロパティの設定解除

4.9.3　検索機能の削除

4.9.4　データベース接続の設定解除

4.9.5　ナビゲーション プラットフォームの停止

4.9.6　組み込みデータベースの設定解除

4.9.7　システム環境変数の設定解除

4.9.8　クライアント環境定義の設定解除

4.9.9　ナビゲーション プラットフォームの起動

4.9.1　アンセットアップの準備（検索機能をアンセットアップする場合）

検索機能をアンセットアップする場合も，セットアップしたときと同様にコマンドプロンプトの準備をします。まず，コマンドプロンプトから次に示すnppdntcmdコマンド（データベース環境変数の設定）を実行してください。

ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

以降で説明するアンセットアップの手順でコマンドを実行する場合は，nppdntcmdコマンドを実行した，このコマンドプロンプトを使用する必要があります。

4.9.2　ナビゲーション プラットフォームのユーザプロパティの設定解除

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.search.enableプロパティに「false」を指定します。ユーザプロパティファイル（ucnp_user.properties）については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

4.9.3　検索機能の削除

ここでは，検索機能を持つ環境を削除する手順について説明します。

注意

Windows XP以外のOSでリソース定義の削除，およびリソース参照の設定を解除する場合は，編集するファイルをダブルクリックで開かないでください。エディタを［管理者として実行］で起動してからファイルを編集する必要があります。

＜この項の構成＞

(1)　リソース定義の削除

(2)　リソース参照の設定解除

(3)　検索機能を適用する前の状態への復元

(1)　リソース定義の削除

次のディレクトリに格納されているweb.xmlファイルを編集して，「4.8.8(3)　リソース定義の追加」でポータルプロジェクトに追加したリソース定義を削除します。

格納ディレクトリ

ポータルプロジェクトディレクトリ¥WEB-INF

(2)　リソース参照の設定解除

次のディレクトリに格納されているcosminexus.xmlファイルを編集して，「4.8.8(4)　リソース参照の設定」で追加した設定を解除します。

格納ディレクトリ

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥base¥dd¥META-INF

(3)　検索機能を適用する前の状態への復元

開発環境で検索機能を削除した環境のファイルを作成し，そのファイルを実行環境および編集環境に適用します。手順の詳細は，「6.7.3　適用する前の状態への復元」を参照してください。

4.9.4　データベース接続の設定解除

ここでは，検索機能用のデータベース接続の設定を解除する手順について説明します。

＜この項の構成＞

(1)　リソースアダプタの設定解除

(2)　J2EEサーバの設定解除

(1)　リソースアダプタの設定解除

Cosminexus Management Serverの運用管理ポータルを使用して，リソースアダプタを削除します。手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

マシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［停止］アンカーをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［リソース］－［リソースアダプタ］をクリックし，［開始/停止］タブを表示します。

［停止］アンカーをクリックします。

運用管理ポータルの［論理サーバの起動／停止］アンカーをクリックします。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］アンカーをクリックします。

J2EEサーバが停止したことを確認したら，再度［起動／停止］タブをクリックして，表示された画面の［起動］ボタンをクリックします。

運用管理ポータルの［論理サーバのアプリケーション管理］アンカーをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［リソース］－［リソースアダプタ］をクリックし，［削除］タブを表示します。

インポートリソースアダプタ一覧で，リソース名「uCNP_DB_Connector_for_HiRDB_Type4」の［削除］アンカーをクリックします。

(2)　J2EEサーバの設定解除

Cosminexus Management Serverの運用管理ポータルを使用して拡張パラメタを削除します。手順を次に示します。

運用管理ポータルの画面で［論理サーバの環境設定］アンカーをクリックし，論理サーバの環境設定画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックします。

［コンテナ］－［J2EE］タブをクリックします。

［拡張パラメタ］欄に表示されている「4.8.8(2)　J2EEサーバの設定」で追加した拡張パラメタの［削除］ボタンをクリックします。

注意事項

同じマシンにHiRDB/Single Serverが存在する環境で，業務コンテンツのプラグインがHiRDB/Single Serverを使用している場合は，この手順は実施しないでください。

右上にある［設定情報の配布］アンカーをクリックします。
［設定情報の配布］画面が表示されます。

ナビゲーション プラットフォームのJ2EEサーバ名の［配布］チェックボックスを選択して，［選択して配布］ボタンをクリックします。

運用管理ポータルの［論理サーバの起動／停止］アンカーをクリックします。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。

J2EEサーバが停止したことを確認したら，再度［起動／停止］タブをクリックして，表示された画面の［起動］ボタンをクリックします。

運用管理ポータルの［論理サーバのアプリケーション管理］アンカーをクリックします。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［開始］アンカーをクリックします。

4.9.5　ナビゲーション プラットフォームの停止

ナビゲーション プラットフォームを停止して，組み込みデータベースだけを開始状態にします。手順の詳細は「4.8.2　ナビゲーション プラットフォームの停止」を参照してください。

4.9.6　組み込みデータベースの設定解除

ここでは，組み込みデータベースに追加で設定した項目の解除方法について説明します。

＜この項の構成＞

(1)　テーブルの削除

(2)　RDエリアの削除

(3)　組み込みデータベースのプラグインの定義情報の削除

(4)　システム定義の削除

(5)　HiRDBファイルシステム領域の削除

(1)　テーブルの削除

検索用データを格納するテーブルを削除する手順を次に示します。

コマンドプロンプトから次のコマンドを実行して，検索用データを格納するテーブルを削除します。

set PDUSER="データベースの認可識別子"/"パスワード"
pddef < "ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥unsetup¥drop_search_table.txt"

(2)　RDエリアの削除

RDエリアを削除する手順を次に示します。

コマンドプロンプトから次のコマンドを実行し，RDエリアを閉塞かつクローズ状態にします。

pdhold -r UCNP_SEARCH_RD_DATA -c
pdhold -r UCNP_SEARCH_RD_XMLIDX -c
pdhold -r UCNP_SEARCH_RD_CONTENTIDIDX -c

コマンドプロンプトから次のコマンドを実行し，RDエリアを削除します。

pdmod -a "ナビゲーション プラットフォームインストールディレクトリ¥sample¥search¥unsetup¥remove_search_rdarea.txt"

注　remove_search_rdarea.txtのパスは，絶対パスで指定してください。

(3)　組み込みデータベースのプラグインの定義情報の削除

組み込みデータベースのプラグインの定義情報を削除する手順を次に示します。

コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースのプラグインの定義情報を組み込みデータベースから削除します。

pdplgrgst -d "HiRDBインストールディレクトリ¥plugin¥_phjxml¥etc¥_phjxml.idx" "HiRDBインストールディレクトリ¥plugin¥_phjxml¥etc¥_phjxml.pic"
pdplgrgst -d "HiRDBインストールディレクトリ¥plugin¥_phdxml¥etc¥_phdxml.adt" "HiRDBインストールディレクトリ¥plugin¥_phdxml¥etc¥_phdxml.pic"

(4)　システム定義の削除

システム共通定義およびシングルサーバ定義から検索機能用の定義を削除します。

削除する手順を次に示します。

組み込みデータベースを停止します。
コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースを停止してください。

pdstop

「4.8.3(4)　システム定義の追加」で追加した検索用の定義を，システム共通定義ファイル（pdsys）から削除します。

「4.8.3(4)　システム定義の追加」で追加した検索用の定義を，シングルサーバ定義ファイル（sds01）から削除します。

プラグイン用シングルサーバ定義（sds01）を削除します。
プラグイン用シングルサーバ定義（sds01）の格納ディレクトリを次に示します。

HiRDBインストールディレクトリ¥plugin¥_phdxml¥conf

HiRDBインストールディレクトリ¥plugin¥_phjxml¥conf

組み込みデータベースを開始します。
コマンドプロンプトから次に示すコマンドを実行し，組み込みデータベースを開始してください。

pdstart

(5)　HiRDBファイルシステム領域の削除

RDエリアを格納するためのHiRDBファイルシステム領域を削除する手順を次に示します。

RDエリアを格納するHiRDBファイルシステム領域を削除します。
コマンドプロンプトから次のコマンドを実行してください。

del "RDエリア格納先¥ucnp_search_user"
del "RDエリア格納先¥ucnp_search_lob"

運用中に検索機能用のRDエリアを拡張した場合は，そのとき作成したHiRDBファイルシステム領域も削除します。
コマンドプロンプトから次のコマンドを実行してください。

del "RDエリア格納先¥拡張時に作成したHiRDBファイルシステム領域名"

4.9.7　システム環境変数の設定解除

「4.8.5　システム環境変数の追加設定」でシステム環境変数に設定した環境変数を削除します。

4.9.8　クライアント環境定義の設定解除

「4.8.6　クライアント環境定義の追加設定」で作成したクライアント環境定義ファイル（HiRDB.ini）を削除します。

4.9.9　ナビゲーション プラットフォームの起動

ナビゲーション プラットフォームを起動します。起動手順については，「4.8.7　ナビゲーション プラットフォームの起動」を参照してください。

4.10　セットアップ後の作業の流れ

セットアップ完了後に必要な作業は，次のとおり環境ごとに異なります。

なお，ナビゲーション プラットフォームの運用開始後まで含めて必要な作業については，「6.1　業務コンテンツの作成から運用までに必要な作業」を参照してください。

編集環境セットアップ後の作業

業務コンテンツの作成を開始するための準備として，次の作業を実施する必要があります。

Webブラウザでナビゲーション プラットフォームの画面にアクセスするためのURLを入力する。

システム管理者ID（デフォルトはuser1）でログインする。

ディレクトリサーバによるユーザ認証を利用している場合は，アクセス権グループを作成して，ほかのユーザにコンテンツ管理者とコンテンツ編集者の役割（アクセス権）を割り当てる。

JP1/Baseによるユーザ認証を利用している場合は，JP1/Baseの管理者に問い合わせて，ほかのユーザにコンテンツ管理者とコンテンツ編集者のJP1権限レベルが設定されているかどうかを確認する。

実行環境セットアップ後の作業

業務コンテンツを公開して利用を開始するための準備として，次の作業を実施する必要があります。

編集環境の業務コンテンツをインポートする。

必要に応じて開発環境を見直して，J2EEサーバメモリなどの設定を実行環境に適用する。

Webブラウザでナビゲーション プラットフォームの画面にアクセスするためのURLを入力する。

任意のIDでログインして，インポートした業務コンテンツが正しく表示・動作するかどうかを確認する。

開発環境セットアップ後の作業

開発環境でプラグインを関連づける場合は，準備として次の作業を実施する必要があります。

編集環境の業務コンテンツをインポートする。

Webブラウザでナビゲーション プラットフォームの画面にアクセスするためのURLを入力する。

システム管理者ID（デフォルトはuser1）でログインする。

4.11　ナビゲーション プラットフォームをセットアップ後にActive Directoryを構築する手順

ユーザ認証を利用しない設定でセットアップしたナビゲーション プラットフォームの環境を，Active Directoryによるユーザ認証の設定に変更する流れは次のとおりです。

システムのバックアップ

ナビゲーション プラットフォームの状態の取得

ナビゲーション プラットフォームのアンセットアップ

ナビゲーション プラットフォームのセットアップ

システムのリストア

手順の詳細を次に示します。

ナビゲーション プラットフォームのデータをバックアップします。
バックアップの方法は，「5.2.1　バックアップするタイミングとデータについて」を参照してください。

npsnapshotlogコマンド（トラブルシュート情報の収集）を実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsnapshotlog トラブルシュート情報を出力するディレクトリ

cjexportappコマンドを実行して，稼働中のナビゲーション プラットフォームのJ2EEアプリケーションをEARファイルに出力します。

コマンドのパス

Cosminexusインストールディレクトリ¥CC¥admin¥bin¥cjexportapp J2EEサーバ名 -f EARファイルの出力先パス -name ucnp -raw -nameserver corbaname::localhost:ネーミングサービスのポート番号

ネーミングサービスのポート番号は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.ejbserver.naming.portの指定値です。指定値がデフォルトの900の場合は，-nameserverオプションの指定は任意になります。
cjexportappコマンドの詳細は，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」を参照してください。

npstopコマンド（停止）を実行して，ナビゲーション プラットフォームを停止します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstop

npunsetupコマンド（アンセットアップ）を実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npunsetup

npsetupコマンドでセットアップを実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsetup

注意事項

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）をActive Directoryに合わせた設定に変更してからセットアップを実行してください。設定の詳細は「4.2　Active Directoryによるユーザ認証を利用する場合のセットアップ準備」を参照してください。

ナビゲーション プラットフォームのシステムをリストアします。
リストアの方法は，「5.2.2　リストアするタイミングとデータについて」を参照してください。

注意事項

ナビゲーション プラットフォームインストールディレクトリ¥conf以下のデータはリストアしないでください。

4.12　ナビゲーション プラットフォームをセットアップ後にJP1/Baseによるユーザ認証を導入する手順

ユーザ認証を利用しない構成でナビゲーション プラットフォームをセットアップし，あとからJP1/Baseによるユーザ認証を導入する場合は，必要なデータをバックアップした上で，いったんナビゲーション プラットフォームをアンセットアップする必要があります。手順を次に示します。

npexportコマンド（業務コンテンツのエクスポート）で，業務コンテンツのデータをバックアップします。

環境設定用のファイルなどを手動でコピーしてバックアップします。
次のディレクトリ下のファイルをコピーしてください。

ナビゲーション プラットフォームインストールディレクトリ¥conf以下のファイル

ポータルプロジェクトディレクトリ以下のファイル

ポータルプロジェクトディレクトリは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティで指定したディレクトリです。

システムが起動している場合は，システムを停止します。
システムの停止手順については「5.1　システムの起動と停止」を参照してください。

ナビゲーション プラットフォームをアンセットアップします。
アンセットアップ手順については，「4.6　アンセットアップ手順」を参照してください。

JP1/Baseをインストール，セットアップします。
JP1/Baseのインストール，セットアップ，および論理ホストの設定については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ナビゲーション プラットフォームにアクセスする利用者をJP1ユーザとして登録します。
JP1ユーザの登録に必要な情報については「4.3　JP1/Baseによるユーザ認証を利用する場合のセットアップ準備」を，登録手順の詳細についてはマニュアル「JP1/Base 運用ガイド」を参照してください。

ナビゲーション プラットフォームをセットアップします。
セットアップ手順については，「4.4　セットアップ手順」を参照してください。

手順1.でバックアップしたデータを，npimportコマンドを使って復元します。

実行例

npimport -d 手順1.のバックアップ先ディレクトリ¥contents.zip

手順2.でバックアップしたデータを手動でコピーして復元します。

コピー元

手順2.でバックアップしたファイルが格納されているディレクトリ

ただし，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）およびユーザプロパティファイル（ucnp_user.properties）は除いてください。

コピー先

ナビゲーション プラットフォームインストールディレクトリ¥conf

手順2.でバックアップしたユーザプロパティファイル（ucnp_user.properties）の内容を新しいユーザプロパティファイルに統合します。

新しいユーザプロパティファイル

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnp_user.properties

手順2.でバックアップしたディレクトリ下にucnpディレクトリがある場合は，新しいポータルプロジェクトディレクトリ下にコピーします。

ナビゲーション プラットフォームを再起動します。
システムの再起動手順については「5.1　システムの起動と停止」を参照してください。

5.　ナビゲーション プラットフォームの運用

この章では，ナビゲーション プラットフォームの日常的な運用やシステムの変更に必要な作業について説明します。

なお，開発・改修したプラグインやカスタム画面をシステムに適用する作業については，「6.7　開発環境で作成したファイルの適用」を参照してください。

＜この章の構成＞

5.1　システムの起動と停止

5.2　バックアップとリストアの必要性

5.3　データベースの運用

5.4　業務コンテンツの操作ログの設定

5.5　監査ログとは

5.6　中断情報の運用

5.7　Portal Managerでの設定の変更

5.8　IPアドレスの変更手順

5.9　Active Directoryの接続パスワードを変更した場合の設定変更の流れ

5.10　JP1製品と連携するための設定

5.1　システムの起動と停止

この節では，開発環境，編集環境および実行環境のシステムの起動方法および停止方法について説明します。

システムの起動と停止は，必ずWindowsの管理者権限があるユーザが実行してください。Windows XP以外の場合は，［管理者として実行］メニューを選択してコマンドを実行する必要があります。また，起動と停止に使用する各コマンドの使用方法については，「8.　コマンド」を参照してください。

参考

ディレクトリサーバを使用している場合，必要に応じてシステムの起動・停止に合わせてディレクトリサーバも起動・停止します。ディレクトリサーバを起動するときはシステムより先に，ディレクトリサーバを停止するときはシステムよりあとに操作をしてください。

ディレクトリサーバの起動および停止方法の詳細は，使用しているディレクトリサーバのマニュアルを参照してください。

＜この節の構成＞

5.1.1　システムの起動手順

5.1.2　システムの停止手順

5.1.1　システムの起動手順

npstopコマンド（停止）で停止させたシステムを再起動する場合などは，次に示す手順に従い，手動で起動してください。

注意

システム起動時は，次の点に注意してください。

JP1/Baseによるユーザ認証を利用している場合，ナビゲーション プラットフォームのシステムを起動する前に，すべてのJP1/Baseを起動しておく必要があります。JP1/Baseの起動方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

ディレクトリサーバを起動するときはナビゲーション プラットフォームのシステムより先に起動してください。ディレクトリサーバの起動方法については，ご使用のディレクトリサーバのマニュアルを参照してください。

npstartコマンドの起動対象となるサーバは，事前にすべて停止してください。
起動対象となるサーバについては，「8.10　npstartコマンド（起動）」を参照してください。

npstartコマンド（起動）を実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstart

エラーメッセージが表示された場合は，次の対処を実施してください。

KDCZ50859-Eの場合

失敗した原因を取り除いた上で，npstopコマンドでシステムを停止します。その後，再度npstartコマンドを実行してください。

KDCZ50859-E以外の場合

メッセージの内容に従って問題を解決してから，再度npstartコマンドを実行してください。

コマンドの詳細な使用方法については，「8.10　npstartコマンド（起動）」を参照してください。

5.1.2　システムの停止手順

コマンドを実行したり，サーバマシンをシャットダウンしたりする場合は，あらかじめシステムを停止させてください。ナビゲーション プラットフォームの停止手順を次に示します。

npstopコマンド（停止）を実行します。

コマンドのパス

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstop

すでにシャットダウンしているサーバが存在した場合は，エラーメッセージが出力されますが，停止処理は続行されます。

エラーメッセージが表示された場合は，次の対処を実施してください。

KDCZ50860-Eの場合

メッセージの内容に従って問題を解決してから，再度npstopコマンドを実行してください。

KDCZ50860-E以外の場合

メッセージの内容に従って問題を解決してから，再度npstopコマンドを実行してください。

コマンドの詳細な使用方法については，「8.11　npstopコマンド（停止）」を参照してください。

注意

システムを停止しないでサーバマシンをシャットダウンしてしまった場合は，システムが正常に停止していないおそれがあります。そのため，次にサーバマシンを起動してコマンドを実行する前に，次の操作を実行してください。

システムを停止してから実行する必要のあるコマンドを実行する前に，npstopコマンドを実行する。

システムを起動した状態で実行する必要のあるコマンドを実行する前に，npstartコマンドを実行する。

5.2　バックアップとリストアの必要性

この節では，バックアップを取得するデータと，データをリストアするタイミングについて説明します。障害が発生してデータが破損した場合は，取得したバックアップデータをリストアし，データを復旧します。

データのバックアップとリストアは，すべての環境（開発環境，編集環境，実行環境）に対して必要です。

＜この節の構成＞

5.2.1　バックアップするタイミングとデータについて

5.2.2　リストアするタイミングとデータについて

5.2.1　バックアップするタイミングとデータについて

次に示すデータは，月に1回を目安に定期的にバックアップすることを推奨します。運用に合わせて，バックアップを取得するタイミングを検討してください。

認証サーバに登録されたユーザ情報
バックアップの取得方法については，ご使用のディレクトリサーバまたはJP1/Baseのマニュアルを参照してください。

開発環境，編集環境および実行環境に登録された業務コンテンツ，およびアクセス権グループのデータ
npexportコマンド（業務コンテンツのエクスポート）およびnpaclexportコマンド（アクセス権グループのエクスポート）を実行することでバックアップを取得できます。業務コンテンツのエクスポートについては「6.6.1　業務コンテンツのエクスポート」を，アクセス権グループのエクスポートについては「6.5.4　アクセス権グループのエクスポートとインポート」を参照してください。

開発環境，編集環境および実行環境の業務コンテンツで使用している静的ファイルのデータ
業務コンテンツで使用している静的ファイルの格納場所については「6.9　業務コンテンツで使用する静的ファイルの管理」を参照してください。

開発環境，編集環境および実行環境のカスタム画面（新規画面）で使用しているJSPファイル
JSPファイルは，「ポータルプロジェクトディレクトリ¥ucnp¥custom」に格納されています。セットアップ時のポータルプロジェクトディレクトリは，ポータルプロジェクトディレクトリはユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティの指定値で確認できます。

開発環境，編集環境および実行環境の次に示すディレクトリ下のデータ

ナビゲーション プラットフォームインストールディレクトリ¥conf

開発環境の次に示すディレクトリ下のデータ

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK

ナビゲーション プラットフォームインストールディレクトリ¥usrlib

5.2.2　リストアするタイミングとデータについて

システム障害の発生や，ハードウェアの故障などでデータが破損した場合は，「5.2.1　バックアップするタイミングとデータについて」で取得したデータをリストアします。

認証サーバに登録されたユーザ情報
リストア方法については，ご使用のディレクトリサーバまたはJP1/Baseのマニュアルを参照してください。

開発環境，編集環境および実行環境に登録された業務コンテンツのデータ
npimportコマンド（業務コンテンツのインポート）を実行して，バックアップ時にエクスポートしたデータをインポートすることでリストアできます。業務コンテンツのインポートについては，「6.6.2　業務コンテンツのインポート」を参照してください。

開発環境，編集環境および実行環境の業務コンテンツで使用している静的ファイルのデータ

開発環境，編集環境および実行環境のカスタム画面（新規画面）で使用しているJSPファイル

開発環境，編集環境および実行環境の次に示すディレクトリ下のデータ

ナビゲーション プラットフォームインストールディレクトリ¥conf

開発環境の次に示すディレクトリ下のデータ

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK

ナビゲーション プラットフォームインストールディレクトリ¥usrlib

5.3　データベースの運用

業務コンテンツの追加や削除を繰り返すと，データベースへのアクセス効率や格納効率が低下することがあります。定期的にテーブルを再編成することで，この問題を軽減できます。ただし，問題の要因がRDエリアの容量不足である場合は，必要に応じてRDエリアを拡張してください。

また，定期的に行うテーブルの再編成といった通常時の運用のほかに，業務コンテンツの増加やバージョンアップによって，容量の再見積もりとRDエリアの拡張が必要になる場合もあります。それぞれの作業の流れについて次に説明します。

通常の運用の場合

通常時の運用で行う作業の流れを次に示します。

図5-1　データベースの運用の流れ（通常の運用の場合）

各作業の概要を説明します。

テーブルの再編成
データベースへのアクセス効率や格納効率を改善します。通常稼働を停止し，業務コンテンツのバックアップを取得してから実施してください。
次のタイミングを目安にすることをお勧めします。
編集環境または開発環境の場合
業務コンテンツを1,000回追加・削除・更新したタイミング。
追加・削除・更新の回数がわからない場合は，月1回を目安にしてください。
実行環境の場合
業務コンテンツを編集環境からインポートするタイミング。

データベースの状態確認
RDエリアのセグメント使用率から，データベースが容量不足になっていないかを確認します。テーブルを再編成するたびに実施してください。
使用率が70％未満であれば，通常稼働を再開できます。使用率が70％以上の場合，不要な業務コンテンツを削除してから再度テーブルの再編成，および状態確認を実施してください。

RDエリアの拡張
不要な業務コンテンツを削除してもRDエリアのセグメント使用率が70％以上になる場合に実施してください。

注意

セットアップで構築した環境でRDエリアを拡張すると，バージョンアップは手動で行う必要があります。コマンドを使用してバージョンアップを実施すると，拡張前のRDエリアが適用され，データベースの容量が不足するおそれがあります。

データベースの運用で使用するコマンドは，Windowsの管理者権限で実行してください。

業務コンテンツの容量を再見積もりしてデータベースを拡張する場合

次の条件に当てはまる場合は，データベースの容量を再見積もりして，RDエリアを拡張してください。

業務コンテンツ数の増加，業務フローやガイドパーツの追加，またはプラグインパーツの追加などによって，業務コンテンツの容量が大きく増加する予定がある

09-50より前のバージョンからバージョンアップする場合，バージョンアップ前の環境でデータベースを拡張していたとき

データベースの容量の再見積もりとRDエリアの拡張の流れを次に示します。

図5-2　データベースの運用の流れ（業務コンテンツの容量を再見積もりしてデータベースを拡張する場合）

各作業の概要を説明します。

データベースの容量の再見積もり
必要なRDエリアのセグメント数を算出します。

データベースの状態確認
RDエリアの拡張時に必要となる，現在のRDエリアのセグメント数を確認します。

RDエリアの拡張
RDエリアを拡張します。

＜この節の構成＞

5.3.1　テーブルの再編成

5.3.2　データベースの状態確認

5.3.3　RDエリアの拡張

5.3.1　テーブルの再編成

ここでは，テーブルを再編成する方法について説明します。

＜この項の構成＞

(1)　J2EEサーバの停止

(2)　業務コンテンツのバックアップ

(3)　作業ディレクトリの準備

(4)　テーブルの再編成

(1)　J2EEサーバの停止

テーブルを再編成する前に，J2EEサーバを停止する必要があります。J2EEサーバを停止する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

マシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバの起動／停止］アンカーをクリックし，論理サーバの起動／停止画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。
J2EEサーバが停止します。

(2)　業務コンテンツのバックアップ

業務コンテンツをエクスポートして，バックアップを取得しておきます。業務コンテンツをエクスポートする方法については，「6.6.1　業務コンテンツのエクスポート」を参照してください。

(3)　作業ディレクトリの準備

再編成で使用するディレクトリとファイルを格納するために，任意のディレクトリを作成してください。以降では，作成したディレクトリのことを「作業ディレクトリ」と呼びます。

なお，作成した作業ディレクトリは，2回目以降の再編成で繰り返し使用できます。

(a)　作業ディレクトリの条件

作業ディレクトリを作成するときの条件を次に示します。

作業ディレクトリ名には，次の文字を使用できます。
半角英数字（A～Z，a～z，0～9），ピリオド（.），半角スペース，半角丸括弧，#，@

データベースのHiRDBファイルシステム領域と同じ容量（デフォルトは4,679MB）のデータを格納できる場所にディレクトリを作成してください。なお，運用開始後にデータベースを拡張している場合は，拡張した容量も加えてください。また，検索機能を使用する場合は，HiRDBファイルシステム領域の3倍の容量が必要です。

(b)　作業ディレクトリ下へのディレクトリ・ファイルの追加

作業ディレクトリ下に，次のディレクトリを作成してください。

idxwork：インデックス情報ファイル格納用のディレクトリです。

sortwork：ソート用のディレクトリです。

また，作業ディレクトリ下に，再編成時の制御情報を記述した次のファイルを作成してください。

ファイル名

control_file

ファイルの記述内容

unload "作業ディレクトリ¥unload_file"
idxwork "作業ディレクトリ¥idxwork"
sort "作業ディレクトリ¥sortwork",8192
option exectime=監視時間

監視時間には，pdrorgの実行時間を監視する場合の監視時間を分単位で指定します。指定した監視時間内にpdrorgの処理が終了しなかった場合，無応答障害を検知して，pdrorgの処理を強制終了します。

なお，マシン性能によっては，監視時間を長めに設定する必要があります。KFPL20000-Eメッセージが出力される（タイムアウトエラーが発生する）場合は，監視時間を長めに設定してください。

監視時間の算出式および値の目安を次に説明します。

データベースの拡張と検索機能のセットアップを実施していない場合

1053

データベースの拡張または検索機能のセットアップを実施している場合

↑1053×拡張後のRDエリアのファイルサイズ÷拡張前のRDエリアのファイルサイズ↑ （単位：MB）

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

例：↑1.2↑ = 2　，↑2.0↑ = 2

拡張後のRDエリアのファイルサイズは，次のファイル名から始まるファイルの合計ファイルサイズ（単位：MB）です。

RDエリア格納先¥usr_contents

RDエリア格納先¥ucnp_search_user

RDエリア格納先¥ucnp_search_lob

拡張前のRDエリアのファイルサイズは，RDエリア格納先にあるusr_contentsという名称のファイルの容量です。

RDエリア格納先は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.rdarea.dirプロパティに指定されているディレクトリ（デフォルト値は「組み込みデータベースインストールディレクトリ¥AREA」）です。パス区切り文字は，「¥¥」ではなく「¥」を使用してください。

検索機能のセットアップだけ実施している場合

2479

ファイルの記述例

unload "C:¥ucnpwork¥unload_file"
idxwork "C:¥ucnpwork¥idxwork"
sort "C:¥ucnpwork¥sortwork",8192
option exectime=1053

(4)　テーブルの再編成

テーブルの再編成は，データベースが稼働している状態で実施します。ただし，ナビゲーション プラットフォームでデータベースを使用しているときは実施できません。

テーブルを再編成する手順を次に示します。

次のコマンドを実行して，データベースの操作に必要な環境変数を設定します。

ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

以降の手順でコマンドを実行する場合は，この手順で使用したコマンドプロンプトを使用してください。

次のコマンドを実行して，ナビゲーション プラットフォームで使用するRDエリアを閉塞します。

pdhold -r RDエリア名[,RDエリア名…]

可変値

RDエリア名

次のRDエリア名を指定します。

META

METAINDEX

TBL01

IDX01

LOB_CONTENTS01

UCNP_SEARCH_RD_DATA（検索機能を使用する場合）

UCNP_SEARCH_RD_XMLIDX（検索機能を使用する場合）

UCNP_SEARCH_RD_CONTENTIDIDX（検索機能を使用する場合）

戻り値

0：正常終了

4：警告終了（一部のRDエリアの処理にエラーあり）

8：異常終了

12：異常終了（内部エラーが発生したため，問い合わせ窓口に連絡してください）

コマンド実行例

検索機能を使用しない場合

pdhold -r META,METAINDEX,TBL01,IDX01,LOB_CONTENTS01

検索機能を使用する場合

pdhold -r META,METAINDEX,TBL01,IDX01,LOB_CONTENTS01,UCNP_SEARCH_RD_DATA,UCNP_SEARCH_RD_XMLIDX,UCNP_SEARCH_RD_CONTENTIDIDX

次のコマンドを実行して，テーブルを再編成します。

pdrorg -k rorg -t 認可識別子.all -u 認可識別子 制御情報ファイル名

可変値

認可識別子

データベース管理者権限を持つユーザ名を指定します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.idプロパティに指定したユーザ名です。デフォルト値は「ADMIN」です。

制御情報ファイル名

「作業ディレクトリ¥control_file」を指定します。

戻り値

0：正常終了

8：異常終了

コマンド実行例

pdrorg -k rorg -t ADMIN.all -u ADMIN "C:¥ucnpwork¥control_file"

このコマンドを実行すると，認可識別子のパスワードを要求されます。パスワードを入力して＜Enter＞キーを押してください。
ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.passwordプロパティに指定したパスワードです。デフォルト値は「UCNPPASS」です。
なお，コマンド実行時にKFPL20000-Eメッセージが出力される（タイムアウトエラーが発生する）場合は，「(3)(b)　作業ディレクトリ下へのディレクトリ・ファイルの追加」で設定した監視時間を長めに設定し直してから，手順3を再度実行してください。

次のコマンドを実行して，RDエリアの閉塞を解除します。

pdrels -r RDエリア名[,RDエリア名…]

可変値

RDエリア名

次のRDエリア名を指定します。

META

METAINDEX

TBL01

IDX01

LOB_CONTENTS01

UCNP_SEARCH_RD_DATA（検索機能を使用する場合）

UCNP_SEARCH_RD_XMLIDX（検索機能を使用する場合）

UCNP_SEARCH_RD_CONTENTIDIDX（検索機能を使用する場合）

戻り値

0：正常終了

1：警告終了

4：警告終了（一部のRDエリアの処理にエラーあり）

8：異常終了

12：異常終了（内部エラーが発生したため，問い合わせ窓口に連絡してください）

コマンド実行例

検索機能を使用しない場合

pdrels -r META,METAINDEX,TBL01,IDX01,LOB_CONTENTS01

検索機能を使用する場合

pdrels -r META,METAINDEX,TBL01,IDX01,LOB_CONTENTS01,UCNP_SEARCH_RD_DATA,UCNP_SEARCH_RD_XMLIDX,UCNP_SEARCH_RD_CONTENTIDIDX

5.3.2　データベースの状態確認

この手順で確認することは，作業の目的によって次のとおり異なります。

通常の運用の場合
テーブルの再編成を実施したら，データベースの状態を確認してRDエリアの拡張要否を判断します。

業務コンテンツの増加などによって，データベースの容量を再見積もりして拡張する場合
拡張時の見積もりに必要な，現在のRDエリアのセグメント数を確認します。

この作業で使用するコマンドは，データベース管理者権限を持つユーザで実行してください。データベースの状態を確認する手順を次に示します。

次のコマンドを実行して，データベースの操作に必要な環境変数を設定します。

ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

以降の手順でコマンドを実行する場合は，この手順で使用したコマンドプロンプトを使用してください。

次のコマンドを実行して，データベースの状態を確認します。

pddbst -r LOB_CONTENTS01 -k phys -f -u 認可識別子 -p パスワード

可変値

認可識別子

データベース管理者権限を持つユーザ名を指定します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.idプロパティに指定したユーザ名です。デフォルト値は「ADMIN」です。

パスワード

認可識別子のパスワードを指定します。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.passwordプロパティに指定したパスワードです。デフォルト値は「UCNPPASS」です。

戻り値

0：正常終了

4：警告終了（指定不正，または解析処理スキップ）

8：異常終了

コマンド実行例

pddbst -r LOB_CONTENTS01 -k phys -f -u ADMIN -p UCNPPASS

ここからは，作業の目的によって手順が異なります。通常の運用の場合と，業務コンテンツの増加などによって，データベースの容量を再見積もりして拡張する場合に分けて説明します。

＜この項の構成＞

(1)　通常の運用の場合

(2)　業務コンテンツの増加などによって，データベースの容量を再見積もりして拡張する場合

(1)　通常の運用の場合

コマンドの実行結果を基に，RDエリアの拡張要否を判断します。
コマンドの実行結果の例を次に示します。

コマンドの実行結果に表示される[　]で囲まれた番号の意味は次のとおりです。
[1]：RDエリア名
[2]：セグメント使用率
[3]：使用中のセグメント数
[4]：RDエリア中のセグメント数の合計
この例の赤い枠で囲んだ部分で，RDエリアのセグメント使用率を確認します。RDエリアのセグメント使用率が70％未満の場合，データベースの状態に問題はありません。70％以上の場合，次の手順へ進んでください。

不要な業務コンテンツを削除します。
検索機能を使用する場合，業務コンテンツを削除したあとに検索用データを更新する必要があります。検索用データを更新する方法については，「6.8　検索用データの更新」を参照してください。

再度テーブルを再編成し，データベースの状態を確認します。
それでもセグメント使用率が70％以上になる場合は，RDエリアの拡張が必要です。

RDエリアを拡張する必要がない場合，J2EEサーバを起動して通常稼働を再開します。RDエリアを拡張する必要がある場合，「5.3.3　RDエリアの拡張」に進んでください。

J2EEサーバを起動する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

マシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［起動］ボタンをクリックします。
J2EEサーバが起動します。

(2)　業務コンテンツの増加などによって，データベースの容量を再見積もりして拡張する場合

コマンドの実行結果を基に，RDエリアのセグメント数を確認します。
コマンドの実行結果の例を次に示します。

コマンドの実行結果に表示される[　]で囲まれた番号の意味は次のとおりです。
[1]：RDエリア名
[2]：セグメント使用率
[3]：使用中のセグメント数
[4]：RDエリア中のセグメント数の合計
この例の赤い枠で囲んだ部分で，現在のRDエリアのセグメント数を確認します。ここで確認した値を基に，拡張する規模を算出してRDエリアを拡張します。

5.3.3　RDエリアの拡張

ここでは，RDエリアを拡張する方法について説明します。

＜この項の構成＞

(1)　拡張する規模の算出

(2)　データベースの環境変数の設定

(3)　HiRDBファイルシステム領域の作成

(4)　制御文ファイルの作成

(5)　RDエリアの拡張

(6)　J2EEサーバの起動

(1)　拡張する規模の算出

拡張するRDエリアのセグメント数，およびHiRDBファイルシステム領域の容量をRDエリアごとに算出します。

検索機能を使用しない場合，RDエリア「LOB_CONTENTS01」の規模を算出してください。検索機能を使用する場合，「LOB_CONTENTS01」に加えて，「UCNP_SEARCH_RD_DATA」と「UCNP_SEARCH_RD_XMLIDX」の規模を算出してください。

(a)　RDエリアのセグメント数の算出

RDエリアの種類によって計算式が異なります。

RDエリア「LOB_CONTENTS01」の場合
通常の運用でRDエリアの容量が不足した際に拡張する場合と，データベースの容量を再見積もりした結果を基にRDエリアを拡張する場合で，計算式が異なります。

通常の運用でRDエリアの容量が不足した際に拡張する場合

RDエリア「LOB_CONTENTS01」のセグメント数＝LOB_CONTENTS01の拡張前のセグメント数÷2

データベースの容量を再見積もりした結果を基にRDエリアを拡張する場合

RDエリア「LOB_CONTENTS01」のセグメント数＝再見積もりで算出したRDエリアのセグメント数－LOB_CONTENTS01の拡張前のセグメント数

LOB_CONTENTS01の拡張前のセグメント数を確認する方法については，「5.3.2　データベースの状態確認」を参照してください。

RDエリア「UCNP_SEARCH_RD_DATA」の場合

RDエリア「UCNP_SEARCH_RD_DATA」のセグメント数＝↑0.04×LOB_CONTENTS01のセグメント数※↑

RDエリア「UCNP_SEARCH_RD_XMLIDX」の場合

RDエリア「UCNP_SEARCH_RD_XMLIDX」のセグメント数＝↑0.8×LOB_CONTENTS01のセグメント数※↑

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

注※　計算式内の「LOB_CONTENTS01のセグメント数」は，「RDエリア「LOB_CONTENTS01」の場合」で求めたLOB_CONTENTS01のセグメント数を使用してください。

（例）通常の運用でRDエリアの容量が不足した際に拡張する場合

RDエリア「LOB_CONTENTS01」の拡張前のセグメント数の合計が201,500の場合，RDエリア「LOB_CONTENTS01」は100,750を拡張します。

（例）データベースの容量を再見積もりした結果を基にRDエリアを拡張する場合

再見積もりで算出したRDエリアのセグメント数が301,500，RDエリア「LOB_CONTENTS01」の拡張前のセグメント数が201,500の場合，RDエリア「LOB_CONTENTS01」は100,000を拡張します。

(b)　HiRDBファイルシステム領域の容量の算出

RDエリアの種類によって計算式が異なります。

RDエリア「LOB_CONTENTS01」の場合

HiRDBファイルシステム領域（MB）＝↑↑（拡張するRDエリアのセグメント数×8,192）÷1,024÷1,024↑×1.3↑

RDエリア「UCNP_SEARCH_RD_DATA」の場合

HiRDBファイルシステム領域（MB）＝↑（拡張するRDエリアのセグメント数×22×8,192）÷1,024÷1,024↑

RDエリア「UCNP_SEARCH_RD_XMLIDX」の場合

HiRDBファイルシステム領域（MB）＝↑（拡張するRDエリアのセグメント数×1.1×8,192）÷1,024÷1,024↑

注　計算式内の「↑　↑」で囲まれた部分は，小数点以下を切り上げてください。

（例）通常の運用でRDエリアの容量が不足した際に拡張する場合

拡張するRDエリア「LOB_CONTENTS01」のセグメント数が100,750の場合の計算式を次に示します。

↑↑（100,750×8,192）÷1,024÷1,024↑×1.3↑＝1,025MB

（例）データベースの容量を再見積もりした結果を基にRDエリアを拡張する場合

拡張するRDエリア「LOB_CONTENTS01」のセグメント数が100,000の場合の計算式を次に示します。

↑↑（100,000×8,192）÷1,024÷1,024↑×1.3↑=1,017MB

(2)　データベースの環境変数の設定

データベースの環境変数を設定する手順を次に示します。

次のコマンドを実行して，データベースの操作に必要な環境変数を設定します。

ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

以降の手順でコマンドを実行する場合は，この手順で使用したコマンドプロンプトを使用してください。

(3)　HiRDBファイルシステム領域の作成

HiRDBファイルシステム領域の作成手順を次に示します。

次のコマンドを実行して，HiRDBファイルシステム領域を作成します。

pdfmkfs -r -i -n HiRDBファイルシステム領域の容量 -l 20 -e 100 -k HiRDBファイルシステム領域名

可変値

HiRDBファイルシステム領域の容量

「(1)　拡張する規模の算出」で算出したHiRDBファイルシステム領域の容量をMB単位で指定します。指定できる範囲は1～1,048,575（符号なし整数）です。

ただし，FAT32ファイルシステムを使用している場合，指定できる容量は最大4,096MBです。

HiRDBファイルシステム領域名

HiRDBファイルシステム領域として，次の値を165文字以内で指定します。

RDエリア名 | HiRDBファイルシステム領域名
LOB_CONTENTS01 | RDエリア格納先¥usr_contents_日付
UCNP_SEARCH_RD_DATA | RDエリア格納先¥ucnp_search_user_日付
UCNP_SEARCH_RD_XMLIDX | RDエリア格納先¥ucnp_search_lob_日付

RDエリア格納先には，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.rdarea.dirプロパティに指定されているディレクトリを指定してください。デフォルト値は「組み込みデータベースインストールディレクトリ¥AREA」です。

戻り値

0：正常終了

-1：異常終了

コマンド実行例

検索機能を使用しない場合

pdfmkfs -r -i -n 1025 -l 20 -e 100 -k DB "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥usr_contents_20101010​"

検索機能を使用する場合

pdfmkfs -r -i -n 1025 -l 20 -e 100 -k DB "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥usr_contents_20101010​"
pdfmkfs -r -i -n 693 -l 20 -e 100 -k DB "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥ucnp_search_user_20101010​"
pdfmkfs -r -i -n 693 -l 20 -e 100 -k DB "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥ucnp_search_lob_20101010​"

(4)　制御文ファイルの作成

「5.3.1(3)　作業ディレクトリの準備」で作成した作業ディレクトリに，制御文ファイルを作成して格納します。

ファイル名

ucnp_expand_日付

ファイルの記述内容

検索機能を使用しない場合

expand rdarea LOB_CONTENTS01
 file name "HiRDBファイルシステム領域名¥contents"
 initial セグメント数 segments;

検索機能を使用する場合

expand rdarea LOB_CONTENTS01
 file name "HiRDBファイルシステム領域名¥contents"
 initial セグメント数 segments;

expand rdarea UCNP_SEARCH_RD_DATA
 file name "HiRDBファイルシステム領域名¥search_data"
 initial セグメント数 segments;

expand rdarea UCNP_SEARCH_RD_XMLIDX
 file name "HiRDBファイルシステム領域名¥index_xml"
 initial セグメント数 segments;

可変値

HiRDBファイルシステム領域名

「(3)　HiRDBファイルシステム領域の作成」で作成したHiRDBファイルシステム領域を指定します。

セグメント数

「(1)　拡張する規模の算出」で算出したRDエリアのセグメント数を指定します。

ファイルの記述例

検索機能を使用しない場合

expand rdarea LOB_CONTENTS01
 file name "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥usr_contents_20101010​¥contents"
 initial 100750 segments;

検索機能を使用する場合

expand rdarea LOB_CONTENTS01
 file name "C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥usr_contents_20101010​¥contents"
 initial 100750 segments;

expand rdarea UCNP_SEARCH_RD_DATA
 file name
"C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥ucnp_search_user_20101010​¥search_data"
 initial 4030 segments;

expand rdarea UCNP_SEARCH_RD_XMLIDX
 file name
"C:¥Program Files¥HITACHI¥ECMPKG¥PP¥hirdb_e_EP0¥AREA¥ucnp_search_lob_20101010​¥index_xml"
 initial 80600 segments;

(5)　RDエリアの拡張

RDエリアの拡張手順を次に示します。

次のコマンドを実行して，RDエリアを拡張します。

pdmod -a 制御文ファイルのファイルパス

可変値

制御文ファイルのファイルパス

「(4)　制御文ファイルの作成」で作成した制御文ファイルのパスを255文字以内で指定します。

コマンド実行例

pdmod -a "C:¥ucnpwork¥ucnp_expand_20101010​"

(6)　J2EEサーバの起動

RDエリアの拡張が完了したら，J2EEサーバを起動して通常稼働を再開します。

J2EEサーバを起動する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

マシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［起動］ボタンをクリックします。
J2EEサーバが起動します。

5.4　業務コンテンツの操作ログの設定

操作ログとは，業務コンテンツでの操作でノードを遷移するごとに出力される，操作履歴です。

操作ログは，業務コンテンツの改善点を見つけるための分析資料として使用できます。例えば，テキストファイルとして出力される操作ログを表計算ソフトで加工および分析し，次のノードへ遷移するまでの時間がほかのノードよりも長いノードが見つかれば，なぜ時間が掛かるのかを利用者にヒアリングしてガイドの説明を改善する，などの活用ができます。

操作ログは，デフォルトで出力されます。操作ログの出力を停止したり，操作ログの格納先や出力内容などをカスタマイズしたりしたい場合は，ユーザプロパティファイル（ucnp_user.properties）の関連するプロパティの指定値を見直します。ユーザプロパティファイル（ucnp_user.properties）の詳細については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

ガイドパーツで入力値チェックを行っている場合の注意事項

操作ログはサーバ側で取得しています。テキストボックスパーツやテキストエリアパーツの入力値チェックはクライアント側で動作するため，入力値チェックの操作ログは取得できません。

入力値チェックの結果を操作ログとして取得したい場合は，入出力プラグインを使って値をチェックするようにしてください。

中断再開プラグインを使用している場合の注意事項

操作ログが取得されるのは，業務フロー開始時およびノード遷移時だけです。フロー中断時およびフロー再開時には，操作ログは取得されません。フロー中断時およびフロー再開時のログを取得したい場合は，中断再開プラグインにログを取得する処理を組み込む必要があります。

なお，ナビゲーション プラットフォームが提供する操作ログには書き込まないでください。操作ログへの直接書き込みをすると，操作ログのファイルが壊れるおそれがあります。

参考

操作ログとは別に監査ログがあります。監査ログの取得方法や項目については，「5.5　監査ログとは」を参照してください。

＜この節の構成＞

5.4.1　操作ログの内容

5.4.2　操作ログの出力先，面数，サイズ

5.4.1　操作ログの内容

＜この項の構成＞

(1)　操作ログに出力される項目

(2)　出力されるタイミング

(3)　出力形式

(1)　操作ログに出力される項目

操作ログには次の項目が出力されます。出力する項目は，ユーザプロパティファイル（ucnp_user.properties）で変更できます。

表5-1　操作ログに出力される項目

項目
説明

日時
操作ログが出力された日時です。日時のフォーマットは，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.operationlog.dateformatプロパティで変更できます。なお，タイムゾーンはナビゲーション プラットフォームのサーバの設定に準じます。

通算ミリ秒
操作ログが出力された日時の通算ミリ秒です。出力された時刻と協定世界時のUTC1970年1月1日午前0時との差をミリ秒で表します。

セッションID
ノードを遷移させた利用者のセッションIDです。

ユーザID
ノードを遷移させた利用者のユーザIDです。

業務コンテンツID
ノードが遷移した業務コンテンツのIDです。

業務コンテンツ名称
ノードが遷移した業務コンテンツの名称です。

遷移種別
どのようにノードを遷移させたかを表す種別です。次の5種類があります。

start：業務フローの開始

show_next_page：［次へ］ボタンなどのクリックによる次のノードへの遷移
ただし，業務フローの最後のプロセスノード（［戻る］ボタン非表示）の場合は，［次へ］ボタンをクリックしたときの遷移種別はshow_complete_pageになります。

show_previous_page：［戻る］ボタンなどのクリックによる前のノードへの遷移

show_complete_page：［次へ］ボタンや［完了］ボタンなどのクリックによる業務フローの終点（プロセスノード※1またはターミナルノード）への遷移

jump：業務フロー上での直接遷移

遷移元ノードのID
遷移元のノードの情報です。
なお，次の場合は空文字が出力されます。

始点にターミナルノードが配置されていない業務フローの開始時

ノードの直接遷移が許可されている場合で，業務フローが完了した状態からの遷移時

遷移元ノードの名称

実際の遷移先ノードのID
実際に遷移した先のノードの情報です。次の場合は，指定した遷移先ノードの情報とこの項目で出力される情報が異なります。

入出力プラグインでエラーが発生し，指定した遷移先ノードと実際に遷移したノードが異なった場合

入出力プラグインの実行確認ダイアログで［キャンセル］ボタンをクリックした場合

なお，業務フローの開始時で，かつ開始のプロセスノード，または開始のターミナルノードに接続されていない先頭のプロセスノードの入出力プラグインでエラーが発生した場合は，空文字が出力されます。

実際の遷移先ノードの名称

指定した遷移先ノードのID
利用者が指定した遷移先のノードの情報です。次の場合は，実際の遷移先ノードの情報とこの項目で出力される情報が異なります。

入出力プラグインでエラーが発生し，指定した遷移先ノードと実際に遷移したノードが異なった場合

入出力プラグインの実行確認ダイアログで［キャンセル］ボタンをクリックした場合

指定した遷移先ノードの名称

エラーフラグ
入出力プラグイン（ユーザプラグイン）の結果を表すフラグです。次に示す種類があります。

OK※2：入出力プラグインの結果が成功，または入出力プラグインが存在しない

WARNING※2：入出力プラグインの結果が警告
入出力プラグインのIIoPluginControllerインタフェースにあるinputFromNodeメソッドまたはoutputToNodeメソッドで，戻り値のMapにucnp.error.messageキーが設定され，かつucnp.error.typeキーにWARNINGが設定された場合に，入出力プラグインの結果が成功だとWARNINGのエラーフラグが出力されます。

NG：入出力プラグインの結果が失敗（IIoPluginControllerインタフェース）
inputFromNodeメソッドまたはoutputToNodeメソッドで，戻り値のMapにucnp.error.messageキーが設定され，かつucnp.error.typeキーにNGが設定された場合，またはinputFromNodeメソッドまたはoutputToNodeメソッドが予期しない例外をスローした場合に，NGのエラーフラグが出力されます。

NG：入出力プラグインの結果が失敗（IIoActionControllerインタフェース（旧バージョンとの互換用））
executeメソッドで，戻り値のMapにucnp.error.messageキーが設定された場合，またはexecuteメソッドが予期しない例外をスローした場合に，NGのエラーフラグが出力されます。入出力プラグインの処理の詳細については，プラグインを開発したユーザに確認してください。

CANCEL：入出力プラグインの実行確認ダイアログでキャンセルを選択（プラグインが実行されていない）

ucnpOptionsパラメタ
ucnpOptionsパラメタに指定された値です。ucnpOptionsパラメタが指定されていない場合は，空文字が出力されます。

注※1

業務フローの終点にプロセスノードを配置する業務コンテンツで，業務が完了した正確なタイミングを分析したい場合は，終点のプロセスノードの［戻る］ボタンを表示しない設定にする必要があります。

終点にプロセスノードを配置する場合は，［戻る］ボタンを表示しないように，コンテンツ管理者またはコンテンツ編集者に指示をしてください。また，［戻る］ボタンを非表示にする設定については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

注※2

直接遷移による遷移では，入出力プラグインの結果がOKとWARNINGが混在することがあります。混在した場合は，操作ログにはWARNINGが出力されます。

(2)　出力されるタイミング

操作ログは，業務実行画面で業務フローを開始したとき，および，ノードが遷移したときに出力されます。また，プロセスノードのクリックによって直接遷移した場合は，操作ログは出力されますが，途中にあるノードの情報は出力されません。ただし，次の場合はノードを遷移しても操作ログは出力されません。

必須のチェックボックスが未チェックのエラーが発生した

テキストボックスまたはテキストエリアの入力値チェックでエラーが発生した

(3)　出力形式

操作ログは，デフォルトではタブ区切りで出力されます。操作ログの出力フォーマットや日時の表示形式などは，ユーザプロパティファイル（ucnp_user.properties）の次のプロパティで変更できます。必要に応じてカスタマイズしてください。

操作ログの出力フォーマット（ucnp.base.server.operationlog.format）

操作ログに出力される日時の表示形式（ucnp.base.server.operationlog.dateformat）

操作ログの文字コード（ucnp.base.server.operationlog.encoding）

詳細については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

［次へ］ボタンをクリックしてノードを遷移した場合の，デフォルトの設定での操作ログの出力例を示します。

表5-2　操作ログの出力項目と出力例の値

出力項目
出力例の値

日時
2012年9月19日17時19分41秒109ミリ秒

利用者のユーザID
user1

業務コンテンツ

ID：268e3592-0133-1000-8002-00000ad23cbb-0

名称：コンテンツ1

遷移元のプロセスノード

ID：P001

名称：プロセスノードA

実際の遷移先のプロセスノード

ID：P002

名称：プロセスノードB

指定した遷移先のプロセスノード

ID：P003

名称：プロセスノードC

遷移時の操作
［次へ］ボタンをクリックして遷移

エラーフラグ
プラグインの結果が失敗

操作ログの出力例

2012/09/19△17:19:41.109（タブ）1348042781109（タブ）00946E257CB395F59C9519BB77C3FF28CsR8JWB_2（タブ）user1（タブ）268e3592-0133-1000-8002-00000ad23cbb-0（タブ）コンテンツ1（タブ）show_next_page（タブ）P001（タブ）プロセスノードA（タブ）P002（タブ）プロセスノードB（タブ）P003（タブ）プロセスノードC（タブ）NG

（凡例）

△：半角スペース

（タブ）：タブ

5.4.2　操作ログの出力先，面数，サイズ

操作ログの出力先，面数，サイズについて説明します。

出力先

デフォルトの出力先は次のとおりです。

ナビゲーション プラットフォームインストールディレクトリ¥operationlogs¥operation[N].log（[N]はファイル面数）

面数

操作ログはシーケンシャルファイルです。例えば「operation0.log」が一定の容量に達した場合，ファイル名は「operation1.log」に変更されて保存され，新たな「operation0.log」が作成され，そこに操作ログが出力されます。よって，[N]の数値が大きいファイルほど古いファイルとなります。[N]が一定の面数に達すると，古いファイルから自動的に削除されます。

デフォルトの面数は16面です。例えば，「operation0.log」から「operation15.log」まで作成されると，古いファイル（operation15.log）から削除されます。

ファイルサイズ

デフォルトのファイルサイズは10,240KBです。

なお，これらの項目はユーザプロパティファイル（ucnp_user.properties）で変更できます。

設定を変更する場合のプロパティ

操作ログの出力先，面数，ファイルサイズをデフォルトから変更したい場合は，次のプロパティの指定値を変更してください。

操作ログの出力先（ucnp.base.server.operationlog.path）

操作ログの最大面数（ucnp.base.server.operationlog.backup.number）

操作ログのファイルサイズの上限値（ucnp.base.server.operationlog.size）

プロパティの指定値については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

5.5　監査ログとは

監査ログとは，セキュリティ対策のために「いつ」「だれが」「何に対して」「どのような操作をしたか」を記録し，出力するログ情報です。監査ログは操作ログとは異なり，操作結果の正常／異常，あるいは機能実行の成功／失敗などのメッセージも重要となります。

監査ログはJP1/Audit Management - Managerで参照できます。詳細はマニュアル「JP1/Audit Management - Manager 構築・運用ガイド」を参照してください。

＜この節の構成＞

5.5.1　監査ログを取得するための設定

5.5.2　監査ログに出力される項目

5.5.3　監査ログが出力されるタイミング

5.5.4　監査ログの出力形式と出力例

5.5.5　監査ログの出力先，面数，サイズ

5.5.6　監査ログの見積もり

5.5.7　監査ログに出力されるメッセージ一覧

5.5.1　監査ログを取得するための設定

監査ログを取得するには，ナビゲーション プラットフォームのユーザプロパティファイル（ucnp_user.properties）で監査ログに関連するプロパティに必要な値を指定します。関連するプロパティを次に示します。

監査ログの使用有無（ucnp.base.client.auditlog.enable）

監査ログの出力先（ucnp.base.server.auditlog.path）

監査ログの最大面数（ucnp.base.server.auditlog.backup.number）

監査ログのファイルサイズの上限値（ucnp.base.server.auditlog.size）

プロパティの指定値については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

注意事項

操作ログでは業務フローの最後のノードがプロセスノードの場合でも，業務コンテンツの終了を示すログが出力されますが，監査ログの場合は業務コンテンツの終了を示すログが出力されるのは，ターミナルノードに遷移したときだけです。
正確な監査ログを取得するために，監査ログの対象とする業務コンテンツは，業務フローの終端にターミナルノードを配置して作成することを推奨します。

ユーザプロパティファイル（ucnp_user.properties）ucnp.base.client.directjump.enableプロパティに「all」が設定されていると，業務フローが完了した状態からプロセスノードに遷移できます。このため，「業務コンテンツの終了」の監査ログが出力されたあとに，「ノード遷移」の監査ログが出力されます。また，業務フローの完了時には遷移元ノードIDと遷移元ノード名称は空文字が出力されます。監査ログを使用して業務実行を監査する場合は，ucnp.base.client.directjump.enableプロパティには「all」以外を設定することを推奨します。

5.5.2　監査ログに出力される項目

監査ログには次の項目が出力されます。

項番
出力項目名
出力項目の意味
説明

1
－
共通仕様識別子
共通仕様の識別子「CALFHM」が固定で出力されます。

2
－
共通仕様リビジョン番号
共通仕様のリビジョン番号「1.0」が固定で出力されます。

3
seqnum
通番
監査ログの通番が出力されます。

4
msgid
メッセージID
監査ログのメッセージIDが，次の形式で出力されます。
KDCZnnnnn-y

KDCZ
メッセージのプリフィックス

nnnnn
コンポーネントごとのメッセージの通番

y
重要度。重要度には，E（エラー情報），W（警告情報），I（通知情報）があります。

5
date
発生日時
メッセージが出力された日時が，次の形式で出力されます。
YYYY-MM-DDThh:mm:ss.sssTZD

YYYY：西暦年

MM：月

DD：日

T：日付と時間の区切り

hh：時

mm：分

ss：秒

sss：マイクロ秒

TZD：タイムゾーン

タイムゾーンは，UTCからの時差で表示されます。表示形式を次に示します。

+hh:mm：UTCからhh時間mm分進んでいる

-hh:mm：UTCからhh時間mm分遅れている

Z：UTCと同じ

（例）日本の場合：+09:00
なお，タイムゾーンはナビゲーション プラットフォームのサーバの設定に準じます。

6
progid
プログラム名
監査事象が発生したプログラムの名称が出力されます。
「uCNP」が固定で出力されます。

7
compid
コンポーネント名
監査事象が発生したコンポーネント名が出力されます。
「Server」が固定で出力されます。

8
pid
プロセスID
監査事象が発生したプロセスIDが出力されます。

9
ocp:host
発生場所
監査事象が発生したホストのホスト識別情報（ホスト名）が出力されます。
発生場所が特定できない場合は，「localhost」が出力されます。

10
ctgry
監査事象種別
監査事象の種別が出力されます。監査事象の種別には，次のどちらかが出力されます。

Authentication：識別・認証

ContentAccess：重要情報アクセス

11
result
監査事象結果
監査事象の結果が出力されます。監査事象の結果には，次のどちらかが出力されます。

Success：成功

Failure：失敗

12
subj:uid
サブジェクト情報
監査事象の発生元が出力されます。次の値が出力されます。

ノード遷移を実施した利用者のユーザID

ログインに失敗した場合は[NULL]が出力されます。

13
op
動作情報
監査事象を発生させた操作の種別が出力されます。次のどれかが出力されます。

監査事象種別が「Authentication」の場合
Login：ログイン
Logout：ログアウト

監査事象種別が「ContentAccess」の場合
Refer：参照

14
logtype
ログ種別情報
ログの種類が出力されます。
「BasicLog」が固定で出力されます

15
msg
自由記述
監査事象の内容を示す任意のメッセージが出力されます。
なお，メッセージは次の形式で出力されます。

メッセージの中のダブル引用符（"）は，ダブル引用符2文字（""）に置き換えられます。

メッセージの先頭と末尾にダブル引用符（"）を追加されます。

情報が取得できない場合は[NULL]が出力されます。

（凡例）　－：該当しない

5.5.3　監査ログが出力されるタイミング

監査ログは，次の操作に対して出力されます。

ログインの成功

ログインの失敗

ログアウトの成功

ログアウトの失敗

業務コンテンツの開始

業務コンテンツの終了

業務コンテンツのノード遷移

業務コンテンツの一時保存

業務コンテンツの再開

5.5.4　監査ログの出力形式と出力例

監査ログの出力形式を次に示します。

CALFHM 1.0, 出力項目1＝値1，出力項目2＝値2，・・・，出力項目n＝値n

監査ログの出力例を次に示します。

CALFHM 1.0， seqnum=1， msgid=KDCZ30002-I， date=2013-06-06T13:40:58.037+09:00， progid=uCNP， compid=Server， pid=4028， ocp:host=hostA， ctgry=Authentication， result=Success， subj:uid=Administrator， op=Login， logtype=BasicLog， msg="ログインに成功しました。"

5.5.5　監査ログの出力先，面数，サイズ

監査ログの出力先，面数，サイズについて説明します。

出力先

デフォルトの出力先は次のとおりです。

ナビゲーション プラットフォームインストールディレクトリ¥¥auditlog¥¥ucnp_audit[N].log（[N]はファイル面数）

面数

監査ログは，シーケンシャルファイルです。例えば「ucnp_audit1.log」が一定の容量に達すると，「ucnp_audit1.log」が保存され，新たに「ucnp_audit2.log」が作成され，そこに監査ログが出力されます。「ucnp_audit2.log」が一定の容量に達すると，「ucnp_audit2.log」が保存され，新たに「ucnp_audit3.log」が作成され，そこに監査ログが出力されます。面数が，監査ログの最大面数（ucnp.base.server.auditlog.backup.number）で指定した値に達すると，古いファイルから自動的に削除されます。

デフォルトの面数は16面です。例えば，「ucnp_audit1.log」から「ucnp_audit16.log」まで作成されると，古いファイル（ucnp_audit1.log）から削除されます。

ファイルサイズ

デフォルトのファイルサイズは10,240KBです。

なお，これらの項目はユーザプロパティファイル（ucnp_user.properties）で変更できます。

設定を変更する場合のプロパティ

監査ログの出力先（ucnp.base.server.auditlog.path）

監査ログの最大面数（ucnp.base.server.auditlog.backup.number）

監査ログのファイルサイズの上限値（ucnp.base.server.auditlog.size）

プロパティの指定値の詳細については，「7.4　ユーザプロパティファイル（ucnp_user.properties）の設定」を参照してください。

5.5.6　監査ログの見積もり

監査ログの容量を見積もります。見積もり式を次に示します。(1)と(2)の合計が，監査ログが使用する容量です。中断再開プラグインによる業務コンテンツの一時保存，および業務コンテンツの再開を監査ログに出力する場合は(3)の値も合計してください。

＜この項の構成＞

(1)　ログイン，ログアウトの操作で使用する監査ログの容量（1日分）

(2)　業務コンテンツの操作で使用する監査ログの容量（1日分）

(3)　業務コンテンツの一時保存，および業務コンテンツの再開で使用する監査ログの容量（1日分）

(4)　監査ログの容量の見積もり例

(1)　ログイン，ログアウトの操作で使用する監査ログの容量（1日分）

｛ログイン操作の監査ログ量＝A×B×C×（250＋D）｝＋｛ログアウト操作の監査ログ量＝A×E×C×（255＋D）｝（単位：バイト）

（凡例）

A：利用者数

B：ログイン回数

C：実働時間（単位：時間）

D：ユーザIDのバイト数

E：ログアウト回数

(2)　業務コンテンツの操作で使用する監査ログの容量（1日分）

｛業務コンテンツの開始／終了の監査ログ量＝A×2×B×C×（380＋D）｝＋｛業務コンテンツのノード遷移の監査ログ量＝A×E×B×C×（380＋（F×3）＋（G×3））｝（単位：バイト）

（凡例）

A：利用者数

B：実働時間（単位：時間）

C：1時間の業務実行回数

D：業務コンテンツ名のバイト数

E：プロセスノードの遷移回数

F：プロセスノード名のバイト数

G：プロセスノードIDのバイト数

(3)　業務コンテンツの一時保存，および業務コンテンツの再開で使用する監査ログの容量（1日分）

370＋A＋B（単位：バイト）

（凡例）

A：ユーザIDのバイト数

B：業務コンテンツ名のバイト数

(4)　監査ログの容量の見積もり例

次に示す見積もり条件を基に，監査ログの容量を見積もる例を示します。

項番
算出に必要な情報
この例での設定値

1

利用者数

実行環境の1日の利用者数です。

10

2
ユーザIDのバイト数
10

3

ログイン回数

1人の利用者がログインする回数です。

1

4

ログアウト回数

1人の利用者がログアウトする回数です。

1

5

1時間の業務実行回数

1人の利用者が1時間に業務コンテンツを実施する回数です。

6（10分ごとに1業務）

6
業務コンテンツ名のバイト数
30

7

プロセスノードの遷移回数

1業務コンテンツで遷移するプロセスノード数です。

10

8
プロセスノード名のバイト数
20

9
プロセスノードのIDのバイト数
10

10

実働時間

1日の実働時間です。

8

ログイン操作，およびログアウト操作に関する監査ログの容量（1日分）の見積もり例

｛10×1×8×（250＋10）｝＋｛10×1×8×（255＋10）｝＝42,000バイト

業務コンテンツの操作に関する監査ログの容量（1日分）の見積もり例

｛10×2×8×6×（380＋30）｝＋｛10×10×8×6×（380＋（20×3）＋（10×3））｝＝2,649,600バイト

監査ログが使用する容量の見積もり例

42,000＋2,649,600＝2,691,600バイト

5.5.7　監査ログに出力されるメッセージ一覧

監査ログに出力されるメッセージの一覧を次に示します。

メッセージID | メッセージ
KDCZ30001-I | ログインに成功しました。
KDCZ30002-E | ログインに失敗しました。
KDCZ30003-I | ログアウトに成功しました。
KDCZ30004-W | ログアウトに失敗しました。
KDCZ30005-I | 業務コンテンツを開始しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID）
KDCZ30006-I | 業務コンテンツを終了しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID）
KDCZ30007-I※1 | ノード遷移しました。（遷移元ノード名=遷移元ノード名, 遷移元ノードID=遷移元ノードID, 指定した遷移先ノード名=指定した遷移先ノード名, 指定した遷移先ノードID=指定した遷移先ノードID, 実際の遷移先ノード名=実際の遷移先ノード名, 実際の遷移先ノードID=実際の遷移先ノードID）
KDCZ30008-I | 業務コンテンツの中断に成功しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID, 中断ID=中断ID※2）
KDCZ30009-E | 業務コンテンツの中断に失敗しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID）
KDCZ30010-I | 業務コンテンツの再開に成功しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID, 中断ID=中断ID※2※3）
KDCZ30011-E | 業務コンテンツの再開に失敗しました。（業務コンテンツ名=業務コンテンツ名, 業務コンテンツID=業務コンテンツID）

注※1

入出力プラグインでエラーが発生した場合，または実行確認ダイアログで［キャンセル］ボタンをクリックした場合，メッセージに表示される遷移先ノードの情報と，実際に遷移したノードは異なります。

注※2

中断した業務コンテンツを識別するための文字列です。中断IDはサーバ側で取得しています。

注※3

09-50以前のバージョンの中断情報の場合は，中断IDに[NULL]が出力されます。

5.6　中断情報の運用

中断再開プラグインを使用する場合，利用者が業務実行画面で入力した情報が中断情報として保存されます。中断情報は，必要に応じて次の運用を実施してください。

中断情報の容量再見積もり

中断情報の削除

システム管理者や業務コンテンツを作成するユーザが実施した作業内容に応じて，対応が必要になります。中断情報の運用が必要な作業と，そのときに必要な対応について，次に示します。

表5-3　中断情報の運用が必要な作業と対応

項番 | 作業の分類 | 作業内容 | 必要な対応についての参照先
1 | 業務コンテンツの作成 | 業務コンテンツの追加 | 5.6.1　中断情報の再見積もり
2 | 業務コンテンツの更新 | 不要です。
3 | 業務コンテンツの削除 | 不要です。
4 | ナビゲーション プラットフォームの運用 | インポートによる業務コンテンツの追加 | 5.6.1　中断情報の再見積もり
5 | インポートによる業務コンテンツの更新 | 5.6.2(1)　業務コンテンツに関連する中断情報の削除
6 | インポートによる業務コンテンツの削除 | 5.6.2(1)　業務コンテンツに関連する中断情報の削除
7 | ユーザの追加 | 5.6.1　中断情報の再見積もり
8 | ユーザの削除 | 5.6.2(2)　ユーザに関連する中断情報の削除
9 | 業務コンテンツの運用 | アクセス権グループの設定 | 不要です。
10 | アクセス権グループの削除 | 5.6.2(3)　業務コンテンツおよびユーザに関連する中断情報の削除

＜この節の構成＞

5.6.1　中断情報の再見積もり

5.6.2　中断情報の削除

5.6.1　中断情報の再見積もり

見積もった容量を再計算する必要があります。中断情報を保存する外部記憶装置に確保した容量が不足する場合，不要な中断情報を削除するか，または保存する容量を拡張する必要があります。

中断情報の容量の見積もりについては，「3.4.3　中断再開プラグインを使用する場合の容量の見積もり」を参照してください。

5.6.2　中断情報の削除

中断情報の削除について説明します。

＜この項の構成＞

(1)　業務コンテンツに関連する中断情報の削除

(2)　ユーザに関連する中断情報の削除

(3)　業務コンテンツおよびユーザに関連する中断情報の削除

(1)　業務コンテンツに関連する中断情報の削除

インポートによって更新，または削除された業務コンテンツに関連する中断情報を削除する必要があります。インポート実行時に「-l」オプションを指定し，結果種別が「modified」，または「deleted」で出力された業務コンテンツの中断情報を削除します。

中断再開プラグインでは，「3.4.3(1)　中断情報の管理単位」に示したタイミング以外で削除処理を呼び出しません。したがって，システム管理者が中断情報を削除するためのコマンドは，中断再開プラグインを開発したユーザ，またはシステム管理者が自分で作成する必要があります。

(2)　ユーザに関連する中断情報の削除

削除したユーザに関連する中断情報を削除する必要があります。

(3)　業務コンテンツおよびユーザに関連する中断情報の削除

アクセス権を削除した業務コンテンツに関連する，アクセス権を削除されたユーザの中断情報を削除する必要があります。

5.7　Portal Managerでの設定の変更

Portal Managerで設定した，uCosminexus Portal Frameworkのセットアップ内容を変更すると，ポータル用設定ファイルと呼ばれるファイルが更新されます。ポータル用設定ファイルが更新された場合，更新内容をナビゲーション プラットフォームのJ2EEアプリケーションに反映する必要があります。

J2EEアプリケーションに反映する手順は，環境によって異なります。この節では，各環境での手順について説明します。

＜この節の構成＞

5.7.1　編集環境または実行環境で設定を変更した場合

5.7.2　開発環境で設定を変更した場合

5.7.1　編集環境または実行環境で設定を変更した場合

編集環境または実行環境でPortal Managerでの設定を変更した場合に，ポータル用設定ファイルの更新内容をJ2EEアプリケーションに反映する手順について説明します。

＜この項の構成＞

(1)　EARファイルの更新

(2)　J2EEアプリケーションの削除

(3)　J2EEサーバの再起動

(4)　J2EEアプリケーションのインポートと開始

(1)　EARファイルの更新

EARファイルに，ポータル用設定ファイルの更新内容を反映します。

EARファイルの更新手順を次に示します。

cjexportappコマンドを実行して，稼働中のナビゲーション プラットフォームのJ2EEアプリケーションをEARファイルに出力します。

Cosminexusインストールディレクトリ¥CC¥admin¥bin¥cjexportapp J2EEサーバ名 -f EARファイルの出力先パス -name ucnp -raw -nameserver corbaname::localhost:ネーミングサービスのポート番号

ネーミングサービスのポート番号は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.ejbserver.naming.portの指定値です。指定値がデフォルトの900の場合は，-nameserverオプションの指定は任意になります。
cjexportappコマンドの詳細は，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」を参照してください。

npupdateearコマンド（EARファイルの更新）を実行して，手順1.で出力したEARファイルにポータル用設定ファイルの更新内容を反映します。

npupdateear -p ポータルプロジェクトのパス -i 手順1.で出力したEARファイルのパス -o 更新後のEARファイルの出力先パス -t 一時ディレクトリのパス

npupdateearコマンド（EARファイルの更新）の詳細は，「8.13　npupdateearコマンド（EARファイルの更新）」を参照してください。

(2)　J2EEアプリケーションの削除

ポータル用設定ファイルの更新内容を反映する前のJ2EEアプリケーションを削除する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

編集環境または実行環境が構築されているマシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［停止］アンカーをクリックします。

［削除］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［削除］アンカーをクリックします。
J2EEサーバからナビゲーション プラットフォームのJ2EEアプリケーションが削除されます。

(3)　J2EEサーバの再起動

J2EEサーバを再起動する手順を次に示します。

［論理サーバの起動／停止］アンカーをクリックし，論理サーバの起動／停止画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。

J2EEサーバが停止したら，［起動／停止］タブを表示し直します。

［起動］ボタンをクリックします。
J2EEサーバの再起動が完了します。

(4)　J2EEアプリケーションのインポートと開始

ポータル用設定ファイルの更新内容を反映したEARファイルで，J2EEアプリケーションをインポートして開始します。

J2EEアプリケーションのインポート・開始手順を次に示します。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［インポート］タブを表示します。

「インポートディレクトリ」に「(1)　EARファイルの更新」で更新したEARファイルがあるディレクトリパスを指定し，［適用］ボタンをクリックします。

J2EEアプリケーションファイルのドロップダウンリストからEARファイルを選択し，［実行］ボタンをクリックします。
J2EEアプリケーションがインポートされます。

［開始/終了］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［開始］アンカーをクリックします。
J2EEアプリケーションが開始されます。

5.7.2　開発環境で設定を変更した場合

開発環境でPortal Managerでの設定を変更した場合に，ポータル用設定ファイルの更新内容をJ2EEアプリケーションに反映する手順について説明します。

＜この項の構成＞

(1)　EARファイルの再作成

(2)　J2EEサーバの再起動

(3)　J2EEアプリケーションのインポートと開始

(1)　EARファイルの再作成

ポータル用設定ファイルの更新内容を反映したEARファイルを再作成します。EARファイルの再作成手順を次に示します。

Eclipseを起動します。

Eclipseで［ウィンドウ］－［ビューの表示］－［その他］－［Ant］－［Ant］を選択して，［Ant］ビューを表示します。

pluginSDKのプロジェクトから，build.xmlを［Ant］ビューにドラッグ＆ドロップします。
［Ant］ビューに［root］が追加されます。

［Ant］ビューの「root」の［+］アイコンをクリックして，ターゲット一覧を表示します。

ターゲット一覧の［clean］をダブルクリックします。

ターゲット一覧の［ear］をダブルクリックします。
プラグインのビルドが実行されます。

ターゲット一覧の［stopEar］をダブルクリックします。
J2EEアプリケーションが停止します。

ターゲット一覧の［deleteEar］をダブルクリックします。
J2EEアプリケーションが削除されます。

(2)　J2EEサーバの再起動

J2EEサーバを再起動する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

開発環境が構築されているマシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバの起動／停止］アンカーをクリックし，論理サーバの起動／停止画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。

J2EEサーバが停止したら，［起動／停止］タブを表示し直します。

［起動］ボタンをクリックします。
J2EEサーバの再起動が完了します。

(3)　J2EEアプリケーションのインポートと開始

再作成したEARファイルをインポートして，J2EEアプリケーションを開始します。

Eclipseで［Ant］ビューのターゲット一覧を表示します。

ターゲット一覧の［deployEar］をダブルクリックします。
J2EEアプリケーションがインポートされます。

ターゲット一覧の［startEar］をダブルクリックします。
J2EEアプリケーションが開始されます。

5.8　IPアドレスの変更手順

ナビゲーション プラットフォームのセットアップ完了後にIPアドレスを変更する手順について説明します。

npstopコマンド（停止）を実行して，ナビゲーション プラットフォームを停止します。

次のサービスを停止します。

HiRDB/EmbeddedEdition _EP0

TPBroker

IPアドレスを変更します。

次のサービスを開始します。

TPBroker

5.9　Active Directoryの接続パスワードを変更した場合の設定変更の流れ

ディレクトリサーバ接続用ユーザのパスワードを変更した場合，uCosminexus Application Server，uCosminexus Developer，およびPortal Managerを再設定する必要があります。この節では再設定の手順について説明します。

＜この節の構成＞

5.9.1　統合ユーザ管理のコンフィグレーションファイル（ua.conf）の変更手順

5.9.2　uCosminexus Portal Framework設定の変更手順

5.9.3　EARファイルの更新手順

5.9.1　統合ユーザ管理のコンフィグレーションファイル（ua.conf）の変更手順

統合ユーザ管理のコンフィグレーションファイル（ua.conf）を設定します。ua.confファイルの格納ディレクトリを次に示します。

格納ディレクトリ

Cosminexusインストールディレクトリ¥manager¥config¥ua.conf

java.naming.security.credentials.0に変更したディレクトリサーバ接続用ユーザのパスワードを指定します。
例：java.naming.security.credentials.0=ディレクトリサーバ接続用ユーザのパスワードに指定した値

5.9.2　uCosminexus Portal Framework設定の変更手順

＜この項の構成＞

(1)　Portal Managerの起動

(2)　Portal Managerの設定変更

(1)　Portal Managerの起動

Windowsのスタートメニューから［プログラム］－［uCosminexus Portal Framework］－［Portal Manager　起動］をクリックします。
Portal Managerが起動します。

Portal Managerにアクセスします。
Webブラウザ上で次のURLを指定します。
http://ホスト名:ポート番号/PortalSetup/admin/portalsetup/index.jsp

ホスト名

Portal Managerがインストールされているマシンのホスト名またはIPアドレスです。ナビゲーションプラットフォームをセットアップしたマシンから接続する際のホスト名は，このマニュアルの手順どおりにセットアップした環境では「127.0.0.1」となります。

ポート番号

Portal Managerが使用するポート番号です。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.portal.manager.http.portプロパティに指定した値になります。デフォルトの場合は「24710」です。

注意

Portal Managerへのアクセスが拒否された場合

「下に表示されているWebサイトのコンテンツは，Internet Explorerセキュリティ強化の構成によってブロックされています。」とメッセージが表示されアクセスを拒否された場合は，次のように対処するとPortal Managerが利用できるようになります。

次のメッセージの横の［追加］ボタンをクリックします。
「Webサイトを信頼している場合，信頼済みサイトのゾーンに追加すると，低いレベルのセキュリティでサイトを実行できます。このWebサイトがローカルイントラネットにある場合，ヘルプの説明を参照して，ローカルイントラネットのゾーンにサイトを追加してください。」

次のメッセージの下の枠に「http://127.0.0.1」と入力し，横にある［追加］ボタンをクリックします。
「このWebサイトをゾーンに追加する」

(2)　Portal Managerの設定変更

Portal Managerのメニューから［ポータルプロジェクトの選択］を選択します。
メイン部に，［ポータルプロジェクトの選択］画面が表示されます。

Portal Managerのメニューから［リポジトリの設定］－［接続情報］－［修正］を選択します。
［接続情報の選択］画面が表示されます。

［接続情報の選択］画面で次の項目を入力します。

表5-4　［接続情報の選択］画面の項目名と設定内容

項目名
設定内容

接続先の種類
接続先のリポジトリの種類を，ドロップダウンリストから選択します。
指定例：LDAP

接続先名称
リポジトリ情報を格納するディレクトリサーバの接続先名称を選択します。
指定例：LDAP-1

［検索］ボタンをクリックします。
［接続情報の設定］画面が表示されます。

［接続情報の設定］画面で次の項目を入力します。

表5-5　［接続情報の設定］画面の項目名と設定内容

項目名
設定内容

接続先URL
ldap://ディレクトリサーバのアドレス:ディレクトリサーバのポート番号を指定します。
指定例：ldap://localhost:389

接続先ユーザー名
ディレクトリサーバ接続用ユーザのDNを指定します。
指定例：CN=user1,CN=Users,DC=hitachi,DC=jp

接続先パスワード
ディレクトリサーバ接続用ユーザのパスワードを指定します。
指定例：UCNPPASS

［登録］ボタンをクリックします。
接続情報が登録されます。

5.9.3　EARファイルの更新手順

ここではEARファイルの更新手順について説明します。

＜この項の構成＞

(1)　EARファイルの出力先ディレクトリの作成

(2)　J2EEアプリケーションのエクスポート

(3)　EARファイルの更新

(4)　J2EEアプリケーションの削除

(5)　J2EEサーバの再起動

(6)　J2EEアプリケーションのインポートと開始

(1)　EARファイルの出力先ディレクトリの作成

EARファイルの出力先ディレクトリを作成します。mkdirコマンドでディレクトリを作成する場合は，次の形式でコマンドを実行してください。

mkdir EARファイル出力先ディレクトリ

(2)　J2EEアプリケーションのエクスポート

cjexportappコマンドを実行して，稼働中のナビゲーション プラットフォームのJ2EEアプリケーションをEARファイルに出力します。

コマンドのパス

Cosminexusインストールディレクトリ¥CC¥admin¥bin¥cjexportapp J2EEサーバ名 -f EARファイルの出力先ディレクトリ¥EARファイル名 -name ucnp -raw -nameserver corbaname::localhost:ネーミングサービスのポート番号

J2EEサーバ名は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.ejbserver.nameプロパティに指定した値になります。デフォルトの場合「MyJ2EE」です。また，ネーミングサービスのポート番号は，ucnp.setup.server.cosminexus.ejbserver.naming.portの指定値です。指定値がデフォルトの900の場合は，-nameserverオプションの指定は任意になります。

cjexportappコマンドの詳細は，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」を参照してください。

(3)　EARファイルの更新

npupdateearコマンド（EARファイルの更新）を実行して，「(2)　J2EEアプリケーションのエクスポート」で出力したEARファイルにポータル用設定ファイルの更新内容を反映します。

コマンドのパス

npupdateear -p ポータルプロジェクトのパス -i 「(2)　J2EEアプリケーションのエクスポート」で出力したEARファイルのパス -o EARファイルの出力先ディレクトリ¥更新後のEARファイル名

(4)　J2EEアプリケーションの削除

ポータル用設定ファイルの更新内容を反映する前のJ2EEアプリケーションを削除する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

編集環境または実行環境が構築されているマシンのホスト名またはIPアドレスを指定します。ナビゲーションプラットフォームをセットアップしたマシンから接続する際のホスト名は，このマニュアルの手順どおりにセットアップした環境では「127.0.0.1」となります。

ポート番号

Cosminexus Management Serverが使用するポート番号です。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.mngsvr.webserver.connector.http.portプロパティに指定した値になります。デフォルトの場合は「28080」です。

運用管理ポータルの画面で［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

ツリーから［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［停止］アンカーをクリックします。

手順4.と同じツリーで［削除］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［削除］アンカーをクリックします。
J2EEサーバからナビゲーション プラットフォームのJ2EEアプリケーションが削除されます。

(5)　J2EEサーバの再起動

J2EEサーバを再起動する手順を次に示します。

運用管理ポータルの画面で［論理サーバの起動／停止］アンカーをクリックし，論理サーバの起動／停止画面を表示します。

ツリーから［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。

J2EEサーバが停止したら，［起動／停止］タブを表示し直します。

［起動］ボタンをクリックします。
J2EEサーバの再起動が完了します。

(6)　J2EEアプリケーションのインポートと開始

ポータル用設定ファイルの更新内容の反映が完了したEARファイルで，J2EEアプリケーションをインポートして開始します。

運用管理ポータルの画面で［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

ツリーから［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［インポート］タブを表示します。

「インポートディレクトリ」に「(1)　EARファイルの出力先ディレクトリの作成」で作成したEARファイル出力先ディレクトリを指定し，［適用］ボタンをクリックします。

J2EEアプリケーションファイルのドロップダウンリストからEARファイルを選択し，［実行］ボタンをクリックします。
J2EEアプリケーションがインポートされます。

手順2.と同じツリーで［開始/終了］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［開始］アンカーをクリックします。
J2EEアプリケーションが開始されます。

5.10　JP1製品と連携するための設定

JP1連携プラグインを使ってJP1製品と連携するためには，次の準備が必要です。

JP1/Baseによるユーザ認証を利用したシステム構成にする

連携相手であるJP1製品のJP1/Baseと同じユーザ認証圏にする

JP1連携プラグインを使った業務コンテンツを操作するJP1ユーザに対して，連携相手のJP1製品を操作するためのJP1権限レベルを設定する
JP1製品を操作するためのJP1権限レベルについては，各製品のマニュアルを参照してください。

連携相手であるJP1製品で環境変数やJP1/Baseなどの設定をする

ナビゲーション プラットフォームのユーザプロパティファイル（ucnp_user.properties）でJP1連携プラグインに関連するプロパティに必要な値を指定する

参考

連携できるJP1製品を次に示します。

JP1/IM 10-10以降

JP1/IM-SS 10-10以降

JP1/AO 10-10以降

＜この節の構成＞

5.10.1　JP1/IMの設定条件

5.10.2　JP1/AOの設定条件

5.10.3　JP1連携プラグインを使用するためのユーザプロパティファイルの設定

5.10.4　JP1イベント情報と業務コンテンツを関連づける

5.10.5　JP1イベント情報関連づけファイルの項目と形式

5.10.6　JP1製品からナビゲーション プラットフォームを呼び出すためのURL

5.10.1　JP1/IMの設定条件

JP1イベント対処状況変更プラグインを使用するために，JP1/IMに必要な設定条件を次に示します。

JP1/Base 10-10以降を使用する
JP1/IM-MがセットアップされているマシンにJP1/Base 10-10以降をセットアップする必要があります。

ユーザ認証圏を合わせる
JP1/IMのマシンにセットアップしたJP1/Baseのユーザ認証圏は，ナビゲーション プラットフォームと同じにしてください。

JP1/IMがセットアップされているマシンのシステム環境変数PATHにjcochstatコマンドの格納ディレクトリのパスを設定する
jcochstatコマンドについては，マニュアル「JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス」を参照してください。

JP1/IMがセットアップされているマシンのJP1/Baseで，JP1ユーザとOSユーザのマッピングをする
JP1連携プラグインを使った業務コンテンツを操作するJP1ユーザすべてに，Windowsの管理者権限のあるOSアカウントをマッピングする必要があります。
なお，JP1/IMとナビゲーション プラットフォームのホストのOSが異なっていても問題ありません。

ナビゲーション プラットフォームの参照権限を設定する
JP1/IMのユーザのうち，JP1/IMのJP1イベントを操作する権限を持つユーザに対してだけ，ナビゲーション プラットフォームを参照できる操作権限（JP1権限レベル）を設定してください。JP1/IMの操作権限については，マニュアル「JP1/Integrated Management - Manager 導入・設計ガイド」を参照してください。

JP1イベント対処状況変更プラグインを使用する前に，これらの設定が完了しているかどうか確認してください。

5.10.2　JP1/AOの設定条件

JP1/AOサービス実行プラグインを使用するために，JP1/AOに必要な設定条件を次に示します。

JP1/Baseによるユーザ認証を使用する
JP1/AOがセットアップされているマシンにJP1/Base 10-10以降をセットアップする必要があります。また，JP1/Baseのユーザ認証圏は，ナビゲーション プラットフォームと同じにしてください。

JP1/AOがセットアップされているマシンのJP1/Baseで，JP1ユーザとOSユーザのマッピングをする
JP1連携プラグインを使った業務コンテンツを操作するJP1ユーザすべてに，Windowsの管理者権限のあるOSアカウントをマッピングする必要があります。
なお，JP1/AOとナビゲーション プラットフォームのホストのOSが異なっていても問題ありません。

JP1/AOがセットアップされているマシンでencryptpasswordコマンドを実行してパスワードファイルを作成する

パスワードファイルの作成条件

JP1ユーザごとに，ユーザIDと同じ名称のファイルを作成してください。

パスワードファイルの格納場所

ucnp.base.client.jp1ao.submittask.passwordfile.pathプロパティで指定したディレクトリに格納します。

encryptpasswordコマンドについては，マニュアル「JP1/Automatic Operation 画面・コマンドリファレンス」を参照してください。

JP1/AOサービス実行プラグインを使用する前に，JP1/AOのシステム管理者に問い合わせて，これらの設定が完了しているかどうか確認してください。

5.10.3　JP1連携プラグインを使用するためのユーザプロパティファイルの設定

JP1連携プラグインを使用する場合は，ユーザプロパティファイル（ucnp_user.properties）を確認し，次に示すプロパティの指定値を必要に応じて変更してください。

ucnp.base.client.jp1imss.hostname

ucnp.base.client.jp1imss.portnum

ucnp.base.client.jp1ao.hostname

ucnp.base.client.jp1ao.portnum

ucnp.base.client.jp1ao.submittask.passwordfile.path

ucnp.base.client.jp1ev.association.enable

各プロパティの指定値については，「7.4.3　ユーザプロパティファイルのプロパティ詳細」を参照してください。

5.10.4　JP1イベント情報と業務コンテンツを関連づける

JP1イベント情報に対応した業務コンテンツを指定して直接表示する場合は，JP1イベント情報と業務コンテンツを関連づけておく必要があります。手順を次に示します。

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.jp1ev.association.enableプロパティの指定値がtrueになっていることを確認します。

JP1イベント関連づけファイル（ucnp_jp1event_mapping.txt）を作成して，次のディレクトリに格納します。
ナビゲーション プラットフォームインストールディレクトリ¥conf
JP1イベント関連づけファイルの内容については，「5.10.5　JP1イベント情報関連づけファイルの項目と形式」を参照してください。

参考

JP1イベント関連づけファイルによる設定は，JP1/IMまたはJP1/IM-SSから業務コンテンツを呼び出す場合だけ有効です。

ナビゲーション プラットフォームを再起動して，JP1イベント関連づけファイルを読み込みます。
ナビゲーション プラットフォームの起動と停止の手順については，「5.1　システムの起動と停止」を参照してください。

5.10.5　JP1イベント情報関連づけファイルの項目と形式

JP1イベント情報関連づけファイル（ucnp_jp1event_mapping.txt）に記載する項目と，記載するときの形式を説明します。

＜この項の構成＞

(1)　JP1イベント情報関連づけファイルの項目

(2)　JP1イベント情報関連づけファイルの形式

(3)　JP1イベント情報の一致判定

(1)　JP1イベント情報関連づけファイルの項目

JP1イベント情報関連づけファイルに記載する項目を次に示します。

イベントID

発行元イベントサーバ名（登録ホスト名）

プロダクト名

メッセージ

業務コンテンツID

業務コンテンツID以外の項目の詳細は，マニュアル「JP1/Integrated Management - Manager 運用ガイド」のイベント一覧の表示についての説明，またはJP1イベント出力元の製品の各マニュアルを参照してください。

(2)　JP1イベント情報関連づけファイルの形式

JP1イベント情報関連づけファイルは次の形式で記載します。

イベントID（タブ）発行元イベントサーバ名（タブ）プロダクト名（タブ）メッセージ（タブ）業務コンテンツID（改行）

（凡例）

（タブ）：タブ

（改行）：改行コード

1行につき一つの関連づけを定義します。項目はタブ区切りで指定してください。最大1,000行を記載できます。使用できる文字コードはUTF-8だけです。

JP1イベント情報関連づけファイルの例を次に示します。

00003FA3        SERVER1        /HITACHI/JP1/IM/JCOCMD        KAVB2402-W [SERVER1] コマンド実行の実行時間が10200秒を超えました。        ce16c98a-0132-1000-8000-00000ad23cbb-0
00004724        SERVER2        /HITACHI/JP1/BASE/SPMD        KAVB3664-I SERVER2 のJP1/Baseを起動しました        2173450f-0133-1000-8003-00000ad23cbb-0
00005F00        SERVER1        /HITACHI/JP1/IM/SS        KNAB15069-I 案件のステータスがクローズで登録されました        2173450f-0133-1000-8003-00000ad23cbb-0
00000001        SERVER1        /APP1/SAMPLE_PRODUCT        SAMPLE application error.        c7c0725a-0132-1000-8003-00000ad23cbb-0
00000002        SERVER2        /APP1/SAMPLE_PRODUCT        SAMPLE application warning.        c7c0725a-0132-1000-8003-00000ad23cbb-0

(3)　JP1イベント情報の一致判定

ナビゲーション プラットフォームは，次のデータを比較して，一致するかどうかを判定します。ただし，アクセス権のない業務コンテンツに関連づけられているJP1イベント情報は判定の対象外です。

JP1製品から受け取ったJP1イベント情報（「(1)　JP1イベント情報関連づけファイルの項目」に示したJP1イベント情報）

JP1イベント情報関連づけファイルに記載されているJP1イベント情報

JP1製品から受け取ったJP1イベント情報が空文字の場合は，JP1イベント情報関連づけファイルに記載されているJP1イベント情報と一致したと見なされます。また，JP1イベント情報関連づけファイルに記載されているJP1イベント情報が空文字の場合は，JP1製品から受け取ったJP1イベント情報と一致したと見なされます。

JP1製品から受け取ったJP1イベント情報の各項目は，前方一致で判定されます。前方一致で複数の行が該当した場合は，最初の行の定義だけが有効になります。

一致と判定される例

JP1製品から受け取ったJP1イベント情報：「/HITACHI/JP1/IM」

JP1イベント情報関連づけファイルに記載されているJP1イベント情報：「/HITACHI/JP1」

不一致と判定される例

JP1製品から受け取ったJP1イベント情報：「/HITACHI/JP1」

JP1イベント情報関連づけファイルに記載されているJP1イベント情報：「/HITACHI/JP1/IM」

5.10.6　JP1製品からナビゲーション プラットフォームを呼び出すためのURL

JP1製品からナビゲーション プラットフォームを呼び出すために指定するURLを次に示します。

http://ホスト名:ポート番号/ucnpBase/portal/screen/Home/action/PLoginUser

このURLを連携元のJP1製品で指定しておき，連携元のJP1製品の画面上で指定したURLをクリックすると，業務コンテンツが選択されていない状態のナビゲーション プラットフォームの画面が表示されます。特定の業務コンテンツを直接表示したい場合は，次の形式のURLを指定してください。

http://ホスト名:ポート番号/ucnpBase/portal/screen/Home/action/PLoginUser?contentId=業務コンテンツID

注意

特定の業務コンテンツを直接表示するためのURLを指定した場合，JP1イベント情報関連づけファイル（ucnp_jp1event_mapping.txt）の設定は無効になります。

6.　業務コンテンツの運用

この章では，業務コンテンツを作成して運用を開始するまでに必要な作業の流れと，それぞれの作業について説明します。業務コンテンツの運用に必要な作業は，システム構成によって異なることもあります。

この章で説明する作業は，ナビゲーション プラットフォームの運用を開始する前や運用中に，適宜実施してください。

＜この章の構成＞

6.1　業務コンテンツの作成から運用までに必要な作業

6.2　編集環境が実行環境を兼ねる場合の業務コンテンツの運用

6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）

6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）

6.5　業務コンテンツのアクセス管理の流れ（ディレクトリサーバによるユーザ認証を利用している場合）

6.6　業務コンテンツのエクスポートとインポート

6.7　開発環境で作成したファイルの適用

6.8　検索用データの更新

6.9　業務コンテンツで使用する静的ファイルの管理

6.1　業務コンテンツの作成から運用までに必要な作業

業務コンテンツを運用するために，システム管理者が実施する必要がある作業を次に示します。

業務コンテンツのアクセス権の運用を検討する
ディレクトリサーバによるユーザ認証を使用している場合は，アクセス権グループを作成して，業務コンテンツを作成するユーザと利用するユーザを登録します。JP1/Baseによるユーザ認証を使用している場合は，JP1/BaseでJP1権限レベル，JP1資源グループを設定します。JP1/Baseでの作業になるため，必要に応じてJP1/Baseの管理者と設定内容などを相談しながら作業を実施してください。

業務コンテンツをエクスポート・インポートする（編集環境と実行環境が異なる場合）

開発環境で作成したファイルをシステムに適用する

検索機能を使用している場合，検索用データを更新する

業務コンテンツで使用する静的ファイルを管理する

これらの作業を実施するには，ナビゲーション プラットフォームのシステムが起動している必要があります。システムの起動方法については，「5.1　システムの起動と停止」を参照してください。

また，利用者が業務コンテンツを操作した履歴は，ログとして取得できます。操作ログの詳細については，「5.4　業務コンテンツの操作ログの設定」を参照してください。

以降では，業務コンテンツを作成し，運用する流れについて，開発環境で開発したプラグインやカスタム画面を使用しない場合と使用する場合に分けて説明します。

＜この節の構成＞

6.1.1　プラグインやカスタム画面を使用しない場合に必要な作業

6.1.2　プラグインやカスタム画面を使用する場合に必要な作業

6.1.1　プラグインやカスタム画面を使用しない場合に必要な作業

開発環境で開発したプラグインやカスタム画面を使用しない場合に，ナビゲーション プラットフォームのセットアップが完了してから運用を開始するまでに必要な作業の流れを次に示します。

図6-1　セットアップが完了してから運用を開始するまでに必要な作業（プラグインやカスタム画面を使用しない場合）

図に示した番号の作業をだれが実施するのかについて説明します。コンテンツ管理者またはコンテンツ編集者が実施する作業の手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

システム管理者：業務コンテンツを作成するユーザや業務コンテンツの公開範囲など，業務コンテンツのアクセス権の運用を検討します。
業務コンテンツごとに，どのユーザが業務コンテンツを作成・編集・利用するのかを検討してください。

ディレクトリサーバによるユーザ認証の場合
必要に応じてアクセス権グループを作成します。
デフォルトの標準アクセス権限だけを使用した場合，業務コンテンツを作成・編集できるのはシステム管理者だけです。また，完成した業務コンテンツは，ナビゲーション プラットフォームにログインするすべてのユーザが利用できます。
デフォルトの標準アクセス権限では実現できない運用（特定のユーザにだけ公開したい業務コンテンツがある場合や，システム管理者以外のユーザが業務コンテンツを作成または編集する場合など）をしたい場合は，編集環境でアクセス権グループを作成する必要があります。
アクセス権の内容については，「6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）」を参照してください。ユーザにアクセス権を設定する手順については，「6.5.1　アクセス権グループを作成する手順」を参照してください。

JP1/Baseによるユーザ認証の場合
ナビゲーション プラットフォームにログインするJP1ユーザには，必ずナビゲーション プラットフォーム用のJP1資源グループを設定してください。さらに，必要に応じてJP1ユーザごとにJP1権限レベルを設定することで，特定のユーザだけが業務コンテンツ編集できるようにしたり，特定のユーザだけに公開する業務コンテンツを作成したりできるようになります。
JP1資源グループおよびJP1権限レベルの設定はJP1/Baseでの作業になるため，必要に応じてJP1/Baseの管理者と設定内容などを相談しながら作業を実施してください。
アクセス権の内容については，「6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）」を参照してください。

コンテンツ管理者：編集環境で業務コンテンツを新規に追加して作成し，アクセス権グループまたはJP1資源グループを設定します。

コンテンツ編集者：編集環境で追加済みの業務コンテンツを編集します。

コンテンツ管理者およびコンテンツ編集者：編集環境で，業務コンテンツの動作をテストします。

コンテンツ管理者：業務コンテンツのグループ名，アクセス権グループまたはJP1資源グループを公開用に変更します。

システム管理者：編集環境で作成した業務コンテンツと，業務コンテンツおよびアクセス権の設定情報をエクスポートします。
エクスポート方法については，「6.6.1　業務コンテンツのエクスポート」を参照してください。
なお，ディレクトリサーバによるユーザ認証の場合は，アクセス権グループだけをエクスポートすることもできます。詳細は，「6.5.4(1)　アクセス権グループだけをエクスポート，インポートする手順」を参照してください。

システム管理者：実行環境に業務コンテンツおよびアクセス権の設定情報をインポートします。
インポート方法については，「6.6.2　業務コンテンツのインポート」を参照してください。
なお，ディレクトリサーバによるユーザ認証の場合は，アクセス権グループだけをインポートすることもできます。詳細は，「6.5.4(1)　アクセス権グループだけをエクスポート，インポートする手順」を参照してください。

ここで説明する作業が完了したら，利用者にURLを通知して，業務コンテンツを公開（運用を開始）します。利用者に通知するURLについては，「2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL」を参照してください。

6.1.2　プラグインやカスタム画面を使用する場合に必要な作業

開発環境で開発したプラグインやカスタム画面を使用する場合に，ナビゲーション プラットフォームのセットアップが完了してから運用を開始するまでに必要な作業の流れを次に示します。

図6-2　セットアップが完了してから運用を開始するまでに必要な作業（プラグインやカスタム画面を使用する場合）

図に示した番号の作業をだれが実施するのかについて説明します。コンテンツ管理者またはコンテンツ編集者が実施する作業の手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。開発者が実施する作業の手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

システム管理者：業務コンテンツを作成するユーザや業務コンテンツの公開範囲など，業務コンテンツのアクセス権の運用を検討します。
業務コンテンツごとに，どのユーザが業務コンテンツを作成・編集・利用するのかを検討してください。

ディレクトリサーバによるユーザ認証の場合
必要に応じてアクセス権グループを作成します。
デフォルトの標準アクセス権限だけを使用した場合，業務コンテンツを作成・編集できるのはシステム管理者だけです。また，完成した業務コンテンツは，ナビゲーション プラットフォームにログインするすべてのユーザが利用できます。
デフォルトの標準アクセス権限では実現できない運用（特定のユーザにだけ公開したい業務コンテンツがある場合や，システム管理者以外のユーザが業務コンテンツを作成または編集する場合など）をしたい場合は，編集環境でアクセス権グループを作成する必要があります。
アクセス権の内容については，「6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）」を参照してください。ユーザにアクセス権を設定する手順については，「6.5.1　アクセス権グループを作成する手順」を参照してください。

JP1/Baseによるユーザ認証の場合
ナビゲーション プラットフォームにログインするJP1ユーザには，必ずナビゲーション プラットフォーム用のJP1資源グループを設定してください。さらに，必要に応じてJP1ユーザごとにJP1権限レベルを設定することで，特定のユーザだけが業務コンテンツ編集できるようにしたり，特定のユーザだけに公開する業務コンテンツを作成したりできるようになります。
JP1資源グループおよびJP1権限レベルの設定はJP1/Baseでの作業になるため，必要に応じてJP1/Baseの管理者と設定内容などを相談しながら作業を実施してください。
アクセス権の内容については，「6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）」を参照してください。

コンテンツ管理者：編集環境で業務コンテンツを新規に追加して作成し，アクセス権グループまたはJP1資源グループを設定します。

コンテンツ編集者：編集環境で追加済みの業務コンテンツを編集します。

システム管理者：編集環境で作成した業務コンテンツをエクスポートします。
エクスポート方法については，「6.6.1　業務コンテンツのエクスポート」を参照してください。

システム管理者（開発者）：開発環境に業務コンテンツをインポートします。
インポート方法については，「6.6.2　業務コンテンツのインポート」を参照してください。

システム管理者（開発者）：開発環境でプラグインやカスタム画面を開発します。

システム管理者（開発者）：開発環境で更新した業務コンテンツをエクスポートします。

システム管理者：編集環境に，開発環境で作成したファイルを適用します。
開発環境で作成したファイルの適用方法については，「6.7　開発環境で作成したファイルの適用」を参照してください。

システム管理者：編集環境に，開発環境で更新した業務コンテンツをインポートします。
必要に応じてインポートした業務コンテンツのアクセス権の設定情報を見直してください。

コンテンツ管理者およびコンテンツ編集者：編集環境で，業務コンテンツの動作をテストします。

コンテンツ管理者：必要に応じて業務コンテンツのグループ名，アクセス権グループまたはJP1資源グループを公開用に変更します。

システム管理者：編集環境でテスト済みの業務コンテンツをエクスポートします。
アクセス権グループを利用している場合は，業務コンテンツに設定されているアクセス権グループもエクスポートしてください。JP1資源グループの場合は，エクスポートは不要です。

システム管理者：実行環境に，開発環境で作成したファイルを適用します。
開発環境で作成したファイルの適用方法については，「6.7　開発環境で作成したファイルの適用」を参照してください。

システム管理者：実行環境に，編集環境でテスト済みの業務コンテンツおよびアクセス権の設定情報をインポートします。

ここで説明する作業が完了したら，利用者にURLを通知し，運用を開始してください。利用者に通知するURLについては，「2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL」を参照してください。

編集環境がない場合

開発環境と実行環境だけのシステム構成でも，業務コンテンツを運用できます。その場合は，編集環境の作業を開発環境で実施する必要があります。

なお，開発環境が編集環境を兼ねる場合は，編集環境と開発環境の間のデータ移行作業（インポートなど）は不要です。そのため，この項に記載した作業の流れを次のように読み替えてください。

編集環境の作業を開発環境で実施してください。

作業の流れのうち，流れ4.～5.と流れ7.～9.は不要です。

検索機能を使用している場合

業務コンテンツを追加・編集・削除したら検索用データを更新する必要があります。検索用データを更新する方法については，「6.8　検索用データの更新」を参照してください。

6.2　編集環境が実行環境を兼ねる場合の業務コンテンツの運用

編集環境が実行環境も兼ねている場合，編集環境で作成途中の業務コンテンツに対して，実行環境の利用者がアクセスしてしまうことがあります。この問題は，次のどちらかの方法で防止できます。

業務コンテンツのグループ名を公開用と非公開用で使い分ける

業務コンテンツに設定するアクセス権グループまたはJP1資源グループを公開用と非公開用で使い分ける

業務コンテンツの公開と非公開については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）

ナビゲーション プラットフォームでは，業務コンテンツごとにアクセス権を設定できます。次のような場合は，必要に応じてアクセス権グループを作成してください。

特定のユーザにだけ公開したい業務コンテンツがある

システム管理者以外のユーザも業務コンテンツを作成，管理できるようにしたい

既存の業務コンテンツを編集するだけのユーザが必要である

業務コンテンツにアクセス権を設定するためには，アクセス権グループが必要です。デフォルトで提供されているアクセス権グループ「標準アクセス権限」を利用するか，新規にアクセス権グループを作成してください。アクセス権グループの作成は，ナビゲーション プラットフォームのシステム管理者権限を持つユーザが実施する必要があります。

ポイント

アクセス権グループ「標準アクセス権限」のデフォルトの設定のままだと，システム管理者権限を持つユーザ以外は，業務コンテンツを参照することしかできません。ほかのユーザに業務コンテンツの作成や編集を実施させたい場合は，「標準アクセス権限」の定義内容を変更するか，新規にアクセス権グループを作成するかして，システム管理者以外のユーザに対して管理者または編集者の権限を与える必要があります。

業務コンテンツに設定するアクセス権グループを変更することによって，業務コンテンツの公開・非公開を切り替えることもできます。その場合は，業務コンテンツを作成・編集するユーザだけのアクセス権グループAと，業務コンテンツを実行するユーザも含むアクセス権グループBの2種類を作成してください。業務コンテンツが非公開のときにはアクセス権グループAを設定しておき，公開するときにアクセス権グループBに変更します。

業務コンテンツにアクセス権を設定する流れを次に示します。

システム管理者がアクセス権グループを作成する
編集環境で，ほかのユーザに対して管理者，編集者，または利用者の権限を定義したアクセス権グループを作成してください。

コンテンツ管理者（管理者の権限を与えたユーザ）が，新規に業務コンテンツを追加し，アクセス権グループを設定する
コンテンツ管理者がいない場合は，この作業もシステム管理者が実施する必要があります。業務コンテンツにアクセス権グループを設定する手順の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

＜この節の構成＞

6.3.1　アクセス権の種別と設定範囲（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.2　アクセス権の種別と実行できる操作（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.3　標準アクセス権限とは

6.3.4　アクセス権設定時の注意事項（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.5　旧バージョンのアクセス権との互換性

6.3.6　［アクセス権限］画面の項目（ディレクトリサーバによるユーザ認証を利用している場合）

6.3.1　アクセス権の種別と設定範囲（ディレクトリサーバによるユーザ認証を利用している場合）

業務コンテンツに設定するアクセス権は，グループやユーザごとに設定できます。例えば，「グループAに属するユーザは業務コンテンツの参照だけができ，グループBに属するユーザおよびユーザCは業務コンテンツの参照と追加の両方を実行できる」というように，一つの業務コンテンツに対してグループやユーザごとに異なるアクセス権を設定できます。この，グループやユーザごとに設定したアクセス権のグループをアクセス権グループと呼びます。

アクセス権グループで定義できるアクセス権の種別（役割）には，次に示す3種類があります。

管理者
管理者の役割を割り当てられたユーザを「コンテンツ管理者」と呼びます。

編集者
編集者の役割を割り当てられたユーザを「コンテンツ編集者」と呼びます。

利用者

また，これらの役割を設定する範囲（割り当て範囲）は，次の3種類を選択できます。

ユーザ
ナビゲーション プラットフォームにログインするユーザ単位でアクセス権が設定されます。

グループ
Active Directoryによるユーザ認証を利用している場合，Active Directory用の所属グループの単位でアクセス権が設定できます。

すべて
システム管理者を除く，ナビゲーション プラットフォームにログインするすべてのユーザに対してアクセス権が設定されます。

6.3.2　アクセス権の種別と実行できる操作（ディレクトリサーバによるユーザ認証を利用している場合）

アクセス権グループで定義できるアクセス権の種別（役割）と実行できる操作の対応を次に示します。

表6-1　アクセス権の種別と実行できる操作の対応

項番 | 操作内容 | アクセス権の種別（役割）
管理者 | 編集者 | 利用者
1 | 業務コンテンツの追加 | ○ | × | ×
2 | 業務コンテンツの複製 | ○ | × | ×
3 | 業務コンテンツの削除 | ○ | × | ×
4 | 業務コンテンツの編集※1 | ○ | ○ | ×
5 | 業務コンテンツの参照※2 | ○ | ○ | ○
6 | 業務コンテンツの名称変更 | ○ | × | ×
7 | 業務コンテンツのグループ変更 | ○ | × | ×
8 | 業務コンテンツへのアクセス権グループの設定（権限の設定） | ○ | × | ×
9 | 業務コンテンツに設定されているアクセス権グループの確認 | ○ | ○ | ×
10 | 関連リンクの設定 | ○ | ○ | ×

（凡例）

○：操作できます。

×：操作できません。

注※1

編集とは，業務編集画面で業務コンテンツを表示して，表示した業務コンテンツ対して実施できる操作（業務フロー領域・ガイド領域の作成やマッピング一覧出力など）を指します。

注※2

参照とは，業務実行画面で業務コンテンツを表示して，表示した業務コンテンツ対して実施できる操作（印刷やURL取得など）を指します。

6.3.3　標準アクセス権限とは

標準アクセス権限は，ナビゲーション プラットフォームがデフォルトで提供しているアクセス権グループです。

標準アクセス権限のデフォルトの定義内容は，次のとおりです。

役割：利用者

割り当て範囲：すべて

標準アクセス権限の定義内容は，デフォルトから変更することもできます。ただし，次のことはできません。

「標準アクセス権限」というアクセス権グループの名称を変更する

「標準アクセス権限」というアクセス権グループを削除する

ポイント

業務コンテンツには，1個以上のアクセス権グループを設定する必要があるため，新規にアクセス権グループを作成しない場合は，必ず標準アクセス権限が設定されることになります。

6.3.4　アクセス権設定時の注意事項（ディレクトリサーバによるユーザ認証を利用している場合）

業務コンテンツにアクセス権を設定して運用する場合は，アクセス権グループの定義内容やユーザプロパティファイル（ucnp_user.properties）の設定に注意が必要です。

＜この項の構成＞

(1)　複数のアクセス権グループを作成する場合に注意すること

(2)　アクセス権を設定している環境で検索機能を使用する場合に注意すること

(1)　複数のアクセス権グループを作成する場合に注意すること

一つのユーザを重複して異なるアクセス権グループに登録し，さらにそのユーザに対して各アクセス権グループで異なるアクセス権の種別（役割）を割り当てると，上位の役割が有効になります。そのため，一つの業務コンテンツに複数のアクセス権グループを設定する場合は，注意が必要です。例を次に示します。

ユーザ1に対してアクセス権グループAでは利用者の役割を割り当て，アクセス権グループBでは編集者の役割を割り当てています。この状態でアクセス権グループAとBの両方を同じ業務コンテンツに設定すると，上位の役割が定義されているアクセス権グループBの定義内容だけが有効となるため，ユーザ1はコンテンツ編集者としてその業務コンテンツを操作することができます。

(2)　アクセス権を設定している環境で検索機能を使用する場合に注意すること

業務コンテンツへのアクセス権を設定している環境で検索機能を使用する場合，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.search.accesscontrol.enableプロパティをtrueに設定して，参照する権限のある業務コンテンツだけを検索の対象とすることを推奨します。

ucnp.base.server.search.accesscontrol.enableプロパティにtrueを設定しないと，アクセス権の種類に関係なく，検索用データとして登録されているすべての業務コンテンツが検索の対象となります。そのため，アクセス権によって参照できない業務コンテンツも，検索結果として表示されるおそれがあります。

6.3.5　旧バージョンのアクセス権との互換性

09-50より前のバージョンのアクセス権の種別（権限）と，09-50以降のバージョンのアクセス権の種別（役割）は，次のように対応しています。

表6-2　旧バージョンのアクセス権の種別との対応

項番 | 旧バージョンの種別（権限） | 09-50以降のバージョンの種別（役割）
1 | すべて | 管理者
2 | 更新 | 編集者
3 | 参照 | 利用者

旧バージョンで次のようなアクセス権を設定して運用していた場合の対処を示します。

標準アクセス権限だけを設定していた場合の対処

旧バージョンでは「更新」権限で業務コンテンツの名称変更とグループ変更が可能でしたが，09-50以降のバージョンの「編集者」は，これらの操作を実行できません。「更新」権限を割り当てていたユーザが，引き続き業務コンテンツの名称変更とグループ変更をできるようにするためには，アクセス権グループの定義内容を見直して，役割を「管理者」に変更してください。

標準アクセス権限以外のアクセス権グループを設定していた場合の対処

旧バージョンでは「すべて」権限では業務コンテンツの追加（作成）と複製はできませんでしたが，09-50以降のバージョンの「管理者」は，これらの操作を実行できます。引き続き業務コンテンツの追加と複製をできないようにするためには，アクセス権グループの定義内容を見直して，役割を「編集者」に変更してください。

また，旧バージョンでは「更新」権限で業務コンテンツの名称変更とグループ変更が可能でしたが，09-50以降のバージョンの「編集者」は，これらの操作を実行できません。「更新」権限を割り当てていたユーザが，引き続き業務コンテンツの名称変更とグループ変更をできるようにするためには，アクセス権グループの定義内容を見直して，役割を「管理者」に変更してください。

6.3.6　［アクセス権限］画面の項目（ディレクトリサーバによるユーザ認証を利用している場合）

アクセス権グループを選択した状態の［アクセス権限］画面を次に示します。

図6-3　［アクセス権限］画面

［アクセス権限］画面は，左側の［アクセス権グループの一覧］領域と右側の［アクセス権グループの編集］領域から構成されています。それぞれの領域に表示されている項目について説明します。

＜この項の構成＞

(1)　［新規］メニュー

(2)　［削除］メニュー

(3)　アクセス権グループ名

(4)　［アクセス権グループの名称］テキストボックス

(5)　［役割］ドロップダウンリスト

(6)　［割り当て範囲］ドロップダウンリスト

(7)　［ID］テキストボックス

(8)　［追加］ボタン

(9)　［ユーザ，グループの一覧］または［ユーザ，組織の一覧］

(10)　［削除］ボタン

(11)　［閉じる］メニュー

(12)　［OK］ボタン

(13)　［キャンセル］ボタン

(1)　［新規］メニュー

選択すると，［アクセス権限］画面の右側の領域に［アクセス権グループの編集］領域が表示されます。この状態で，新規に追加したいアクセス権グループの名称やユーザを設定してから［OK］ボタンをクリックすると，新規のアクセス権グループが［アクセス権グループの一覧］領域に表示されます。

(2)　［削除］メニュー

選択すると，チェックボックスをチェックしたアクセス権グループが削除されます。［削除］メニューは，チェックボックスをチェックしないと非活性となり選択できません。

(3)　アクセス権グループ名

チェックボックスとともに，保存済みのアクセス権グループの名称が表示されます。名称部分をクリックすると，アクセス権グループ編集領域に［アクセス権グループの編集］画面が表示されて，アクセス権グループの設定を変更できます。

なお，アクセス権グループを一つも作成していなくても，デフォルトのアクセス権グループ「標準アクセス権限」は常に表示されます。

(4)　［アクセス権グループの名称］テキストボックス

アクセス権グループの名称を入力または変更するためのテキストボックスです。アクセス権グループの名称は，省略できません。255バイト以内の文字列を必ず入力してください。ただし，制御文字（ASCIIコードの0x00～0x1Fと0x7F）を含む文字列は入力できません。また，作成済みのアクセス権グループと重複する名称は入力できません。

(5)　［役割］ドロップダウンリスト

設定したいアクセス権を選択します。［管理者］，［編集者］，または［利用者］から選択してください。ドロップダウンリストの右に表示されている「？」マークのアイコンをクリックすると，それぞれの役割で実行できる操作の一覧と，アクセス権グループの定義例を別画面で参照できます。

(6)　［割り当て範囲］ドロップダウンリスト

アクセス権を設定する対象を選択します。［ユーザ］，［グループ］，または［すべて］から選択できます。

なお，システム構築時の設定によっては，［グループ］の代わりに［組織］が表示されます。

(7)　［ID］テキストボックス

アクセス権を設定する対象のIDを入力します。［役割］ドロップダウンリストで［ユーザ］，［グループ］，または［組織］を選択している場合，IDの入力は省略できません。

(8)　［追加］ボタン

クリックすると，設定したアクセス権の内容が［ユーザ，グループの一覧］または［ユーザ，組織の一覧］に追加されて，［ユーザ，グループの追加］または［ユーザ，組織の追加］がデフォルトの状態に戻ります。

(9)　［ユーザ，グループの一覧］または［ユーザ，組織の一覧］

アクセス権を定義済みのユーザ，グループ，または組織が表示されます。

(10)　［削除］ボタン

クリックすると，アクセス権を定義済みのユーザ，グループ，または組織が削除されます。

(11)　［閉じる］メニュー

クリックすると，［アクセス権限］画面が閉じます。［OK］ボタンで保存していない変更内容は破棄されます。

(12)　［OK］ボタン

クリックすると，［アクセス権グループの編集］領域の変更内容が保存されます。［アクセス権グループの名称］テキストボックスの内容を変更した場合は，変更後の名称が［アクセス権グループの一覧］領域に表示されます。

(13)　［キャンセル］ボタン

クリックすると，［アクセス権グループの編集］領域の変更内容が破棄されて，領域の表示内容が消去されます。

6.4　業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）

JP1/Baseに登録されているJP1ユーザに対してJP1権限レベルとJP1資源グループを組み合わせて設定することで，業務コンテンツへのアクセス権を設定できるようになります。

業務コンテンツにアクセス権を設定する流れを次に示します。

JP1/BaseでJP1権限レベル，JP1資源グループを設定する
JP1/Baseでの作業になるため，必要に応じてJP1/Baseの管理者と設定内容などを相談しながら作業を実施してください。

コンテンツ管理者（管理者の権限を与えたユーザ）が，新規に業務コンテンツを追加し，JP1資源グループを設定する
業務コンテンツにJP1資源グループを設定する手順の詳細は，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド」を参照してください。

ポイント

業務コンテンツに設定するJP1資源グループを変更することによって，業務コンテンツの公開・非公開を切り替えることもできます。その場合は，業務コンテンツを作成・編集するユーザだけを登録したJP1資源グループAと，業務コンテンツを実行するユーザも含むJP1資源グループBの2種類を作成してください。業務コンテンツが非公開のときにはJP1資源グループAを設定しておき，公開するときにJP1資源グループBに変更します。

＜この節の構成＞

6.4.1　アクセス権の種別と設定範囲（JP1/Baseによるユーザ認証を利用している場合）

6.4.2　アクセス権の種別と実行できる操作（JP1/Baseによるユーザ認証を利用している場合）

6.4.3　アクセス権設定時の注意事項（JP1/Baseによるユーザ認証を利用している場合）

6.4.4　JP1資源グループの運用時の注意事項

6.4.1　アクセス権の種別と設定範囲（JP1/Baseによるユーザ認証を利用している場合）

JP1/Baseによるユーザ認証を利用している場合，業務コンテンツに設定するアクセス権の種別はJP1権限レベルによって，アクセス権の設定範囲はJP1資源グループによって決まります。

例えば，「JP1ユーザAは業務コンテンツの参照だけができ，JP1ユーザBおよびJP1ユーザCは業務コンテンツの参照と追加の両方を実行できる」というアクセス権を設定したい場合は，ユーザAとユーザB・Cにそれぞれ異なるJP1権限レベルを設定します。さらに，このJP1権限レベルの設定をすべての業務コンテンツに対して有効にするのか，特定の業務コンテンツに対してだけ有効にするのかによって，JP1資源グループを使い分けます。

ナビゲーション プラットフォームで使用するJP1権限レベルとJP1資源グループについては，「4.3.1　ナビゲーション プラットフォームで使用できるJP1資源グループ」および「4.3.2　ナビゲーション プラットフォームで使用できるJP1権限レベル」を参照してください。

6.4.2　アクセス権の種別と実行できる操作（JP1/Baseによるユーザ認証を利用している場合）

JP1/Baseによるユーザ認証を利用している場合，ユーザが実際にどのような操作ができるかは，JP1資源グループとJP1権限レベルの組み合わせで決まります。同じJP1権限レベルが設定されていても，JP1資源グループが異なると，実行できる操作が異なることがあります。

例えば，コンテンツ編集者のJP1権限レベルを持つユーザがいた場合，システム全体に対するJP1資源グループに登録されているか，業務コンテンツ単位のJP1資源グループに登録されているかによって，次のように実行できる操作が異なります。

システム全体に対するJP1資源グループの場合
システム内のすべての業務コンテンツを編集，参照できる。

業務コンテンツ単位のJP1資源グループの場合
該当するJP1資源グループが設定されている業務コンテンツだけを編集，参照できる。

JP1資源グループとJP1権限レベルの組み合わせによってどのように操作内容が異なるかについては，「4.3.3　JP1資源グループとJP1権限レベルの組み合わせ」を参照してください。

6.4.3　アクセス権設定時の注意事項（JP1/Baseによるユーザ認証を利用している場合）

一つのユーザを重複して異なるJP1資源グループに登録し，さらにそのユーザに対して各JP1資源グループで異なるアクセス権の種別（JP1権限レベル）を割り当てると，上位のJP1権限レベルが有効になります。そのため，一つの業務コンテンツに複数のJP1資源グループを設定する場合は，注意が必要です。例を次に示します。

ユーザ1に対してJP1資源グループAでは利用者のJP1権限レベルを割り当て，JP1資源グループBでは編集者のJP1権限レベルを割り当てています。この状態でJP1資源グループAとBの両方を同じ業務コンテンツに設定すると，上位のJP1権限レベルが定義されているJP1資源グループBの定義内容だけが有効となるため，ユーザ1はコンテンツ編集者としてその業務コンテンツを操作することができます。

6.4.4　JP1資源グループの運用時の注意事項

JP1資源グループの追加，変更，削除などは，JP1/Baseでの操作が必要です。ただし，システム全体のJP1資源グループの名称を見直す場合は，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.jp1auth.system.resource.groupプロパティの指定値も見直す必要があります。JP1/Baseの操作方法については，マニュアル「JP1/Base 運用ガイド」を参照してください。

6.5　業務コンテンツのアクセス管理の流れ（ディレクトリサーバによるユーザ認証を利用している場合）

ユーザ認証の利用なし，またはディレクトリサーバによるユーザ認証を利用している場合，次のような流れで業務コンテンツのアクセス管理をします。

システム管理者が，編集環境でアクセス権グループを作成する。

コンテンツ管理者が，編集環境で業務コンテンツを作成し，アクセス権グループを設定する。

システム管理者が，編集環境のアクセス権グループを実行環境にエクスポートする。

＜この節の構成＞

6.5.1　アクセス権グループを作成する手順

6.5.2　アクセス権グループの定義内容を変更する手順

6.5.3　アクセス権グループを削除する手順

6.5.4　アクセス権グループのエクスポートとインポート

6.5.5　アクセス権グループの作成例

6.5.1　アクセス権グループを作成する手順

ここでは，［アクセス権限］画面でアクセス権グループを作成する手順について説明します。なお，アクセス権グループを作成するに当たっては，次の点を考慮してください。

作成できるアクセス権グループは最大100個です。

各アクセス権グループに定義できるユーザとグループ（または組織）は，合計で最大64個です。そのため，1個のアクセス権グループに多数のユーザを定義する必要がある場合は，グループ（または組織）として定義することを推奨します。

Webブラウザ上で次のURLを指定して，ログイン画面を呼び出します。
http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default/tab_id/-44Ob44O844Og55S76Z2i?start_editor=true&open_editor=true

ホスト名
ナビゲーション プラットフォームのJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ナビゲーション プラットフォームのWebサーバのポート番号です。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値になります。

ユーザIDとパスワードを入力して，［ログイン］ボタンをクリックします。

ナビゲーション プラットフォームのシステム管理者権限を持つユーザID（デフォルトはuser1）とパスワードを入力してください。業務編集画面が表示されます。

業務編集画面の上部（ヘッダ領域）にある［アクセス権限］メニューを選択します。
［アクセス権限］画面が表示されます。

［アクセス権グループの一覧］領域から［新規］メニューを選択します。
画面右側に［アクセス権グループの編集］領域が表示されます。

［アクセス権グループの名称］テキストボックスに，アクセス権グループの名前を入力します。
アクセス権グループの名前は，255バイトまで入力できます。制御文字（ASCIIコードの0x00～0x1Fと0x7F）を含む文字列は入力できません。アクセス権グループの名前は必ず入力してください。

［ユーザ，グループの追加］または［ユーザ，組織の追加］の［役割］ドロップダウンリストから，アクセス権の種別を選択します。
アクセス権の種別（役割）ごとに実行できる操作については，ドロップダウンリストの見出しの横に表示されているアイコンをクリックして表示される画面で確認してください。

［割り当て範囲］ドロップダウンリストから，アクセス権限を設定する範囲を選択します。

ユーザ単位でアクセス権を設定したい場合

［ユーザ］を選択します。

グループ単位でアクセス権を設定したい場合

［グループ］または［組織］を選択します。

ユーザ全員にアクセス権を設定したい場合

［すべて］を選択します。

ユーザとは，ナビゲーション プラットフォームにログインできるユーザを指しています。
グループまたは組織とは，ディレクトリサーバに登録されているグループまたは組織のことです。

割り当て範囲が「すべて」以外の場合は，［ID］テキストボックスにアクセス権を設定したいユーザ，グループ，または組織のIDを入力します。
IDは254バイトまで入力できます。割り当て範囲が「すべて」以外の場合は，省略できません。また，制御文字（ASCIIコードの0x00～0x1Fと0x7F）を含む文字列は入力できません。

［追加］ボタンをクリックします。
アクセス権の定義内容が［ユーザ，グループの一覧］または［ユーザ，組織の一覧］に表示されます。
ほかの対象にもアクセス権を定義する場合は，手順6.～9.を繰り返してください。

［OK］ボタンをクリックします。
［ユーザ，グループの一覧］または［ユーザ，組織の一覧］に表示されている内容が保存され，［アクセス権グループの一覧］領域に，手順5.で入力したアクセス権グループの名前が表示されます。

参考

作成中，または編集中のアクセス権グループが［アクセス権グループの編集］領域に表示されている状態でほかのアクセス権グループを選択したり，［新規］メニューまたは［削除］メニューを選択したりすると，保存していないアクセス権グループを破棄してよいかを確認するメッセージが表示されます。メッセージに対しては次のように対応してください。

編集中のアクセス権グループを保存しない場合
ダイアログで［OK］ボタンをクリックしてください。

編集中のアクセス権グループを保存したい場合
ダイアログで［キャンセル］ボタンをクリックしてください。
そのあと，［アクセス権グループの編集］画面で［OK］ボタンをクリックして編集途中のアクセス権グループを保存してから，再度［新規］メニューまたは［削除］メニューをクリックしてください。

6.5.2　アクセス権グループの定義内容を変更する手順

ここでは，［アクセス権限］画面でアクセス権グループの定義内容を変更する手順について説明します。なお，アクセス権グループの定義内容を変更するに当たっては，次の点を考慮してください。

コンテンツ管理者のユーザを削除したり，コンテンツ編集者または利用者に変更したりすると，業務コンテンツの名称変更やグループ変更ができなくなり，作業に支障が発生することがあります。

アクセス権グループの名称を変更すると，コンテンツ管理者が変更前と変更後のアクセス権グループが同じであることを認識できなくなることがあります。名称を変更したら，コンテンツ管理者にも知らせることを推奨します。

Webブラウザ上で次のURLを指定して，ログイン画面を呼び出します。
http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default/tab_id/-44Ob44O844Og55S76Z2i?start_editor=true&open_editor=true

ホスト名
ナビゲーション プラットフォームのJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ナビゲーション プラットフォームのWebサーバのポート番号です。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値になります。

ユーザIDとパスワードを入力して，［ログイン］ボタンをクリックします。
ナビゲーション プラットフォームのシステム管理者権限を持つユーザID（デフォルトはuser1）とパスワードを入力してください。業務編集画面が表示されます。

業務編集画面の上部（ヘッダ領域）にある［アクセス権限］メニューを選択します。
［アクセス権限］画面が表示されます。

［アクセス権グループの一覧］領域で，定義内容を変更したいアクセス権グループの名称をクリックします。
［アクセス権グループの編集］画面にアクセス権グループの定義内容が表示されます。

アクセス権グループの名称，ユーザまたはグループ・組織の役割，割り当て範囲，IDを変更します。

アクセス権グループの名称を変更する場合
［アクセス権グループの名称］テキストボックスの内容を変更してください。

ユーザまたはグループ・組織の役割，割り当て範囲，IDを変更，削除する場合
追加済みのユーザまたはグループ・組織を変更したい場合は，いったん削除してから，変更後のユーザまたはグループ・組織を追加する必要があります。
まず，［ユーザ，グループの一覧］または［ユーザ，組織の一覧］で変更したいユーザまたはグループ・組織の［削除］ボタンをクリックしてください。次に，［ユーザ，グループの追加］または［ユーザ，組織の追加］で変更後の役割，割り当て範囲，IDを設定して，［追加］ボタンをクリックします。

［OK］ボタンをクリックします。
アクセス権グループの定義内容の変更が保存されます。

6.5.3　アクセス権グループを削除する手順

ここでは，［アクセス権限］画面でアクセス権グループを削除する手順について説明します。アクセス権グループの削除は，環境ごとに実施する必要があります。また，アクセス権グループを削除するに当たっては，次の点を考慮してください。

削除するアクセス権グループにコンテンツ管理者またはコンテンツ編集者として定義されていたユーザが，業務コンテンツを参照しかできなくなり，作業に支障が発生することがあります。

アクセス権グループ「標準アクセス権限」は，削除できません。

削除するアクセス権グループだけが設定されている業務コンテンツがある場合，そのアクセス権グループは削除できません。

Webブラウザ上で次のURLを指定して，ログイン画面を呼び出します。
http://ホスト名:ポート番号/ucnpBase/portal/screen/TitlePortlet/portlet/ucnp/pane/-44Ob44O844Og55S76Z2i/layout_id/default/tab_id/-44Ob44O844Og55S76Z2i?start_editor=true&open_editor=true

ホスト名
ナビゲーション プラットフォームのJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
ナビゲーション プラットフォームのWebサーバのポート番号です。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティの指定値になります。

ユーザIDとパスワードを入力して，［ログイン］ボタンをクリックします。
ナビゲーション プラットフォームのシステム管理者権限を持つユーザID（デフォルトはuser1）とパスワードを入力してください。業務編集画面が表示されます。

業務編集画面の上部（ヘッダ領域）にある［アクセス権限］メニューを選択して，［アクセス権限］画面を表示します。

［アクセス権グループの一覧］領域で，削除したいアクセス権グループのチェックボックスをチェックします。

複数のアクセス権グループを一度に削除したい場合は，削除したいアクセス権グループのチェックボックスをすべてチェックしてください。

［アクセス権グループの一覧］領域の［削除］メニューをクリックします。
アクセス権グループを削除するかどうかを確認するダイアログが表示されます。

ダイアログで［OK］ボタンをクリックします。
手順4.でチェックしたアクセス権グループが削除されます。

6.5.4　アクセス権グループのエクスポートとインポート

編集環境で作成したアクセス権グループは，エクスポートして実行環境またはほかの編集環境へインポートできます。エクスポートするときは，アクセス権グループだけをエクスポートするか，業務コンテンツごとエクスポートするか，2種類の方法があります。それぞれの方法の手順を説明します。

＜この項の構成＞

(1)　アクセス権グループだけをエクスポート，インポートする手順

(2)　業務コンテンツごとアクセス権グループをエクスポート，インポートする手順

(1)　アクセス権グループだけをエクスポート，インポートする手順

編集環境のマシンにログインします。

コマンドプロンプトから，npaclexportコマンド（アクセス権グループのエクスポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npaclexport C:¥work¥accessgroup.zip

例のとおりに実行すると，accessgroup.zipファイルにすべてのアクセス権グループの情報がエクスポートされて，workディレクトリに格納されます。

インポート先の実行環境または編集環境のマシンにログインします。

npaclexportコマンドで取得したファイルを任意のディレクトリに格納します。

コマンドプロンプトから，npimportコマンド（業務コンテンツのインポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -f C:¥work¥accessgroup.zip

例のとおりに実行すると，accessgroup.zipファイルのアクセス権グループの情報がインポートされます。インポート先にすでに同じ名称のアクセス権グループがある場合は，定義内容が上書きされます。

(2)　業務コンテンツごとアクセス権グループをエクスポート，インポートする手順

編集環境のマシンにログインします。

コマンドプロンプトから，npexportコマンド（業務コンテンツのエクスポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport C:¥work¥contents.zip

例のとおりに実行すると，contents.zipファイルにすべての業務コンテンツおよびアクセス権グループの情報がエクスポートされて，workディレクトリに格納されます。

インポート先の実行環境または編集環境のマシンにログインします。

npexportコマンドで取得したファイルを任意のディレクトリに格納します。

コマンドプロンプトから，npimportコマンド（業務コンテンツのインポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -f C:¥work¥contents.zip

例のとおりに実行すると，contents.zipファイルの業務コンテンツおよびアクセス権グループの情報がインポートされます。インポート先にすでに同じIDの業務コンテンツまたは同じ名称のアクセス権グループがある場合は，内容が上書きされます。

6.5.5　アクセス権グループの作成例

アクセス権グループの作成例（定義例）を次に示します。アクセス権グループで定義できるアクセス権の種別（役割）に対応する操作の詳細は，「6.3.2　アクセス権の種別と実行できる操作（ディレクトリサーバによるユーザ認証を利用している場合）」を参照してください。

すべてのユーザに業務コンテンツの追加，編集，参照を許可する場合

役割：管理者
割り当て範囲：すべて
ID：空欄（指定しない）

このように定義したアクセス権グループを作成した場合，ナビゲーション プラットフォームにアクセスできるすべてのユーザがコンテンツ管理者となります。

業務コンテンツの追加，編集は一部のユーザに限定し，参照はすべてのユーザに許可する場合

役割：管理者
割り当て範囲：ユーザ
ID：userA

役割：編集者
割り当て範囲：ユーザ
ID：userB

役割：利用者
割り当て範囲：すべて
ID：空欄（指定しない）

このように定義したアクセス権グループを作成した場合，userAのIDでナビゲーション プラットフォームにログインするとコンテンツ管理者に，userBのIDでログインするとコンテンツ編集者となります。userA・userB以外のIDでログインすると利用者と見なされます。

Active Directoryで管理しているグループ単位でアクセス権を設定する場合

役割：管理者
割り当て範囲：グループ
ID：groupA

役割：利用者
割り当て範囲：グループ
ID：groupB

このように定義したアクセス権グループを作成した場合，groupAに所属するユーザのIDでナビゲーション プラットフォームにログインするとコンテンツ管理者に，groupBに所属するユーザのIDでログインすると利用者となります。ユーザ数が多く，Active Directoryでグループ管理をしている場合は，アクセス権グループもグループ単位で定義しておくと，定義内容を見直す回数を少なくすることができて効率的です。

6.6　業務コンテンツのエクスポートとインポート

編集環境と実行環境が異なるサーバマシンに構築されている場合，編集環境で作成した業務コンテンツをいったんエクスポートし，実行環境にインポートする必要があります。開発環境がある場合も同様です。

エクスポートとインポートには，ナビゲーション プラットフォームのコマンドを使用します。使用するコマンドおよびその使用方法の詳細については，「8.　コマンド」を参照してください。

エクスポート・インポートできるのは，業務コンテンツのデータ，およびアクセス権の設定情報（アクセス権グループまたはJP1資源グループ）です。ただし，業務コンテンツで静的ファイルを使用している場合，静的ファイルはコマンドによるエクスポート・インポートの対象とはならないため，別途管理する必要があります。詳細は，「6.9　業務コンテンツで使用する静的ファイルの管理」を参照してください。

なお，すべて環境が一つのマシンに構築されている場合でも，バックアップ用としてエクスポートだけを実施することもできます。

エクスポート・インポート実施時の注意事項

エクスポートとインポートでは，作業フォルダとして環境変数TMPまたはTEMPのフォルダを使用します。このため，環境変数TMPおよびTEMPのフォルダのディスク容量に余裕を持たせてから，エクスポート・インポートを実施してください。

＜この節の構成＞

6.6.1　業務コンテンツのエクスポート

6.6.2　業務コンテンツのインポート

6.6.1　業務コンテンツのエクスポート

ここでは，編集環境または開発環境に保存されている業務コンテンツだけをエクスポートする方法について説明します。

編集環境または開発環境のマシンにログインします。

コマンドプロンプトから，npexportコマンド（業務コンテンツのエクスポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -x C:¥work¥contents.zip

例のとおりに実行すると，contents.zipファイルにすべての業務コンテンツの情報がエクスポートされて，workディレクトリに格納されます。
なお，この例はディレクトリサーバによるユーザ認証を使用していて，アクセス権グループの情報を上書きしたくない場合の実行例です。

npexportコマンド（業務コンテンツのエクスポート）の詳細は，「8.4　npexportコマンド（業務コンテンツのエクスポート）」を参照してください。

6.6.2　業務コンテンツのインポート

ここでは，npexportコマンド（業務コンテンツのエクスポート）でエクスポートした業務コンテンツをインポートする方法について説明します。インポート作業は，すべての環境で実施します。

インポート先の環境のマシンにログインします。

バックアップのため，インポート先の環境の業務コンテンツをエクスポートします。
手順の詳細は，「6.6.1　業務コンテンツのエクスポート」を参照してください。

npexportコマンドで取得したインポート元の環境のファイルを任意のディレクトリに格納します。

コマンドプロンプトから，npimportコマンド（業務コンテンツのインポート）を実行します。

実行例

ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -f -x C:¥work¥contents.zip

例のとおりに実行すると，contents.zipファイルに含まれる業務コンテンツの情報だけがインポートされます。インポート先にすでに同じIDの業務コンテンツがある場合は，内容が上書きされます。
なお，この例はディレクトリサーバによるユーザ認証を使用していて，アクセス権グループの情報を上書きしたくない場合の実行例です。

npimportコマンド（業務コンテンツのインポート）の詳細は，「8.5　npimportコマンド（業務コンテンツのインポート）」を参照してください。

6.7　開発環境で作成したファイルの適用

開発環境では，プラグインやカスタム画面を開発してナビゲーション プラットフォームのJ2EEアプリケーションに追加します。編集環境または実行環境では，開発環境でプラグインやカスタム画面を適用したJ2EEアプリケーションのEARファイルを受け取って，システムに適用します。

この節では，開発環境で開発したプラグインやカスタム画面をナビゲーション プラットフォームのJ2EEアプリケーションに追加し，編集環境または実行環境に適用する手順について説明します。あわせて，適用前の状態（プラグインもカスタム画面も適用されていない状態）に戻す手順についても説明します。

＜この節の構成＞

6.7.1　開発環境から受け取るファイル

6.7.2　開発環境から受け取ったファイルの適用

6.7.3　適用する前の状態への復元

6.7.1　開発環境から受け取るファイル

開発環境から受け取るファイルを次に示します。

＜この項の構成＞

(1)　EARファイル

(2)　静的ファイルの格納先

(3)　ライブラリのファイル

(1)　EARファイル

開発環境にある次のファイルを，編集環境および実行環境の任意のディレクトリにコピーしておいてください。

ナビゲーション プラットフォームインストールディレクトリ¥pluginSDK¥dest¥ucnp.ear

なお，コピー元（開発環境）とコピー先（編集環境または実行環境）のナビゲーション プラットフォームのバージョンは，構成ソフトウェアも含めて同じである必要があります。

(2)　静的ファイルの格納先

開発環境から受け取った静的ファイルを，編集環境または実行環境の次のディレクトリに格納してください。

Webサーバのコンテンツ格納ディレクトリ

Webサーバのコンテンツ格納ディレクトリは，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.cosminexus.httpsd.documentroot.pathプロパティの指定値で確認してください。デフォルトの指定値は「Cosminexusインストールディレクトリ¥httpsd¥htdocs」です。

(3)　ライブラリのファイル

ライブラリのファイルはEARファイルに含まれるため，個別に受け取る必要はありません。

ただし，コンテナ拡張ライブラリを使用する場合は，開発環境から受け取ったライブラリファイルを編集環境および実行環境の任意のディレクトリに格納し，開発環境と同様にJ2EEサーバに設定してください。コンテナ拡張ライブラリの使用方法の詳細は，マニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 拡張編」を参照してください。

6.7.2　開発環境から受け取ったファイルの適用

開発環境から受け取ったファイルを編集環境または実行環境に適用する手順について説明します。

＜この項の構成＞

(1)　EARファイルの更新

(2)　J2EEアプリケーションの削除

(3)　Webサーバリダイレクトの設定

(4)　J2EEサーバの再起動

(5)　J2EEアプリケーションのインポートと開始

(1)　EARファイルの更新

開発環境から受け取ったEARファイルには，開発環境のPortal Managerでの設定（ポータル用設定ファイル）が反映されています。したがって，開発環境から受け取ったファイルを編集環境または実行環境に適用する前に，開発環境から受け取ったEARファイルを更新し，編集環境または実行環境のポータル用設定ファイルの内容を反映する必要があります。

開発環境から受け取ったEARファイルを更新し，編集環境または実行環境のポータル用設定ファイルの内容を反映する手順を次に示します。

cjexportappコマンドを実行して，プラグインやカスタム画面を適用する前のナビゲーション プラットフォームのJ2EEアプリケーションをEARファイルにバックアップします。

Cosminexusインストールディレクトリ¥CC¥admin¥bin¥cjexportapp J2EEサーバ名 -f EARファイルの出力先パス -name ucnp -raw -nameserver corbaname::localhost:ネーミングサービスのポート番号

バックアップしたEARファイルは，プラグインを適用する前の状態に復元したいときに使用します。
ネーミングサービスのポート番号は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.ejbserver.naming.portの指定値です。指定値がデフォルトの900の場合は，-nameserverオプションの指定は任意になります。
cjexportappコマンドの詳細は，マニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」を参照してください。

npupdateearコマンド（EARファイルの更新）を実行して，「6.7.1　開発環境から受け取るファイル」でコピーしたEARファイルにポータル用設定ファイルの内容を反映します。

npupdateear -p ポータルプロジェクトのパス -i 「6.7.1　開発環境から受け取るファイル」でコピーしたEARファイルのパス -o 更新後のEARファイルの出力先パス -t 一時ディレクトリのパス

npupdateearコマンド（EARファイルの更新）の詳細は，「8.13　npupdateearコマンド（EARファイルの更新）」を参照してください。

(2)　J2EEアプリケーションの削除

プラグインやカスタム画面を適用する前のJ2EEアプリケーションを削除する手順を次に示します。

Cosminexus Management Serverを起動します。

次のURLにアクセスして，Cosminexus Management Serverにログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名

編集環境または実行環境が構築されているマシンのホスト名またはIPアドレスを指定します。

ポート番号

Cosminexus Management Serverが使用するポート番号を指定します。このマニュアルの手順どおりにセットアップした環境では，「28080」です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［開始/停止］タブを表示します。

インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［停止］アンカーをクリックします。

［削除］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［削除］アンカーをクリックします。
J2EEサーバからナビゲーション プラットフォームのJ2EEアプリケーションが削除されます。

(3)　Webサーバリダイレクトの設定

Webサーバリダイレクトを設定し，Webサーバを再起動します。手順を次に示します。

注意事項

Webサーバリダイレクトの設定は，入出力プラグインを追加・削除した場合だけ実施してください。既存のプラグインを修正した場合，またはカスタム画面を開発した場合は不要です。

次のURLにアクセスして，Cosminexus Management Serverをログインします。
http://ホスト名:ポート番号/mngsvr/

ホスト名
開発環境のJ2EEサーバマシンのホスト名またはIPアドレスです。

ポート番号
Cosminexus Management Serverが使用するポート番号です。

なお，このマニュアルの手順どおりにセットアップした環境では，ログイン時に入力する管理ユーザIDが「admin」，パスワードが「ucnppass」です。

［論理サーバの環境設定］アンカーをクリックします。
論理サーバの環境設定画面が表示されます。

［サーバビュー］タブ－［論理Webサーバ］－［Webサーバ］－［編集環境または実行環境のWebサーバ名称］をクリックし，［マッピング］タブをクリックします。
［マッピングの定義］画面が表示されます。

次のとおりに設定します。

いちばん下の行の［有効］のチェックボックスをチェックする

［URLパターン］に「/プラグイン名/*」と入力する

［論理サーバ名］に編集環境または実行環境の論理サーバ名を入力する

プラグイン名は，プラグインを開発したユーザに問い合わせてください。

［追加］ボタンをクリックします。
複数のプラグインを利用する場合は，手順4.～5.を複数回実行してください。

画面右上の［設定情報の配布］アンカーをクリックします。
［設定情報の配布］画面が表示されます。

論理サーバ名に編集環境または実行環境のWebサーバ名称が表示されている行の［配布］チェックボックスをチェックします。
論理サーバが選択されます。

［選択して配布］ボタンをクリックします。
手順7.で選択した論理サーバの設定情報がWebサーバに配布されます。

編集環境または実行環境のWebサーバを再起動します。

(4)　J2EEサーバの再起動

J2EEサーバを再起動する手順を次に示します。

［論理サーバの起動／停止］アンカーをクリックし，論理サーバの起動／停止画面を表示します。

［サーバビュー］タブ－［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックし，［起動／停止］タブを表示します。

［停止］ボタンをクリックします。

J2EEサーバが停止したら，［起動／停止］タブを表示し直します。

［起動］ボタンをクリックします。
J2EEサーバの再起動が完了します。

注意事項

J2EEサーバは，プラグインを追加・削除・修正した場合だけ再起動してください。カスタム画面を開発した場合は不要です。

(5)　J2EEアプリケーションのインポートと開始

プラグインの適用，カスタム画面の適用，およびポータル用設定ファイルの更新内容の反映が完了したEARファイルで，J2EEアプリケーションをインポートして開始します。

［論理サーバのアプリケーション管理］アンカーをクリックし，論理サーバのアプリケーション管理画面を表示します。

［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］－［アプリケーション］をクリックし，［インポート］タブを表示します。

「インポートディレクトリ」に「(1)　EARファイルの更新」で更新したEARファイルがあるディレクトリパスを指定し，［適用］ボタンをクリックします。

J2EEアプリケーションファイルのドロップダウンリストからEARファイルを選択し，［実行］ボタンをクリックします。
J2EEアプリケーションがインポートされます。

［開始/終了］タブを表示し，インポートJ2EEアプリケーション一覧で，アプリケーション名「ucnp」の［開始］アンカーをクリックします。
J2EEアプリケーションが開始されます。

注意事項

開発環境になく，編集環境または実行環境だけに存在するプラグインがある場合，そのプラグインは削除されます。

プラグインまたはカスタム画面を利用するために，J2EEサーバおよびWebサーバの設定を追加，変更する場合は，プラグインまたはカスタム画面を開発したユーザ（開発者）の指示に従って個別に設定してください。

6.7.3　適用する前の状態への復元

編集環境または実行環境で，プラグインおよびカスタム画面を適用する前の状態に復元する手順を次に示します。

注意

この手順は，プラグインとカスタム画面の両方の適用を取り消す手順です。どちらか一方を削除したい場合は，開発環境でEARファイルを作り直して，「6.7.2　開発環境から受け取ったファイルの適用」の手順を実施してください。

プラグインまたはカスタム画面を適用したあとにPortal Managerでの設定を変更した場合，npupdateearコマンド（EARファイルの更新）を実行して，「6.7.2(1)　EARファイルの更新」でバックアップした，プラグイン適用前のEARファイルに最新のポータル用設定ファイルの内容を反映します。

npupdateear -p ポータルプロジェクトのパス -i 「6.7.2(1)　EARファイルの更新」でバックアップしたEARファイルのパス -o 更新後のEARファイルの出力先パス -t 一時ディレクトリのパス

npupdateearコマンド（EARファイルの更新）の詳細は，「8.13　npupdateearコマンド（EARファイルの更新）」を参照してください。
なお，この手順は，プラグインを適用したあとにPortal Managerでの設定を一度も変更していない場合は不要です。

適用済みのJ2EEアプリケーションを削除します。
削除手順については，「6.7.2(2)　J2EEアプリケーションの削除」を参照してください。
入出力プラグインを適用していた場合は次の手順へ，カスタム画面だけを適用していた場合は手順5.へ進んでください。

適用時に設定したWebサーバのリダイレクト設定を元に戻し，Webサーバを再起動します。
Webサーバリダイレクトの設定については，「6.7.2(3)　Webサーバリダイレクトの設定」を参照してください。

J2EEサーバを再起動します。
再起動手順については，「6.7.2(4)　J2EEサーバの再起動」を参照してください。

J2EEアプリケーションをインポートして開始します。
プラグインまたはカスタム画面を適用したあとにPortal Managerでの設定を変更した場合，手順1.で出力した，更新後のEARファイルをインポートしてください。適用後にPortal Managerでの設定を変更していない場合，「6.7.2(1)　EARファイルの更新」でバックアップした，プラグインまたはカスタム画面を適用する前のEARファイルをインポートしてください。
インポートと開始の手順については，「6.7.2(5)　J2EEアプリケーションのインポートと開始」を参照してください。

カスタム画面用に格納したファイルを削除します。
カスタム画面で使用していた静的ファイルとコンテナ拡張ライブラリのファイルを削除してください。各ファイルの格納場所の詳細は，「6.7.1　開発環境から受け取るファイル」を参照してください。

プラグインまたはカスタム画面を利用するために，J2EEサーバおよびWebサーバの設定を追加，変更した場合は，それらの設定を元に戻します。

6.8　検索用データの更新

検索用のデータを登録したあとに，業務コンテンツを追加・編集・削除した場合，または業務コンテンツをインポートした場合は，検索用のデータを更新する必要があります。手順を次に示します。

npupdatesearchdataコマンド（検索用データの更新）を実行します。
検索用データが更新されます。
npupdatesearchdataコマンド（検索用データの更新）の詳細は，「8.14　npupdatesearchdataコマンド（検索用データの更新）」を参照してください。

参考

検索用データを更新するタイミングについて，推奨する方法を説明します。

編集環境
業務コンテンツの更新頻度が高いため，OSの機能を利用して，定期的に自動でnpupdatesearchdataコマンド（検索用データの更新）が実行されるよう設定します。

実行環境
業務コンテンツのインポート時に必ず検索用データを更新するために，npimportコマンド（業務コンテンツのインポート）およびnpupdatesearchdataコマンド（検索用データの更新）を連続して実行するバッチファイルを作成します。

6.9　業務コンテンツで使用する静的ファイルの管理

この節では，業務コンテンツやカスタム画面で使用する静的ファイル（画像ファイルやHTMLファイルなど）を管理するときの注意事項を説明します。

参考

業務編集画面から静的ファイルを格納するためには，［ファイル管理／登録］メニューを使用します。業務編集画面に［ファイル管理／登録］メニューが表示されていない場合は，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.fileupload.link.displayプロパティの指定値を見直してください。

＜この節の構成＞

6.9.1　業務編集画面から静的ファイルを格納する場合のファイル管理

6.9.2　Webサーバのディレクトリに直接静的ファイルを格納する場合のファイル管理

6.9.3　業務コンテンツをエクスポートまたはインポートする場合の注意事項

6.9.1　業務編集画面から静的ファイルを格納する場合のファイル管理

業務編集画面の操作で静的ファイルを格納する場合，静的ファイルは次のディレクトリに格納されます。

ucnp.base.server.cosminexus.httpsd.documentroot.pathに指定したディレクトリ¥ucnpuserstaticfiles

ここでは，このディレクトリに対する操作と運用について説明します。

＜この項の構成＞

(1)　ディスク容量の管理

(2)　ファイルへのアクセスの管理

(3)　操作時の注意

(1)　ディスク容量の管理

サーバのディスク容量が不足することを防止するため，ファイルサーバーリソースマネージャのクォータ機能を利用してください。クォータ機能を利用して，業務編集画面から静的ファイルを格納するためのディレクトリ「ucnpuserstaticfiles」に対して容量制限の設定をしておきます。サーバのディスク容量を考慮し，「ucnpuserstaticfiles」に格納できるデータの容量の制限値を決めてください。制限値に達する前に警告の通知が送られるような設定にしておくと，容量不足の防止に効果的です。

なお，業務コンテンツを削除しても，その業務コンテンツで使用していた静的ファイルは残ります。静的ファイルの格納ディレクトリを定期的に確認して，不要なファイルは削除するようにしてください。

(2)　ファイルへのアクセスの管理

業務編集画面から格納した静的ファイルは，業務編集画面を利用するすべてのユーザが参照・削除できます。アクセス制限などの管理をしたい静的ファイルは，業務編集画面から格納するのではなく，ほかのディレクトリに直接格納してください。

(3)　操作時の注意

業務編集画面から静的ファイルを操作しているときに，サーバ上でも同じ静的ファイルを操作すると，動作は保証されません。また，アップロード処理または削除処理の途中でWebブラウザの［×］ボタンで画面を閉じてしまうと，処理が失敗するおそれがあるため，注意が必要です。

ナビゲーション プラットフォームの画面を閉じる場合，［ファイル管理／登録］画面を閉じてから閉じるようにしてください。誤って［ファイル管理／登録］画面を開いたまま，ナビゲーション プラットフォームの画面を閉じてしまった場合，［ファイル管理／登録］画面も閉じてください。

6.9.2　Webサーバのディレクトリに直接静的ファイルを格納する場合のファイル管理

業務編集画面に［ファイル管理／登録］メニューを表示していない場合は，Webサーバの任意のディレクトリに直接静的ファイルを格納する必要があります。また，業務編集画面の［ファイル管理／登録］メニューからは，静的ファイルを1ファイルずつしか格納できないため，複数の静的ファイルを一度にWebサーバへ格納する場合は，Webサーバのディレクトリに直接格納する方がスムーズです。

静的ファイルをWebサーバのディレクトリに直接格納する場合の注意事項を次に示します。

＜この項の構成＞

(1)　格納ディレクトリの決め方

(2)　コンテンツ格納ディレクトリの確認方法

(3)　ファイル名とディレクトリ名の制限

(1)　格納ディレクトリの決め方

ナビゲーション プラットフォームのWebサーバのディレクトリに格納した静的ファイルを，業務コンテンツに配置する場合，静的ファイルの相対パスを指定します。このパスは，Webサーバのコンテンツ格納ディレクトリを基点とした相対パスとなります。そのため，パスが複雑にならないよう，コンテンツ格納ディレクトリから近いディレクトリに画像ファイルを格納することをお勧めします。

静的ファイル格納後は，コンテンツ格納ディレクトリからの相対パスをコンテンツ管理者とコンテンツ編集者に通知してください。

(2)　コンテンツ格納ディレクトリの確認方法

ナビゲーション プラットフォームのWebサーバのコンテンツ格納ディレクトリは，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.cosminexus.httpsd.documentroot.pathプロパティの指定値で確認してください。デフォルトの指定値は，次のとおりです。

Cosminexusインストールディレクトリ¥httpsd¥htdocs

(3)　ファイル名とディレクトリ名の制限

ナビゲーション プラットフォームのWebサーバのコンテンツ格納ディレクトリの直下には，「ucnpuserstaticfiles」ディレクトリ以外に，「ucnp」で始まるファイルまたはディレクトリを作成しないでください。「ucnp」はナビゲーション プラットフォームのシステムで予約されている名称のためです。この名称のファイルまたはディレクトリを作成した場合の動作は保証されません。

また，「ucnpuserstaticfiles」ディレクトリ以外の，「ucnp」で始まるディレクトリの中に存在するディレクトリおよびファイルを編集しないでください。編集した場合の動作は保証されません。

6.9.3　業務コンテンツをエクスポートまたはインポートする場合の注意事項

業務コンテンツで使用する静的ファイルは，コマンドで自動的にエクスポートまたはインポートすることはできません。業務コンテンツで使用している静的ファイルがどこに格納されているかを確認し，必ず手動でコピーして移動させてください。

7.　プロパティ

この章では，ナビゲーション プラットフォームのプロパティファイルについて説明します。プロパティファイルは，セットアップ時に作成します。

＜この章の構成＞

7.1　設定が必要なプロパティファイル

7.2　プロパティファイルの記述形式

7.3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定

7.4　ユーザプロパティファイル（ucnp_user.properties）の設定

7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定

7.1　設定が必要なプロパティファイル

システム構築時に設定が必要なプロパティファイルを次の表に示します。

表7-1　プロパティファイルの種類

種類
ファイル名
用途
参照先

ユーザセットアッププロパティファイル
ucnp_setup_user.properties
npsetupコマンド（セットアップ）の実行時に適用されるセットアップ情報を指定します。

ディレクトリサーバに関する情報

ポート番号　など

7.3

ユーザプロパティファイル
ucnp_user.properties
ナビゲーション プラットフォームの動作環境を指定します。

画面表示

トレース情報　など

7.4

ユーザメッセージプロパティファイル
ucnp_message_user.properties
業務実行画面のガイド領域に表示される次のメッセージをカスタマイズします。

業務完了時に表示されるメッセージ

必須のチェックボックスが未チェックの場合に表示されるメッセージ

7.5

注意事項

この表のプロパティファイルに記述されているプロパティのうち，以降で説明しているプロパティ以外は編集しないでください。

Windows XP以外のOSに環境を構築する場合，管理者としてプロパティファイルをコピーしてください。管理者としてコピーしないと，プロパティファイルがユーザフォルダにリダイレクトされるため，正しくコピーされません。また，設定値を変更するときには，エディタを［管理者として実行］で起動してから，プロパティファイルを編集してください。

画面などをカスタマイズするにはユーザプロパティファイルおよびユーザメッセージプロパティファイルを編集します。
プロパティの設定をナビゲーション プラットフォームに反映させるためには，ナビゲーション プラットフォームの再起動が必要です。npstopコマンド（停止）を実行したあと，npstartコマンド（起動）を実行してください。

7.2　プロパティファイルの記述形式

この節では，プロパティファイルの記述形式について説明します。記述形式は各プロパティファイルで共通です。

プロパティファイルは，Java 2 Platform, Standard Editionのプロパティファイル形式です。

＜この節の構成＞

7.2.1　プロパティファイルを記述する際の注意事項

7.2.2　エスケープシーケンスの指定

7.2.1　プロパティファイルを記述する際の注意事項

プロパティファイルを記述する際の注意事項を次に示します。なお，説明中の「空白文字」は半角スペース，タブまたは改行を指します。

プロパティキーと値の間には「:」または「=」を記述してください。

プロパティキーの次の文字（空白文字を除く）が「:」または「=」の場合，その次の文字（空白文字を除く）から行末の文字までが値として解釈されます。

プロパティキーの次の文字（空白文字を除く）が「:」または「=」でない場合，その文字から行末文字までが値として解釈されます。

値の後ろに空白文字を付加した場合，値の一部と解釈されます。

値の中に「:」，「=」，「#」，または「!」が使用されている場合，値の一部と解釈されます。

Windowsの予約デバイス名（CON，AUX，COMn（nは1～9），LPTn（nは1～9），PRN，NUL，CLOCK$）は使用できません。

行頭文字に「#」または「!」を指定した場合，行全体がコメントと見なされます。

行頭に続く空白文字は無視されます。

ディレクトリを指定する場合，区切り文字（記号）には，「¥¥」または「/」を使用してください。

例：ucnp.base.server.trace.path = C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥logs

指定した値の大文字と小文字は区別されます。

7.2.2　エスケープシーケンスの指定

指定できるエスケープシーケンスを次に示します。

表7-2　エスケープシーケンス一覧

エスケープシーケンス | 説明
¥t | タブ
¥n | ラインフィード（改行）
¥f | フォームフィード（改ページ）
¥r | キャリッジリターン（行頭復帰）
¥" | ダブル引用符（"）
¥' | シングル引用符（'）
¥¥ | バックスラッシュ

エスケープシーケンスの注意事項を次に示します。

8進数のUnicodeエスケープは認識されません。ただし，無効なUnicodeエスケープを指定するとエラーになります。

無効なエスケープシーケンスを指定すると，「¥」を削除してその次の文字を通常文字と見なします。例えば，「¥v」というエスケープシーケンスを指定すると，「v」を指定したと見なされます。

7.3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定

ユーザセットアッププロパティファイルの設定方法について説明します。

ユーザセットアッププロパティファイルを作成するには，サンプルファイルを所定のディレクトリにコピーして作成すると便利です。

＜この節の構成＞

7.3.1　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のプロパティ一覧

7.3.2　ユーザセットアッププロパティファイルの格納先

7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細

7.3.1　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のプロパティ一覧

ユーザセットアッププロパティファイルのプロパティ一覧を次の表に示します。

表7-3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定内容

項番 | プロパティキー | 設定内容 | デフォルト値
1 | ucnp.setup.server.ldap.directory.kind | ユーザ認証の種別 | PasswordSkip
2 | ucnp.setup.server.docb.security.admin | システム管理者ID | user1
3 | ucnp.setup.server.jp1auth.virtual.hostname | ユーザ認証用の論理ホストの名称 | JP1_DEFAULT
4 | ucnp.setup.server.ldap.hostname | ディレクトリサーバのホスト名 | localhost
5 | ucnp.setup.server.ldap.port | ディレクトリサーバのポート番号 | 389
6 | ucnp.setup.server.ldap.java.naming.security.principal | ディレクトリサーバにアクセスする際の認証者の識別子 | cn=user1, cn=Users, dc=hitachi, dc=jp
7 | ucnp.setup.server.ldap.java.naming.security.credentials | ディレクトリサーバにアクセスする際の認証者の識別子に対応するパスワード | password
8 | ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn | JAAS対応ユーザ管理でのリポジトリのベースDN | cn=Users, dc=hitachi, dc=jp
9 | ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.userid | ユーザのログインIDを示す識別名 | sAMAccountName
10 | ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.password | ユーザのパスワードを示す属性名 | unicodePwd
11 | ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.password.encrypt | リポジトリに格納されているパスワードの形式 | sha1
12 | ucnp.setup.server.ldap.department.basedn | 所属組織情報のベースDN | ou=department,o=hitachi,c=jp
13 | ucnp.setup.server.ldap.group.basedn | 所属グループ情報のベースDN | dc=hitachi,dc=jp
14 | ucnp.setup.server.db.port | データベースサーバのポート番号 | 22200
15 | ucnp.setup.server.db.rdarea.dir | RDエリアの作成ディレクトリのパス | DocumentBroker Smart Document Managementインストールディレクトリ¥¥PP¥¥hirdb_e_EP0¥¥AREA
16 | ucnp.setup.server.db.user.id | データベースの認可識別子 | ADMIN
17 | ucnp.setup.server.db.user.password | データベースの認可識別子に対応するパスワード | UCNPPASS
18 | ucnp.setup.server.db.middle.pd_max_users | データベースサーバへの最大同時接続数 | 10
19 | ucnp.setup.server.docb.process | DocumentBrokerサーバのサービスプロセス数 | 1
20 | ucnp.setup.server.docb.dbconnection.pool.count | DocumentBrokerサーバのDBコネクションプール数 | 4
21 | ucnp.setup.server.docb.osagent.port | スマートエージェントがリクエストを受け付けるポート番号 | 14000
22 | ucnp.setup.server.cosminexus.ejbserver.name | J2EEサーバ名 | MyJ2EE
23 | ucnp.setup.server.cosminexus.webserver.name | Webサーバ名 | uCNP_WebSV
24 | ucnp.setup.server.cosminexus.mngsvr.webserver.connector.http.port | Cosminexus Management Server接続HTTPポート番号 | 28080
25 | ucnp.setup.server.cosminexus.mngsvr.webserver.shutdown.port | Cosminexus Management Server終了要求受信ポート番号 | 28005
26 | ucnp.setup.server.cosminexus.mngsvr.webserver.connector.ajp13.port | Cosminexus Management Server内部通信用ポート番号 | 28009
27 | ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.port | Cosminexus Management Serverリモート管理機能への外部接続ポート番号 | 28099
28 | ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.id | Cosminexus Management Serverの管理ユーザID | admin
29 | ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.password | Cosminexus Management Serverの管理ユーザパスワード | ucnppass
30 | ucnp.setup.server.cosminexus.adminagent.adapter.port | Cosminexusのサーバ機能が使用するポート番号 | 20295
31 | ucnp.setup.server.cosminexus.websystem.name | Webシステムの識別名 | uCNP
32 | ucnp.setup.server.cosminexus.ejbserver.http.port | 簡易Webサーバのポート番号 | 8080
33 | ucnp.setup.server.cosminexus.ejbserver.naming.port | ネーミングサービスのポート番号 | 900
34 | ucnp.setup.server.cosminexus.ejbserver.rmi.naming.port | J2EEサーバが利用するRMIレジストリのポート番号 | 23152
35 | ucnp.setup.server.cosminexus.webserver.connector.ajp13.port | Webサーバとの通信に使用するポート番号 | 8007
36 | ucnp.setup.server.cosminexus.webserver.connector.ajp13.max_threads | アプリケーションサーバの最大同時実行スレッド数 | 4
37 | ucnp.setup.server.cosminexus.webserver.connector.redirect_https.port | Webサーバが使用しているHTTPSのポート番号 | 801
38 | ucnp.setup.server.cosminexus.hws.http.port | Cosminexus HTTP Serverがリクエストを受け付けるポート番号 | 80
39 | ucnp.setup.server.portal.manager.http.port | Portal Managerの簡易Webサーバのポート番号 | 24710
40 | ucnp.setup.server.portal.manager.ajp13.port | Portal ManagerのWebコンテナとの通信用ポート番号 | 24711
41 | ucnp.setup.server.portal.manager.rmi.naming.port | Portal Managerが利用するRMIレジストリのポート番号 | 24712
42 | ucnp.setup.server.portal.manager.naming.port | Portal Managerがネーミングサービスとして利用するCORBAネーミングサービスのポート番号 | 24713
43 | ucnp.setup.server.portal.trace.dir | uCosminexus Portal Frameworkのトレース出力ディレクトリ | uCosminexus Portal Frameworkインストールディレクトリ¥¥log
44 | ucnp.setup.server.ucnp.portalproject.path | ナビゲーション プラットフォームで使用するポータルプロジェクトのパス | ナビゲーション プラットフォームインストールディレクトリ¥¥setup¥¥portalproject

なお，ユーザセットアッププロパティファイルで指定するポート番号には，必ず，使用されていないポート番号を指定してください。使用中のポート番号を指定した場合，動作は保証されません。

7.3.2　ユーザセットアッププロパティファイルの格納先

ユーザセットアッププロパティファイルの格納先を次に示します。

プロパティファイルの格納先

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnp_setup_user.properties

ユーザセットアッププロパティファイルの記述例については，サンプルファイルを参照してください。サンプルファイルは，次のディレクトリに格納されています。

サンプルファイルの格納先

ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnp_setup_user.properties

7.3.3　ユーザセットアッププロパティファイルのプロパティ詳細

ユーザセットアッププロパティファイルの各プロパティについて説明します。

ここで説明しているデフォルト値は，セットアップ後にシステムで自動的に指定される値です。ファイル記載値は，サンプルファイルに記載されている値がデフォルト値と異なる場合にだけ記載しています。

プロパティで指定するポート番号の注意事項

ユーザセットアッププロパティファイルの各プロパティには，すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。ほかのアプリケーションのポート番号を変更するか，ユーザセットアッププロパティファイルのプロパティを変更してください。

＜この項の構成＞

(1)　ユーザ認証の種別（ucnp.setup.server.ldap.directory.kind）

(2)　システム管理者ID（ucnp.setup.server.docb.security.admin）

(3)　ユーザ認証用の論理ホストの名称（ucnp.setup.server.jp1auth.virtual.hostname）

(4)　ディレクトリサーバのホスト名（ucnp.setup.server.ldap.hostname）

(5)　ディレクトリサーバのポート番号（ucnp.setup.server.ldap.port）

(6)　ディレクトリサーバにアクセスする際の認証者の識別子（ucnp.setup.server.ldap.java.naming.security.principal）

(7)　ディレクトリサーバにアクセスする際のパスワード（ucnp.setup.server.ldap.java.naming.security.credentials）

(8)　JAAS対応ユーザ管理でのリポジトリのベースDN（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn）

(9)　ユーザのログインIDを示す属性名（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.userid）

(10)　ユーザのパスワードを示す属性名（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.password）

(11)　リポジトリに格納されているパスワードの形式（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.password.encrypt）

(12)　所属組織情報のベースDN（ucnp.setup.server.ldap.department.basedn）

(13)　所属グループ情報のベースDN（ucnp.setup.server.ldap.group.basedn）

(14)　データベースサーバのポート番号（ucnp.setup.server.db.port）

(15)　RDエリアの作成ディレクトリのパス（ucnp.setup.server.db.rdarea.dir）

(16)　データベースの認可識別子（ucnp.setup.server.db.user.id）

(17)　データベースの認可識別子に対応するパスワード（ucnp.setup.server.db.user.password）

(18)　データベースサーバへの最大同時接続数（ucnp.setup.server.db.middle.pd_max_users）

(19)　DocumentBrokerサーバのサービスプロセス数（ucnp.setup.server.docb.process）

(20)　DocumentBrokerサーバのDBコネクションプール数（ucnp.setup.server.docb.dbconnection.pool.count）

(21)　スマートエージェントがリクエストを受け付けるポート番号（ucnp.setup.server.docb.osagent.port）

(22)　J2EEサーバ名（ucnp.setup.server.cosminexus.ejbserver.name）

(23)　Webサーバ名（ucnp.setup.server.cosminexus.webserver.name）

(24)　Cosminexus Management Server接続HTTPポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.connector.http.port）

(25)　Cosminexus Management Server終了要求受信ポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.shutdown.port）

(26)　Cosminexus Management Server内部通信用ポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.connector.ajp13.port）

(27)　Cosminexus Management Serverリモート管理機能への外部接続ポート番号（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.port）

(28)　Cosminexus Management Serverの管理ユーザID（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.id）

(29)　Cosminexus Management Serverの管理ユーザパスワード（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.password）

(30)　Cosminexusのサーバ機能が使用するポート番号（ucnp.setup.server.cosminexus.adminagent.adapter.port）

(31)　Webシステムの識別名（ucnp.setup.server.cosminexus.websystem.name）

(32)　簡易Webサーバのポート番号（ucnp.setup.server.cosminexus.ejbserver.http.port）

(33)　ネーミングサービスのポート番号（ucnp.setup.server.cosminexus.ejbserver.naming.port）

(34)　J2EEサーバが利用するRMIレジストリのポート番号（ucnp.setup.server.cosminexus.ejbserver.rmi.naming.port）

(35)　Webサーバとの通信に使用するポート番号（ucnp.setup.server.cosminexus.webserver.connector.ajp13.port）

(36)　アプリケーションサーバの最大同時実行スレッド数（ucnp.setup.server.cosminexus.webserver.connector.ajp13.max_threads）

(37)　Webサーバが使用しているHTTPSのポート番号（ucnp.setup.server.cosminexus.webserver.connector.redirect_https.port）

(38)　Cosminexus HTTP Serverがリクエストを受け付けるポート番号（ucnp.setup.server.cosminexus.hws.http.port）

(39)　Portal Managerの簡易Webサーバのポート番号（ucnp.setup.server.portal.manager.http.port）

(40)　Portal ManagerのWebコンテナとの通信用ポート番号（ucnp.setup.server.portal.manager.ajp13.port）

(41)　Portal Managerが利用するRMIレジストリのポート番号（ucnp.setup.server.portal.manager.rmi.naming.port）

(42)　Portal Managerがネーミングサービスとして利用するCORBAネーミングサービスのポート番号（ucnp.setup.server.portal.manager.naming.port）

(43)　uCosminexus Portal Frameworkのトレース出力ディレクトリ（ucnp.setup.server.portal.trace.dir）

(44)　ナビゲーション プラットフォームで使用するポータルプロジェクトのパス（ucnp.setup.server.ucnp.portalproject.path）

(1)　ユーザ認証の種別（ucnp.setup.server.ldap.directory.kind）

ユーザ認証の種別を指定します。

指定できる値：

PasswordSkip：ユーザ認証を利用しない（パスワード入力を省略する）

AD：Active Directoryによるユーザ認証を利用する

OD：Oracle Directory Serverによるユーザ認証を利用する

JP1Auth：JP1/Baseによるユーザ認証を利用する

デフォルト値：PasswordSkip

「AD」または「OD」を指定した場合は，幾つかのプロパティの指定値を確認，または変更する必要があります。「AD」を指定した場合に確認が必要なプロパティについては「4.2　Active Directoryによるユーザ認証を利用する場合のセットアップ準備」を参照してください。

(2)　システム管理者ID（ucnp.setup.server.docb.security.admin）

ナビゲーション プラットフォームのシステム管理者権限を持つユーザIDを指定します。指定は省略できません。

システム管理者を複数指定する場合は，ユーザIDをコンマ（,）で区切って指定します。

ユーザIDとして指定できる値：OSで有効なユーザID，かつ，1～30文字の半角英数字

デフォルト値：user1

ナビゲーション プラットフォームのシステム管理者権限を持つユーザは，次の作業を実施できます。

業務コンテンツに設定するアクセス権グループを作成する。

プラグインパーツの関連づけを更新する。

(3)　ユーザ認証用の論理ホストの名称（ucnp.setup.server.jp1auth.virtual.hostname）

ナビゲーション プラットフォームと同じマシン上にあるJP1/Baseが論理ホスト環境の場合，論理ホスト名を指定します。論理ホスト環境ではない，またはユーザ認証を利用しない場合は，このプロパティの設定はデフォルト値のまま変更する必要はありません。

ucnp.setup.server.ldap.directory.kindプロパティの値が「JP1Auth」の場合，この値は，ucnp.base.server.jp1auth.virtual.hostnameプロパティの値として，セットアップ時に自動でユーザプロパティファイルに設定されます。セットアップ後に値を変更したい場合は，ユーザプロパティファイルでucnp.base.server.jp1auth.virtual.hostnameプロパティの値を変更してください。

指定できる値：

デフォルトから変更する場合は，1文字以上196文字以下の半角英数字および半角ハイフンを組み合わせてください。63文字以下の名称とすることを推奨します。

デフォルト値：JP1_DEFAULT

(4)　ディレクトリサーバのホスト名（ucnp.setup.server.ldap.hostname）

ディレクトリサーバのホスト名を指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：localhost

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のjava.naming.provider.url.0を参照してください。

(5)　ディレクトリサーバのポート番号（ucnp.setup.server.ldap.port）

ディレクトリサーバのポート番号を指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：1～65535の整数値

デフォルト値：389

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のjava.naming.provider.url.0を参照してください。

(6)　ディレクトリサーバにアクセスする際の認証者の識別子（ucnp.setup.server.ldap.java.naming.security.principal）

ディレクトリサーバにアクセスする際の認証者の識別子を指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：cn=user1, cn=Users, dc=hitachi, dc=jp

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(7)　ディレクトリサーバにアクセスする際のパスワード（ucnp.setup.server.ldap.java.naming.security.credentials）

ディレクトリサーバにアクセスする際の認証者の識別子（ucnp.setup.server.ldap.java.naming.security.principal）に対応するパスワードを指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：password

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(8)　JAAS対応ユーザ管理でのリポジトリのベースDN（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn）

JAAS対応ユーザ管理でのリポジトリのベースDNを指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：cn=Users, dc=hitachi, dc=jp

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(9)　ユーザのログインIDを示す属性名（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.userid）

ユーザのログインIDを表す属性名を指定します。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：sAMAccountName

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(10)　ユーザのパスワードを示す属性名（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.password）

ユーザのパスワードを表す属性名を指定します。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：unicodePwd

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(11)　リポジトリに格納されているパスワードの形式（ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.password.encrypt）

リポジトリに格納されているパスワードの形式を指定します。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：sha1

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編」のua.conf（統合ユーザ管理のコンフィグレーションファイル）に関する説明を参照してください。

(12)　所属組織情報のベースDN（ucnp.setup.server.ldap.department.basedn）

所属組織情報のベースDNを指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：ou=department,o=hitachi,c=jp

(13)　所属グループ情報のベースDN（ucnp.setup.server.ldap.group.basedn）

所属グループ情報のベースDNを指定します。指定は省略できません。ディレクトリサーバを使用しない場合は，値をファイル記載値のままとしてください。

指定できる値：文字列

デフォルト値：dn=hitachi,dn=jp

(14)　データベースサーバのポート番号（ucnp.setup.server.db.port）

データベースサーバのポート番号を指定します。

指定できる値：5001～65535の整数値

デフォルト値：22200

(15)　RDエリアの作成ディレクトリのパス（ucnp.setup.server.db.rdarea.dir）

RDエリアの作成ディレクトリのパスを絶対パスで指定します。指定できる文字については，「8.1.2　全コマンド共通の注意事項」の表8-2を参照してください。

指定できる値：60バイト以内の文字列

デフォルト値：DocumentBroker Smart Document Managementインストールディレクトリ¥¥PP¥¥hirdb_e_EP0¥¥AREA

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥ECMPKG¥¥PP¥¥hirdb_e_EP0¥¥AREA

なお，指定した絶対パスにディレクトリが存在しない場合，組み込みデータベースの構築時に，組み込みデータベース側でディレクトリを作成します。

(16)　データベースの認可識別子（ucnp.setup.server.db.user.id）

データベースの認可識別子を指定します。

指定できる値：文字列

デフォルト値：ADMIN

指定する値の詳細は，マニュアル「スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス」の名前に使用できる文字と制限に関する説明を参照してください。

(17)　データベースの認可識別子に対応するパスワード（ucnp.setup.server.db.user.password）

データベースの認可識別子（ucnp.setup.server.db.user.id）に対応するパスワードを指定します。

指定できる値：文字列

デフォルト値：UCNPPASS

指定する値の詳細は，マニュアル「スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス」の名前に使用できる文字と制限に関する説明を参照してください。

(18)　データベースサーバへの最大同時接続数（ucnp.setup.server.db.middle.pd_max_users）

データベースサーバに同時接続するユーザ数の最大値を指定します。

指定できる値：10，22

デフォルト値：10

(19)　DocumentBrokerサーバのサービスプロセス数（ucnp.setup.server.docb.process）

DocumentBrokerがデータベースサーバへ接続するときのプロセス数を指定します。

指定できる値：1，2

デフォルト値：1

(20)　DocumentBrokerサーバのDBコネクションプール数（ucnp.setup.server.docb.dbconnection.pool.count）

DocumentBrokerサーバのサービスプロセス当たりのDBコネクションプール数を指定します。DocumentBrokerが使用するデータベースのユーザ数の平均を指定してください。

指定できる値：4，5

デフォルト値：4

(21)　スマートエージェントがリクエストを受け付けるポート番号（ucnp.setup.server.docb.osagent.port）

スマートエージェントがリクエストを受け付けるポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：14000

(22)　J2EEサーバ名（ucnp.setup.server.cosminexus.ejbserver.name）

J2EEサーバ名を指定します。Cosminexusの制限に従った値を指定してください。

指定できる値：文字列

デフォルト値：MyJ2EE

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」のcjsetupコマンドの説明を参照してください。

(23)　Webサーバ名（ucnp.setup.server.cosminexus.webserver.name）

Webサーバ名を指定します。Cosminexus HTTP Serverの制限に従った値を指定してください。

指定できる値：文字列

デフォルト値：uCNP_WebSV

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ Cosminexus HTTP Server」のhwsservereditユティリティの説明を参照してください。

注意事項

Cosminexus HTTP Serverの停止・起動はCosminexus Management Serverを使って実行してください。Cosminexus HTTP Serverをサービスから停止・起動すると，コマンドがエラーになる場合があります。

(24)　Cosminexus Management Server接続HTTPポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.connector.http.port）

Cosminexus Management Server接続HTTPポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：28080

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のmserver.properties（Cosminexus Management Server環境設定ファイル）に関する説明を参照してください。

(25)　Cosminexus Management Server終了要求受信ポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.shutdown.port）

Cosminexus Management Server終了要求受信ポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：28005

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のmserver.properties（Cosminexus Management Server環境設定ファイル）に関する説明を参照してください。

(26)　Cosminexus Management Server内部通信用ポート番号（ucnp.setup.server.cosminexus.mngsvr.webserver.connector.ajp13.port）

Cosminexus Management Server内部通信用ポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：28009

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のmserver.properties（Cosminexus Management Server環境設定ファイル）に関する説明を参照してください。

(27)　Cosminexus Management Serverリモート管理機能への外部接続ポート番号（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.port）

Cosminexus Management Serverリモート管理機能への外部接続ポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：28099

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のmserver.properties（Cosminexus Management Server環境設定ファイル）に関する説明を参照してください。

(28)　Cosminexus Management Serverの管理ユーザID（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.id）

Cosminexus Management Serverの管理ユーザIDを指定します。

指定できる値：文字列

デフォルト値：admin

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」のmngsvrctl（Cosminexus Management Serverの起動／停止／セットアップ）に関する説明を参照してください。

(29)　Cosminexus Management Serverの管理ユーザパスワード（ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.password）

Cosminexus Management Serverの管理ユーザパスワードを指定します。

指定できる値：文字列

デフォルト値：ucnppass

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス コマンド編」のmngsvrctl（Cosminexus Management Serverの起動／停止／セットアップ）に関する説明を参照してください。

(30)　Cosminexusのサーバ機能が使用するポート番号（ucnp.setup.server.cosminexus.adminagent.adapter.port）

Cosminexusのサーバ機能が使用するポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：20295

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のadminagent.properties（運用管理エージェントプロパティファイル）に関する説明を参照してください。

(31)　Webシステムの識別名（ucnp.setup.server.cosminexus.websystem.name）

Webシステムを識別するための名称を指定します。

指定できる値：文字列

デフォルト値：uCNP

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のJ2EEアプリケーションを実行するシステムで指定できるタグに関する説明を参照してください。

(32)　簡易Webサーバのポート番号（ucnp.setup.server.cosminexus.ejbserver.http.port）

簡易Webサーバのポート番号を指定します。すでにほかのアプリケーションで使用または確保されているポート番号は指定できません。

指定できる値：1～65535の整数値

デフォルト値：8080

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(33)　ネーミングサービスのポート番号（ucnp.setup.server.cosminexus.ejbserver.naming.port）

J2EEサーバがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：900

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(34)　J2EEサーバが利用するRMIレジストリのポート番号（ucnp.setup.server.cosminexus.ejbserver.rmi.naming.port）

J2EEサーバが利用するRMIレジストリのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：23152

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(35)　Webサーバとの通信に使用するポート番号（ucnp.setup.server.cosminexus.webserver.connector.ajp13.port）

Webサーバとの通信に使用するポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：8007

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(36)　アプリケーションサーバの最大同時実行スレッド数（ucnp.setup.server.cosminexus.webserver.connector.ajp13.max_threads）

J2EEサーバのWebコンテナが，ナビゲーション プラットフォームからのリクエストを処理する同時実行スレッド数の上限値を設定します。

指定できる値：4，10

デフォルト値：4

(37)　Webサーバが使用しているHTTPSのポート番号（ucnp.setup.server.cosminexus.webserver.connector.redirect_https.port）

Webサーバが使用しているHTTPSのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：801

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(38)　Cosminexus HTTP Serverがリクエストを受け付けるポート番号（ucnp.setup.server.cosminexus.hws.http.port）

Cosminexus HTTP Serverがリクエストを受け付けるポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：80

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ Cosminexus HTTP Server」のK，Lで始まるディレクティブに関する説明を参照してください。

(39)　Portal Managerの簡易Webサーバのポート番号（ucnp.setup.server.portal.manager.http.port）

Portal Managerの簡易Webサーバのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：24710

詳細はマニュアル「uCosminexus Portal Framework システム管理者ガイド」の，ポート番号の設定に関する説明を参照してください。

(40)　Portal ManagerのWebコンテナとの通信用ポート番号（ucnp.setup.server.portal.manager.ajp13.port）

Portal ManagerのWebコンテナとの通信用ポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：24711

詳細はマニュアル「uCosminexus Portal Framework システム管理者ガイド」のポート番号の設定に関する説明を参照してください。

(41)　Portal Managerが利用するRMIレジストリのポート番号（ucnp.setup.server.portal.manager.rmi.naming.port）

Portal Managerが利用するRMIレジストリのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：24712

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(42)　Portal Managerがネーミングサービスとして利用するCORBAネーミングサービスのポート番号（ucnp.setup.server.portal.manager.naming.port）

Portal Managerがネーミングサービスとして利用するCORBAネーミングサービスのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：24713

詳細はマニュアル「Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)」のusrconf.properties（J2EEサーバ用ユーザプロパティファイル）に関する説明を参照してください。

(43)　uCosminexus Portal Frameworkのトレース出力ディレクトリ（ucnp.setup.server.portal.trace.dir）

uCosminexus Portal Frameworkのトレース出力ディレクトリを絶対パスで指定します。

必ずディレクトリのパスを指定してください。ファイルのパスを指定するとエラーになります。また，ファイルの作成および削除ができるディレクトリを指定してください。指定されたディレクトリがない場合には新規に作成します。

指定できる値：文字列

デフォルト値：uCosminexus Portal Frameworkインストールディレクトリ¥¥log

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥CosmiPortal¥¥log

(44)　ナビゲーション プラットフォームで使用するポータルプロジェクトのパス（ucnp.setup.server.ucnp.portalproject.path）

ナビゲーション プラットフォームで使用するポータルプロジェクトのパスを絶対パスで指定します。指定できる文字については，「8.1.2　全コマンド共通の注意事項」の表8-2を参照してください。

必ずディレクトリのパスを指定してください。ファイルのパスを指定するとエラーになります。

指定できる値：文字列

デフォルト値：ナビゲーション プラットフォームインストールディレクトリ¥¥setup¥¥portalproject

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥setup¥¥portalproject

7.4　ユーザプロパティファイル（ucnp_user.properties）の設定

ユーザプロパティファイルの設定方法について説明します。

＜この節の構成＞

7.4.1　ユーザプロパティファイル（ucnp_user.properties）のプロパティ一覧

7.4.2　ユーザプロパティファイルの格納先

7.4.3　ユーザプロパティファイルのプロパティ詳細

7.4.1　ユーザプロパティファイル（ucnp_user.properties）のプロパティ一覧

ユーザプロパティファイルのプロパティ一覧を次の表に示します。

表7-4　ユーザプロパティファイル（ucnp_user.properties）の設定内容

項番 | プロパティキー | 設定内容 | デフォルト値
1 | ucnp.base.server.command.legacy | 旧バージョンのインポート/エクスポートコマンドの使用可否 | false
2 | ucnp.base.server.jp1auth.system.resource.group | システム全体のJP1資源グループ名 | UCNP
3 | ucnp.base.server.jp1auth.virtual.hostname | JP1/Baseの論理ホスト名 | JP1_DEFAULT
4 | ucnp.base.server.trace.path | トレースファイルの出力先ディレクトリの絶対パス | ナビゲーション プラットフォームインストールディレクトリ¥¥logs
5 | ucnp.base.server.trace.size | トレースファイルのファイルサイズの上限値 | 32768
6 | ucnp.base.server.trace.backup.number | トレースファイルの最大面数 | 16
7 | ucnp.base.server.keepsession.interval | リクエスト発信間隔 | 240
8 | ucnp.base.client.frame.resize.target | Webブラウザのウィンドウサイズ変更時，およびメニュー領域の折りたたみ時に幅を変更する領域 | guide
9 | ucnp.base.client.menu.frame.width | メニュー領域の幅（ピクセル単位） | 250
10 | ucnp.base.client.flow.frame.width | 業務フロー領域の幅（ピクセル単位） | 450
11 | ucnp.base.client.guide.frame.width | ガイド領域の幅（ピクセル単位） | 540
12 | ucnp.base.client.editingarea.width | 業務フロー領域とガイド領域の幅の最大値（ピクセル単位） | 1500
13 | ucnp.base.client.editingarea.height | 業務フロー領域とガイド領域の高さの最大値（ピクセル単位） | 1500
14 | ucnp.base.server.logoutbutton.display | ヘッダ領域の［ログアウト］ボタンの表示有無 | true
15 | ucnp.base.server.close.button.setting | ヘッダ領域の［閉じる］ボタンの表示有無 | none
16 | ucnp.base.server.print.link.display | ヘッダ領域の［印刷］メニューの表示有無 | all
17 | ucnp.base.server.custom.head.logo | ヘッダ領域のロゴ画像のパス | なし
18 | ucnp.base.server.custom.login.main | ログイン画面のメイン画像のパス | なし
19 | ucnp.base.server.custom.login.background | ログイン画面の背景画像のパス | なし
20 | ucnp.base.server.custom.browser.title | Webブラウザのタイトルバーまたはタブ名の文字列 | uCosminexus Navigation Platform
21 | ucnp.base.server.custom.help | HTMLマニュアルのパス | なし
22 | ucnp.base.server.search.enable | 検索機能の使用有無 | false
23 | ucnp.base.server.search.accesscontrol.enable | アクセス権限の使用有無（検索機能使用時） | false
24 | ucnp.base.client.confirm.page.unload.enable | 画面の遷移または画面を閉じるときの確認ダイアログの表示有無 | true
25 | ucnp.base.client.menu.group.enable | メニュー領域のグループ表示有無 | true
26 | ucnp.base.client.menu.group.default | デフォルトのグループ名 | !editing
27 | ucnp.base.client.menu.frame.visible | 業務実行画面のメニュー領域の表示有無 | true
28 | ucnp.base.client.flow.frame.visible | 業務実行画面の業務フロー領域の表示有無 | true
29 | ucnp.base.server.custom.menu | カスタマイズしたメニューのHTMLファイルまたはJSPファイルの相対パス | なし
30 | ucnp.base.server.htmlpart.css | HTMLパーツで使用するCSSファイルのパス | なし
31 | ucnp.base.client.terminal.display | 業務実行画面のターミナルノードの表示有無 | false
32 | ucnp.base.client.directjump.enable | 業務フローの直接遷移の可否 | true
33 | ucnp.base.client.currentnode.color | 業務実行画面に表示する選択状態のプロセスノードの色 | orange
34 | ucnp.base.client.node.color | 非選択状態／直接遷移可能状態のプロセスノードの色 | gray
35 | ucnp.base.client.directjump.design | 直接遷移できるプロセスノードのデザイン | gradation
36 | ucnp.base.client.node.checkmark.position | プロセスノードに表示するチェックマークの位置 | left
37 | ucnp.base.client.flow.connector.color | 業務フロー領域の関連線の色 | gray
38 | ucnp.base.client.autoscroll | 業務フロー領域の自動スクロール可否 | true
39 | ucnp.base.client.complete.button.window.close | 業務実行画面で［完了］ボタンをクリックしたときのWebブラウザ動作 | false
40 | ucnp.base.client.viewer.confirm.discardinput.enable | 入力情報の破棄確認ダイアログの表示有無 | true
41 | ucnp.base.client.suspend.enable | 中断再開プラグインの使用有無 | false
42 | ucnp.base.client.suspend.confirm.load.enable | 業務再開の確認ダイアログの表示有無 | true
43 | ucnp.base.client.erroritem.emphasis.regexp.enable | 業務実行画面でのエラー個所の強調表示の有無 | true
44 | ucnp.base.client.erroritem.emphasis.border.color | エラーのパーツを強調する枠の色 | red
45 | ucnp.base.client.operationlog.enable | 操作ログ機能の使用有無 | true
46 | ucnp.base.server.operationlog.path | 操作ログの出力先 | ナビゲーション プラットフォームインストールディレクトリ¥¥operationlogs¥¥operation%g.log
47 | ucnp.base.server.operationlog.backup.number | 操作ログの最大面数 | 16
48 | ucnp.base.server.operationlog.size | 操作ログのファイルサイズの上限値 | 10240
49 | ucnp.base.server.operationlog.format | 操作ログの出力フォーマット | {0}¥t{1}¥t{2}¥t{3}¥t{4}¥t{5}¥t{6}¥t{7}¥t{8}¥t{9}¥t{10}¥t{11}¥t{12}¥t{13}
50 | ucnp.base.server.operationlog.dateformat | 操作ログに出力される日時の表示形式 | yyyy/MM/dd HH:mm:ss.SSS
51 | ucnp.base.server.operationlog.encoding | 操作ログの文字コード | Shift_JIS
52 | ucnp.base.client.auditlog.enable | 監査ログの使用有無 | false
53 | ucnp.base.server.auditlog.path | 監査ログの出力先 | ナビゲーション プラットフォームインストールディレクトリ¥¥auditlog¥¥ucnp_audit
54 | ucnp.base.server.auditlog.backup.number | 監査ログの最大面数 | 16
55 | ucnp.base.server.auditlog.size | 監査ログのファイルサイズの上限値 | 10240
56 | ucnp.base.client.jp1imss.hostname | 連携先のJP1/IM-SSのホスト名 | localhost
57 | ucnp.base.client.jp1imss.portnum | 連携先のJP1/IM-SSのポート番号 | 24401
58 | ucnp.base.client.jp1ao.hostname | 連携先のJP1/AOのホスト名 | localhost
59 | ucnp.base.client.jp1ao.portnum | 連携先のJP1/AOのポート番号 | 23015
60 | ucnp.base.client.jp1ao.submittask.passwordfile.path | パスワードファイルの配置先 | C:¥¥ucnpwork
61 | ucnp.base.client.jp1ev.association.enable | JP1イベント関連づけファイルの使用可否 | false
62 | ucnp.base.server.geturl.link.display | ヘッダ領域の［URL取得］メニューの表示有無 | true
63 | ucnp.base.client.back.button.width | 業務実行画面の［戻る］ボタンの幅（ピクセル単位） | 100
64 | ucnp.base.client.next.button.width | 業務実行画面の［次へ］ボタンの幅（ピクセル単位） | 130
65 | ucnp.base.client.complete.button.width | 業務実行画面の［完了］ボタンの幅（ピクセル単位） | 130
66 | ucnp.base.client.branch.button.width | 業務実行画面で分岐合流ノードを経由して次のノードへ遷移するためのボタンの幅（ピクセル単位） | 130
67 | ucnp.base.server.acl.group.type | アクセス権限の設定対象の指定 | group
68 | ucnp.base.client.contentsname.uniquecheck.enable | 一意の業務コンテンツ名称の指定可否 | true
69 | ucnp.base.client.grid.size | 業務編集画面のグリッド間隔（ピクセル単位） | 10
70 | ucnp.base.client.undo.max.count | ［元に戻す］ボタンの対象操作履歴の最大保持数 | 10
71 | ucnp.base.server.cosminexus.httpsd.documentroot.path | 静的ファイルの格納ディレクトリ | Cosminexusインストールディレクトリ¥¥httpsd¥¥htdocs
72 | ucnp.base.server.fileupload.link.display | ［ファイル管理／登録］メニューの表示有無 | admin
73 | ucnp.base.server.dropdown.csv.dir | ドロップダウンの選択項目を一括設定するためのCSVファイルの格納ディレクトリの絶対パス | なし
74 | ucnp.base.client.editor.jp1plugin.toolpalette.display | ［Plugins］パレットに表示するアイコン | false

7.4.2　ユーザプロパティファイルの格納先

ユーザプロパティファイルはセットアップ時に自動で作成されます。ユーザプロパティファイルの格納先を次に示します。

プロパティファイルの格納先

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnp_user.properties

7.4.3　ユーザプロパティファイルのプロパティ詳細

ユーザプロパティファイルの各プロパティについて説明します。

プロパティの値を変更する場合は，ユーザプロパティファイルのコメントアウトを外し，任意の値を指定してください。ここで説明しているデフォルト値は，セットアップ後にシステムで自動的に指定される値です。ファイル記載値は，ユーザプロパティファイルにコメントアウトで記載されている値で，デフォルト値とファイル記載値が異なる場合に記載しています。

＜この項の構成＞

(1)　旧バージョンのインポート/エクスポートコマンドの使用可否（ucnp.base.server.command.legacy）

(2)　システム全体のJP1資源グループ名（ucnp.base.server.jp1auth.system.resource.group）

(3)　JP1/Baseの論理ホスト名（ucnp.base.server.jp1auth.virtual.hostname）

(4)　トレースファイルの出力先ディレクトリの絶対パス（ucnp.base.server.trace.path）

(5)　トレースファイルのファイルサイズの上限値（ucnp.base.server.trace.size）

(6)　トレースファイルの最大面数（ucnp.base.server.trace.backup.number）

(7)　リクエスト発信間隔（ucnp.base.server.keepsession.interval）

(8)　Webブラウザのウィンドウサイズ変更時，およびメニュー領域の折りたたみ時に幅を変更する領域（ucnp.base.client.frame.resize.target）

(9)　メニュー領域の幅（ucnp.base.client.menu.frame.width）

(10)　業務フロー領域の幅（ucnp.base.client.flow.frame.width）

(11)　ガイド領域の幅（ucnp.base.client.guide.frame.width）

(12)　業務フロー領域とガイド領域の幅の最大値（ucnp.base.client.editingarea.width）

(13)　業務フロー領域とガイド領域の高さの最大値（ucnp.base.client.editingarea.height）

(14)　ヘッダ領域の［ログアウト］ボタンの表示有無（ucnp.base.server.logoutbutton.display）

(15)　ヘッダ領域の［閉じる］ボタンの表示有無（ucnp.base.server.close.button.setting）

(16)　ヘッダ領域の［印刷］メニューの表示有無（ucnp.base.server.print.link.display）

(17)　ヘッダ領域のロゴ画像のパス（ucnp.base.server.custom.head.logo）

(18)　ログイン画面のメイン画像のパス（ucnp.base.server.custom.login.main）

(19)　ログイン画面の背景画像のパス（ucnp.base.server.custom.login.background）

(20)　Webブラウザのタイトルバーまたはタブ名の文字列（ucnp.base.server.custom.browser.title）

(21)　HTMLマニュアルのパス（ucnp.base.server.custom.help）

(22)　検索機能の使用有無（ucnp.base.server.search.enable）

(23)　アクセス権限の使用有無（ucnp.base.server.search.accesscontrol.enable）

(24)　画面の遷移または画面を閉じるときの確認ダイアログの表示有無（ucnp.base.client.confirm.page.unload.enable）

(25)　メニュー領域のグループ表示有無（ucnp.base.client.menu.group.enable）

(26)　デフォルトのグループ名（ucnp.base.client.menu.group.default）

(27)　業務実行画面のメニュー領域の表示有無（ucnp.base.client.menu.frame.visible）

(28)　業務実行画面の業務フロー領域の表示有無（ucnp.base.client.flow.frame.visible）

(29)　カスタマイズしたメニューのHTMLファイルまたはJSPファイルの相対パス（ucnp.base.server.custom.menu）

(30)　HTMLパーツで使用するCSSファイルのパス（ucnp.base.server.htmlpart.css）

(31)　業務実行画面のターミナルノードの表示有無（ucnp.base.client.terminal.display）

(32)　業務フローの直接遷移の可否（ucnp.base.client.directjump.enable）

(33)　業務実行画面に表示する選択状態のプロセスノードの色（ucnp.base.client.currentnode.color）

(34)　非選択状態／直接遷移可能状態のプロセスノードの色（ucnp.base.client.node.color）

(35)　直接遷移できるプロセスノードのデザイン（ucnp.base.client.directjump.design）

(36)　プロセスノードに表示するチェックマークの位置（ucnp.base.client.node.checkmark.position）

(37)　業務フロー領域の関連線の色（ucnp.base.client.flow.connector.color）

(38)　業務フロー領域の自動スクロール可否（ucnp.base.client.autoscroll）

(39)　業務実行画面で［完了］ボタンをクリックしたときのWebブラウザ動作（ucnp.base.client.complete.button.window.close）

(40)　入力情報の破棄確認ダイアログの表示有無（ucnp.base.client.viewer.confirm.discardinput.enable）

(41)　中断再開プラグインの使用有無（ucnp.base.client.suspend.enable）

(42)　業務再開の確認ダイアログの表示有無（ucnp.base.client.suspend.confirm.load.enable）

(43)　業務実行画面でのエラー個所の強調表示の有無（ucnp.base.client.erroritem.emphasis.regexp.enable）

(44)　エラーのパーツを強調する枠の色（ucnp.base.client.erroritem.emphasis.border.color）

(45)　操作ログ機能の使用有無（ucnp.base.client.operationlog.enable）

(46)　操作ログの出力先（ucnp.base.server.operationlog.path）

(47)　操作ログの最大面数（ucnp.base.server.operationlog.backup.number）

(48)　操作ログのファイルサイズの上限値（ucnp.base.server.operationlog.size）

(49)　操作ログの出力フォーマット（ucnp.base.server.operationlog.format）

(50)　操作ログに出力される日時の表示形式（ucnp.base.server.operationlog.dateformat）

(51)　操作ログの文字コード（ucnp.base.server.operationlog.encoding）

(52)　監査ログの使用有無（ucnp.base.client.auditlog.enable）

(53)　監査ログの出力先（ucnp.base.server.auditlog.path）

(54)　監査ログの最大面数（ucnp.base.server.auditlog.backup.number）

(55)　監査ログのファイルサイズの上限値（ucnp.base.server.auditlog.size）

(56)　連携先のJP1/IM-SSのホスト名（ucnp.base.client.jp1imss.hostname）

(57)　連携先のJP1/IM-SSのポート番号（ucnp.base.client.jp1imss.portnum）

(58)　連携先のJP1/AOのホスト名（ucnp.base.client.jp1ao.hostname）

(59)　連携先のJP1/AOのポート番号（ucnp.base.client.jp1ao.portnum）

(60)　パスワードファイルの配置先（ucnp.base.client.jp1ao.submittask.passwordfile.path）

(61)　JP1イベント関連づけファイルの使用可否（ucnp.base.client.jp1ev.association.enable）

(62)　ヘッダ領域の［URL取得］メニューの表示有無（ucnp.base.server.geturl.link.display）

(63)　業務実行画面の［戻る］ボタンの幅（ucnp.base.client.back.button.width）

(64)　業務実行画面の［次へ］ボタンの幅（ucnp.base.client.next.button.width）

(65)　業務実行画面の［完了］ボタンの幅（ucnp.base.client.complete.button.width）

(66)　業務実行画面で分岐合流ノードを経由して次のノードへ遷移するためのボタンの幅（ucnp.base.client.branch.button.width）

(67)　アクセス権限の設定対象の指定（ucnp.base.server.acl.group.type）

(68)　一意の業務コンテンツ名称の指定可否（ucnp.base.client.contentsname.uniquecheck.enable）

(69)　業務編集画面のグリッド間隔（ucnp.base.client.grid.size）

(70)　［元に戻す］ボタンの対象操作履歴の最大保持数（ucnp.base.client.undo.max.count）

(71)　静的ファイルの格納ディレクトリ（ucnp.base.server.cosminexus.httpsd.documentroot.path）

(72)　［ファイル管理／登録］メニューの表示有無（ucnp.base.server.fileupload.link.display）

(73)　ドロップダウンの選択項目を一括設定するためのCSVファイルの格納ディレクトリの絶対パス（ucnp.base.server.dropdown.csv.dir）

(74)　［Plugins］パレットに表示するアイコン（ucnp.base.client.editor.jp1plugin.toolpalette.display）

(1)　旧バージョンのインポート/エクスポートコマンドの使用可否（ucnp.base.server.command.legacy）

旧バージョンのnpimportコマンドおよびnpexportコマンドの使用可否を指定します。

指定できる値：

true：旧バージョンのコマンドを使用できる

false：旧バージョンのコマンドは使用できない

デフォルト値：false

なお，バ－ジョン09-00以前のnpimportコマンド，およびnpexportコマンドをバッチファイルなどで利用している場合は，次の表に示す変更点を確認し，状況に応じてプロパティの値を「true」に変更する必要があります。

表7-5　npimportコマンド，およびnpexportコマンドの変更点

変更点 | バージョン09-00以前 | バージョン09-50以降
npexportコマンドの形式 | npexport△[-c△エクスポートしたい業務コンテンツID]△[-l△エクスポート一覧ファイルのパス]△エクスポート先のファイルのパス | npexport△[-c△エクスポートしたい業務コンテンツID｜-i△コンテンツID一覧ファイルのパス]△[-x]△[-l△エクスポート一覧ファイルのパス]△エクスポート先のファイルのパス
npexportコマンドの-cオプション指定時の動作 | 指定した業務コンテンツIDに対応する業務コンテンツの情報を出力します。 | 指定した業務コンテンツIDに対応する業務コンテンツの情報，およびその業務コンテンツに設定されているアクセス権グループの情報を出力します。
npimportコマンド，およびnpexportコマンドの-lオプションで出力するリストファイルのフォーマット | アクセス権グループの情報を出力しません。 | アクセス権グループの情報を出力します。

なお，JP1/Baseによるユーザ認証を利用する場合は，このプロパティの設定値にかかわらず，常に「false」が指定されたときの動作になります。

(2)　システム全体のJP1資源グループ名（ucnp.base.server.jp1auth.system.resource.group）

ナビゲーション プラットフォームのシステム全体のJP1資源グループの名称を指定します。

このプロパティはucnp.setup.server.ldap.directory.kindプロパティに「JP1Auth」を指定したときだけ有効です。

編集環境と実行環境を分離したシステムで，両方の環境が同じ認証サーバを利用する場合などに，この設定値をユニークにしておくと，実行環境のすべての業務コンテンツにだけアクセスできるユーザを設定できます。

JP1資源グループの詳細は，「4.3.1　ナビゲーション プラットフォームで使用できるJP1資源グループ」を参照してください。

指定できる値：

半角英数字と_（半角アンダースコア）で構成されている64文字以内の文字列

デフォルト値：UCNP

(3)　JP1/Baseの論理ホスト名（ucnp.base.server.jp1auth.virtual.hostname）

JP1/Baseの論理ホスト名を指定するためのプロパティです。

このプロパティはucnp.setup.server.ldap.directory.kindプロパティに「JP1Auth」を指定したときだけ有効です。

セットアップ時に，ucnp.setup.server.jp1auth.virtual.hostnameプロパティを指定した場合，セットアップ完了時にucnp.setup.server.jp1auth.virtual.hostnameプロパティで指定した値がこのプロパティの値として指定されます。セットアップ完了後にJP1/Baseの論理ホスト名を変更したい場合は，このプロパティの値を設定してください。

ucnp.setup.server.ldap.directory.kindプロパティの詳細は，「7.3.3(1)　ユーザ認証の種別（ucnp.setup.server.ldap.directory.kind）」を参照してください。

デフォルト値：JP1_DEFAULT

(4)　トレースファイルの出力先ディレクトリの絶対パス（ucnp.base.server.trace.path）

トレースファイルの出力先ディレクトリを絶対パスで設定します。トレースファイルについては，「9.　トラブルシューティング」を参照してください。

ディレクトリ名には，次に示すWindowsの予約デバイス名は使用できません。

Windowsの予約デバイス名

「AUX」，「CON」，「NUL」，「PRN」，「CLOCK$」，「COMn（nは1～9）」，「LPTn（nは1～9）」

デフォルト値：ナビゲーション プラットフォームインストールディレクトリ¥¥logs

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥logs

(5)　トレースファイルのファイルサイズの上限値（ucnp.base.server.trace.size）

トレースファイルのファイルサイズの上限値を設定します。

トレースファイルについては，「9.　トラブルシューティング」を参照してください。

指定できる値：4～2097151の整数値（単位：KB）

デフォルト値：32768

(6)　トレースファイルの最大面数（ucnp.base.server.trace.backup.number）

トレースファイルの最大面数を設定します。

トレースファイルについては，「9.　トラブルシューティング」を参照してください。

指定できる値：1～16の整数値

デフォルト値：16

(7)　リクエスト発信間隔（ucnp.base.server.keepsession.interval）

セッションを維持するために，リクエストを定期的に発信するリクエスト発信の間隔を指定します。

0を指定すると，セッション維持のためのリクエストは発信されません。

指定できる値：0または60～3600（単位：秒）

デフォルト値：240（単位：秒）

補足事項

セッションを維持するためのリクエスト送信は，ナビゲーション プラットフォームの画面でだけ有効です。ユーザが開発したカスタム画面（検索機能用の画面など）では，使用できません。

(8)　Webブラウザのウィンドウサイズ変更時，およびメニュー領域の折りたたみ時に幅を変更する領域（ucnp.base.client.frame.resize.target）

Webブラウザのウィンドウサイズ変更時，およびメニュー領域の折りたたみ時に幅を変更する領域を指定します。

指定できる値：

flow：業務フロー領域の幅を変更する

guide：ガイド領域の幅を変更する

デフォルト値：guide

補足事項

ucnp.base.client.flow.frame.visibleプロパティに「false」が指定されている場合，このプロパティの指定内容は業務編集画面に対してだけ有効です。この場合にプロパティに「flow」を指定しても，業務実行画面には業務フロー領域が表示されないため，ウィンドウサイズ変更時にはガイド領域の幅が変更されます。

(9)　メニュー領域の幅（ucnp.base.client.menu.frame.width）

折りたたんでいない状態のメニュー領域の幅の初期値をピクセル単位で指定します。

なお，このプロパティに大きな値を指定すると，業務フロー領域またはガイド領域の幅の初期値が0（ピクセル）となり，画面を起動したときに内容が表示されないことがあるので注意してください。

指定できる値：190～600（単位：ピクセル）

デフォルト値：250（単位：ピクセル）

補足事項

ucnp.base.client.menu.frame.visibleプロパティに「false」が指定されている場合，このプロパティの指定内容は業務編集画面に対してだけ有効です。

(10)　業務フロー領域の幅（ucnp.base.client.flow.frame.width）

業務フロー領域の幅の初期値をピクセル単位で指定します。

このプロパティは，ucnp.base.client.frame.resize.targetプロパティに「guide」を指定した場合だけ有効になります。ucnp.base.client.frame.resize.targetプロパティに「flow」を指定した場合，業務フロー領域の幅の初期値は，Webブラウザのウィンドウの幅，メニュー領域およびガイド領域の幅から自動計算され，このプロパティで指定された値は無視されます。

なお，このプロパティに大きな値を指定すると，ガイド領域の幅の初期値が0（ピクセル）となり，画面を起動したときに内容が表示されないことがあるので注意してください。

指定できる値：100～4000（単位：ピクセル）

デフォルト値：450（単位：ピクセル）

補足事項

ucnp.base.client.flow.frame.visibleプロパティに「false」が指定されている場合，このプロパティの指定内容は業務編集画面に対してだけ有効です。

(11)　ガイド領域の幅（ucnp.base.client.guide.frame.width）

ガイド領域の幅の初期値をピクセル単位で指定します。

このプロパティは，ucnp.base.client.frame.resize.targetプロパティに「flow」を指定した場合だけ有効になります。ucnp.base.client.frame.resize.targetプロパティに「guide」を指定した場合，ガイド領域の幅の初期値は，Webブラウザのウィンドウの幅，メニュー領域および業務フロー領域の幅から自動計算され，このプロパティで指定した値は無視されます。

なお，このプロパティに大きな値を指定すると，業務フロー領域の幅の初期値が0（ピクセル）となり，画面を起動したときに内容が表示されないことがあるので注意してください。

指定できる値：100～4000（単位：ピクセル）

デフォルト値：540（単位：ピクセル）

補足事項

ucnp.base.client.flow.frame.visibleプロパティに「false」が指定されている場合，このプロパティの指定内容は業務編集画面に対してだけ有効です。

(12)　業務フロー領域とガイド領域の幅の最大値（ucnp.base.client.editingarea.width）

業務フロー領域とガイド領域の幅の最大値をピクセル単位で指定します。横に大きい業務コンテンツを作成する場合に，このプロパティの値を変更してください。

このプロパティで指定した値は業務フロー領域とガイド領域の両方に適用されます。各領域に対して，異なる値を設定することはできません。

指定できる値：1500～10000（単位：ピクセル）

デフォルト値：1500（単位：ピクセル）

補足事項

業務実行画面の業務フロー領域とガイド領域の幅は，このプロパティの値とパーツの配置によって変わります。

このプロパティの値を小さくする場合は，変更後もすべてのパーツが業務フロー／ガイド領域内に収まることを確認してください。値の変更によって，既存のパーツが業務フロー／ガイド領域の外に配置された状態となった場合，そのパーツは画面に表示されないため，編集できなくなります。

(13)　業務フロー領域とガイド領域の高さの最大値（ucnp.base.client.editingarea.height）

業務フロー領域とガイド領域の高さの最大値をピクセル単位で指定します。縦に大きい業務コンテンツを作成する場合に，このプロパティの値を変更してください。

このプロパティで指定した値は業務フロー領域とガイド領域の両方に適用されます。各領域に対して，異なる値を設定することはできません。

指定できる値：1000～10000（単位：ピクセル）

デフォルト値：1500（単位：ピクセル）

補足事項

業務実行画面の業務フロー領域とガイド領域の高さは，このプロパティの値とパーツの配置によって変わります。

このプロパティの値を小さくする場合は，変更後もすべてのパーツが業務フロー／ガイド領域内に収まることを確認してください。値の変更によって，既存のパーツが業務フロー／ガイド領域の外に配置された状態となった場合，そのパーツは画面に表示されないため，編集できなくなります。

(14)　ヘッダ領域の［ログアウト］ボタンの表示有無（ucnp.base.server.logoutbutton.display）

ヘッダ領域の［ログアウト］ボタンの表示有無を設定します。［ログアウト］ボタンを持つPortal Frameworkテンプレートを組み込む場合に，［ログアウト］ボタンを非表示にすることで，［ログアウト］ボタンが二つ表示されることを防げます。

指定できる値：

true：［ログアウト］ボタンを表示する

false：［ログアウト］ボタンを表示しない

デフォルト値：true

補足事項

業務実行画面にメニュー領域が表示されていない状態で［ログアウト］ボタンを使用すると，再度ログインしたときに利用者が業務コンテンツを選択できません。そのため，ucnp.base.client.menu.frame.visibleプロパティに「false」を指定した場合，このプロパティにも「false」を指定することを推奨します。

ナビゲーション プラットフォームにアクセスするときのURLにucnpCloseBtnパラメタが指定された場合は，ucnpCloseBtnパラメタの指定値が優先されます。ucnpCloseBtnパラメタを含むURLについては，「2.1.4　基本URLに指定できるパラメタ」を参照してください。

ucnp.base.client.confirm.page.unload.enableプロパティに「true」が指定されている場合に，このプロパティを変更するときには，ユーザメッセージプロパティファイル（ucnp_message_user.properties）のKDCZ00146-Wの内容についても見直してください。詳細については，「7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定」を参照してください。

(15)　ヘッダ領域の［閉じる］ボタンの表示有無（ucnp.base.server.close.button.setting）

ヘッダ領域に［ログアウト］ボタンを表示しない設定の場合に，［閉じる］ボタンの表示有無を設定します。

指定できる値：

none：［閉じる］ボタンを表示しない

close_only：［閉じる］ボタンを表示する
クリックすると，ログアウトしないで（セッションを無効にしないで）Webブラウザを閉じます。

logout_close：［閉じる］ボタン
クリックすると，ログアウトして（セッションを無効にして）Webブラウザを閉じます。

デフォルト値：none

補足事項

このプロパティはucnp.base.server.logoutbutton.displayプロパティに「false」を指定した場合だけ有効となります。

ナビゲーション プラットフォームにアクセスするときのURLにucnpCloseBtnパラメタが指定された場合は，ucnpCloseBtnパラメタの指定値が優先されます。ucnpCloseBtnパラメタを含むURLについては，「2.1.4　基本URLに指定できるパラメタ」を参照してください。

ucnp.base.client.confirm.page.unload.enableプロパティに「true」が指定されている場合に，このプロパティを変更するときには，ユーザメッセージプロパティファイル（ucnp_message_user.properties）のKDCZ00146-Wの内容についても見直してください。詳細については，「7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定」を参照してください。

(16)　ヘッダ領域の［印刷］メニューの表示有無（ucnp.base.server.print.link.display）

業務編集画面および業務実行画面でのヘッダ領域の［印刷］メニューの表示有無を設定します。

指定できる値：

none：［印刷］メニューを表示しない

all：業務編集画面と業務実行画面の両方で［印刷］メニューを表示する

editor：業務編集画面だけ［印刷］メニューを表示する

viewer：業務実行画面だけ［印刷］メニューを表示する

デフォルト値：all

注意事項

iPad向けの業務コンテンツを公開する実行環境では，このプロパティは使用できません。必ず「none」を指定してください。

(17)　ヘッダ領域のロゴ画像のパス（ucnp.base.server.custom.head.logo）

ヘッダ領域のロゴ画像を変更する場合，画像のパスを指定します。Webブラウザに表示できる形式のファイルで，高さ30×幅290ピクセルの画像を指定してください。このプロパティを指定しない場合，ヘッダ領域のロゴ画像にはシステム標準の画像が表示されます。

システム標準のロゴ画像は次のとおりです。

図7-1　ヘッダ領域のロゴ画像

指定できるパスの形式

指定できるパスの形式を次に示します。使用するファイルの格納先が，ナビゲーション プラットフォームのWebサーバか，それ以外のWebサーバかによって，指定するパスの形式が異なります。

ナビゲーション プラットフォームのWebサーバに格納したファイルを指定する場合

Webサーバのコンテンツ格納ディレクトリ（デフォルトは「Cosminexusインストールディレクトリ¥httpsd¥htdocs」）からの相対パスを指定します。

デフォルトのWebサーバのコンテンツ格納ディレクトリ下にimagesフォルダを作成し，imagesフォルダに格納したucnp.gifを指定する場合の例を次に示します。

/images/ucnp.gif

ナビゲーション プラットフォーム以外のWebサーバに格納したファイルを指定する場合

「プロトコル://ホスト名:ポート番号/ファイルパス」の形式で指定します。

　プロトコル：httpまたはhttps

　ホスト名：Webサーバのホスト名またはIPアドレス

　ポート番号：Webサーバのポート番号

　ファイルパス：Webサーバに格納されたファイルのパス

プロトコルがhttp，ホスト名がhost1，ポート番号が55555のWebサーバのimagesフォルダにある，image1.gifというファイルを指定する場合のパスを次に示します。

http://host1:55555/images/image1.gif

デフォルト値：なし

ファイル記載値：/custom/images/head_logo.gif

補足事項

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(18)　ログイン画面のメイン画像のパス（ucnp.base.server.custom.login.main）

ログイン画面のメイン画像を変更する場合，画像のパスを指定します。Webブラウザで表示できる形式のファイルで，高さ200×幅500ピクセルの画像を指定してください。このプロパティを指定しない場合，ログイン画面のメイン画像にはシステム標準の画像が表示されます。

システム標準のメイン画像は次のとおりです。

図7-2　ログイン画面のメイン画像

指定できるパスの形式

指定できるパスの形式を次に示します。使用するファイルの格納先が，ナビゲーション プラットフォームのWebサーバか，それ以外のWebサーバかによって，指定するパスの形式が異なります。

ナビゲーション プラットフォームのWebサーバに格納したファイルを指定する場合

Webサーバのコンテンツ格納ディレクトリ（デフォルトは「Cosminexusインストールディレクトリ¥httpsd¥htdocs」）からの相対パスを指定します。

デフォルトのWebサーバのコンテンツ格納ディレクトリ下にimagesフォルダを作成し，imagesフォルダに格納したucnp.pngを指定する場合の例を次に示します。

/images/ucnp.png

ナビゲーション プラットフォーム以外のWebサーバに格納したファイルを指定する場合

「プロトコル://ホスト名:ポート番号/ファイルパス」の形式で指定します。

　プロトコル：httpまたはhttps

　ホスト名：Webサーバのホスト名またはIPアドレス

　ポート番号：Webサーバのポート番号

　ファイルパス：Webサーバに格納されたファイルのパス

プロトコルがhttp，ホスト名がhost1，ポート番号が55555のWebサーバのimagesフォルダにある，image1.pngというファイルを指定する場合のパスを次に示します。

http://host1:55555/images/image1.png

指定例

画像ファイルを「Webサーバのコンテンツ格納ディレクトリ¥custom¥images¥login.png」に配置した場合，このプロパティには次のどれかを指定します。

http://ホスト名:ポート番号/custom/images/login.png

https://ホスト名:ポート番号/custom/images/login.png

/custom/images/login.png

デフォルト値：なし

ファイル記載値：/custom/images/login.png

補足事項

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(19)　ログイン画面の背景画像のパス（ucnp.base.server.custom.login.background）

ログイン画面の背景画像を変更する場合，画像のパスを指定します。このプロパティを指定しない場合，ログイン画面の背景画像にはシステム標準の画像が表示されます。

システム標準の背景画像は次のとおりです。

図7-3　ログイン画面の背景画像

指定できるパスの形式

指定できるパスの形式を次に示します。使用するファイルの格納先が，ナビゲーション プラットフォームのWebサーバか，それ以外のWebサーバかによって，指定するパスの形式が異なります。

ナビゲーション プラットフォームのWebサーバに格納したファイルを指定する場合

Webサーバのコンテンツ格納ディレクトリ（デフォルトは「Cosminexusインストールディレクトリ¥httpsd¥htdocs」）からの相対パスを指定します。

デフォルトのWebサーバのコンテンツ格納ディレクトリ下にimagesフォルダを作成し，imagesフォルダに格納したucnp.gifを指定する場合の例を次に示します。

/images/ucnp.gif

ナビゲーション プラットフォーム以外のWebサーバに格納したファイルを指定する場合

「プロトコル://ホスト名:ポート番号/ファイルパス」の形式で指定します。

　プロトコル：httpまたはhttps

　ホスト名：Webサーバのホスト名またはIPアドレス

　ポート番号：Webサーバのポート番号

　ファイルパス：Webサーバに格納されたファイルのパス

プロトコルがhttp，ホスト名がhost1，ポート番号が55555のWebサーバのimagesフォルダにある，image1.gifというファイルを指定する場合のパスを次に示します。

http://host1:55555/images/image1.gif

デフォルト値：なし

ファイル記載値：/custom/images/background.gif

補足事項

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(20)　Webブラウザのタイトルバーまたはタブ名の文字列（ucnp.base.server.custom.browser.title）

Webブラウザのタイトルバーまたはタブ名に表示される文字列を指定します。文字列は引用符（"）で囲む必要はありません。このプロパティの値が空文字の場合，Webブラウザのタイトルバーまたはタブ名にはURLが表示されます。

デフォルトのタイトルバーまたはタブ名の文字列は次のとおりです。

図7-4　Webブラウザのタイトルバーまたはタブ名の文字列

デフォルト値：uCosminexus Navigation Platform

(21)　HTMLマニュアルのパス（ucnp.base.server.custom.help）

画面にHTMLマニュアルを登録したい場合，表示するHTMLマニュアルのパスを指定します。パスを指定すると画面に［ヘルプ］メニューが表示され，そのメニューをクリックすると別ウィンドウでHTMLマニュアルが参照できるようになります。

HTMLマニュアルの登録画面は次のとおりです。

図7-5　ヘッダ領域へのHTMLマニュアルの登録

指定できるパスの形式

HTMLマニュアルの格納先が，ナビゲーション プラットフォームのWebサーバか，それ以外のWebサーバかによって，指定するパスの形式が異なります。

ナビゲーション プラットフォームのWebサーバに格納したHTMLマニュアルを指定する場合

Webサーバのコンテンツ格納ディレクトリ（デフォルトは「Cosminexusインストールディレクトリ¥httpsd¥htdocs」）からの相対パスを指定します。

デフォルトのWebサーバのコンテンツ格納ディレクトリ下にhelpフォルダを作成し，helpフォルダに格納したindex.htmlというファイルを指定する場合の例を次に示します。

/help/index.html

ナビゲーション プラットフォーム以外のWebサーバに格納したHTMLマニュアルを指定する場合

「プロトコル://ホスト名:ポート番号/ファイルパス」の形式で指定します。

　プロトコル：httpまたはhttps

　ホスト名：Webサーバのホスト名またはIPアドレス

　ポート番号：Webサーバのポート番号

　ファイルパス：Webサーバに格納されたファイルのパス

プロトコルがhttp，ホスト名がhost1，ポート番号が55555のWebサーバのhelpフォルダにある，index.htmlというファイルを指定する場合のパスを次に示します。

http://host1:55555/help/index.html

デフォルト値：なし

ファイル記載値：http://localhost/custom/help/index.html

補足事項

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(22)　検索機能の使用有無（ucnp.base.server.search.enable）

検索機能を使用するかどうかを指定します。

検索機能を使用するときは，検索機能をセットアップして，このプロパティに「true」を設定してください。必要な手順については，「4.8　検索機能を使用するための追加セットアップ」を参照してください。

なお，このプロパティで「false」を指定した場合，検索機能をセットアップしていても検索機能は使用できません。

指定できる値：

true：検索機能を使用する

false：検索機能を使用しない

デフォルト値：false

(23)　アクセス権限の使用有無（ucnp.base.server.search.accesscontrol.enable）

業務コンテンツを検索する場合に，参照のアクセス権限がある業務コンテンツだけを対象とするかどうかを指定します。

指定できる値：

true：参照のアクセス権限がある業務コンテンツだけを検索の対象とする

false：参照のアクセス権限の有無にかかわらず，すべての業務コンテンツを検索の対象とする

デフォルトの標準アクセス権限を変更したり，新しいアクセス権限を追加したりしている場合は，「true」を指定してください。

なお，デフォルトの標準アクセス権限だけを使用している場合は，このプロパティに「false」を指定した方が，検索結果が早く表示されるようになります。ただし，参照のアクセス権限がない業務コンテンツも検索結果に表示されるため，運用には注意が必要です。

デフォルト値：false

(24)　画面の遷移または画面を閉じるときの確認ダイアログの表示有無（ucnp.base.client.confirm.page.unload.enable）

業務実行画面または業務編集画面で，Webブラウザの［×］ボタンで画面を閉じようとしたとき，またはほかのページへ遷移しようとしたとき，メッセージ（KDCZ00146-W）を表示するどうか指定します。

指定できる値：

true：メッセージ（KDCZ00146-W）を表示する

false：メッセージ（KDCZ00146-W）を表示しない

デフォルト値：true

注意事項

iPad向けの業務コンテンツを公開する実行環境では，このプロパティは使用できません。必ず「false」を指定してください。

補足事項

このプロパティに「false」を指定して，メッセージを表示しない設定にする場合，運用時には次の点に注意してください。

利用者がWebブラウザのパーツにフォーカスが当たっていない状態で＜BackSpace＞キーを押したとき，前に表示していたページに遷移してしまうことで，入力中のデータが消えてしまうおそれがあります。

ナビゲーション プラットフォームの画面を閉じるときは，［ログアウト］ボタンまたは［閉じる］ボタンをクリックしてください。

(25)　メニュー領域のグループ表示有無（ucnp.base.client.menu.group.enable）

業務実行画面または業務編集画面を表示するとき，業務コンテンツをグループにまとめて表示するかどうかを指定します。このプロパティは，通常はtrueを指定してください。npexportコマンドまたはnpimportコマンドの一覧ファイルの形式を，09-00より前と同じにしたい場合にfalseを指定してください。

指定できる値：

true：業務コンテンツをグループにまとめて表示する

false：業務コンテンツをグループにまとめないで表示する

デフォルト値：true

補足事項

業務コンテンツをグループに所属させたあとで，このプロパティに「false」を指定した場合，グループ名は画面に表示されなくなりますが，グループの値そのものは残ります。その後，このプロパティを「true」に変更すると，所属させたグループ名が再度画面に表示されます。

プロパティに「true」を指定した場合

業務編集画面で新規作成または複製した業務コンテンツは，ucnp.base.client.menu.group.defaultプロパティで指定したグループに所属します。

インポートまたはエクスポート時に出力できる一覧ファイルにグループが出力されます。

グループ名のない業務コンテンツと編集中グループ（「!」で始まるグループ名のグループ）だけが存在する場合，業務実行画面ではグループにまとめて表示されません。

プロパティに「false」を指定した場合

新規作成または複製した業務コンテンツの所属先は，名称のないグループになります。ucnp.base.client.menu.group.defaultプロパティでデフォルトのグループ名を指定している場合でも無視されます。

インポートまたはエクスポート時に出力できる一覧ファイルにグループ名は出力されません。

編集中グループの業務コンテンツも業務実行画面に表示されます。

(26)　デフォルトのグループ名（ucnp.base.client.menu.group.default）

業務編集画面で新規作成または複製した業務コンテンツが所属する，デフォルトのグループ名を指定します。

このプロパティを省略した場合，新規作成，または複製した業務コンテンツは，「!editing」グループに所属します。空文字を指定した場合，新規作成または複製した業務コンテンツのグループは，次のようになります。

業務コンテンツを新規作成した場合：名称のないグループ

業務コンテンツを複製した場合：複製元の業務コンテンツのグループ

指定できる値：128文字以内の文字列

デフォルト値：!editing

補足事項

このプロパティで編集中グループ（グループ名の先頭に「!」を指定する）を指定すると，新規作成または複製した業務コンテンツが，業務実行画面にデフォルトで表示されないようになります。

このプロパティで指定したグループ名は，ucnp.base.client.menu.group.enableプロパティに「true」が指定されている場合だけ有効になります。

値にマルチバイト文字を指定する場合は，native2asciiコマンドなどを使用してUnicodeに変換してください。

(27)　業務実行画面のメニュー領域の表示有無（ucnp.base.client.menu.frame.visible）

業務実行画面にメニュー領域を表示するかどうかを指定します。メニュー領域を非表示にすると，メニュー領域折りたたみボタンも非表示になります。

このプロパティで「false」を設定した場合，業務実行画面の利用者は業務コンテンツIDを指定したURLでログインする必要があります。URLについては，「2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL」を参照してください。

指定できる値：

true：メニュー領域を表示する

false：メニュー領域を表示しない

デフォルト値：true

(28)　業務実行画面の業務フロー領域の表示有無（ucnp.base.client.flow.frame.visible）

業務実行画面に業務フロー領域を表示するかどうかを指定します。業務フロー領域を非表示にすると，業務フロー領域とガイド領域の幅を調節するためのバーも非表示になります。

指定できる値：

true：業務フロー領域を表示する

false：業務フロー領域を表示しない

デフォルト値：true

補足事項

ucnp.base.client.directjump.enableプロパティに「all」を指定した場合，ガイド領域に［戻る］ボタンが表示されないため，前のノードに戻ることができなくなります。

(29)　カスタマイズしたメニューのHTMLファイルまたはJSPファイルの相対パス（ucnp.base.server.custom.menu）

画面のメニュー領域をカスタマイズする場合，表示したいHTMLファイルまたはJSPファイルを相対パスで指定します。このプロパティは，ucnp.base.client.menu.frame.visibleプロパティに「true」を指定した場合だけ有効になります。

メニュー領域のカスタマイズについては，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

ファイルの種別（HTMLファイルまたはJSPファイル）ごとに，設定できるパスの形式を次に示します。

HTMLファイルの場合
/ファイルパス
ファイルパス：Webサーバのコンテンツ格納ディレクトリからの相対パス

JSPファイルの場合
/ucnpBase/ファイルパス
ファイルパス：ポータルプロジェクトのディレクトリからの相対パス。

デフォルト値：なし

ファイル記載値：/ucnpBase/custom/menu/menu.jsp

補足事項

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(30)　HTMLパーツで使用するCSSファイルのパス（ucnp.base.server.htmlpart.css）

HTMLパーツで使用するCSSファイルのパスを指定します。

指定できるパスの形式

指定できるパスの形式を次に示します。使用するファイルの格納先が，ナビゲーション プラットフォームのWebサーバか，それ以外のWebサーバかによって，指定するパスの形式が異なります。

ナビゲーション プラットフォームのWebサーバに格納したファイルを指定する場合

Webサーバのコンテンツ格納ディレクトリ（デフォルトは「Cosminexusインストールディレクトリ¥httpsd¥htdocs」）からの相対パスを指定します。

ナビゲーション プラットフォーム以外のWebサーバに格納したファイルを指定する場合

「プロトコル://ホスト名:ポート番号/ファイルパス」の形式で指定します。

　プロトコル：httpまたはhttps

　ホスト名：Webサーバのホスト名またはIPアドレス

　ポート番号：Webサーバのポート番号

　ファイルパス：Webサーバに格納されたファイルのパス

プロトコルがhttp，ホスト名がhost1，ポート番号が55555のWebサーバのcssフォルダにある，htmlpart.cssというファイルを指定する場合のパスを次に示します。

http://host1:55555/css/htmlpart.css

デフォルト値：なし

ファイル記載値：/css/htmlpart.css

補足事項

CSSファイルが指定したパスに存在しない場合，ユーザ定義のCSSファイルは適用されません。また，Webサーバのアクセスログに「404」が出力されます。

ホスト名以外に「/ucnp」を含むパスは設定できません。設定した場合の動作は保証されません。

URIで使用できない文字をプロパティの値に使用する場合は，必要に応じてURLエンコードした値を設定してください。

(31)　業務実行画面のターミナルノードの表示有無（ucnp.base.client.terminal.display）

業務実行画面にターミナルノードを表示するかどうかを指定します。ucnp.base.client.flow.frame.visibleプロパティに「false」を指定した場合，このプロパティに「true」を指定しても無視されるため，「false」を指定することを推奨します。ucnp.base.client.flow.frame.visibleプロパティに「false」が指定されている場合は，ucnp.base.client.terminal.displayプロパティに「true」を指定するよりも「false」を指定した方が，処理速度が向上します。

指定できる値：

true：ターミナルノードを表示する

false：ターミナルノードを表示しない

デフォルト値：false

(32)　業務フローの直接遷移の可否（ucnp.base.client.directjump.enable）

業務実行画面でプロセスノードをクリックした時，そのプロセスノードへ遷移するかどうかを指定します。また，遷移できる範囲についても選択できます。

ucnp.base.client.flow.frame.visibleプロパティに「false」を指定した場合，このプロパティに「true」または「all」を指定しても無視されるため，「false」を指定することを推奨します。「false」を指定すれば，「true」または「all」を指定するよりも処理速度が向上します。

指定できる値：

true：一度遷移したことがあるプロセスノードにだけ直接遷移する

all：すべてのプロセスノードに直接遷移する

false：直接遷移しない

デフォルト値：true

補足事項

プロパティに「true」を指定した場合

業務フローを戻って別の分岐へ遷移したとき，元の分岐のプロセスノードには遷移できません。

終点のターミナルノードへ遷移すると，すべてのプロセスノードに遷移できなくなります。

［戻る］ボタンを非表示に設定しているプロセスノードへ遷移すると，そのプロセスノードより前のノードには遷移できなくなります。

プロパティに「all」を指定した場合

ガイド領域の［戻る］ボタンが表示されなくなります。

終点のターミナルノードへ遷移しても，すべてのプロセスノードに遷移できます。

ガイド領域のチェックボックスがチェック必須かどうかのチェックが実行されません。

入出力プラグインまたは入力値チェック機能を設定していても実行されません。

中断再開プラグインと併用できません。ucnp.base.client.suspend.enableプロパティに「true」を指定している場合，メッセージ（KDCZ10138-E）が出力され，システムの起動が中止されます。

(33)　業務実行画面に表示する選択状態のプロセスノードの色（ucnp.base.client.currentnode.color）

業務実行画面に表示する選択状態のプロセスノードの色を指定します。どのノードが選択状態かをわかりやすくするために，このプロパティには，ucnp.base.client.node.colorプロパティの値と異なる値を設定することを推奨します。

指定できる値：

orange

pink

green

purple

blue

gray

デフォルト値：orange

(34)　非選択状態／直接遷移可能状態のプロセスノードの色（ucnp.base.client.node.color）

業務実行画面および業務編集画面に表示するプロセスノードの色を指定します。どのノードが選択状態かをわかりやすくするために，このプロパティには，ucnp.base.client.currentnode.colorプロパティの値と異なる値を設定することを推奨します。

指定できる値：

orange

pink

green

purple

blue

gray

デフォルト値：gray

(35)　直接遷移できるプロセスノードのデザイン（ucnp.base.client.directjump.design）

直接遷移できるプロセスノードのデザインを指定します。

指定できる値：

gradation：プロセスノードの色をグラデーションありにする

flat：プロセスノードの色をグラデーションなしにする

デフォルト値：gradation

補足事項

画像を配置したプロセスノードは，このプロパティの指定値に関係なく，次のように「flat」のデザインになります。

業務フローの中に画像を配置したプロセスノードと画像を配置しないプロセスノードが混在する場合，全体のデザインを統一したいときは，「flat」を指定してください。

業務フローの中に画像を配置したプロセスノードと画像を配置しないプロセスノードが混在しない場合でも，このプロパティは有効です。

このプロパティは，ucnp.base.client.directjump.enableプロパティに「true」を指定した場合だけ有効になります。

(36)　プロセスノードに表示するチェックマークの位置（ucnp.base.client.node.checkmark.position）

処理が終了したプロセスノードに表示するチェックマークの位置を指定します。

指定できる値：

left：プロセスノードの左上に表示する

right：プロセスノードの右上に表示する

off：チェックマークは表示しない

デフォルト値：left

補足事項

ucnp.base.client.directjump.enableプロパティに「all」を指定していると，このプロパティに指定した値にかかわらずチェックマークは表示されません。チェックマークを表示したい場合は，ucnp.base.client.directjump.enableプロパティに「true」または「false」を指定してください。

(37)　業務フロー領域の関連線の色（ucnp.base.client.flow.connector.color）

業務フロー領域の関連線の色を指定します。

指定できる値：

gray：[図データ]

black：[図データ]

orange：[図データ]

pink：[図データ]

green：[図データ]

purple：[図データ]

blue：[図データ]

デフォルト値：gray

補足事項

このプロパティの指定値は，ガイド領域のマッピング線には影響しません。

(38)　業務フロー領域の自動スクロール可否（ucnp.base.client.autoscroll）

業務フロー領域を自動的にスクロールするかどうかを指定します。ucnp.base.client.flow.frame.visibleプロパティに「false」を指定した場合，このプロパティに「true」を指定しても無視されるため，「false」を指定することを推奨します。「false」を指定すれば，「true」を指定するよりも処理速度が向上します。

このプロパティで「true」を設定した場合，業務フロー領域が自動的にスクロールされ，常に現在の工程が表示されるようになります。

指定できる値：

true：自動スクロールをする

false：自動スクロールをしない

デフォルト値：true

(39)　業務実行画面で［完了］ボタンをクリックしたときのWebブラウザ動作（ucnp.base.client.complete.button.window.close）

業務実行画面で［完了］ボタンをクリックしたときにWebブラウザを閉じるかどうかを指定します。

指定できる値：

true：Webブラウザを閉じる

false：Webブラウザを閉じない

デフォルト値：false

補足事項

Webブラウザを閉じるかどうかの確認メッセージは表示されません。

Internet Explorer 7以降の場合，複数のタブを表示していると，［完了］ボタンをクリックした業務実行画面のタブだけが閉じます。

このプロパティで「true」を設定していても，業務実行画面で印刷プレビューを実行すると，Webブラウザが閉じないことがあります。その場合は手動でWebブラウザを閉じる必要があります。

このプロパティで「false」を設定した場合，［完了］ボタンをクリックしたときに表示されるKDCZ10060-Iは，ユーザメッセージプロパティファイル（ucnp_message_user.properties）で任意に設定できます。ユーザメッセージプロパティファイルについては，「7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定」を参照してください。

(40)　入力情報の破棄確認ダイアログの表示有無（ucnp.base.client.viewer.confirm.discardinput.enable）

入力情報を破棄するときの確認ダイアログを表示させるかどうかを指定します。

このプロパティで「true」を設定した場合，業務の実行中にほかの画面に遷移するときに，入力中の情報を破棄するかどうかを確認するダイアログが表示されます。確認ダイアログの表示が不要な場合は，このプロパティを「false」に設定します。

指定できる値：

true：入力情報の破棄確認ダイアログを表示する

false：入力情報の破棄確認ダイアログを表示しない

デフォルト値：true

補足事項

ucnp.base.client.viewer.confirm.discardinput.enableプロパティに「false」を指定すると，終了のターミナルノードの配置は任意になります。

ucnp.base.client.directjump.enableプロパティに「all」が指定されている場合，入力情報の破棄確認ダイアログは表示されません。そのため，このプロパティでの設定は無視されます。

(41)　中断再開プラグインの使用有無（ucnp.base.client.suspend.enable）

中断再開プラグインを使用するかどうかを指定します。

業務実行中に入力中の情報を一時保存し，次回同じ業務を実行する場合に，保存した情報を復元して業務を途中から再開する機能を使用したいときには，このプロパティに「true」を設定してください。

このプロパティが「true」の場合で，ナビゲーション プラットフォームのログイン時に中断再開プラグインが登録されていないときには，メッセージ（KDCZ10082-E）が出力され，システムエラー画面が表示されます。

なお，中断再開プラグインを使用するには，このプロパティの設定以外にも必要な手順があります。必要な手順については，「3.4.3　中断再開プラグインを使用する場合の容量の見積もり」を参照してください。

指定できる値：

true：中断再開プラグインを使用する

false：中断再開プラグインを使用しない

デフォルト値：false

補足事項

このプロパティに「true」を指定し，かつucnp.base.client.directjump.enableプロパティに「all」を指定した場合，メッセージ（KDCZ10138-E）が出力され，システムの起動が中止されます。

(42)　業務再開の確認ダイアログの表示有無（ucnp.base.client.suspend.confirm.load.enable）

業務を再開するときの確認ダイアログを表示させるかどうかを指定します。

このプロパティに「true」を設定した場合，以前実行したときの情報が一時保存されている業務コンテンツを選択すると，保存した情報を復元して業務を途中から再開するかどうかを確認するダイアログが表示されます。この確認ダイアログの表示が不要な場合は，このプロパティを「false」に設定します。業務を再開するときの確認ダイアログが表示されないで業務が再開されます。

ucnp.base.client.suspend.enableプロパティの値が「false」の場合は，このプロパティの値に関係なく，業務コンテンツ選択時に業務再開の確認，および業務の再開は実行されません。

指定できる値：

true：業務実行画面で業務コンテンツを選択した場合，中断情報が存在したときに業務再開確認ダイアログを表示する

false：業務実行画面で業務コンテンツを選択した場合，中断情報が存在したときでも業務再開確認ダイアログを表示させないで，そのまま業務を再開する

デフォルト値：true

(43)　業務実行画面でのエラー個所の強調表示の有無（ucnp.base.client.erroritem.emphasis.regexp.enable）

［属性の設定］画面で設定した入力規則に反する値が業務実行画面で入力された場合に，エラー個所を強調して表示するかどうかを指定します。

なお，このプロパティに「false」を設定していても，入出力プラグインを使用している場合はエラー個所が強調して表示されることがあります。入出力プラグインについては，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

指定できる値：

true：エラー個所を強調して表示する

false：エラー個所を強調して表示しない

デフォルト値：true

(44)　エラーのパーツを強調する枠の色（ucnp.base.client.erroritem.emphasis.border.color）

必須のパーツを入力しないで次の操作をしようとした場合，エラーが発生します。このとき，エラーであるパーツを強調する枠の色を指定します。

指定できる値：

6桁の16進数または英語の色名で指定してください。使用できる文字は，半角英数字および「#」です。

16進数
先頭に必ず「#」を付けてください。「#」の後ろは6桁の16進数を指定します。

英語の色名
スタイルシートで使用できる色名を指定します。

デフォルト値：red

補足事項

入出力プラグインからエラーとなる項目が通知された場合は，ucnp.base.client.erroritem.emphasis.regexp.enableプロパティの値が「false」でも，このプロパティで設定した色でエラーが強調表示されます。

(45)　操作ログ機能の使用有無（ucnp.base.client.operationlog.enable）

操作ログ機能を使用するかどうかを指定します。

指定できる値：

true：操作ログ機能を使用する

false：操作ログ機能を使用しない

デフォルト値：true

ucnp.base.client.operationlog.enableプロパティを指定していない場合，メッセージ（KDCZ10302-E）をトレースファイルに出力し，システムの起動を中止します。

09-00より前からバージョンアップした環境で操作ログを使用する場合に，必要なserver.policyファイルの設定

次の手順でserver.policyファイルを編集してください。

Cosminexus Management Serverを起動します。

Cosminexus Management Serverの運用管理ポータルにログインします。

運用管理ポータルの画面で，［論理サーバの起動／停止］アンカーをクリックします。
論理サーバの起動／停止画面が表示されます。

ツリーから［論理J2EEサーバ］－［J2EEサーバ］－［ナビゲーション プラットフォームのJ2EEサーバ名］をクリックします。
［開始／停止］タブが表示されます。

［停止］ボタンをクリックします。

server.policyファイルを編集します。
server.policyファイルの格納先は「Cosminexusインストールディレクトリ¥CC¥server¥usrconf¥ejb¥J2EEサーバ名¥server.policy」です。

J2EEアプリケーションのコードベース（file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/apps/-）のアクセス権に，次の内容が追加されているかどうか確認します。
permission java.util.logging.LoggingPermission "control";

設定例を次に示します。太字が追加個所です。

//
// Grant permissions to uCosminexus Navigation Platform
// ucnpclasses
//
grant codeBase "file:${ejbserver.http.root}/ejb/${ejbserver.serverName}/apps/-" {
   permission java.io.FilePermission "<<ALL FILES>>", "read, write, delete, execute";
   permission java.lang.RuntimePermission "accessDeclaredMembers";
   permission java.lang.RuntimePermission "getProtectionDomain";
   permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
   permission java.lang.RuntimePermission "getenv.*";
   permission java.util.logging.LoggingPermission "control";
};

手順4.で表示した［開始／停止］タブを再度表示し，［起動］ボタンをクリックします。

(46)　操作ログの出力先（ucnp.base.server.operationlog.path）

操作ログの出力先を絶対パスで指定します。パスの区切り文字には「¥¥」を使用してください。

デフォルト値：ナビゲーション プラットフォームインストールディレクトリ¥¥operationlogs¥¥operation%g.log

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥operationlogs¥¥operation%g.log

補足事項

出力先に，次に示す条件を満たしていない値を指定した場合，動作は保証されません。

プロパティに指定する値では，「%g」以外に「%」を使用しないでください。

「%g」は操作ログファイルの面数を表します。「%g」を指定しなかった場合，「operation.log.0」というように，操作ログファイル名の末尾にピリオドと面数を示す数字が追加されます。
ただし，ucnp.base.server.operationlog.backup.numberプロパティで「1」を指定した場合は，末尾にピリオドと面数を示す数字は追加されません。

出力先として，ナビゲーション プラットフォームインストールディレクトリ以下を指定する場合，「operationlogs」ディレクトリを指定してください。

出力先として，ナビゲーション プラットフォームインストールディレクトリ以外を指定する場合，存在するディレクトリを指定してください。

出力先には，次のファイルやディレクトリが存在しないパスを指定してください。ファイルやディレクトリが操作ログに上書きされるおそれがあります。
「%g」と拡張子を除いた操作ログのファイル名で始まる，操作ログ以外のファイル
「%g」と拡張子を除いた操作ログのファイル名で始まるディレクトリ

操作ログは排他制御を行うプロセスで参照しないでください。参照した場合，操作ログの出力および面数の切り替えができなくなるおそれがあります。

システムの起動時に，操作ログのほかに「操作ログのファイル名.lck」というファイルが作成されますが，システムの停止時にこのファイルは削除されます。

このプロパティを省略した場合，デフォルト値が適用されます。

(47)　操作ログの最大面数（ucnp.base.server.operationlog.backup.number）

操作ログの最大面数を設定します。なお，このプロパティで指定した値から1を引いた数が，操作ログのファイル名に使用される数字の最大値となります。例えば，デフォルトの16の場合，「operation0.log」から「operation15.log」までが操作ログのファイル名として使用され，計16個の操作ログが出力されます。

指定できる値：1～128の整数値

デフォルト値：16

補足事項

操作ログは排他制御を行うプロセスで参照しないでください。参照した場合，操作ログの出力および面数の切り替えができなくなるおそれがあります。

1日に出力したいレコード数や操作ログの保存期間に合わせて，このプロパティの設定値を調整してください。
次のプロパティの値と一緒に調整してください。

操作ログの1レコード当たりのバイト数

ucnp.base.server.operationlog.formatプロパティ

ucnp.base.server.operationlog.dateformatプロパティ

操作ログの最大出力ファイルサイズ

ucnp.base.server.operationlog.sizeプロパティ

(48)　操作ログのファイルサイズの上限値（ucnp.base.server.operationlog.size）

操作ログのファイルサイズの上限値を設定します。

指定できる値：1024～2097151の整数値（単位：KB）

デフォルト値：10240（単位：KB）

(49)　操作ログの出力フォーマット（ucnp.base.server.operationlog.format）

操作ログのフォーマットを指定します。操作ログの出力項目を「{整数値}」の形式で指定し，区切り文字として「¥t」を使用できます。出力項目の詳細については，「5.4.1　操作ログの内容」を参照してください。

操作ログの出力項目と，それに対応する{整数値}を次に示します。

日時：{0}

通算ミリ秒：{1}

セッションID：{2}

ユーザID：{3}

業務コンテンツID：{4}

業務コンテンツ名称：{5}

遷移種別：{6}

遷移元ノードのID：{7}

遷移元ノードの名称：{8}

実際の遷移先ノードのID：{9}

実際の遷移先ノードの名称：{10}

指定した遷移先ノードのID：{11}

指定した遷移先ノードの名称：{12}

エラーフラグ：{13}

ucnpOptionsパラメタ：{14}

デフォルト値：{0}¥t{1}¥t{2}¥t{3}¥t{4}¥t{5}¥t{6}¥t{7}¥t{8}¥t{9}¥t{10}¥t{11}¥t{12}¥t{13}

補足事項

操作ログのフォーマットの指定では，次のルールに従ってください。ルールに従わないフォーマットで指定した場合の動作は保証されません。

「{整数値}」はすべて予約語です。文字列として表示したい場合は，必ずシングル引用符（'）で囲んで指定してください。例えば，操作ログに「{0}」という文字列を出力させたい場合は，「'{0}'」または「'{'0'}'」と指定してください。

文字列として「{」や「}」を指定する場合には，必ずシングル引用符（'）で囲んでください。また，「¥」を出力したい場合は「¥¥」を，「'」を出力したい場合は「''」を指定してください。

半角英数字および半角記号以外の文字を指定する場合，Javaツールのnative2asciiを実行して文字コードを変換してから使用してください。

(50)　操作ログに出力される日時の表示形式（ucnp.base.server.operationlog.dateformat）

操作ログに出力される日時の表示形式を，java.text.SimpleDateFormatクラスのパターンで指定します。java.text.SimpleDateFormatクラスのパターンに従っていない形式で指定した場合，動作は保証されません。

デフォルト値：yyyy/MM/dd HH:mm:ss.SSS

補足事項

操作ログに「¥」を出力したい場合は「¥¥」を，「'」を出力したい場合は「''」を指定してください。

半角英数字以外の文字は，Javaツールのnative2asciiを実行して文字コードを変換してから使用してください。

プロパティに半角数字および半角記号以外の文字を指定する場合，必ずシングル引用符（'）で囲んでください。
現在の日付が2012/02/07の場合の指定例を次に示します。
操作ログに「2012h02m07d」と出力したい場合：yyyy'h'MM'm'dd'd'
操作ログに「2012年02月07日」と出力したい場合：yyyy'¥u5E74'MM'¥u6708'dd'¥u65E5'

(51)　操作ログの文字コード（ucnp.base.server.operationlog.encoding）

操作ログの文字コードを指定します。

ナビゲーション プラットフォームがサポートしている文字コードは「Shift_JIS」と「UTF-8」です。サポートしていない文字コードを指定した場合の動作は保証されません。

デフォルト値：Shift_JIS

補足事項

業務コンテンツ名称，ノード名称，ucnp.base.server.operationlog.formatプロパティまたはucnp.base.server.operationlog.dateformatプロパティで指定したフォーマットなどにShift_JISで文字化けする文字列を含める場合は，UTF-8を設定してください。

すでに操作ログ機能を有効にしている状態で，文字コードを変更する場合，システムが停止している時間帯に操作ログを退避させてから変更してください。操作ログを退避させないで文字コードを変更すると，複数の文字コードが操作ログに含まれてしまうため，文字化けするおそれがあります。

(52)　監査ログの使用有無（ucnp.base.client.auditlog.enable）

監査ログを使用するかどうかを指定します。

指定できる値：

true：監査ログを使用する

false：監査ログを使用しない

デフォルト値：false

(53)　監査ログの出力先（ucnp.base.server.auditlog.path）

監査ログのファイルの絶対パスを指定します。パスの区切り文字には「¥¥」を使用してください。監査ログのファイル名を変更したい場合は，「ucnp_audit」を任意の文字列に変更してください。

デフォルト値：ナビゲーション プラットフォームインストールディレクトリ¥¥auditlog¥¥ucnp_audit

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥auditlog¥¥ucnp_audit

補足事項

監査ログは「ucnp_audit面数.log」の形式で出力されます。

このプロパティを省略した場合は，「ナビゲーション プラットフォームインストールディレクトリ¥¥auditlog¥¥ucnp_audit面数.log」が出力されます。

システムの起動時に，監査ログファイルとは別に「ucnp_audit.lck」というファイルが作成されます。

出力先に，ナビゲーション プラットフォームインストールディレクトリ以下を指定する場合，「auditlog」以外のディレクトリを指定しないでください。指定した場合，動作は保証されません。

出力先に「auditlog」以下のディレクトリを指定した場合は，次のファイルやディレクトリが存在しないパスを指定してください。ファイルやディレクトリが監査ログに上書きされるおそれがあります。「ucnp_audit」を任意の文字列に変更しているときは，変更後のファイル名を指定しないでください。
「ucnp_audit面数.log」から始まる監査ログ以外のファイル
「ucnp_audit面数.log」から始まるディレクトリ

条件を満たしていないファイルパスを指定した場合は，動作は保証されません。また，エラーになったときは，メッセージ（KDCZ10304-E）がトレースファイルに出力され，システムの起動が中止されます。

(54)　監査ログの最大面数（ucnp.base.server.auditlog.backup.number）

監査ログの最大面数を設定します。監査ログのファイル名には，指定した値が最大面数として割り振られます。例えば，デフォルトの「16」の場合，「監査ログのファイル名1.log」から「監査ログのファイル名16.log」がファイル名になります。

指定できる値：1～32の整数値

デフォルト値：16

(55)　監査ログのファイルサイズの上限値（ucnp.base.server.auditlog.size）

監査ログのファイルサイズの上限値を設定します

指定できる値：1024～2097151の整数値（単位：KB）

デフォルト値：10240（単位：KB）

(56)　連携先のJP1/IM-SSのホスト名（ucnp.base.client.jp1imss.hostname）

連携先のJP1/IM-SSのホスト名を指定します。

指定できる値：文字列

デフォルト値：localhost

補足事項

JP1/IM-SS URLプラグインを利用する場合は，JP1/IM-SSが動作する物理ホスト名または論理ホスト名を必ず指定してください。

空文字列は指定できません。

(57)　連携先のJP1/IM-SSのポート番号（ucnp.base.client.jp1imss.portnum）

連携先のJP1/IM-SSのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：24401

補足事項

JP1/IM-SS URL出力プラグインを利用する場合は，このプロパティを必ず指定してください。

(58)　連携先のJP1/AOのホスト名（ucnp.base.client.jp1ao.hostname）

連携先のJP1/AOのホスト名を指定します。

指定できる値：文字列

デフォルト値：localhost

補足事項

次のシステムプラグインを利用する場合は，JP1/AOが動作する物理ホスト名または論理ホスト名を必ず指定してください。
JP1/AO URL出力プラグイン
JP1/AO サービス実行プラグイン

空文字列は指定できません。

(59)　連携先のJP1/AOのポート番号（ucnp.base.client.jp1ao.portnum）

連携先のJP1/AOのポート番号を指定します。

指定できる値：1～65535の整数値

デフォルト値：23015

補足事項

JP1/AO URL出力プラグインを利用する場合は，このプロパティを必ず指定してください。

(60)　パスワードファイルの配置先（ucnp.base.client.jp1ao.submittask.passwordfile.path）

JP1/AOのsubmittaskコマンドで使用するパスワードファイルの配置ディレクトリを指定します。

指定できる値：

Windowsに作成できるパスを指定してください。

ただし，Windowsの予約デバイス名を使用したパスは指定できません。

デフォルト値：C:¥¥ucnpwork

補足事項

配置ディレクトリは，JP1/AOホストの任意のディレクトリを指定してください。

JP1/AOサービス実行プラグインを利用する場合は，このプロパティを必ず指定してください。

ディレクトリ名にWindowsの予約デバイス名を使用するとエラーになります。Windowsの予約デバイス名を次に示します。
「AUX」，「CON」，「NUL」，「PRN」，「CLOCK$」，「COM1」～「COM9」，「LPT1」～「LPT9」

(61)　JP1イベント関連づけファイルの使用可否（ucnp.base.client.jp1ev.association.enable）

JP1/IMまたはJP1/IM-SSから呼び出されたとき，JP1イベント情報と関連づけられた特定の業務コンテンツを開くかどうかを設定します。

JP1イベント情報と業務コンテンツの関連づけについては，「5.10.4　JP1イベント情報と業務コンテンツを関連づける」を参照してください。

指定できる値：

true：JP1イベント関連づけファイルが有効

false：JP1イベント関連づけファイルが無効

デフォルト値：false

(62)　ヘッダ領域の［URL取得］メニューの表示有無（ucnp.base.server.geturl.link.display）

業務実行画面のヘッダ領域に［URL取得］メニューを表示するかどうかを指定します。

指定できる値：

true：［URL取得］メニューを表示する

false：［URL取得］メニューを表示しない

デフォルト値：true

注意事項

iPad向けの業務コンテンツを公開する実行環境では，このプロパティは使用できません。必ず「false」を指定してください。

補足事項

［URL取得］メニューから取得できるURLは，業務コンテンツID以外のパラメタを含みません。業務編集画面を表示するURLや終了ボタンを指定するためのURLは取得できません。ほかのパラメタもURLで使用する運用の場合，このプロパティでは「false」を指定し，［URL取得］メニューを表示しないことを推奨します。

URLの詳細は，「2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL」を参照してください。

(63)　業務実行画面の［戻る］ボタンの幅（ucnp.base.client.back.button.width）

業務実行画面の［戻る］ボタンの幅をピクセル単位で指定します。

指定できる値：30～260（単位：ピクセル）

デフォルト値：100（単位：ピクセル）

補足事項

ucnp.base.client.directjump.enableプロパティに「all」が指定されている場合，［戻る］ボタンは表示されません。そのため，このプロパティの設定は無視されます。

ボタン名はノードの属性の設定内容によって変更できます。ボタン名がこのプロパティで指定した幅よりも長い場合，ボタン名は途中までしか表示されません。

(64)　業務実行画面の［次へ］ボタンの幅（ucnp.base.client.next.button.width）

業務実行画面の［次へ］ボタンの幅をピクセル単位で指定します。

指定できる値：30～260（単位：ピクセル）

デフォルト値：130（単位：ピクセル）

補足事項

ボタン名はノードの属性の設定内容によって変更できます。ボタン名がこのプロパティで指定した幅よりも長い場合，ボタン名は途中までしか表示されません。

(65)　業務実行画面の［完了］ボタンの幅（ucnp.base.client.complete.button.width）

業務実行画面の［完了］ボタンの幅をピクセル単位で指定します。

指定できる値：30～260（単位：ピクセル）

デフォルト値：130（単位：ピクセル）

補足事項

ボタン名はノードの属性の設定内容によって変更できます。ボタン名がこのプロパティで指定した幅よりも長い場合，ボタン名は途中までしか表示されません。

(66)　業務実行画面で分岐合流ノードを経由して次のノードへ遷移するためのボタンの幅（ucnp.base.client.branch.button.width）

業務実行画面で分岐合流ノードの前のプロセスノードを選択した場合に表示される，次のノードへ遷移するためのボタンの幅をピクセル単位で指定します。なお，このプロパティは，分岐先が一つしかないプロセスノードに対しては適用されません。

指定できる値：30～260（単位：ピクセル）

デフォルト値：130（単位：ピクセル）

補足事項

ボタン名はノードの属性の設定内容によって変更できます。ボタン名がこのプロパティで指定した幅よりも長い場合，ボタン名は途中までしか表示されません。

(67)　アクセス権限の設定対象の指定（ucnp.base.server.acl.group.type）

アクセス権限の設定対象として，組織またはグループのどちらかを設定します。

アクセス権限の詳細は，「6.3　業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）」を参照してください。

指定できる値：

org：組織

group：グループ

デフォルト値：group

(68)　一意の業務コンテンツ名称の指定可否（ucnp.base.client.contentsname.uniquecheck.enable）

次の場合に，業務コンテンツ名称を一意にするかどうかを指定します。

業務編集画面で業務コンテンツを作成または複製する場合

業務編集画面で業務コンテンツの名称を変更する場合

業務コンテンツをインポートする場合

このプロパティを「true」にすると，設定されているアクセス権に関係なく，すべての業務コンテンツに対して名称の重複チェックが実行されます。アクセス権の設定によっては，業務編集画面に表示されていない業務コンテンツと名称が重複して，業務コンテンツの追加，名称の変更，複製がエラーとなることがあります。

指定できる値：

true：業務コンテンツの名称を一意にする

false：業務コンテンツ名称の重複を許容する

デフォルト値：true

補足事項

業務コンテンツ名称の重複を許容する環境から，許容しない環境に変更する場合，業務編集画面で業務コンテンツの名称が重複していないかをチェックする必要があります。業務コンテンツ名称の重複を許容する環境から許容しない環境に変更する手順を次に示します。

手順

業務コンテンツ名称の重複を許容しない環境に変更します。
ucnp.base.client.contentsname.uniquecheck.enableプロパティをtrueに変更します。そのあと，ナビゲーション プラットフォームを再起動してください。

業務コンテンツの名称を一意に変更します。
ナビゲーション プラットフォームにログインし，業務編集画面を表示します。そのあと，業務コンテンツの名称を変更してください。

業務コンテンツの名称が重複していないかチェックします。
npexportコマンドですべての業務コンテンツをエクスポートしてください。そのあと，同じ環境でnpimportコマンドに-dオプションを指定して，エクスポートしたコンテンツをインポートします。
インポート時に業務コンテンツの名称が重複していないかがチェックされます。エラーが発生した場合，手順2.からやり直してください。

(69)　業務編集画面のグリッド間隔（ucnp.base.client.grid.size）

業務編集画面のグリッド間隔を指定します。業務編集画面に配置したパーツは，このグリッド間隔を基準にスナップされます。

指定できる値：

0：スナップ処理は実行されない

5：5ピクセル

10：10ピクセル

20：20ピクセル

デフォルト値：10

(70)　［元に戻す］ボタンの対象操作履歴の最大保持数（ucnp.base.client.undo.max.count）

［元に戻す］ボタンの対象操作履歴の最大保持数を指定します。つまり，このプロパティで指定した値は，［元に戻す］ボタンが有効になる最大の回数になります。

指定できる値：1～100

デフォルト値：10

(71)　静的ファイルの格納ディレクトリ（ucnp.base.server.cosminexus.httpsd.documentroot.path）

静的ファイルの格納ディレクトリのパスを指定します。

指定できる値：長さが100文字以内の文字列

デフォルト値：Cosminexusインストールディレクトリ¥httpsd¥htdocs

補足事項

このプロパティには，Cosminexus Management Serverの運用管理ポータルにある「静的コンテンツの設定」の「コンテンツ格納ディレクトリ」で設定されている値と同じパスを指定してください。運用管理ポータルで設定されたパスと，このプロパティで指定したパスが異なる場合の動作は保証されません。運用管理ポータルの詳細については，マニュアル「Cosminexus V9 アプリケーションサーバ 運用管理ポータル操作ガイド」の［Webサーバの設定］画面の説明を参照してください。

静的ファイルの格納ディレクトリのパスが長くなると，格納できるファイル名の長さが短くなります。パスの長さは，100文字以内になるように指定してください。

(72)　［ファイル管理／登録］メニューの表示有無（ucnp.base.server.fileupload.link.display）

業務編集画面のヘッダ領域に［ファイル管理／登録］メニューを表示するかどうかを指定します。

指定できる値：

all：すべてのユーザに［ファイル管理／登録］メニューを表示する

admin：システム管理者にだけ［ファイル管理／登録］メニューを表示する

none：［ファイル管理／登録］メニューを表示しない

デフォルト値：admin

(73)　ドロップダウンの選択項目を一括設定するためのCSVファイルの格納ディレクトリの絶対パス（ucnp.base.server.dropdown.csv.dir）

ドロップダウンの選択項目を一括で設定する場合に必要なCSVファイルを格納するディレクトリを絶対パスで指定します。

デフォルト値：なし

ファイル記載値：C:¥¥Program Files¥¥Hitachi¥¥uCNP¥¥conf¥¥dropdown

(74)　［Plugins］パレットに表示するアイコン（ucnp.base.client.editor.jp1plugin.toolpalette.display）

［Plugins］パレットにJP1連携プラグインのアイコンを表示するかどうかを指定します。

指定できる値：

true：JP1連携プラグインのアイコンを表示する

false：JP1連携プラグインのアイコンを表示しない

デフォルト値：false

補足事項

このプロパティはJP1連携プラグインのアイコンの表示だけを制御します。falseを指定しても，すでにJP1連携プラグインを配置している業務コンテンツを操作したり，配置されているJP1連携プラグインの設定を変更したりできます。

7.5　ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定

ユーザメッセージプロパティファイルを編集すると，次のメッセージの内容を変更できます。

業務実行画面または業務編集画面で，Webブラウザの［×］ボタンで画面を閉じようとしたとき，またはほかのページへ遷移しようとしたときに表示されるメッセージ（KDCZ00146-W）

業務実行画面での操作が完了したときに表示されるメッセージ（KDCZ10060-I）

必須のチェックボックスが未チェックの場合のメッセージ（KDCZ00307-E）

参考

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.confirm.page.unload.enableプロパティに「false」が指定されている場合，ユーザメッセージプロパティファイルで設定したメッセージ（KDCZ00146-W）は表示されないで，業務フロー終了と同時にWebブラウザが閉じます。

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.complete.button.window.closeプロパティに「true」が指定されている場合，ユーザメッセージプロパティファイルで設定したメッセージ（KDCZ10060-I）は表示されないで，業務フロー終了と同時にWebブラウザが閉じます。

＜この節の構成＞

7.5.1　ユーザメッセージプロパティファイルの格納先

7.5.2　ユーザメッセージプロパティファイルの記述例

7.5.1　ユーザメッセージプロパティファイルの格納先

ユーザメッセージプロパティファイルのサンプルファイルとプロパティファイルの格納先を次に示します。

サンプルファイルの格納先

ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnp_message_user.properties

プロパティファイルの格納先

ナビゲーション プラットフォームインストールディレクトリ¥conf¥ucnp_message_user.properties

7.5.2　ユーザメッセージプロパティファイルの記述例

ユーザメッセージプロパティファイルの記述例を次に示します。

KDCZ10060-I = 完了しました。

下線で示す部分を変更すると，メッセージを変更できます。

なお，記述できるメッセージIDは「KDCZ00146-W」，「KDCZ10060-I」，または「KDCZ00307-E」で固定です。これ以外のメッセージIDは記述しないでください。

マルチバイト文字を含むメッセージを表示させる場合は，Javaツールのnative2asciiを実行して文字コードを変換する必要があります。KDCZ00307-Eの場合は，セットアップ時に自動で作成されるユーザメッセージプロパティファイルには，「未チェックの項目を確認してください。」という日本語のメッセージが表示されるよう，文字コード変換をした文字列がデフォルトで記述されています。

＜この項の構成＞

(1)　KDCZ00146-Wのメッセージ例

(1)　KDCZ00146-Wのメッセージ例

KDCZ00146-Wは，Webブラウザの［×］ボタンで画面を閉じようとしたとき，または＜F5＞キーや＜BackSpace＞キーでほかのページに遷移しようとしたときに出力されるメッセージです。画面のヘッダ領域に表示されるボタンの種類，およびプラグインの使用有無に応じた，KDCZ00146-Wのメッセージ例を次に示します。この例では，業務実行画面を操作する利用者が，Webブラウザの［×］ボタンで画面を閉じようとしたときを想定しています。

表7-6　KDCZ00146-Wのメッセージ例

項番
ボタンの種類※1
プラグインの有無
メッセージ例

1
［ログアウト］ボタン
なし
ウィンドウを閉じる場合は， [ログアウト] でログアウトしてから終了してください。※2

2
あり
入力中の項目は保存されません。¥¥nウィンドウを閉じる場合は， [ログアウト] でログアウトしてから終了してください。

3
［閉じる］ボタン
なし
ウィンドウを閉じる場合は， [閉じる] で終了してください。

4
あり
入力中の項目は保存されません。¥¥nウィンドウを閉じる場合は， [閉じる] で終了してください。

5
ボタンなし
（業務フローが完了したときだけ閉じる場合）
なし
－

6
あり
入力中の項目は保存されません。¥¥n業務フローを完了させてください。

（凡例）

－：メッセージはありません。

注

「¥¥n」は改行を示します。

注※1

ボタンの種類を設定する方法には，URLにucnpCloseBtnパラメタを指定する方法，およびユーザプロパティファイル（ucnp_user.properties）の次のプロパティを設定する方法があります。

ucnp.base.server.logoutbutton.displayプロパティ

ucnp.base.server.close.button.settingプロパティ

ucnp.base.client.complete.button.window.closeプロパティ

注※2

デフォルトで出力されるメッセージです。

この表の項番3で示したメッセージ例の場合，次のようなダイアログが表示されます。

8.　コマンド

この章では，ナビゲーション プラットフォームのコマンドについて説明します。

＜この章の構成＞

8.1　コマンドの概要

8.2　npaclexportコマンド（アクセス権グループのエクスポート）

8.3　npenvupdateコマンド（環境更新）

8.4　npexportコマンド（業務コンテンツのエクスポート）

8.5　npimportコマンド（業務コンテンツのインポート）

8.6　nppdntcmdコマンド（データベース環境変数の設定）

8.7　npsetenvコマンド（環境変数の設定）

8.8　npsetupコマンド（セットアップ）

8.9　npsnapshotlogコマンド（トラブルシュート情報の収集）

8.10　npstartコマンド（起動）

8.11　npstopコマンド（停止）

8.12　npunsetupコマンド（アンセットアップ）

8.13　npupdateearコマンド（EARファイルの更新）

8.14　npupdatesearchdataコマンド（検索用データの更新）

8.1　コマンドの概要

ここでは，ナビゲーション プラットフォームのコマンドの一覧を示します。また，コマンドを実行するに当たっての注意事項について説明します。

＜この節の構成＞

8.1.1　コマンド一覧

8.1.2　全コマンド共通の注意事項

8.1.1　コマンド一覧

ナビゲーション プラットフォームのコマンドを次の表に示します。

表8-1　ナビゲーション プラットフォームのコマンド一覧

項番
コマンド名
機能概要

1
npaclexportコマンド
保存済みのアクセス権グループの情報をエクスポートします。

2
npenvupdateコマンド
ナビゲーション プラットフォームを上書きインストールしたあとに環境を更新します。

3
npexportコマンド
保存済みの業務コンテンツおよびアクセス権の設定情報をエクスポートします。

4
npimportコマンド
次のどちらか，または両方の情報をインポートします。

npexportコマンドでエクスポートした業務コンテンツおよびアクセス権の設定情報

npaclexportコマンドでエクスポートしたアクセス権グループの情報

5
nppdntcmdコマンド
組み込みデータベースの処理に必要な環境変数を設定します。

6
npsetenvコマンド
ナビゲーション プラットフォームの構成ソフトウェアのインストールディレクトリを環境変数に設定します。

7
npsetupコマンド
ナビゲーション プラットフォームをセットアップします。

8
npsnapshotlogコマンド
ナビゲーション プラットフォームに関するログおよび環境設定ファイルを取得します。

9
npstartコマンド
ナビゲーション プラットフォームおよび構成ソフトウェアを起動します。

10
npstopコマンド
ナビゲーション プラットフォームおよび構成ソフトウェアを停止します。

11
npunsetupコマンド
ナビゲーション プラットフォームをアンセットアップします。

12
npupdateearコマンド
ナビゲーション プラットフォームのEARファイルにポータル用設定ファイルを反映します。

13
npupdatesearchdataコマンド
業務コンテンツを追加，編集，削除，またはインポートしたあとで，検索用のデータを更新します。

8.1.2　全コマンド共通の注意事項

ここでは，全コマンド共通の注意事項を説明します。次に示す内容を守らなかった場合，エラーが発生していなくても動作は保証されません。

ナビゲーション プラットフォームのインストール操作を実行した，Windowsの管理者権限を持つユーザでコマンドを実行してください。Windows XP以外のOSの場合は，さらにコマンドプロンプトを［管理者として実行］を選択して開いてからコマンドを実行する必要があります。

npsnapshotlogコマンド（トラブルシュート情報の収集）以外のコマンドについては，2種類以上のコマンドを同時に実行しないでください。ただし，npsnapshotlogコマンドの場合も，複数のnpsnapshotlogコマンドを同時に実行することはできません。

コマンド実行中は，ほかの操作をしないでください。

コマンド実行時に表示されるコマンドプロンプトを停止しないでください。

ナビゲーション プラットフォームをセットアップしたときに設定した環境変数以外の環境変数には，「UCNP」で始まる名称を付けないでください。

ディレクトリおよびホスト名に使用できる文字には，次の表に示す条件があります。

表8-2　ディレクトリおよびホスト名に使用できる文字の条件

対象
条件

RDエリアを格納するディレクトリのパス

次の文字だけを使用してください。
・半角英数字（A～Z，a～z，0～9）
・半角スペース
・半角アンダースコア（_）
・半角ハイフン（-）
・半角ピリオド（.）
・半角丸括弧

半角ピリオド（.）で始まるディレクトリを含めないでください。

ネットワークドライブを指定しないでください。

ドライブ直下を指定しないでください。

60バイト以内の文字列を指定してください。

ポータルプロジェクトのディレクトリのパス

次の文字だけを使用してください。
・半角英数字（A～Z，a～z，0～9）
・半角スペース
・半角アンダースコア（_）
・半角ハイフン（-）
・半角ピリオド（.）
・半角丸括弧

半角ピリオド（.）で始まるディレクトリを含めないでください。

ネットワークドライブを指定しないでください。

DocumentBroker Smart Document Managementインストールディレクトリのパス
40バイト以内の文字列を指定してください。

ホスト名

次の文字だけを使用してください。
・半角英数字（A～Z，a～z，0～9）
・半角ハイフン（-）

15バイト以内の文字列を指定してください。

コマンドのオプションに指定するパスに半角スペースを含める場合は，パスを引用符（"）で囲んでください。

インストールディレクトリ以下のディレクトリおよびファイルは，指示されているもの以外は変更，削除しないでください。

8.2　npaclexportコマンド（アクセス権グループのエクスポート）

機能

保存済みのアクセス権グループの情報をエクスポートします。

このコマンドは，アクセス権グループの情報だけをエクスポートしたい場合に使用します。例えば，業務コンテンツを参照できるユーザを追加するときに，アクセス権グループだけを変更したい場合にnpaclexportコマンドを使用すると便利です。

業務コンテンツの情報をエクスポートしたい場合は「8.4　npexportコマンド（業務コンテンツのエクスポート）」を参照してください。

なお，このコマンドは，セットアップ完了後，システムが起動している状態で実行する必要があります。Windows XP以外の場合，コマンドプロンプトは管理者として開いてください。

形式

npaclexport△[-i△アクセス権グループ名入力ファイルのパス]△[-l△アクセス権グループのエクスポート一覧ファイルのパス]△エクスポート先のファイルのパス

エクスポート先のファイルのパスは，200文字以内の絶対パスまたは相対パスで指定します。出力されるファイルの形式はZIP形式です。

また，区切り文字には「¥」を使用します。パスに半角スペースが含まれる場合は，パス全体を「"」で囲んでください。ディレクトリのパスで使用できる記号は，これら以外には半角のコロン（:）と相対パスを表す半角ピリオド（.）だけです。

オプション

-i アクセス権グループ名入力ファイルのパス

アクセス権グループ名入力ファイルのパスを絶対パスまたは相対パスで指定します。

このオプションを指定すると，ファイルに記載されているアクセス権グループ名と同じ名称のアクセス権グループだけがエクスポートされます。このオプションを省略した場合は，すべてのアクセス権グループがエクスポートされます。

-l アクセス権グループのエクスポート一覧ファイルのパス

アクセス権グループのエクスポート一覧ファイルのパスを絶対パスまたは相対パスで指定します。

このオプションを指定すると，エクスポートされたアクセス権グループの一覧がテキストファイルとして出力されます。

アクセス権グループ名入力ファイルの形式

改行区切りでアクセス権グループ名を指定します。アクセス権グループ名入力ファイルはテキストファイルで作成してください。テキストファイル以外の場合は，コマンド実行時にエラーメッセージ（KDCZ10147-E）が表示されます。

各行の前後の空白（半角スペース，または全角スペース）を削除した文字列をアクセス権グループ名として読み込みます。各行の前後の空白を削除した結果，アクセス権グループ名が空文字になる行は読み込みません。

行の途中でEOFになっている場合，EOFまでの文字列をアクセス権グループ名として読み込みます。

なお，「#」などの記号でコメント行を付加することはできません。

アクセス権グループのエクスポート一覧ファイルの形式

ファイルの先頭にヘッダ情報が出力され，続いて，次の形式でメッセージが出力されます。

[結果種別]<T>[アクセス権グループ名] <CR><LF>

<T>：タブ文字

<CR><LF>：終端文字（0x0D，0x0A）

メッセージの詳細を次の表に示します。

表8-3　アクセス権グループのエクスポート一覧ファイルに出力されるメッセージの詳細

項目
説明

結果種別
npaclexportコマンドの実行結果の種別が出力されます。

exported

アクセス権グループがエクスポートされました。

アクセス権グループ名
エクスポートしたアクセス権グループ名が出力されます。

アクセス権グループのエクスポート一覧ファイルの出力例を次に示します。

注意事項

npexportコマンド，およびnpimportコマンドとは同時に実行できません。実行した場合の動作は保証されません。

出力先として指定したファイルと同じ名前のファイルがすでにそのディレクトリに存在している場合はエラーとなり，エクスポートできません。存在していないファイルを指定してください。

ファイルのパスには，ネットワークドライブを指定しないでください。

エクスポートする業務コンテンツの容量に対して，エクスポート先のディスクの空き容量が不十分だった場合，このコマンドは異常終了します。
また，コマンド実行中は作業フォルダとして環境変数TMPまたはTEMPのフォルダを使用します。このため，環境変数TMPおよびTEMPのフォルダのディスク容量に余裕を持たせてからコマンドを実行するようにしてください。

JP1/Baseによるユーザ認証を利用している場合はアクセス権グループが存在しないため，このコマンドは使用しないでください。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。または，エクスポート対象の業務コンテンツが存在しなかったため警告終了した。
1 | コマンドが異常終了した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

例1

次の条件でアクセス権グループをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

すべてのアクセス権グループをエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npaclexport C:¥work¥repository.zip

例2

次の条件でアクセス権グループをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

アクセス権グループ名入力ファイルのパスが「C:¥work¥accessName.txt」である。

アクセス権グループ名入力ファイルで指定したアクセス権グループをエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npaclexport -i C:¥work¥accessName.txt C:¥work¥repository.zip

例3

次の条件でアクセス権グループをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

アクセス権グループのエクスポート一覧ファイルのパスが「C:¥work¥list.csv」である。

すべてのアクセス権グループをエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npaclexport -l C:¥work¥list.csv C:¥work¥repository.zip

8.3　npenvupdateコマンド（環境更新）

機能

ナビゲーション プラットフォームを上書きインストールしたあとに環境を更新します。更新が完了すると，ナビゲーション プラットフォームは起動状態になります。

このコマンドは，構成ソフトウェアの上書きインストールが正常終了したあとに実行してください。

形式

npenvupdate

オプション

なし。

注意事項

コマンドが異常終了した場合は，出力されているメッセージおよびログを参照して，エラーの原因を取り除いてから再度コマンドを実行してください。

コマンド実行時に＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合，コマンドを再実行してもエラーメッセージ（KDCZ60202-E）が表示され，再実行できなくなります。同時に実行している別のコマンドがないのにエラーメッセージが表示される場合は，次のディレクトリを削除してから再実行してください。
ナビゲーション プラットフォームインストールディレクトリ¥migrate¥work¥running

ユーザ認証用のディレクトリサーバにActive Directoryを使用している環境では，npenvupdateコマンドで環境を更新できます。

コマンド実行時に，データベースが自動で2.6GB拡張されます。ディスク容量に余裕を持たせてからコマンドを実行するようにしてください。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。
1 | コマンドが異常終了した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

8.4　npexportコマンド（業務コンテンツのエクスポート）

機能

保存された業務コンテンツ，およびアクセス権の設定情報（アクセス権グループまたはJP1資源グループ）をエクスポートします。

このコマンドは，セットアップ完了後，システムが起動している状態で実行する必要があります。Windows XP以外の場合，コマンドプロンプトは管理者として開いてください。

なお，業務コンテンツが作成されていない状態でこのコマンドを実行した場合，業務コンテンツ数が0のファイルがエクスポートされます。

参考

ディレクトリサーバによるユーザ認証を利用している場合は，アクセス権グループおよび標準アクセス権限によって業務コンテンツのアクセス権が決まります。一方，JP1/Baseによるユーザ認証を利用している場合は，JP1資源グループの設定によって業務コンテンツのアクセス権が決まります。ただし，このコマンドでエクスポートできるJP1資源グループの情報は，JP1資源グループ名だけです。JP1資源グループの設定をインポート時に変更するための情報はエクスポートされないため，注意してください。

形式

ucnp.base.server.command.legacyプロパティの値が「false」の場合

npexport△[-c△エクスポートしたい業務コンテンツID｜-i△業務コンテンツID一覧ファイルのパス]△[-x]△[-l△エクスポート一覧ファイルのパス]△エクスポート先のファイルのパス

ucnp.base.server.command.legacyプロパティの値が「true」の場合

npexport△[-c△エクスポートしたい業務コンテンツID]△[-l△エクスポート一覧ファイルのパス]△エクスポート先のファイルのパス

エクスポート先のファイルのパスは，200文字以内の絶対パスまたは相対パスで指定します。出力されるファイルの形式はZIP形式です。

また，区切り文字には「¥」を使用します。パスに半角スペースが含まれる場合は，パス全体を「"」で囲んでください。ディレクトリのパスで使用できる記号は，これら以外には半角のコロン（:）と相対パスを表す半角ピリオド（.）だけです。

オプション

-c エクスポートしたい業務コンテンツID

ucnp.base.server.command.legacyプロパティの値が「false」の場合

エクスポートしたい業務コンテンツの業務コンテンツIDを指定します。指定したIDに対応した業務コンテンツおよびアクセス権の設定情報だけがエクスポートされます。なお，-cオプションおよび-iオプションを省略した場合は，すべての業務コンテンツおよびアクセス権の設定情報をエクスポートします。

ucnp.base.server.command.legacyプロパティの値が「true」の場合

特定の業務コンテンツだけエクスポートしたい場合は，エクスポートしたい業務コンテンツの業務コンテンツIDを指定します。この場合，アクセス権の設定情報はエクスポートされません。-cオプションを省略すると，登録されているすべての業務コンテンツおよびアクセス権の設定情報がエクスポートされます。

-i 業務コンテンツID一覧ファイルのパス

業務コンテンツID一覧ファイルのパスを絶対パスまたは相対パスで指定します。

このオプションは，ucnp.base.server.command.legacyプロパティの値が「false」の場合だけ指定できます。

なお，-cオプションおよび-iオプションを省略した場合は，すべての業務コンテンツをエクスポートします。

-iオプションに指定した業務コンテンツID一覧ファイルに存在しない業務コンテンツIDが含まれている場合は，対応する業務コンテンツがないことを示す警告メッセージを出力し，存在する業務コンテンツとアクセス権の設定情報だけをエクスポートします。

-x

業務コンテンツだけを出力する場合に指定します。

このオプションは，ucnp.base.server.command.legacyプロパティの値が「false」の場合だけ指定できます。

なお，JP1/Baseによるユーザ認証を利用している場合は，このオプションを指定しても無視されます。

-l エクスポート一覧ファイルのパス

エクスポート一覧ファイルのパスを絶対パスまたは相対パスで指定します。

このオプションを指定すると，エクスポートされた業務コンテンツの一覧がテキストファイルとして出力されます。

参考

ucnp.base.server.command.legacyプロパティに「true」を設定すると，バージョン09-00以前と同じようにコマンドを指定できます。この場合，オプションの指定は次のとおりになります。

オプションを指定しない
すべての業務コンテンツとアクセス権の設定情報をエクスポートする。

-cオプションを指定する
エクスポートしたい業務コンテンツの業務コンテンツIDを指定して，特定の業務コンテンツだけエクスポートする。

-lオプションを指定する
エクスポートした業務コンテンツの一覧（エクスポート一覧ファイル）を出力する。エクスポート一覧ファイルのパスは絶対パスまたは相対パスで指定する。

業務コンテンツID一覧ファイルの形式

改行区切りで業務コンテンツIDを指定します。業務コンテンツID一覧ファイルはテキストファイルで作成してください。テキストファイル以外の場合は，コマンド実行時にエラーメッセージ（KDCZ10147-E）が表示されます。

各行の前後の空白（半角スペース，または全角スペース）を削除した文字列を業務コンテンツIDとして読み込みます。各行の前後の空白を削除した結果，業務コンテンツIDが空文字になる行は読み込みません。

行の途中でEOFになっている場合，EOFまでの文字列を業務コンテンツIDとして読み込みます。

なお，「#」などの記号でコメント行を付加することはできません。

エクスポート一覧ファイルの形式

ファイルの先頭にヘッダ情報が出力され，続いて，次の形式でメッセージが出力されます。

[結果種別]<T>[業務コンテンツID]<T>[業務コンテンツの更新日時]<T>[業務コンテンツ名称]<T>[グループ名]<T>[アクセス権グループ名またはJP1資源グループ名1]<T>
…
[アクセス権グループ名またはJP1資源グループ名10]<CR><LF>
[結果種別][アクセス権グループ名1]<CR><LF>
…
[結果種別][アクセス権グループ名10]<CR><LF>

<T>：タブ文字

<CR><LF>：終端文字（0x0D，0x0A）

メッセージの詳細を次の表に示します。

表8-4　エクスポート一覧ファイルに出力されるメッセージの詳細

項目
説明

結果種別
npexportコマンド（業務コンテンツのエクスポート）の実行結果の種別が出力されます。

exported

業務コンテンツまたはアクセス権グループがエクスポートされました。

業務コンテンツID
エクスポートした業務コンテンツIDが出力されます。

業務コンテンツの更新日時
エクスポートした業務コンテンツの最終更新日時が出力されます。
形式：YYYY/MM/DD hh:mm:ss.SSS

業務コンテンツ名称
エクスポートした業務コンテンツの名称が出力されます。

グループ名
エクスポートした業務コンテンツのグループ名が出力されます。
ただし，ucnp.base.client.menu.group.enableプロパティの設定によってはこの項目は出力されません。

アクセス権グループ名
業務コンテンツ名称と同じ行には，エクスポートした業務コンテンツに設定されているアクセス権グループ名が出力されます。それ以外の行には，エクスポートしたアクセス権グループ名が出力されます。
アクセス権グループは，はじめに標準アクセス権限が出力されたあと，名称の昇順で出力されます。
ただし，ucnp.base.server.command.legacyプロパティの設定によってはこの項目は出力されません。

JP1資源グループ名
業務コンテンツ名称と同じ行には，エクスポートした業務コンテンツに設定されているJP1資源グループ名が出力されます。

エクスポート一覧ファイルの出力例を次に示します。

注意事項

業務コンテンツで使用している画像やHTMLなどの静的ファイルは，このコマンドではエクスポートされません。静的ファイルは手動でコピーし，移動させてください。静的ファイルの取り扱いの詳細は，「6.9　業務コンテンツで使用する静的ファイルの管理」を参照してください。

出力先として指定したファイルと同じ名前のファイルがすでにそのディレクトリに存在している場合はエラーとなり，エクスポートできません。存在していないファイルを指定してください。

ファイルのパスには，ネットワークドライブを指定しないでください。

エクスポートする業務コンテンツの容量に対して，エクスポート先のディスクの空き容量が不十分だった場合，このコマンドは異常終了します。
また，コマンド実行中は作業フォルダとして環境変数TMPまたはTEMPのフォルダを使用します。このため，環境変数TMPおよびTEMPのフォルダのディスク容量に余裕を持たせてからコマンドを実行するようにしてください。

出力したファイルの内容を変更しないでください。出力したファイルの内容を変更してインポートした場合，動作は保証されません。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。または，エクスポート対象の業務コンテンツが存在しなかったため警告終了した。
1 | コマンドが異常終了した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

例1

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

業務コンテンツとアクセス権の設定情報をエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport C:¥work¥repository.zip

例2

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

エクスポート後に出力するエクスポート一覧ファイルのパスを「C:¥work¥list.csv」とする。

業務コンテンツとアクセス権の設定情報をエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -l C:¥work¥list.csv C:¥work¥repository.zip

例3

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

業務コンテンツID一覧ファイルのパスが「C:¥work¥contentsId.txt」である。

業務コンテンツとアクセス権の設定情報をエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -i C:¥work¥contentsId.txt C:¥work¥repository.zip

例4

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

ucnp.base.server.command.legacyプロパティの値が「false」である。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

指定した業務コンテンツID（85D412B4-BB5D-4a14-A331-B0D31B7E1297-1）の業務コンテンツと，それに設定されているアクセス権の設定情報をエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -c 85D412B4-BB5D-4a14-A331-B0D31B7E1297-1 C:¥work¥repository.zip

例5

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

ucnp.base.server.command.legacyプロパティの値が「true」である。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

指定した業務コンテンツID（85D412B4-BB5D-4a14-A331-B0D31B7E1297-1）の業務コンテンツだけをエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -c 85D412B4-BB5D-4a14-A331-B0D31B7E1297-1 C:¥work¥repository.zip

例6

次の条件で業務コンテンツをエクスポートする場合の使用例を次に示します。

エクスポート先のファイルのパスが「C:¥work¥repository.zip」である。

すべての業務コンテンツだけをエクスポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npexport -x C:¥work¥repository.zip

8.5　npimportコマンド（業務コンテンツのインポート）

機能

ナビゲーション プラットフォームのコマンドでエクスポートした業務コンテンツ，およびアクセス権の設定情報（アクセス権グループまたはJP1資源グループ）をインポートします。

このコマンドは，セットアップ完了後，システムが起動している状態で実行する必要があります。Windows XP以外の場合，コマンドプロンプトは管理者として開いてください。

参考

ディレクトリサーバによるユーザ認証を利用している場合は，アクセス権グループおよび標準アクセス権限によって業務コンテンツのアクセス権が決まります。一方，JP1/Baseによるユーザ認証を利用している場合は，JP1資源グループの設定によって業務コンテンツのアクセス権が決まりますが，このコマンドを実行しても，JP1資源グループの設定は変更されません。JP1資源グループの設定は，業務編集画面から変更する必要があります。

デフォルトではインポート対象の業務コンテンツを既存の業務コンテンツに追加します。

既存データへの追加ではなく，既存データをインポートするデータに置き換える場合には，-dオプションを指定してください。既存データを強制上書きするには，-fオプションを指定します。また，アクセス権グループをインポートする必要がない場合は，-xオプションを指定すると，業務コンテンツだけをインポートできます。

なお，すべての業務コンテンツをまとめてエクスポートしている場合（-cオプション指定なしでnpexportコマンドを実行），インポート時には-dオプション，-fオプション，または-xオプションを必ず指定してください。

ディレクトリサーバによるユーザ認証を使用している場合は，次のどちらかの条件を満たすと，インポートした業務コンテンツに標準アクセス権限が設定されます。ただし，IDが同じ既存の業務コンテンツを上書きする場合（-fオプション指定）は，既存の業務コンテンツのアクセス権の設定情報が有効となります。

アクセス権グループをインポートしないで，業務コンテンツだけをインポート対象とした（-xオプション指定ありでnpimportコマンドを実行した）

特定の業務コンテンツだけをエクスポートした（-cオプション指定ありでnpexportコマンドを実行した）ファイルをインポート対象とした

形式

npimport△[-d]△[-f]△[-x]△[-l△インポート一覧ファイルのパス]△インポートしたいファイルのパス

インポートしたいファイルのパスは，絶対パスまたは相対パスで指定します。ナビゲーション プラットフォームのコマンドで取得したファイルを指定してください。それ以外のファイルは，指定できません。

オプション

-d

インポートする前に，すべての業務コンテンツおよびアクセス権の設定情報を削除します。

既存の業務コンテンツをインポートした業務コンテンツで置き換える場合は，このオプションを指定してください。このオプションを指定しない場合は，既存のデータにインポートしたデータを追加します。

オプション「-d」「-f」を同時に指定した場合，「-f（強制登録）」は実行されません。

業務コンテンツにアクセス権グループを設定する場合は，-dオプションまたは-fオプションを指定してください。インポート先に同名のアクセス権グループが存在する場合，インポート時に-dオプションまたは-fオプションの指定がないとエラーになります。

オプション「-d」「-x」を同時に指定した場合，すべての業務コンテンツに標準アクセス権限を設定します。また，すべてのアクセス権グループを削除して，標準アクセス権限の定義をセットアップ時の状態にリセットします。なお，npexportコマンド（業務コンテンツのエクスポート）実行時に-xオプションを指定して，このコマンドで-dオプションを指定した場合も同じ状態になります。

ポイント

このオプションを指定して，npexportコマンド（業務コンテンツのエクスポート）の-xオプションでエクスポートしたファイルをインポートした場合，追加した業務コンテンツには標準アクセス権限を設定します。上書きする業務コンテンツのアクセス権の設定情報は変更されません。

このオプションを指定して，業務コンテンツ数が0のファイルをインポートすると，登録されているすべての業務コンテンツが削除されます。多数の業務コンテンツを一括で削除したい場合に便利です。

-f

インポート先に，インポート元と同じ名称のアクセス権グループ，または，同じIDの業務コンテンツがすでに保存されている場合は，必ずこのオプションを指定してください。インポート元のアクセス権グループと業務コンテンツをインポート先に上書きします（強制登録）。

業務コンテンツにアクセス権グループを設定する場合は，-dオプションまたは-fオプションを指定してください。

-fオプションを指定しないと，同じ名称のアクセス権グループまたは同じIDの業務コンテンツがすでに保存されている場合はエラーとなり，インポートできません。オプション「-d」「-f」を同時に指定した場合，「-f（強制登録）」は実行されないので，注意してください。

オプション「-f」「-x」を同時に指定した場合，インポート先のアクセス権グループを業務コンテンツに設定します。業務コンテンツに設定するアクセス権グループがインポート先に一つも存在しない場合は，標準アクセス権限を設定します。

ポイント

ucnp.base.client.contentsname.uniquecheck.enableプロパティの設定によっては，同じ名称の業務コンテンツが存在することがあります。その場合，業務コンテンツをIDで管理する必要があります。業務コンテンツのIDは，次の方法で確認できます。

オプション「-l」を指定してnpexportコマンドを実行して，出力される一覧ファイルを確認する。

業務編集画面でIDを確認したい業務コンテンツを選択して，メニュー領域の［ID取得］メニューをクリックする。

なお，ucnp.base.client.contentsname.uniquecheck.enableプロパティに「true」を設定すると，同じ名称の業務コンテンツを作成できなくなるため，名称によって業務コンテンツを管理しやすくなります。

-x

アクセス権グループをインポートしないで，業務コンテンツだけをインポートします。業務コンテンツにアクセス権グループを設定しない場合に指定してください。

このオプションを指定してインポートした業務コンテンツには，インポート元のアクセス権グループの設定にかかわらず，インポート先ではすべて標準アクセス権限が設定されます。ただし，-fオプションも同時に指定している場合で，IDが同じ業務コンテンツを上書きするときは，インポート先のアクセス権グループが有効となります。

なお，npexportコマンドで-xオプションを指定してエクスポートした業務コンテンツをインポートする場合は，-xオプションを指定していなくても，インポート結果は-xオプションを指定したときと同じです。

オプション「-d」「-x」を同時に指定した場合，すべての業務コンテンツに標準アクセス権限を設定します。また，すべてのアクセス権グループを削除して，標準アクセス権限の定義をセットアップ時の状態にリセットします。

オプション「-f」「-x」を同時に指定した場合，インポート先のアクセス権グループを業務コンテンツに設定します。業務コンテンツに設定するアクセス権グループがインポート先に一つも存在しない場合は，標準アクセス権限を設定します。

オプション「-x」「-l」を同時に指定した場合，アクセス権グループはインポート一覧ファイルに出力されません。

なお，JP1/Baseによるユーザ認証を利用している場合は，このオプションを指定しても無視されます。

-l インポート一覧ファイルのパス

追加，更新，または削除された業務コンテンツの一覧をテキストファイルとして出力します。

インポート一覧ファイルのパスは，絶対パスまたは相対パスで指定します。

インポート一覧ファイルの形式

ファイルの先頭にヘッダ情報が出力され，続いて，次の形式でメッセージが出力されます。

[結果種別]<T>[業務コンテンツID]<T>[業務コンテンツの更新日時]<T>[業務コンテンツ名称]<T>[グループ名]<T>[アクセス権グループ名またはJP1資源グループ名1]<T>
…
[アクセス権グループ名またはJP1資源グループ名10]<CR><LF>
[結果種別][アクセス権グループ名1]<CR><LF>
…
[結果種別][アクセス権グループ名10]<CR><LF>

<T>：タブ文字

<CR><LF>：終端文字（0x0D，0x0A）

メッセージの詳細を次の表に示します。

表8-5　インポート一覧ファイルに出力されるメッセージの詳細

項目
説明

結果種別
npimportコマンド（業務コンテンツのインポート）の実行結果の種別が出力されます。

added
業務コンテンツまたはアクセス権グループが新規に追加されました。

modified
内容に変更のある業務コンテンツが更新されました。※
同じ名称のアクセス権グループが上書き，または-dオプションによって削除されたあとにインポートされました。

deleted
業務コンテンツまたはアクセス権グループが削除されました。

業務コンテンツID
インポートした業務コンテンツIDが出力されます。

業務コンテンツの更新日時
インポートした業務コンテンツの最終更新日時が出力されます。
形式：YYYY/MM/DD hh:mm:ss.SSS

業務コンテンツ名称
インポートした業務コンテンツの名称が出力されます。

グループ名
インポートした業務コンテンツのグループ名が出力されます。
ただし，ucnp.base.client.menu.group.enableプロパティの設定によってはこの項目は出力されません。

アクセス権グループ名
業務コンテンツ名称と同じ行には，インポートした業務コンテンツに設定されているアクセス権グループ名が出力されます。それ以外の行には，インポートしたアクセス権グループ名が出力されます。
アクセス権グループは，はじめに標準アクセス権限が出力されたあと，名称の昇順で出力されます。
ただし，ucnp.base.server.command.legacyプロパティの設定によってはこの項目は出力されません。

JP1資源グループ名
業務コンテンツ名称と同じ行には，インポートした業務コンテンツに設定されているJP1資源グループ名が出力されます。

注※

-dオプションを指定すると，業務コンテンツはいったん削除されてからインポートされますが，結果種別は「modified」となります。「deleted」または「added」は表示されません。

次に示す項目だけを変更した場合，業務コンテンツの結果種別は「modified」にはなりません。
業務コンテンツ名称
業務コンテンツのグループ名
業務コンテンツに設定するアクセス権グループ（またはJP1資源グループ）

インポート一覧ファイルの出力例を次に示します。

注意事項

このコマンドを実行する前に，npexportコマンド（業務コンテンツのエクスポート）で自環境の業務コンテンツのバックアップを取得しておくことを推奨します。

業務コンテンツで使用している画像やHTMLなどの静的ファイルは，このコマンドではインポートされません。静的ファイルは手動でコピーし，移動させてください。静的ファイルの取り扱いの詳細は，「6.9　業務コンテンツで使用する静的ファイルの管理」を参照してください。

ファイルのパスには，ネットワークドライブを指定しないでください。

インポートする業務コンテンツの容量に対して，インポート先のディスクの空き容量が不十分だった場合，このコマンドは異常終了します。
また，コマンド実行中は作業フォルダとして環境変数TMPまたはTEMPのフォルダを使用します。このため，環境変数TMPおよびTEMPのフォルダのディスク容量に余裕を持たせてからコマンドを実行するようにしてください。

サーバ運用中にこのコマンドを実行すると，コマンドのデータ処理がサーバのデータ処理をブロックするため，性能が低下します。

コマンド実行時にエラーが発生した場合は，インポート処理が一部だけ反映された状態になっています。エラーの原因を取り除いて再度コマンドを実行してください。
-dオプション，-fオプションを指定してコマンドを実行した場合は，同じオプションを指定して，再度コマンドを実行してください。-dオプション，-fオプションの両方とも指定していなかった場合は，-fオプションを指定して，再度コマンドを実行してください。

-lオプションを指定してコマンドを実行し，エラーが発生した場合は，エラー発生時に出力されたインポート一覧ファイルの内容と，エラーの原因を取り除いて再度コマンドを実行したときに出力されたインポート一覧ファイルの内容を合わせて，インポート一覧ファイルとして利用してください。

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.contentsname.uniquecheck.enableプロパティ（一意の業務コンテンツ名称の指定可否）が「true」の場合，業務フローの名称が一意にならないときはエラーとなります。

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.client.menu.group.enableプロパティ（メニュー領域のグループ表示有無）が「false」の場合は，インポート一覧ファイルにグループ名は表示されませんが，グループ名の情報もインポートされています。そのため，プロパティの設定を「true」に変更すると，メニュー領域にグループ名が表示されるようになります。ただし，09-00より前のバージョンで作成した業務コンテンツをインポートすると，グループ名は空白となります。

npexportコマンド（業務コンテンツのエクスポート）で-xオプションを指定してエクスポートしたファイルをインポートした場合，追加した業務コンテンツには標準アクセス権限を設定します。上書きする業務コンテンツのアクセス権は変更されません。

バージョン09-50から，プラグインはプロセスノードに対して関連づけられるようになりますが，バージョン09-00以前で作成した業務コンテンツのプラグインについても自動的に処理されるため，バージョン09-00以前で作成した業務コンテンツのプラグインも使用できます。ただし，プラグインの配置のしかたによっては，npimportコマンドでインポートした業務コンテンツと，09-50以降で新たにプラグインを配置した業務コンテンツとでプラグインの動作が異なる場合があります。プラグインの動作の差異についてはマニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」を参照してください。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。
1 | コマンドが異常終了した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

例1

次の条件で業務コンテンツをインポートする場合の使用例を次に示します。

インポートしたいファイルのパスが「C:¥work¥repository.zip」である。

インポート先に同じ名称のアクセス権グループ，または同じIDの業務コンテンツが保存されている場合，強制登録しない。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport C:¥work¥repository.zip

例2

次の条件で業務コンテンツをインポートする場合の使用例を次に示します。

インポートしたいファイルのパスが「C:¥work¥repository.zip」である。

インポート先に同じ名称のアクセス権グループ，または同じIDの業務コンテンツが保存されている場合，強制登録する。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -f C:¥work¥repository.zip

例3

次の条件で業務コンテンツをインポートする場合の使用例を次に示します。

インポートしたいファイルのパスが「C:¥work¥repository.zip」である。

すべてのアクセス権グループと業務コンテンツを削除してからインポートする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -d C:¥work¥repository.zip

例4

次の条件で業務コンテンツをインポートする場合の使用例を次に示します。

インポートしたいファイルのパスが「C:¥work¥repository.zip」である。

インポート後に出力するインポート一覧ファイルのパスを「C:¥work¥list.txt」とする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -l C:¥work¥list.txt C:¥work¥repository.zip

例5

次の条件で業務コンテンツをインポートする場合の使用例を次に示します。

インポートしたいファイルのパスが「C:¥work¥repository.zip」である。

アクセス権グループをインポートしない。

インポート先にIDが同じ業務コンテンツが保存されている場合，強制登録しない。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npimport -x C:¥work¥repository.zip

8.6　nppdntcmdコマンド（データベース環境変数の設定）

機能

組み込みデータベースの処理に必要な環境変数を設定します。このコマンドは，ナビゲーション プラットフォームをインストールしたユーザが実行してください。このコマンドを実行する必要がある操作が説明されている個所を次に示します。

「4.8　検索機能を使用するための追加セットアップ」

「4.9　検索機能のアンセットアップ」

「5.3　データベースの運用」

これらの操作でコマンドプロンプトを使用する場合は，使用するコマンドプロンプト上であらかじめこのコマンドを実行してください。

形式

nppdntcmd

オプション

なし。

戻り値

不定。

使用例

環境変数を設定します。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥nppdntcmd

8.7　npsetenvコマンド（環境変数の設定）

機能

ナビゲーション プラットフォームの構成ソフトウェアのインストールディレクトリパスを環境変数に設定します。このコマンドは，構成ソフトウェアのインストールが完了したあと，ナビゲーション プラットフォームをセットアップする前に実行してください。また，実行前にデータベースのサービスが起動していることを確認してください。データベースのサービスが起動していない場合は，コマンド実行時にエラーになります。

なお，コマンド実行後はマシンを再起動する必要があります。

このコマンドが設定する環境変数を次に示します。

表8-6　npsetenvコマンド（環境変数の設定）が設定する環境変数

環境変数 | 設定する値
UCNP_HOME | ナビゲーション プラットフォームインストールディレクトリ
TPDIR | Cosminexusインストールディレクトリ¥TPB
VBROKER_ADM | Cosminexusインストールディレクトリ¥TPB¥adm
JAVA_HOME | Cosminexusインストールディレクトリ¥jdk
DOCB_LIB | DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥java¥lib¥Djlib.jar
Path | Cosminexusインストールディレクトリ¥jdk¥bin;Cosminexusインストールディレクトリ¥CC¥admin¥bin;Cosminexusインストールディレクトリ¥TPB¥bin;Cosminexusインストールディレクトリ¥DAB¥lib;設定前のPath
TZ | JST-9

形式

npsetenv

オプション

なし。

注意事項

コマンドで設定する環境変数が，すでにシステム環境変数に登録されている場合は，環境変数の値を上書きします。

構成ソフトウェアまたはnpsetenvコマンド（環境変数の設定）が設定する環境変数を削除しないでください。

戻り値

戻り値 | 説明
0 | システム環境変数の設定に成功した。
1 | システム環境変数の設定に失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

システム環境変数を設定します。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsetenv

8.8　npsetupコマンド（セットアップ）

機能

構成ソフトウェアが未セットアップ状態のときに，ナビゲーション プラットフォームを順次セットアップします。再セットアップの場合は，このコマンドを実行する前に，一度ナビゲーション プラットフォームを停止して，npunsetupコマンドでアンセットアップをしてください。

このコマンドを実行するユーザは，ナビゲーション プラットフォームをインストールしたユーザである必要があります。

このコマンドを実行する前に，次のことを実行してください。

npsetenvコマンド（環境変数の設定）を実行する。

ユーザ認証を使用する場合やポート番号を変更する場合は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）を編集する。
詳細は，「7.3　ユーザセットアッププロパティファイル（ucnp_setup_user.properties）の設定」を参照してください。

セットアップ時に使用されるポート番号が別のプログラムなどで使用されていないことを確認する。
セットアップ時に使用されるポート番号は，ユーザセットアッププロパティファイルで確認できます。

インストール後に，セットアップ対象のナビゲーション プラットフォームのインストールディレクトリおよびファイルが移動，編集または削除されていないことを確認する。

データベースのサービスが起動していることを確認する。
データベースのサービスが起動していない場合は，コマンド実行時にエラーになります。

なお，このコマンドを実行すると，ナビゲーション プラットフォームインストールディレクトリ¥spool¥earにucnp.earが生成されます。プラグインを追加していない状態のEARファイルが必要になった場合に，このEARファイルを利用できます。プラグインを追加していない状態に戻す方法については，「6.7.3　適用する前の状態への復元」を参照してください。

ソフトウェアのセットアップ順序と内容を次の表に示します。

表8-7　npsetupコマンドのセットアップ順序と内容

順序 | ソフトウェア名 | 内容
1 | Cosminexus | Cosminexus Management Serverの構築
2 | Cosminexus Management Serverの起動
3 | HiRDB | データベースの構築
4 | データベースの開始
5 | DocumentBroker | 文書管理サーバの設定
6 | 文書管理サーバ用データベースの構築
7 | TPBroker環境の構築
8 | TPBrokerの起動
9 | 文書管理サーバの起動
10 | uCosminexus Portal Framework | ポータルプロジェクトの作成
11 | ポータルの構築
12 | Portal Managerのセットアップ
13 | ナビゲーション プラットフォーム | ナビゲーション プラットフォームのJ2EEアプリケーションの作成
14 | ナビゲーション プラットフォームのJ2EEアプリケーションの設定
15 | Webシステムの構築
16 | Webシステムの起動
17 | Cosminexus | 統合ユーザ管理アプリケーションのインポート
18 | 統合ユーザ管理アプリケーションの起動
19 | ナビゲーション プラットフォーム | 静的ファイル格納ディレクトリの作成
20 | ナビゲーション プラットフォームのJ2EEアプリケーションのインポート
21 | ナビゲーション プラットフォームのJ2EEアプリケーションの起動

形式

npsetup

オプション

なし。

注意事項

このコマンドを実行すると，デフォルト値のユーザプロパティファイル（ucnp_user.properties）およびユーザメッセージプロパティファイル（ucnp_message_user.properties）が設定されます。そのため，これらのプロパティファイルの編集はこのコマンドの実行後に実施してください。再セットアップの場合は，これらのプロパティファイルの既存ファイルをバックアップしておくことをお勧めします。
プロパティファイルの詳細は，「7.　プロパティ」を参照してください。

セットアップに失敗した場合は，npunsetupコマンド（アンセットアップ）を実行し，要因を取り除いてからコマンドを再実行してください。

このコマンドで環境を構築したあとにホスト名を変更しないでください。ホスト名を変更した場合，動作は保証されません。

戻り値

戻り値 | 説明
0 | ナビゲーション プラットフォームのセットアップに成功した。
1 | ナビゲーション プラットフォームのセットアップに失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

ナビゲーション プラットフォームをセットアップします。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsetup

8.9　npsnapshotlogコマンド（トラブルシュート情報の収集）

機能

トラブルの対処に必要なトラブルシュート情報（ログや環境設定ファイル）をまとめて，ZIP形式のファイルで取得します。なお，ここで説明していない情報は，このコマンドでは取得しません。

このコマンドは，セットアップまたはバージョンアップが完了した状態で，ナビゲーション プラットフォームをインストールしたユーザが実行してください。セットアップに失敗した場合など，ナビゲーション プラットフォームが未セットアップの状態でnpsnapshotlogコマンドを使用するときは，コマンドを実行する前に環境変数の設定などの準備が必要です。未セットアップ状態でコマンドを実行するための準備については，「9.2　運用開始後に発生するトラブル」を参照してください。

トラブルシュート情報は，1次資料と2次資料に分類されます。1次資料と2次資料は，それぞれ別のファイルに出力されます。

1次資料のファイル

npsnapshotlog_yyyyMMddhhmmssSSS_1.zip

2次資料のファイル

npsnapshotlog_yyyyMMddhhmmssSSS_2.zip

ログの格納先をデフォルトから変更している場合は，これらのファイルに変更後のディレクトリのパスを追加する必要があります。ファイルの編集方法については，「4.7　トラブルシュート情報収集先定義ファイルの設定」を参照してください。

このコマンドで取得できるトラブルシュート情報のうち，1次資料としてデフォルトで取得される情報を次の表に示します。

表8-8　トラブルシュート情報（1次資料）

項番
トラブルシュート情報
内容

1
OSのイベントログ
システム，アプリケーション，およびセキュリティのイベントログです。

2
マシンのホスト名
OSのインストールディレクトリ¥system32¥drivers¥etc¥hosts

3
マシンのサービスとポート
OSのインストールディレクトリ¥system32¥drivers¥etc¥services

4
プロセスの一覧
tasklist /Vの実行結果です。

5
マシンのシステム情報
systeminfoの実行結果です。

6
バインド状況
netstat -aoの実行結果です。

7
NICの実装状況
ipconfig /allの実行結果です。

8
起動サービス一覧
net startの実行結果です。

9
環境変数の一覧
setの実行結果です。

10
各種設定ファイル
ナビゲーション プラットフォームのインストールディレクトリ下のディレクトリのファイルが取得されます。対象となるファイルを次に示します。

confディレクトリ以下のファイル

sysconfディレクトリ以下のファイル

libディレクトリ以下のucnpbaseversion.propertiesファイル

libディレクトリ以下のucnpsdkversion.propertiesファイル

pluginSDKディレクトリ直下のファイル

pluginSDK¥baseディレクトリ以下のファイル

setup¥logsディレクトリ以下のファイル

setup¥portalproject¥WEB-INF¥conf以下のファイル※1

C:¥ucnpwork¥portalproject¥WEB-INF¥conf以下のファイル※1

pluginSDK¥plugin¥プラグイン名ディレクトリ以下のbuild.xmlファイル

pluginSDK¥plugin¥プラグイン名¥WEB-INF¥confディレクトリ以下のioaction.xmlファイル

uCosminexus Portal Frameworkインストールディレクトリ¥confディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Server¥etcディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥etcディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥java¥etcディレクトリ以下のファイル

HiRDBインストールディレクトリ¥CONFディレクトリ以下のファイル

Cosminexusインストールディレクトリ以下の各種設定ファイル情報

11
各種ログファイル
ナビゲーション プラットフォームのインストールディレクトリ下のディレクトリのファイルが取得されます。対象となるファイルを次に示します。

logsディレクトリ以下のファイル※2

uCosminexus Portal Frameworkインストールディレクトリ¥logディレクトリ以下のファイル※3

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Server¥spoolディレクトリ以下のファイル

Cosminexusインストールディレクトリ以下の各種ログファイル情報

注※1

ここに示したのは，デフォルトのディレクトリです。デフォルトから設定を変更している場合は，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティの指定値に従って，「ナビゲーション プラットフォームインストールディレクトリ¥setup¥portalproject」の部分を読み替えてください。

注※2

ここに示したのは，デフォルトのディレクトリです。ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.pathプロパティの指定値によって，実際には異なるディレクトリが指定されていることがあります。

注※3

ここに示したのは，デフォルトのディレクトリです。ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.portal.trace.dirプロパティの指定値によって，実際には異なるディレクトリが指定されていることがあります。

このコマンドで取得できるトラブルシュート情報のうち，2次資料としてデフォルトで取得される情報を次の表に示します。

表8-9　トラブルシュート情報（2次資料）

項番
トラブルシュート情報
内容

1
レジストリの一覧
reg query HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI /sの実行結果です。
なお，64ビット版OSの場合は，HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥HITACHIの実行結果となります。

2
各種設定ファイル
Cosminexusインストールディレクトリ以下の各種設定ファイル情報

3
各種ログファイル
ナビゲーション プラットフォームのインストールディレクトリ下のディレクトリのファイルが取得されます。対象となるファイルを次に示します。

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Server¥tmpディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥spoolディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥tmpディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥java¥logディレクトリ以下のファイル

DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥java¥errlogディレクトリ以下のファイル

HiRDBインストールディレクトリ¥SPOOLディレクトリ以下のファイル

PP¥TPB¥logディレクトリ以下のファイル

Cosminexusインストールディレクトリ以下の各種ログファイル情報

形式

npsnapshotlog△トラブルシュート情報を出力するディレクトリ

ディレクトリは，絶対パス・相対パスのどちらでも指定できます。パスが長くなり過ぎないよう，200文字以内で指定することを推奨します。

また，区切り文字には「¥」を使用します。パスに半角スペースが含まれる場合は，パス全体を「"」で囲んでください。ディレクトリのパスで使用できる記号は，これら以外には半角のコロン（:）と相対パスを表す半角ピリオド（.）だけです。

注意事項

トラブルシュート情報を出力するディレクトリは，次の条件を満たしている必要があります。

200MB以上の空き容量がある。

ネットワークドライブではない。

なお，トラブルシュート情報として取得される各種ログファイルの最大出力ファイルサイズおよび最大面数をデフォルト値から増やしている場合は，200MB以上の空き容量が必要になります。

サポートサービスをご利用の場合，障害の原因を調査するために，表8-8および表8-9に出力されるトラブルシュート情報を送付していただく必要があります。送付されたトラブルシュート情報は，障害の原因調査以外の目的に使用することはありません。

戻り値

戻り値 | 説明
0 | トラブルシュート情報の取得に成功した，または警告レベルのエラーが発生してコマンドが正常に終了した。
1 | トラブルシュート情報の取得に失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

トラブルシュート情報の出力先ディレクトリが「C:¥work¥npsnapshotlog」の場合の例です。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npsnapshotlog C:¥work¥npsnapshotlog

8.10　npstartコマンド（起動）

機能

ナビゲーション プラットフォームおよび構成ソフトウェアを起動します。このコマンドは，セットアップで構築した環境で実行できます。

コマンドの実行前にデータベースのサービスが起動していることを確認してください。データベースのサービスが起動していない場合は，コマンド実行時にエラーになります。

ソフトウェアの起動順序と内容を次の表に示します。

表8-10　npstartコマンド（起動）の起動順序と内容

順序 | ソフトウェア名 | 内容
1 | Cosminexus | 運用管理エージェントの起動
2 | Cosminexus Management Serverの起動
3 | HiRDB | 組み込みデータベースの開始
4 | DocumentBroker | 文書管理サーバの起動
5 | Cosminexus | Webシステムの起動
6 | ナビゲーション プラットフォーム | ナビゲーション プラットフォームのJ2EEアプリケーションの起動

形式

npstart

オプション

なし。

注意事項

起動に失敗した場合は，npstopコマンド（停止）を実行し，要因を取り除いてからコマンドを再実行してください。

戻り値

戻り値 | 説明
0 | 起動に成功した。
1 | 起動に失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstart

8.11　npstopコマンド（停止）

機能

ナビゲーション プラットフォームおよび構成ソフトウェアを通常停止します。OSをシャットダウンする前には，必ずこのコマンドを実行してください。このコマンドは，ナビゲーション プラットフォームの起動または停止に失敗した状態で使用することもできます。なお，このコマンドは，セットアップで構築した環境で実行できます。

コマンドの実行前にデータベースのサービスが起動していることを確認してください。データベースのサービスが起動していない場合は，コマンド実行時にエラーになります。

ソフトウェアの停止順序と内容を次の表に示します。

表8-11　npstopコマンド（停止）の停止順序と内容

順序 | ソフトウェア名 | 内容
1 | Cosminexus | Webシステムの停止※
2 | Cosminexus Management Serverの停止
3 | 運用管理エージェントの停止
4 | DocumentBroker | 文書管理サーバの停止
5 | HiRDB | 組み込みデータベースの停止

注※

Webシステムを停止すると，ナビゲーション プラットフォームのJ2EEアプリケーションも停止されます。

形式

npstop

オプション

なし。

注意事項

停止に失敗した場合は，要因を取り除いてからコマンドを再実行してください。

コマンド実行時に停止済みのサーバがあった場合は，すでに停止中である旨の警告メッセージを出力して，停止処理を続行します。

通常停止は，ナビゲーション プラットフォームの構成ソフトウェアを安全に停止させる方法です。強制停止を実行したい場合は，各ソフトウェアが提供する強制停止コマンドを実行してください。
通常停止を実行後，処理中のリクエストが終了しないなどの要因で通常停止が継続できない場合に強制停止を実行すると，処理中のリクエストが終了し，通常停止を継続できるようになります。

このコマンドを実行すると，Cosminexus Management Serverも停止します。ナビゲーション プラットフォームを停止した状態でCosminexus Management Serverを利用する場合は，コマンドプロンプトから次のコマンドを実行して，Cosminexus Management Serverを起動してください。

"Cosminexusインストールディレクトリ/manager/bin/adminagentctl.exe" start
"Cosminexusインストールディレクトリ/manager/bin/mngsvrctl.exe" start

戻り値

戻り値 | 説明
0 | 停止に成功した。
1 | 停止に失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npstop

8.12　npunsetupコマンド（アンセットアップ）

機能

すべての業務コンテンツのデータを削除し，ナビゲーション プラットフォームがアンセットアップされます。このコマンドは，セットアップで構築した環境で実行できます。

コマンドの実行前にデータベースのサービスが起動していることを確認してください。データベースのサービスが起動していない場合は，コマンド実行時にエラーになります。

なお，このコマンドを実行するユーザは，ナビゲーション プラットフォームをインストールしたユーザである必要があります。

ソフトウェアのアンセットアップ順序と内容を次の表に示します。

表8-12　npunsetupコマンド（アンセットアップ）のアンセットアップ順序と内容

順序 | ソフトウェア名 | 内容
1 | uCosminexus Portal Framework | ポータルプロジェクトの削除
2 | Cosminexus | J2EEサーバの削除
3 | Webサーバの削除
4 | Cosminexus Management Serverのアンセットアップ※
5 | DocumentBroker | TPBroker環境の削除
6 | HiRDB | データベース情報の初期化
7 | ファイルシステム領域の削除

注

コマンドを実行する前に，アンセットアップ対象のサーバが停止していることを確認してください。また，検索機能をセットアップ済みの場合は，このコマンドを実行する前に検索機能をアンセットアップしてください。検索機能のアンセットアップの手順は「4.9　検索機能のアンセットアップ」を参照してください。

注※

Cosminexus Management Serverをアンセットアップすると，Webシステム（ナビゲーション プラットフォーム）も削除されます。

形式

npunsetup

オプション

なし。

注意事項

アンセットアップに失敗した場合は，要因を取り除いてからコマンドを再実行してください。

検索機能をアンセットアップしないで，このコマンドを実行してしまった場合は，検索用のHiRDBファイルシステム領域を削除する必要があります。
HiRDBファイルシステム領域の削除手順は「4.9.6(5)　HiRDBファイルシステム領域の削除」を参照してください。

戻り値

戻り値 | 説明
0 | ナビゲーション プラットフォームのアンセットアップに成功した。
1 | ナビゲーション プラットフォームのアンセットアップに失敗した。
2 | コマンドの排他エラーが発生した。
9 | 実行権限のエラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npunsetup

8.13　npupdateearコマンド（EARファイルの更新）

機能

ナビゲーション プラットフォームのEARファイルに，コマンドを実行する環境のポータル用設定ファイル（Portal Managerで設定した内容が記載されるファイル）を反映します。このコマンドは，編集環境または実行環境で，次の場合に使用します。

Portal Managerの設定を変更した場合
変更した内容をナビゲーション プラットフォームのEARファイルに反映します。

プラグインを適用する場合
開発環境から受け取った，プラグインが適用されたEARファイルに，編集環境または実行環境のPortal Managerの設定を反映します。

参考

開発環境でPortal Managerの設定を変更した場合の手順については，「5.7.2　開発環境で設定を変更した場合」を参照してください。また，開発環境にプラグインを適用する場合の手順については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド」のプラグインのビルド手順を参照してください。

形式

npupdateear△-p△ポータルプロジェクトのパス△-i△更新前のEARファイルのパス△-o△更新後のEARファイルの出力先パス[△-t△一時ディレクトリのパス]

オプション

-p ポータルプロジェクトのパス

コマンドを実行する環境のポータルプロジェクトのパスを絶対パスまたは相対パスで指定します。ポータルプロジェクトのパスは，ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.ucnp.portalproject.pathプロパティの指定値で確認してください。

-i 更新前のEARファイルのパス

ポータル用設定ファイルの内容を反映するEARファイルのパスを絶対パスまたは相対パスで指定します。

-o 更新後のEARファイルの出力先パス

ポータル用設定ファイルの内容を反映したEARファイルを出力するパスを，絶対パスまたは相対パスで指定します。EARファイルを出力するパスには，ファイルやディレクトリが存在するパスは指定しないでください。

コマンド実行時は，更新後のEARファイルだけが作成されます。ディレクトリは作成されません。このため，指定するファイルパスの親ディレクトリをあらかじめ作成しておいてください。

-t 一時ディレクトリのパス

一時ディレクトリのパスを絶対パスまたは相対パスで指定します。

コマンド実行中，ナビゲーション プラットフォームの作業ディレクトリとして，一時ディレクトリ¥ucnptempディレクトリが作成されます（コマンドが終了すると削除されます）。作業ディレクトリは更新前のEARファイルを展開するのに使用されます。したがって，一時ディレクトリには，EARファイルを展開するのに十分な空き容量があるドライブ下のディレクトリで，かつ，「ucnptemp」という名称のディレクトリやファイルが存在しないディレクトリを指定してください。

なお，環境変数「TEMP」を設定している場合，このオプションを省略できます。このオプションを省略すると，「TEMP」に設定されているディレクトリが一時ディレクトリとなります。

注意事項

更新後のEARファイルをインポートする環境と，更新前のEARファイルを作成した環境とで，ナビゲーション プラットフォームのバージョン（構成ソフトウェアを含む）を合わせてください。

コマンドのオプションに指定するパスに，Windowsの予約デバイス名，およびWindowsでファイル名やディレクトリ名に使用できない文字を含めないでください。また，ネットワークドライブを指定しないでください。

＜Ctrl＞キーと＜C＞キーを同時に押してコマンドを強制終了した場合などに，作業用ディレクトリが削除されないで残ることがあります。この場合，手動で作業用ディレクトリを削除してください。

このコマンド実行時のトレース情報は，構築時の設定に関係なく，ナビゲーション プラットフォームインストールディレクトリ¥logs¥ucnp_updateear_trace.logに出力されます。このファイルに対しては，ラップアラウンドは実施されません。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。
1 | コマンドが異常終了した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

次の条件でEARファイルを更新する場合の使用例を次に示します。

ポータルプロジェクトのパスが「C:¥Program Files¥Hitachi¥uCNP¥setup¥portalproject」である。

更新前のEARファイルのパスを「C:¥work¥input_ucnp.ear」とする。

更新後のEARファイルの出力先パスを「C:¥work¥output_ucnp.ear」とする。

一時ディレクトリのパスを「C:¥work¥temp」とする。

> ナビゲーション プラットフォームインストールディレクトリ¥bin¥npupdateear -p "C:¥Program Files¥Hitachi¥uCNP¥setup¥portalproject" -i C:¥work¥input_ucnp.ear -o C:¥work¥output_ucnp.ear -t C:¥work¥temp

8.14　npupdatesearchdataコマンド（検索用データの更新）

機能

検索機能を使用している環境で，検索用のデータを更新します。このコマンドは，組み込みデータベースおよびDocumentBroker Smart Document Managementが起動した状態で，次の場合に使用します。

編集環境で業務コンテンツを新規に作成した場合

編集環境で業務コンテンツを編集した場合

編集環境で業務コンテンツを削除した場合

実行環境または開発環境で，npimportコマンド（業務コンテンツのインポート）を実行して業務コンテンツを更新した場合

なお，このコマンドは，ナビゲーション プラットフォームで検索処理が実施されている間も実行できます。

形式

npupdatesearchdata△-u△データベースの認可識別子△-p△認可識別子に対応するパスワード

オプション

-u データベースの認可識別子

検索機能用のデータベースに接続する認可識別子を指定します。認可識別子に英小文字を含む場合は，「¥"dbUserId¥"」のように「¥"」で囲みます。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.idプロパティの値を指定してください。

指定した認可識別子でデータベースにアクセスできない場合は，データベースへの接続に失敗したことを示すメッセージが出力され，異常終了します。

-p 認可識別子に対応するパスワード

検索機能用のデータベースに接続する認可識別子に対応するパスワードを指定します。パスワードに英小文字を含む場合は，「¥"dbPassword¥"」のように「¥"」で囲みます。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.db.user.passwordプロパティの値を指定してください。

指定したパスワードでデータベースにアクセスできない場合は，データベースへの接続に失敗したことを示すメッセージが出力され，異常終了します。

トレースファイル

このコマンドを実行すると，次に示すトレースファイルが出力されます。

出力先ディレクトリ

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.pathプロパティに指定したディレクトリ

ファイル名

ucnp_search_trace[N].log（[N]：ファイル面数）

サイズ

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.sizeプロパティに指定したサイズ

面数

ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.backup.numberプロパティに指定した面数

内容

コマンドが出力するメッセージ

処理の開始／終了情報

エラー発生時のエラー情報

なお，トレースが初期化される前にエラーが発生した場合は，標準エラー出力に出力され，トレースには出力されません。

このトレースファイルのほかに，ユーザプロパティファイル（ucnp_user.properties）のucnp.base.server.trace.pathプロパティで指定したディレクトリ直下にある，searchディレクトリに保守用のトレースが出力されることがあります。ナビゲーション プラットフォームの運用中にトラブルが発生した場合のお問い合わせには，このトレースファイルと保守用のトレースを合わせて送付してください。なお，searchディレクトリはコマンド実行時に作成されます。

注意事項

npimportコマンド（業務コンテンツのインポート）の実行中に，このコマンドを実行しないでください。実行すると，業務コンテンツと検索用データの整合性が取れなくなることがあります。その場合，npimportコマンド（業務コンテンツのインポート）が終了したあと，もう一度このコマンドを実行してください。

このコマンドの実行中に，業務編集画面を使用して業務コンテンツを追加，更新，または削除しないでください。
このコマンド実行中に更新対象の検索用データを含む業務コンテンツが削除された場合，検索用データの更新に失敗したことを示すメッセージが出力されて，異常終了することがあります。また，このコマンドが正常に終了しても，業務コンテンツと検索用データの整合性が取れなくなることがあります。その場合，業務コンテンツの更新が終了したあと，もう一度このコマンドを実行してください。
なお，npimportコマンド（業務コンテンツのインポート）に-dオプションを指定すると，業務コンテンツが削除されます。

コマンドが異常終了して出力されるメッセージの詳細情報にKFPA11920-Eメッセージが出力されている場合は，検索機能用のRDエリアが閉塞しています。その場合は，次のコマンドを実行してRDエリアの閉塞状態を解除してから，コマンドを再実行してください。

pdrels -r UCNP_SEARCH_RD_DATA,UCNP_SEARCH_RD_XMLIDX,UCNP_SEARCH_RD_CONTENTIDIDX

更新する検索用データが多い場合，コマンドの実行に数分掛かる場合があります。

戻り値

戻り値 | 説明
0 | コマンドが正常終了した。
1 | コマンドが異常終了した。
2 | コマンドの排他エラーが発生した。
9 | コマンドの実行権限エラーが発生した。

注

コマンド制御外のタイミングで終了した場合（＜Ctrl＞キーと＜C＞キーを同時に押して強制終了した場合など）の戻り値は不定となります。

使用例

次の条件で検索用データを更新する場合の使用例を次に示します。

データベースの認可識別子を「ADMIN」とする。

パスワードを「UCNPPASS」とする。

npupdatesearchdata -u ADMIN -p UCNPPASS

9.　トラブルシューティング

この章では，ナビゲーション プラットフォームの使用時に発生するトラブルと対処について説明します。また，トラブルが発生したときに取得するファイルについても説明します。

＜この章の構成＞

9.1　インストール，セットアップ中に発生するトラブル

9.2　運用開始後に発生するトラブル

9.3　トレースファイルの出力先

9.1　インストール，セットアップ中に発生するトラブル

ナビゲーション プラットフォームのインストール，およびセットアップ中にトラブルが発生した場合は，次に説明する内容に従って対処してください。

＜この節の構成＞

9.1.1　正しくインストールされなかったというメッセージが表示された場合の対処

9.1.2　インストールに失敗したというメッセージが表示された場合の対処

9.1.3　インストール処理に時間が掛かる場合の対処

9.1.4　ファイアウォールでブロックされているというメッセージが表示された場合の対処

9.1.5　セットアップ後に起動エラーが発生する場合の対処

9.1.1　正しくインストールされなかったというメッセージが表示された場合の対処

構成ソフトウェアのインストール中に，「このプログラムは正しくインストールされなかった可能性があります」というメッセージがダイアログに表示され，インストールに失敗する場合の要因と対処について説明します。

要因

管理者権限を持たないユーザでインストールを実行しています。

対処

次の手順で構成ソフトウェアをインストールし直してください。

ダイアログの［キャンセル］ボタンをクリックし，インストーラを終了する。

ナビゲーション プラットフォームをアンインストールする。

OSによって次の操作を実行する。
Windows XPの場合：Windowsの管理者権限があるユーザでログインする。
Windows XP以外のOSの場合：［管理者として実行］を選択する。

ナビゲーション プラットフォームを再度インストールする。

インストールおよびアンインストールの詳細については，「3.　ナビゲーション プラットフォームのセットアップの準備」を参照してください。

9.1.2　インストールに失敗したというメッセージが表示された場合の対処

構成ソフトウェアのインストール中に，「HiRDB Embedded Serverのインストールに失敗しました。」というメッセージがダイアログに表示され，インストールに失敗する場合の要因と対処について説明します。

要因

次のどちらかの要因が考えられます。

Windows Firewallのサービスが停止している。

インストールドライブの直下にProgramというフォルダまたはファイルが存在している。

対処

次のとおり対処してください。

次のどちらかのサービスが停止していないかどうかを確認し，停止していたら起動する。
Windows Firewall/Internet Connection Sharing (ICS)
Windows Firewall

インストールドライブの直下にProgramというフォルダまたはファイルが存在するかどうかを確認し，存在している場合は退避または削除する。

9.1.3　インストール処理に時間が掛かる場合の対処

構成ソフトウェアのインストール中に，進行状況を示すダイアログのバーの表示が進まなくなることがあります。インストールする環境によっては，特定の構成ソフトウェアのインストールに時間が掛かることがあるので，そのままインストールを続けてください。

9.1.4　ファイアウォールでブロックされているというメッセージが表示された場合の対処

npsetupコマンド（セットアップ）の実行中に，「このプログラムの機能の幾つかがWindowsファイアウォールでブロックされています」という警告メッセージがダイアログに表示される場合があります。

この場合の要因と対処について説明します。

要因

Windowsファイアウォールを有効にしている環境では，構成ソフトウェアの機能の一部がファイアウォールによってブロックされて，使用できないことがあります。

対処

ダイアログの［アクセスを許可する］ボタンをクリックして，ブロックを解除してください。

9.1.5　セットアップ後に起動エラーが発生する場合の対処

ナビゲーション プラットフォームを起動すると，エラーメッセージ（KDCZ58409-EおよびKEOS24124-E）が出力されて起動に失敗する場合があります。

自動起動のとき

ナビゲーション プラットフォームの画面にアクセスすると，404エラーが表示される

トレースファイル（ucnp_setup_trace[N].log）にエラーメッセージ（KDCZ58409-EおよびKEOS24124-E）が出力される

npstartコマンド（起動）を実行して起動したとき

コマンドプロンプトにエラーメッセージ（KDCZ58409-EおよびKEOS24124-E）が出力される

トレースファイル（ucnp_setup_trace[N].log）にエラーメッセージ（KDCZ58409-EおよびKEOS24124-E）が出力される

この場合の要因と対処について説明します。

要因

ucnp.setup.server.cosminexus.hws.http.portプロパティの値をデフォルト値の「80」に設定している場合，ほかのWebサーバなどとポート番号が重複していることがあります。

対処

ほかのWebサーバのポート番号を変更するか，またはナビゲーション プラットフォームのポート番号をデフォルトから変更してください。

それぞれの対処の詳細を次に示します。

ほかのWebサーバのポート番号を変更する場合

次の手順でナビゲーション プラットフォームと重複しているほかのWebサーバのポート番号を変更できます。

npunsetupコマンド（アンセットアップ）を実行する。

重複しているポート番号を使用しているプロセスを，netstatコマンドなどで特定する。

特定したプロセスを終了させて，ほかのWebサーバのポート番号を変更する。

npsetupコマンド（セットアップ）を再度実行する。

ナビゲーション プラットフォームのポート番号を変更する場合

次の手順でナビゲーション プラットフォームのポート番号を変更できます。

npunsetupコマンド（アンセットアップ）を実行する。

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のucnp.setup.server.cosminexus.hws.http.portプロパティを変更する。

npsetupコマンド（セットアップ）を再度実行する。

なお，ポート番号を変更するとURLが変更になります。URLについての詳細は「2.1.3　ナビゲーション プラットフォームの画面にアクセスするためのURL」を参照してください。

9.2　運用開始後に発生するトラブル

ナビゲーション プラットフォームの運用開始後にトラブルが発生した場合は，次の情報を参照してください。

標準出力，標準エラー出力，またはトレースファイルに出力されたメッセージ

トレースファイル

npsnapshotlogコマンド（トラブルシュート情報の収集）で取得する情報

npsnapshotlogコマンドで取得する情報は，1次資料と2次資料に分類できます。

1次資料

トラブルの概要を把握するためのログと，システムの主要な設定ファイルが含まれます。簡単なトラブルであれば，1次資料だけで対処できます。

なお，1次資料にはユーザ情報が記述されている次のファイルも含まれます。

マシンのシステム情報およびシステムファイル

ナビゲーション プラットフォームの各種設定ファイル（データベースやCosminexus Management ServerのユーザID，パスワードなどの情報を含む）

2次資料

レジストリ情報や，1次資料では取得されないシステムの詳細な設定ファイルが含まれます。1次資料だけでは解決できない，難易度の高いトラブルの場合は，2次資料も活用します。

メッセージの出力先，要因，および対処については，マニュアル「Cosminexus V9 ナビゲーション プラットフォーム メッセージ」を参照してください。

トレースファイルの出力先については，「9.3　トレースファイルの出力先」を参照してください。

また，npsnapshotlogコマンドの使用方法については，「8.9　npsnapshotlogコマンド（トラブルシュート情報の収集）」を参照してください。

注意事項

新規またはバージョンアップのセットアップに失敗した場合など，ナビゲーション プラットフォームが未セットアップの状態でnpsnapshotlogコマンドを使用するときは，コマンド実行前に次のことを実施する必要があります。

次に示す環境変数を設定する。

COSMINEXUS_HOME
Cosminexusインストールディレクトリ

ECMPKG_HOME
DocumentBroker Smart Document Managementインストールディレクトリ

PORTAL_INSTALLDIR
uCosminexus Portal Frameworkインストールディレクトリ

UCNP_HOME
ナビゲーション プラットフォームインストールディレクトリ

TPDIR
Cosminexusインストールディレクトリ¥TPB

JAVA_HOME
Cosminexusインストールディレクトリ¥jdk

DOCB_LIB
DocumentBroker Smart Document Managementインストールディレクトリ¥PP¥Runtime¥java¥lib¥Djlib.jar

トラブルシュート情報収集先定義ファイルをコピーする。

コピー元ファイル
ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnpsnapshotlog.conf
ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnpsnapshotlog.2.conf
ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnpsystorusnapshotconf.conf
ナビゲーション プラットフォームインストールディレクトリ¥sample¥conf¥ucnpsystorusnapshotlog.conf

コピー先ディレクトリ
ナビゲーション プラットフォームインストールディレクトリ¥conf

なお，すでにファイルが存在する場合は，上書きしないでください。

9.3　トレースファイルの出力先

トレースファイルの出力先とファイル名を次に示します。出力先のパスにある[N]は，ファイル面数を示します。

ナビゲーション プラットフォームのJ2EEサーバのトレースファイル
ucnp.base.server.trace.pathプロパティで指定したディレクトリ¥ucnp_trace[N].log

npaclexportコマンド（アクセス権グループのエクスポート），npexportコマンド（業務コンテンツのエクスポート）およびnpimportコマンド（業務コンテンツのインポート）のトレースファイル
ucnp.base.server.trace.pathプロパティで指定したディレクトリ¥ucnp_cmd_trace[N].log

npupdatesearchdataコマンド（検索用データの更新）のトレースファイル
ucnp.base.server.trace.pathプロパティで指定したディレクトリ¥ucnp_search_trace[N].log

セットアップとアンセットアップで使用するコマンドのトレースファイル
ナビゲーション プラットフォームインストールディレクトリ¥logs¥ucnp_setup_trace[N].log
このトレースファイルには，npsetupコマンド（セットアップ），npstartコマンド（起動），npstopコマンド（停止），およびnpunsetupコマンド（アンセットアップ）の実行結果が出力されます。セットアップ後のシステム自動起動のトレースもこのファイルに出力されます。

npenvupdateコマンド（環境更新）のトレースファイル
ナビゲーション プラットフォームインストールディレクトリ¥logs¥ucnp_migrate_trace.log

npupdateearコマンド（EARファイルの更新）のトレースファイル
ナビゲーション プラットフォームインストールディレクトリ¥logs¥ucnp_updateear_trace.log

npsetenvコマンド（環境変数の設定）のトレースファイル
ナビゲーション プラットフォームインストールディレクトリ¥logs¥ucnp_setenv_trace.log

npsnapshotlogコマンド（トラブルシュート情報の収集）のトレースファイル
トラブルシュート情報の出力先ディレクトリ（コマンドで指定したディレクトリ）¥npsnapshotlog_yyyyMMddhhmmssSSS.log

そのほかのトレースファイル
ナビゲーション プラットフォームインストールディレクトリ¥logs

付録

＜この付録の構成＞

付録A　検索の対象となる項目

付録B　このマニュアルの参考情報

付録C　用語解説

付録A　検索の対象となる項目

業務コンテンツの検索機能を使用する場合，業務フローの名称および業務編集画面の［属性の設定］画面で設定した項目の一部を検索できます。編集中グループの業務コンテンツも含め，すべての業務コンテンツの項目が検索の対象となります。

業務編集画面で設定した項目が検索の対象となるかどうかを，領域ごとに次の表に示します。

表A-1　業務編集画面での設定項目一覧（メニュー領域）

項番 | メニュー名 | 項目名 | 検索の対象かどうか
1 | 名称変更 | 業務コンテンツの名称 | ○
2 | グループ変更 | グループ名 | ×
3 | リンク設定 | アンカーの文字列 | ○
URL | ×

（凡例）

○：検索の対象となる（ガイド外としてヒットする）

×：検索の対象外

表A-2　業務編集画面での設定項目一覧（フロー領域）

項番 | パーツ名 | 項目名 | 検索の対象かどうか
1 | ターミナルノード | ノードの名称 | ○※1
2 | ノードID | ×
3 | 前のノードの「完了」ボタンの名称 | ×
4 | 前面／背面の並び順 | ×
5 | プロセスノード | ノードの名称 | ×※2
6 | ノードID | ×
7 | このノードの「戻る」ボタンの名称 | ×
8 | 前のノードの「次へ」ボタンの名称 | ×
9 | 画像URL | ×
10 | 前面／背面の並び順 | ×
11 | 分岐合流ノード | ノードの名称 | ○※3
12 | ノードID | ×
13 | 前面／背面の並び順 | ×
14 | 画像 | URL | ×
15 | ツールチップ | ×
16 | 前面／背面の並び順 | ×
17 | 固定テキスト | 表示文字列 | ○※3
18 | 文字列の色 | ×
19 | 文字のサイズ（px） | ×
20 | 前面／背面の並び順 | ×

（凡例）

○：検索の対象となる（ガイド外としてヒットする）

×：検索の対象外

注※1

設定によってフロー領域が表示されていない場合は，検索の対象外となります。また，フロー領域が表示されている場合でも，設定によってターミナルノードが表示されていない場合は，検索の対象外となります。

注※2

プロセスノードの名称としては検索の対象外ですが，ガイド領域のガイド名称として検索対象となります。詳細は表A-3を参照してください。

注※3

フロー領域を表示しない設定になっている場合は，検索の対象外となります。

表A-3　業務編集画面での設定項目一覧（ガイド領域）

項番 | パーツ名 | 項目名 | 検索の対象かどうか
1 | ガイド名称※ | － | ○
2 | 固定テキスト | 表示文字列 | ○
3 | 文字列の色 | ×
4 | 文字のサイズ（px） | ×
5 | 画像 | URL | ×
6 | ツールチップ | ×
7 | テキストボックス | 最大入力文字数 | ×
8 | 初期値 | ○
9 | 入力規則 | ×
10 | エラーメッセージ | ×
11 | テキストエリア | 初期値 | ○
12 | 入力規則 | ×
13 | エラーメッセージ | ×
14 | チェックボックス | 表示文字列 | ○
15 | ラジオボタン | 表示文字列 | ○
16 | 値 | ×
17 | グループ名 | ×
18 | ドロップダウン | ガイドパーツID | ×
19 | 親のガイドパーツID | ×
20 | 親の値 | ×
21 | ［選択項目一覧］テキストボックスの上段：ラベル | ○
22 | ［選択項目一覧］テキストボックスの下段：値 | ×
23 | ハイパーリンク | アンカーの文字列 | ○
24 | URL | ×
25 | ツールチップ | ×
26 | インラインフレーム | URL | ×
27 | HTMLパーツ | HTMLソース文字列 | ×
28 | 検索キーワード | ○

（凡例）

○：検索の対象となる（ガイド内としてヒットする）

×：検索の対象外

－：該当しない

注※

ガイド名称とは，プロセスノードのノード名称として設定された値のことです。

付録B　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

＜この節の構成＞

付録B.1　関連マニュアル

付録B.2　このマニュアルでの表記

付録B.3　英略語

付録B.4　KB（キロバイト）などの単位表記について

付録B.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

＜この項の構成＞

(1)　ナビゲーション プラットフォームのマニュアル

(2)　構成ソフトウェアのマニュアル

(3)　関連ソフトウェアのマニュアル

(1)　ナビゲーション プラットフォームのマニュアル

ナビゲーション プラットフォームのマニュアルを次に示します。

Cosminexus V9 ナビゲーション プラットフォーム 導入から運用まで（3020-3-V40）
このマニュアルです。ナビゲーション プラットフォームの概要，機能，構築，および運用について説明しています。
ナビゲーション プラットフォームの使用に当たっては，このマニュアルを最初にお読みください。

Cosminexus V9 ナビゲーション プラットフォーム コンテンツ作成ガイド（3020-3-V41）
ナビゲーション プラットフォームを使用して業務コンテンツを作成，変更，削除したり，コンテンツのアクセス権を管理したりする方法について説明しています。

Cosminexus V9 ナビゲーション プラットフォーム 開発ガイド（3020-3-V42）
ナビゲーション プラットフォームのプラグインおよびカスタム画面を開発する方法について説明しています。

Cosminexus V9 ナビゲーション プラットフォーム メッセージ（3020-3-V43）
ナビゲーション プラットフォームを使用しているときに出力されるメッセージについて説明しています。

(2)　構成ソフトウェアのマニュアル

ナビゲーション プラットフォームの構成ソフトウェアのマニュアルを次に示します。

uCosminexus Portal Framework システム管理者ガイド（3020-3-H71）
uCosminexus Portal Frameworkの機能概要，およびポータルの構築方法と管理方法について説明しています。

Cosminexus V9 アプリケーションサーバ システム構築・運用ガイド（3020-3-Y02）
アプリケーションサーバを導入してシステムを構築・運用する方法について説明しています。

Cosminexus V9 アプリケーションサーバ システム設計ガイド（3020-3-Y04）
マニュアル「Cosminexus V9 アプリケーションサーバ システム構築・運用ガイド」で説明しているシステム構成以外の構成でシステムを構築・運用したい場合に参照するマニュアルです。
システムの目的に応じたシステム構成や運用方法を検討するための指針について説明しています。また，チューニングの方法についても説明しています。

Cosminexus V9 アプリケーションサーバ 機能解説 拡張編（3020-3-Y08）
アプリケーションサーバの機能の詳細について，アプリケーションの実装方法や実行環境で必要な設定などを含めて解説しています。
このマニュアルでは，アプリケーションサーバ独自の拡張機能について説明しています。

Cosminexus V9 アプリケーションサーバ 機能解説 セキュリティ管理機能編（3020-3-Y09）
アプリケーションサーバの機能の詳細について，アプリケーションの実装方法や実行環境で必要な設定などを含めて解説しています。
このマニュアルでは，アプリケーションサーバを中心としたシステムのセキュリティを確保するための機能について解説しています。また，セキュリティを確保するためのシステム構成や運用方法についても説明しています。

Cosminexus V9 アプリケーションサーバ 機能解説 保守／移行編（3020-3-Y11）
アプリケーションサーバの機能の詳細について，アプリケーションの実装方法や実行環境で必要な設定などを含めて解説しています。
このマニュアルでは，トラブルが発生した場合のシステム保守に必要な機能，および製品のバージョンアップに伴うシステムの移行について説明しています。

Cosminexus V9 アプリケーションサーバ 運用管理ポータル操作ガイド（3020-3-Y14）
運用管理ポータルの画面および操作について説明しています。

Cosminexus V9 アプリケーションサーバ リファレンス コマンド編（3020-3-Y15）
システムを構築・運用するとき，またはアプリケーションを開発するときに使用するコマンドについて説明しています。

Cosminexus V9 アプリケーションサーバ リファレンス 定義編(サーバ定義)（3020-3-Y16）
システムを構築・運用するとき，またはアプリケーションを開発するときに使用するファイルの定義方法について説明しています。
このマニュアルでは，J2EEサーバやManagement Serverなどのサーバの定義に使用するファイルについて説明しています。

Cosminexus V9 アプリケーションサーバ Cosminexus HTTP Server（3020-3-Y18）
Cosminexus HTTP Server（Webサーバ）の構築，管理方法について説明しています。

Cosminexus V9 アプリケーションサーバ アプリケーション開発ガイド（3020-3-Y20）
アプリケーションの開発方法について説明しています。また，開発環境のセットアップ方法についても説明しています。

スケーラブルデータベースサーバ HiRDB Version 8 システム運用ガイド（Windows(R)用）（3020-6-354）
HiRDBのシステム運用方法について説明しています。

スケーラブルデータベースサーバ HiRDB Version 8 SQLリファレンス（3020-6-357）
HiRDBのデータベース操作に使用する，SQLの文法について説明しています。

(3)　関連ソフトウェアのマニュアル

ナビゲーション プラットフォームの関連ソフトウェアのマニュアルを次に示します。なお，このマニュアルの本文中では「JP1 Version 10」を省略して表記しています。

JP1 Version 10 JP1/Base 運用ガイド（3021-3-001）
JP1/Baseによるユーザ認証を導入する場合に必要なJP1/Baseの運用方法について説明しています。

JP1 Version 10 JP1/Base メッセージ（3021-3-002）
JP1/Baseで出力されるメッセージについて説明しています。

JP1 Version 10 JP1/Integrated Management - Manager 導入・設計ガイド（3021-3-007）
JP1/IMを使ったシステムと連携する場合に必要なJP1/IMの導入・設計方法について説明しています。

JP1 Version 10 JP1/Integrated Management - Manager 運用ガイド（3021-3-009）
JP1/IMを使ったシステムと連携する場合に必要なJP1/IMの運用方法について説明しています。

JP1 Version 10 JP1/Integrated Management - Manager コマンド・定義ファイルリファレンス（3021-3-011）
JP1/IMを使ったシステムと連携する場合に必要なJP1/IMのコマンドの使用方法について説明しています。

JP1 Version 10 JP1/Integrated Management - Service Support 操作ガイド（3021-3-019）
JP1/IM-SSを使ったシステムと連携する場合に必要なJP1/IM-SSの運用方法について説明しています。

JP1 Version 10 JP1/Automatic Operation 画面・コマンドリファレンス（3021-3-084）
JP1/AOを使ったシステムと連携する場合に必要なJP1/AOのコマンドの使用方法について説明しています。

JP1 Version 10 JP1/Audit Management - Manager 構築・運用ガイド（3021-3-165）
監査ログの参照時に必要なJP1/Audit Management - Managerの運用方法について説明しています。

付録B.2　このマニュアルでの表記

このマニュアルでは，製品名，構成ソフトウェア，および構成ソフトウェアの機能の正式名称を次のように表記しています。

表記 | 正式名称
Cosminexus | uCosminexus Application Server
uCosminexus Developer
DABroker Library | Cosminexus DABroker Library
DocumentBroker | uCosminexus DocumentBroker Server Version 3
DocumentBroker Runtime | uCosminexus DocumentBroker Runtime Version 3
DocumentBroker Smart Document Management | DocumentBroker Version 3 Smart Document Management
HiRDBまたは組み込みデータベース | HiRDB Embedded Server Version 8
JP1/AO | JP1/Automatic Operation
JP1/IM | JP1/IM-M | JP1/Integrated Management - Manager
JP1/IM-V | JP1/Integrated Management - View
JP1/IM-SS | JP1/Integrated Management - Service Support
Oracle Directory Server | Oracle Directory Server Enterprise Edition 11.0
PRF | Cosminexus Performance Tracer
TPBroker | Cosminexus TPBroker
インテル Core2 Duo | インテル Core2 Duoプロセッサー

付録B.3　英略語

このマニュアルで使用する英略語を次に示します。

英略語 | 英字での表記
ACI | Access Control Information
ASCII | American Standard Code for Information Interchange
EAR | Enterprise ARchive
FAT | File Allocation Table
J2EE | Java 2 Platform, Enterprise Edition
JAAS | Java Authentication and Authorization Service
JAR | Java ARchive
JavaVM | Java Virtual Machine
JDK | Java Development Kit
JIS | Japanese Industrial Standards
JSP | Java Server Pages
LDAP | Lightweight Directory Access Protocol
RMI | Remote Method Invocation
SHA | Secure Hashing Algorithm
URI | Uniform Resource Identifier
URL | Uniform Resource Locator
UTC | Universal Time Coordinated
UTF | UCS Transformation Format
VM | Virtual Machine
WAR | Web ARchive
WOW64 | Windows On Windows 64

付録B.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録C　用語解説

英字｜ア行｜カ行｜サ行｜タ行｜ナ行｜ハ行｜ヤ行

英字

Cosminexus Management Server

構成ソフトウェアであるuCosminexus Application ServerまたはuCosminexus Developerの機能です。アプリケーションサーバやWebサーバの運用を管理します。

HiRDB

このマニュアルでは，構成ソフトウェアであるDocumentBroker Smart Document Managementに含まれているHiRDB Embedded Server Version 8のことを指します。組み込みデータベースと表記する場合もあります。

HiRDB/Single Server

ナビゲーション プラットフォームと同じマシンで運用されるデータベースです。プラグインや外部システムによって利用されます。

HiRDB/Single Serverは，構成ソフトウェアに含まれている組み込みデータベースとは別にインストールおよびセットアップする必要があります。

JP1/AO

JP1/AOとは，JP1製品のJP1/Automatic Operationの略です。高度化・複雑化するシステム運用を自動化するための製品です。

JP1/AO URL出力プラグイン

JP1/AOのURLを取得して，業務コンテンツからJP1/AOのメイン画面または［サービス実行］ダイアログボックスにアクセスするために，ナビゲーション プラットフォームが提供しているプラグインです。

JP1/AOサービス実行プラグイン

業務コンテンツからJP1/AOのサービスを即時実行するために，ナビゲーション プラットフォームが提供しているプラグインです。

JP1/Base

イベントサービス機能を提供するプログラムです。ナビゲーション プラットフォームでは，ユーザ認証にJP1/Baseを使用します。

JP1/IM-M

JP1/IM-Mとは，JP1製品のJP1/Integrated Management - Managerの略です。システム全体の一元的な監視と操作を実現し，システムを統合管理するためのプログラムです。なお，このマニュアルではJP1/IM-MとJP1/IM-Vを総称してJP1/IMと呼びます。

JP1/IM-SS

JP1/IM-SSとは，JP1製品のJP1/Integrated Management - Service Supportの略です。ITIL（ITインフラストラクチャ・ライブラリ）の考えに基づき，ITサービス管理でのサービスサポートに沿った運用の負荷軽減，効率向上を目的として開発された製品です。

JP1/IM-SS URL出力プラグイン

JP1/IM-SSのURLを取得して，業務コンテンツからJP1/IM-SSの案件をプレビューする画面または［案件編集］画面にアクセスするために，ナビゲーション プラットフォームが提供しているプラグインです。

JP1/IM-V

JP1/IM-Vとは，JP1製品のJP1/Integrated Management - Viewの略です。JP1/IMでのシステム統合管理を実現するためのビューアー機能を提供するプログラムです。JP1/IM-Mに接続し，システムの監視や管理をします。

JP1イベント情報出力プラグイン

JP1/IMまたはJP1/IM-SSが管理しているイベントIDやプロダクト名などのJP1イベント情報を表示するために，ナビゲーション プラットフォームが提供しているプラグインです。

JP1イベント対処状況変更プラグイン

JP1/IMが管理しているJP1イベントの対処状況を変更するために，ナビゲーション プラットフォームが提供しているプラグインです。

JP1連携プラグイン

JP1/IMやJP1/AOなどのJP1製品とデータをやり取りして，業務コンテンツと外部プログラムであるJP1製品を相互に連携するために，ナビゲーション プラットフォームが提供しているプラグインです。

Webサーバ

Webブラウザからのリクエスト受信，およびWebブラウザへのデータ送信に関連する処理を実行するサーバです。ナビゲーション プラットフォームの構成ソフトウェアであるuCosminexus Application ServerまたはuCosminexus Developerが，Webサーバの役割を持ちます。

ア行

アプリケーションサーバ

Webブラウザからのユーザの操作を処理し，データベースなどの業務システムに反映させるためのサーバです。ナビゲーション プラットフォームの構成ソフトウェアであるuCosminexus Application ServerまたはuCosminexus Developerが，アプリケーションサーバの役割を持ちます。

インポート

エクスポートされたデータを自環境に取り込むことです。

業務コンテンツ，およびアクセス権の設定情報をインポートできます。

エクスポート

業務コンテンツ，およびアクセス権の設定情報をZIP形式で出力することです。エクスポートしたデータは，ほかの環境にインポートできます。

カ行

ガイド

業務コンテンツのうち，業務で実施する個々の作業の説明のことです。

ガイドパーツ

ガイドを作成するための部品です。［Guide］パレットから選択して，ガイド領域に配置します。

開発環境

プラグインを開発するための環境です。uCosminexus Navigation Developerが必要です。

業務コンテンツ

業務を遂行するために必要な情報のことです。業務コンテンツは，ナビゲーション プラットフォームの画面で作成，表示できます。

業務実行画面

業務コンテンツを利用して業務を実行するための画面です。

業務フロー

業務コンテンツのうち，業務の流れをフローチャート化した図のことです。

業務編集画面

ナビゲーション プラットフォームで，次の操作を実施するための画面です。

業務コンテンツの作成・変更・複製・削除

入出力プラグインの関連づけ

業務コンテンツに対するアクセス権の設定

組み込みデータベース

このマニュアルでは，構成ソフトウェアであるDocumentBroker Smart Document Managementに含まれているHiRDB Embedded Server Version 8のことを指します。HiRDBと表記する場合もあります。

コンテンツ管理者

業務コンテンツに対して管理者のアクセス権を持つユーザのことです。

コンテンツ編集者

業務コンテンツに対して編集者のアクセス権を持つユーザのことです。

サ行

システムプラグイン

外部プログラムまたはガイドパーツ間の連携に必要なプラグインのうち，ナビゲーション プラットフォームが提供しているプラグインのことです。

実行環境

業務コンテンツを利用して業務を実行する際に，利用者のアクセス先となる環境です。uCosminexus Navigation Platformが必要です。

セットアップ

ナビゲーション プラットフォームのコマンドを使用したセットアップのことです。簡単な手順でナビゲーション プラットフォームをセットアップできます。

タ行

ターミナルノード

業務の開始または終了を表すノードです。業務フローの最初と最後に配置します。ナビゲーション プラットフォームの画面では，丸で表示されます。

中断再開プラグイン

利用者が業務の途中にほかの業務を参照したり，ログアウトしたりしても，一時保存した状態から業務を再開できるようにするために必要なプラグインです。

中断情報

中断再開プラグインを使用している環境で，利用者が画面操作を中断したときに，一時保存される情報です。画面操作を再開すると，中断情報が復元されます。

ディレクトリサーバ

LDAP認証に必要なユーザID，パスワードなどのユーザ情報を管理するサーバです。ナビゲーション プラットフォームでは，Active DirectoryまたはOracle Directory Serverを使用できます。

データストアプラグイン

ガイドパーツ間でデータをやり取りするために，ナビゲーション プラットフォームが提供しているプラグインです。

ナ行

ナビゲーション プラットフォーム

uCosminexus Navigation Platform，uCosminexus Navigation Platform - User License，uCosminexus Navigation Platform - Authoring License，uCosminexus Navigation Developerの総称です。

入出力プラグイン

ナビゲーション プラットフォームの画面に入力された情報を処理したり，画面に出力する情報を決定したりするためのプラグインです。入出力プラグインを使用すると，ガイドに入力された値の整合性をチェックしたり，外部プログラムへ出力したり，ログとして記録したりできます。

ノード

業務の工程を表す部品であり，業務フローに表示されます。ノードには，ターミナルノード，プロセスノード，および分岐合流ノードの3種類があります。

ハ行

パーツ

ナビゲーション プラットフォームの画面に配置する部品です。

プラグイン

ナビゲーション プラットフォームと外部プログラムとを連携したり，ナビゲーション プラットフォームの拡張機能を使用したりするためのユーザプログラムです。ナビゲーション プラットフォームでは，プラグインを開発するために必要なインタフェースを提供しています。

プラグインパーツ

業務コンテンツにプラグインを関連づけるための部品です。［Plugins］パレットから選択して，ガイド領域に配置します。

フローパーツ

業務フローを作成するための部品です。［Flow］パレットから選択して，フロー領域に配置します。

プロセスノード

業務の途中の工程を表すノードです。ターミナルノードの間には1個以上のプロセスノードが必要です。画面上では長方形で表示されます。

分岐合流ノード

業務の工程が分岐する場合に必要なノードです。ナビゲーション プラットフォームの画面では，ひし形で表示されます。

文書管理サーバ

業務コンテンツ，およびアクセス権の設定情報を管理するサーバです。ナビゲーション プラットフォームのデータベースサーバとしての機能も含みます。

ナビゲーション プラットフォームの構成ソフトウェアであるDocumentBroker Version 3 Smart Document Managementが，文書管理サーバの役割を持ちます。

編集環境

業務コンテンツを作成，編集したり，業務コンテンツに対するアクセス権を設定したりするための環境です。uCosminexus Navigation Platform - Authoring Licenseが必要です。

ポータル用設定ファイル

構成ソフトウェアであるuCosminexus Portal Frameworkのファイルです。ディレクトリサーバ，およびデータベースサーバとの連携に必要な情報を定義します。

ヤ行

ユーザセットアッププロパティファイル

セットアップを実行する場合に，セットアップ情報を定義するファイルです。ディレクトリサーバとの連携に必要な情報やポート番号などを定義します。

ユーザプラグイン

ナビゲーション プラットフォームが提供するAPIを使用して，開発者が開発したプラグインのことです。

ユーザプロパティファイル

ナビゲーション プラットフォームの動作環境を定義するファイルです。ナビゲーション プラットフォームのシステム管理者権限を持つユーザID，画面の見映えに関する情報，トレース情報などを定義します。

ユーザメッセージプロパティファイル

業務実行画面で業務コンテンツを操作しているとき，または操作を終了するときに表示されるメッセージを定義するファイルです。

索引

[数字]
[Ａ][Ｃ][Ｄ][Ｅ][Ｈ][Ｉ][Ｊ][Ｋ][Ｎ][Ｐ][Ｒ][Ｕ][Ｗ]
[ア行][カ行][サ行][タ行][ナ行][ハ行][マ行][ヤ行][ラ行]

(数字)

1次資料〔トラブルシュート情報〕

1次資料のファイル

2次資料〔トラブルシュート情報〕

2次資料のファイル

(英字)

(Ａ)

Active Directoryで管理するユーザを作成する手順

Active Directoryの接続パスワードを変更した場合の設定変更の流れ

Active Directory用のグループを作成する手順

Active Directory用の所属グループを設定する手順

Active Directoryをインストールする手順

(Ｃ)

Cosminexus HTTP Serverがリクエストを受け付けるポート番号

Cosminexus Management Server〔用語解説〕

Cosminexusのサーバ機能が使用するポート番号

CSVファイルの格納ディレクトリの絶対パス〔ドロップダウン一括設定〕

(Ｄ)

DocumentBrokerサーバ

DocumentBrokerサーバのDBコネクションプール数

DocumentBrokerサーバのサービスプロセス数

(Ｅ)

EARファイル〔ナビゲーション プラットフォーム〕

EARファイルの更新〔コマンド〕

EARファイルの更新手順

(Ｈ)

HiRDB〔用語解説〕

HiRDB/Single Server〔用語解説〕

HTMLパーツで使用するCSSファイルのパス

HTMLマニュアルのパス

HTTPポート番号（Cosminexus Management Server接続）

(Ｉ)

Internet Explorer 6〔注意事項〕

Internet Explorer 7〔注意事項〕

Internet Explorer 8〔注意事項〕

Internet Explorer 9〔注意事項〕

IPv4

IPアドレスの変更手順

IPアドレスを変更する手順

(Ｊ)

J2EEアプリケーションへの検索画面取り込み

J2EEサーバが利用するRMIレジストリのポート番号

J2EEサーバ名

JAAS対応ユーザ管理でのリポジトリのベースDN

JP1/AO〔用語解説〕

JP1/AO URL出力プラグイン〔用語解説〕

JP1/AOサービス実行プラグイン〔用語解説〕

JP1/AOの設定条件〔ほかのJP1製品と連携するための設定〕

JP1/Base〔用語解説〕

JP1/Baseの論理ホスト名

JP1/IM-M〔用語解説〕

JP1/IM-SS〔用語解説〕

JP1/IM-SS URL出力プラグイン〔用語解説〕

JP1/IM-SSのホスト名

JP1/IM-V〔用語解説〕

JP1/IMの設定条件〔ほかのJP1製品と連携するための設定〕

JP1イベント関連づけファイル（ucnp_jp1event_mapping.txt）

JP1イベント関連づけファイルの使用可否

JP1イベント情報関連づけファイルの形式

JP1イベント情報関連づけファイルの項目

JP1イベント情報出力プラグイン〔用語解説〕

JP1イベント情報と業務コンテンツを関連づける

JP1イベント情報の一致判定

JP1イベント対処状況変更プラグイン〔用語解説〕

JP1権限レベル

JP1資源グループ

JP1資源グループとJP1権限レベルの組み合わせ

JP1ユーザの登録手順

JP1連携プラグイン〔用語解説〕

JP1連携プラグインを使用するためのユーザプロパティファイルの設定

(Ｋ)

KDCZ00146-Wのメッセージ例

(Ｎ)

npaclexportコマンド

npenvupdateコマンド

npexportコマンド

npimportコマンド

nppdntcmdコマンド

npsetenvコマンド

npsetupコマンド

npsnapshotlogコマンド

npstartコマンド

npstopコマンド

npunsetupコマンド

npupdateearコマンド

npupdatesearchdataコマンド

(Ｐ)

［Plugins］パレットに表示するアイコン

Portal Managerがネーミングサービスとして利用するCORBAネーミングサービスのポート番号

Portal Managerが利用するRMIレジストリのポート番号

Portal Managerでの設定の変更

Portal ManagerのWebコンテナとの通信用ポート番号

Portal Managerの簡易Webサーバのポート番号

(Ｒ)

RDエリアの拡張

RDエリアの作成ディレクトリのパス

(Ｕ)

ucnp.base.client.auditlog.enable

ucnp.base.client.autoscroll

ucnp.base.client.back.button.width

ucnp.base.client.branch.button.width

ucnp.base.client.complete.button.width

ucnp.base.client.complete.button.window.close

ucnp.base.client.confirm.page.unload.enable

ucnp.base.client.contentsname.uniquecheck.enable

ucnp.base.client.currentnode.color

ucnp.base.client.directjump.design

ucnp.base.client.directjump.enable

ucnp.base.client.editingarea.height

ucnp.base.client.editingarea.width

ucnp.base.client.editor.jp1plugin.toolpalette.display

ucnp.base.client.erroritem.emphasis.border.color

ucnp.base.client.erroritem.emphasis.regexp.enable

ucnp.base.client.flow.connector.color

ucnp.base.client.flow.frame.visible

ucnp.base.client.flow.frame.width

ucnp.base.client.frame.resize.target

ucnp.base.client.grid.size

ucnp.base.client.guide.frame.width

ucnp.base.client.jp1ao.hostname

ucnp.base.client.jp1ao.portnum

ucnp.base.client.jp1ao.submittask.passwordfile.path

ucnp.base.client.jp1ev.association.enable

ucnp.base.client.jp1imss.hostname

ucnp.base.client.jp1imss.portnum

ucnp.base.client.menu.frame.visible

ucnp.base.client.menu.frame.width

ucnp.base.client.menu.group.default

ucnp.base.client.menu.group.enable

ucnp.base.client.next.button.width

ucnp.base.client.node.checkmark.position

ucnp.base.client.node.color

ucnp.base.client.operationlog.enable

ucnp.base.client.suspend.confirm.load.enable

ucnp.base.client.suspend.enable

ucnp.base.client.terminal.display

ucnp.base.client.undo.max.count

ucnp.base.client.viewer.confirm.discardinput.enable

ucnp.base.server.acl.group.type

ucnp.base.server.auditlog.backup.number

ucnp.base.server.auditlog.path

ucnp.base.server.auditlog.size

ucnp.base.server.close.button.setting

ucnp.base.server.command.legacy

ucnp.base.server.cosminexus.httpsd.documentroot.path

ucnp.base.server.custom.browser.title

ucnp.base.server.custom.head.logo

ucnp.base.server.custom.help

ucnp.base.server.custom.login.background

ucnp.base.server.custom.login.main

ucnp.base.server.custom.menu

ucnp.base.server.dropdown.csv.dir

ucnp.base.server.fileupload.link.display

ucnp.base.server.geturl.link.display

ucnp.base.server.htmlpart.css

ucnp.base.server.jp1auth.system.resource.group

ucnp.base.server.jp1auth.virtual.hostname

ucnp.base.server.keepsession.interval

ucnp.base.server.logoutbutton.display

ucnp.base.server.operationlog.backup.number

ucnp.base.server.operationlog.dateformat

ucnp.base.server.operationlog.encoding

ucnp.base.server.operationlog.format

ucnp.base.server.operationlog.path

ucnp.base.server.operationlog.size

ucnp.base.server.print.link.display

ucnp.base.server.search.accesscontrol.enable

ucnp.base.server.search.enable

ucnp.base.server.trace.backup.number

ucnp.base.server.trace.path

ucnp.base.server.trace.size

ucnp.setup.server.cosminexus.adminagent.adapter.port

ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.port

ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.id

ucnp.setup.server.cosminexus.com.cosminexus.mngsvr.management.user.password

ucnp.setup.server.cosminexus.ejbserver.http.port

ucnp.setup.server.cosminexus.ejbserver.name

ucnp.setup.server.cosminexus.ejbserver.naming.port

ucnp.setup.server.cosminexus.ejbserver.rmi.naming.port

ucnp.setup.server.cosminexus.hws.http.port

ucnp.setup.server.cosminexus.mngsvr.webserver.connector.ajp13.port

ucnp.setup.server.cosminexus.mngsvr.webserver.connector.http.port

ucnp.setup.server.cosminexus.mngsvr.webserver.shutdown.port

ucnp.setup.server.cosminexus.webserver.connector.ajp13.max_threads

ucnp.setup.server.cosminexus.webserver.connector.ajp13.port

ucnp.setup.server.cosminexus.webserver.connector.redirect_https.port

ucnp.setup.server.cosminexus.webserver.name

ucnp.setup.server.cosminexus.websystem.name

ucnp.setup.server.db.middle.pd_max_users

ucnp.setup.server.db.port

ucnp.setup.server.db.rdarea.dir

ucnp.setup.server.db.user.id

ucnp.setup.server.db.user.password

ucnp.setup.server.docb.dbconnection.pool.count

ucnp.setup.server.docb.osagent.port

ucnp.setup.server.docb.process

ucnp.setup.server.docb.security.admin

ucnp.setup.server.jp1auth.virtual.hostname

ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.password

ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.attr.userid

ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.basedn

ucnp.setup.server.ldap.com.cosminexus.admin.auth.ldap.password.encrypt

ucnp.setup.server.ldap.department.basedn

ucnp.setup.server.ldap.directory.kind

ucnp.setup.server.ldap.group.basedn

ucnp.setup.server.ldap.hostname

ucnp.setup.server.ldap.java.naming.security.credentials

ucnp.setup.server.ldap.java.naming.security.principal

ucnp.setup.server.ldap.port

ucnp.setup.server.portal.manager.ajp13.port

ucnp.setup.server.portal.manager.http.port

ucnp.setup.server.portal.manager.naming.port

ucnp.setup.server.portal.manager.rmi.naming.port

ucnp.setup.server.portal.trace.dir

ucnp.setup.server.ucnp.portalproject.path

ucnp_jp1event_mapping.txt

ucnp_message_user.properties

ucnp_setup_user.properties

ucnp_setup_user.properties〔プロパティ一覧〕

ucnp_user.properties

ucnp_user.properties〔プロパティ一覧〕

uCosminexus Navigation Developer

uCosminexus Navigation Platform

uCosminexus Navigation Platform - Authoring License

uCosminexus Navigation Platform - User License

uCosminexus Portal Framework設定の変更手順

uCosminexus Portal Frameworkのトレース出力ディレクトリ

URL

URL〔カスタム画面にアクセスする場合〕

URL〔業務実行画面にアクセスする場合〕

URL〔業務編集画面にアクセスする場合〕

(Ｗ)

Webサーバ

Webサーバ〔用語解説〕

Webサーバが使用しているHTTPSのポート番号

Webサーバとの通信に使用するポート番号

Webサーバのコンテンツ格納ディレクトリ

Webサーバのディレクトリに直接静的ファイルを格納する場合のファイル管理

Webサーバ名

Webシステムの識別名

Webブラウザ

Webブラウザ動作〔［完了］ボタンをクリックしたとき〕

Webブラウザのウィンドウサイズ変更時，およびメニュー領域の折りたたみ時に幅を変更する領域

Webブラウザのタイトルバーまたはタブ名の文字列

Windows Vista以降のOS〔注意事項〕

(ア行)

(あ)

空き容量〔インストールディレクトリ〕

アクセス権グループ

アクセス権グループのエクスポート〔コマンド〕

アクセス権グループのエクスポートとインポート

アクセス権グループの作成例

アクセス権グループの定義内容を変更する手順

アクセス権グループを削除する手順

アクセス権グループを作成する手順

［アクセス権限］画面の項目（ディレクトリサーバによるユーザ認証を利用している場合）

アクセス権限の使用有無

アクセス権限の設定対象の指定

アクセス権設定時の注意事項（JP1/Baseによるユーザ認証を利用している場合）

アクセス権設定時の注意事項（ディレクトリサーバによるユーザ認証を利用している場合）

アクセス権の種別と実行できる操作（JP1/Baseによるユーザ認証を利用している場合）

アクセス権の種別と実行できる操作（ディレクトリサーバによるユーザ認証を利用している場合）

アクセス権の種別と設定範囲（JP1/Baseによるユーザ認証を利用している場合）

アクセス権の種別と設定範囲（ディレクトリサーバによるユーザ認証を利用している場合）

アクティブスクリプト

アプリケーションサーバ

アプリケーションサーバ〔用語解説〕

アプリケーションサーバの最大同時実行スレッド数

アンインストール〔ナビゲーション プラットフォーム〕

アンセットアップ〔コマンド〕

アンセットアップ順序

アンセットアップ手順

アンセットアップの準備（検索機能をアンセットアップする場合）

アンセットアップ前の注意点

(い)

一意の業務コンテンツ名称の指定可否

色を指定

インストール〔JP1/Base〕

インストール，セットアップ中に発生するトラブル

インストール〔ナビゲーション プラットフォーム〕

インストール処理に時間が掛かる場合の対処

インストールに失敗したというメッセージが表示された場合の対処

インストール前に確認すること

インポート

インポート〔コマンド〕

インポート〔用語解説〕

(う)

運用〔業務コンテンツ〕

運用〔ナビゲーション プラットフォーム〕

運用開始後に発生するトラブル

(え)

エクスポート

エクスポート〔コマンド〕

エクスポート〔用語解説〕

エスケープシーケンスの指定

エラー個所の強調表示の有無

エラーのパーツを強調する枠の色

(カ行)

(か)

ガイド

ガイド〔用語解説〕

ガイドパーツ〔用語解説〕

ガイド領域の幅

開発環境

開発環境〔用語解説〕

開発環境から受け取ったファイルの適用

開発環境から受け取るファイル

開発環境で作成したファイルの適用

開発環境で使用する製品

開発環境で設定を変更した場合

外部プログラムとの連携

概要

カスタマイズしたメニューのHTMLファイルまたはJSPファイルの相対パス

カスタム画面

画面の遷移または画面を閉じるときの確認ダイアログの表示有無

簡易Webサーバのポート番号

環境更新〔コマンド〕

環境変数〔npsetenvコマンドによる設定〕

環境変数の設定〔コマンド〕

監査ログ

監査ログが出力されるタイミング

監査ログに出力される項目

監査ログの最大面数

監査ログの出力形式と出力例

監査ログの出力先

監査ログの使用有無

監査ログのファイルサイズの上限値

監査ログのファイル名

監査ログの見積もり

監査ログを取得するための設定

管理ユーザID〔Cosminexus Management Server〕

管理ユーザパスワード〔Cosminexus Management Server〕

関連リンク

(き)

起動

起動〔コマンド〕

起動順序

起動順序定義ファイル

機能

旧バージョンのアクセス権との互換性

旧バージョンのインポート/エクスポートコマンドの使用可否

業務コンテンツ

業務コンテンツ〔用語解説〕

業務コンテンツで使用する静的ファイルの管理

業務コンテンツのアクセス管理の流れ（ディレクトリサーバによるユーザ認証を利用している場合）

業務コンテンツのインポート〔コマンド〕

業務コンテンツのエクスポート〔コマンド〕

業務コンテンツのエクスポートとインポート

業務コンテンツの検索

業務コンテンツの作成から運用までに必要な作業

業務コンテンツの操作ログの設定

業務コンテンツの利用と作成

業務コンテンツへのアクセス権の設定（JP1/Baseによるユーザ認証を利用している場合）

業務コンテンツへのアクセス権の設定（ディレクトリサーバによるユーザ認証を利用している場合）

業務コンテンツをエクスポートまたはインポートする場合の注意事項

業務再開の確認ダイアログの表示有無

業務実行画面

業務実行画面〔用語解説〕

業務実行画面でできること

業務実行画面にアクセスするための基本URL

業務実行画面のカスタマイズ

業務フロー

業務フロー〔用語解説〕

業務フローの直接遷移

業務フロー領域とガイド領域の高さの最大値

業務フロー領域とガイド領域の幅の最大値

業務フロー領域の関連線の色

業務フロー領域の自動スクロール可否

業務フロー領域の幅

業務フロー領域の表示有無

業務編集画面

業務編集画面〔用語解説〕

業務編集画面から静的ファイルを格納する場合のファイル管理

業務編集画面でできること

業務編集画面にアクセスするための基本URL

業務編集画面のグリッド間隔

(く)

組み込みデータベース

組み込みデータベース〔用語解説〕

組み込みデータベースの設定解除

組み込みデータベースの追加設定

クライアント環境定義の設定解除

クライアント環境定義の追加設定

(け)

検索機能のアンセットアップ

検索機能の削除

検索機能の使用有無

検索機能を使用するための追加セットアップ

検索機能を使用する場合の容量の見積もり

検索の対象となる項目

検索用データの更新

検索用データの更新〔コマンド〕

検索用データの初期登録

(こ)

構成ソフトウェア

コマンド

コマンド一覧

コマンドの概要

コンテナ拡張ライブラリ

コンテンツ管理者 ,[2]

コンテンツ管理者〔用語解説〕

コンテンツ編集者 ,[2]

コンテンツ編集者〔用語解説〕

(サ行)

(さ)

サービス起動順序

サイズ〔監査ログ〕

作業の流れ

(し)

システム環境変数の設定解除

システム環境変数の追加設定

システム管理者ID〔ユーザセットアッププロパティファイル〕

システム構成

システム構成の検討

システム構成例

システム構築の前提条件

システム全体のJP1資源グループ名

システムの起動手順

システムの起動と停止

システムの停止手順

システムの見積もり

システムフォントのサイズ

システムプラグイン

システムプラグイン〔用語解説〕

実行環境

実行環境〔用語解説〕

実行環境で使用する製品

修正パッチ

修正パッチの適用手順

出力先〔監査ログ〕

所属グループ情報のベースDN

所属組織情報のベースDN

新規インストール手順

(す)

スクロール

スマートエージェントがリクエストを受け付けるポート番号

(せ)

静的ファイル

静的ファイルの格納ディレクトリ

製品体系

セットアップ

セットアップ〔コマンド〕

セットアップ〔用語解説〕

セットアップが完了してから運用を開始するまでに必要な作業〔開発環境で開発したプラグインやカスタム画面を使用しない場合〕

セットアップが完了してから運用を開始するまでに必要な作業〔開発環境で開発したプラグインやカスタム画面を使用する場合〕

セットアップ後に起動エラーが発生する場合の対処

セットアップ後の作業の流れ

セットアップ順序

セットアップ準備〔Active Directoryによるユーザ認証を利用する場合〕

セットアップ準備〔JP1/Baseによるユーザ認証を利用する場合〕

セットアップ手順

セットアップの準備（検索機能をセットアップする場合）

セットアップ前に確認すること

セットアップまでの流れ

選択状態のプロセスノードの色

(そ)

操作ログ

操作ログ機能の使用有無

操作ログに出力される日時の表示形式

操作ログの最大面数

操作ログの出力先

操作ログの出力先，面数，サイズ

操作ログの出力フォーマット

操作ログの内容

操作ログのファイルサイズの上限値

操作ログの文字コード

(タ行)

(た)

ターミナルノード〔用語解説〕

ターミナルノードの表示有無

正しくインストールされなかったというメッセージが表示された場合の対処

(ち)

注意事項〔Webブラウザ操作時〕

注意事項〔全コマンド共通〕

注意事項〔プロパティファイル〕

注意事項〔メモリ使用量の見積もり〕

中断再開プラグイン〔用語解説〕

中断再開プラグインの使用有無

中断再開プラグインを使用する場合の容量の見積もり

中断情報

中断情報〔用語解説〕

中断情報の運用

中断情報の管理単位

中断情報の再見積もり

中断情報の削除

直接遷移できるプロセスノードのデザイン

(つ)

追加セットアップ〔検索機能〕

(て)

停止

停止〔コマンド〕

停止順序

ディレクトリ構成

ディレクトリサーバ〔用語解説〕

ディレクトリサーバ（Active Directory）構築の流れ

ディレクトリサーバにアクセスする際の認証者の識別子

ディレクトリサーバにアクセスする際のパスワード

ディレクトリサーバのポート番号

ディレクトリサーバのホスト名

データストアプラグイン〔用語解説〕

データベース環境変数の設定〔コマンド〕

データベースサーバのポート番号

データベースサーバの容量の見積もり

データベースサーバへの最大同時接続数

データベース接続の設定解除

データベース接続の追加設定

データベースの運用

データベースの状態確認

データベースの認可識別子

データベースの認可識別子に対応するパスワード

テーブルの再編成

適用する前の状態への復元

デフォルトのグループ名

(と)

統合ユーザ管理のコンフィグレーションファイル（ua.conf）の変更手順

導入から運用までの作業の概要

特長

トラブルシューティング

トラブルシュート情報（1次資料）

トラブルシュート情報（2次資料）

トラブルシュート情報収集先定義ファイルの設定

トラブルシュート情報の収集〔コマンド〕

トレースファイルの最大面数

トレースファイルの出力先

トレースファイルの出力先ディレクトリの絶対パス

トレースファイルのファイルサイズの上限値

(ナ行)

(な)

ナビゲーション プラットフォーム〔用語解説〕

ナビゲーション プラットフォームで使用するポータルプロジェクトのパス

ナビゲーション プラットフォームで使用するマシンの推奨マシンスペック

ナビゲーション プラットフォームで使用できるWebブラウザ

ナビゲーション プラットフォームで使用できるユーザ認証の種類

ナビゲーション プラットフォームとは

ナビゲーション プラットフォームにログインするためのIDとパスワード

ナビゲーション プラットフォームの画面にアクセスするためのURL

ナビゲーション プラットフォームの環境ごとの作業内容

ナビゲーション プラットフォームの起動〔検索機能のアンセットアップ〕

ナビゲーション プラットフォームの起動〔検索機能を使用するための追加セットアップ〕

ナビゲーション プラットフォームのセットアップの準備

ナビゲーション プラットフォームの停止〔検索機能のアンセットアップ〕

ナビゲーション プラットフォームの停止〔検索機能を使用するための追加セットアップ〕

ナビゲーション プラットフォームのディレクトリサーバとしてActive Directoryを使用する場合の制限事項

ナビゲーション プラットフォームのバージョンアップ

ナビゲーション プラットフォームのプロパティの追加設定

ナビゲーション プラットフォームのユーザプロパティの設定解除

ナビゲーション プラットフォームへの同時接続数の見積もり

ナビゲーション プラットフォームをセットアップ後にActive Directoryを構築する手順

ナビゲーション プラットフォームをセットアップ後にJP1/Baseによるユーザ認証を導入する手順

ナビゲーション プラットフォームを呼び出すためのURL

(に)

入出力プラグイン

入出力プラグイン〔用語解説〕

入力情報の破棄確認ダイアログの表示有無

(ね)

ネーミングサービスのポート番号

(の)

ノード〔用語解説〕

(ハ行)

(は)

バージョンアップ後に確認すること

バージョンアップ手順

バージョンアップ前に確認すること

パーツ〔用語解説〕

パスワード〔ディレクトリサーバ〕

パスワード〔データベース〕

パスワードファイルの配置先

バックアップするタイミングとデータ

パラメタ〔基本URLに指定する場合〕

(ひ)

非選択状態／直接遷移可能状態のプロセスノードの色

標準アクセス権限とは

(ふ)

ファイアウォールでブロックされているというメッセージが表示された場合の対処

［ファイル管理／登録］メニューの表示有無

フォントのサイズ

プラグイン〔用語解説〕

プラグインの更新手順

プラグインパーツ〔用語解説〕

プラグインやカスタム画面を使用しない場合に必要な作業

プラグインやカスタム画面を使用する場合に必要な作業

フローパーツ〔用語解説〕

プロセスノード〔用語解説〕

プロセスノードに表示するチェックマークの位置

プロパティ

プロパティファイル

プロパティファイルの記述形式

分岐合流ノード〔用語解説〕

文書管理サーバ

文書管理サーバ〔用語解説〕

(へ)

ヘッダ領域の［URL取得］メニューの表示有無

ヘッダ領域の［印刷］メニューの表示有無

ヘッダ領域の［閉じる］ボタンの表示有無

ヘッダ領域の［ログアウト］ボタンの表示有無

ヘッダ領域のロゴ画像のパス

編集環境

編集環境〔用語解説〕

編集環境が実行環境を兼ねる場合の業務コンテンツの運用

編集環境で使用する製品

編集環境または実行環境で設定を変更した場合

(ほ)

ポータル用設定ファイル〔用語解説〕

ポート番号〔Cosminexus Management Server終了要求受信〕

ポート番号〔Cosminexus Management Server内部通信用〕

ポート番号〔Cosminexus Management Serverリモート管理機能への外部接続〕

ポート番号〔Cosminexusのサーバ機能〕

ポート番号〔簡易Webサーバ用〕

ポート番号〔ディレクトリサーバ〕

ポート番号〔データベース〕

ほかのJP1製品と連携するための設定

ホスト名〔ディレクトリサーバ〕

ボタンの幅〔［完了］ボタン〕

ボタンの幅〔［次へ］ボタン〕

ボタンの幅〔分岐合流ノードを経由して次のノードへ遷移するためのボタン〕

ボタンの幅〔［戻る］ボタン〕

(マ行)

(ま)

マシンスペック

マニュアル〔関連ソフトウェア〕

マニュアル〔ナビゲーション プラットフォーム〕

マニュアル〔ナビゲーション プラットフォーム以外〕

(み)

見積もり

(め)

メニュー領域のグループ表示有無

メニュー領域の幅

メニュー領域の表示有無

メモリ使用量の見積もり〔注意事項〕

面数〔監査ログ〕

(も)

文字サイズ〔Webブラウザ〕

［元に戻す］ボタンの対象操作履歴の最大保持数

(ヤ行)

(ゆ)

ユーザセットアッププロパティファイル〔用語解説〕

ユーザセットアッププロパティファイル（ucnp_setup_user.properties）のプロパティ一覧

ユーザセットアッププロパティファイルの格納先

ユーザセットアッププロパティファイルの記述例

ユーザセットアッププロパティファイルの設定〔ucnp_setup_user.properties〕

ユーザセットアッププロパティファイルのプロパティ詳細

ユーザ認証の種別

ユーザ認証用の論理ホストの名称

ユーザのパスワードを示す属性名

ユーザのログインIDを示す属性名

ユーザプラグイン

ユーザプラグイン〔用語解説〕

ユーザプロパティファイル〔用語解説〕

ユーザプロパティファイル（ucnp_user.properties）のプロパティ一覧

ユーザプロパティファイルの格納先

ユーザプロパティファイルの設定〔ucnp_user.properties〕

ユーザプロパティファイルのプロパティ詳細

ユーザメッセージプロパティファイル〔用語解説〕

ユーザメッセージプロパティファイル（ucnp_message_user.properties）の設定

ユーザメッセージプロパティファイルの格納先

ユーザメッセージプロパティファイルの記述例

(ラ行)

(ら)

ライブラリ

(り)

リクエスト発信間隔

リストアするタイミングとデータ

リポジトリに格納されているパスワードの形式

(れ)

連携先のJP1/AOのポート番号

連携先のJP1/AOのホスト名

連携先のJP1/IM-SSのポート番号

(ろ)

ログイン画面の背景画像のパス

ログイン画面のメイン画像のパス

■ 商標類

Active Directoryは，米国Microsoft Corporationの，米国およびその他の国における登録商標または商標です。
Borlandのブランド名および製品名はすべて，米国Borland Software Corporationの米国およびその他の国における商標または登録商標です。
CORBAは，Object Management Groupが提唱する分散処理環境アーキテクチャの名称です。
GIFは，米国CompuServe Inc.が開発したフォーマットの名称です。
IIOPは，OMG仕様によるORB(Object Request Broker)間通信のネットワークプロトコルの名称です。
Internet Explorerは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
iOS は，Apple Inc.のOS名称です。
iPadは，Apple Inc.の商標です。
Microsoftは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
OracleとJavaは，Oracle Corporation 及びその子会社，関連会社の米国及びその他の国における登録商標です。
Safariは，Apple Inc.の商標です。
Wi-Fiは，米国におけるWi-Fi Allianceの登録商標です。
Windowsは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Serverは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
Windows Vistaは，米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。
インテル，Intel，およびIntel Core は，アメリカ合衆国およびその他の国におけるIntel Corporationの商標です。
その他記載の会社名，製品名は，それぞれの会社の商標もしくは登録商標です。
Eclipseは，開発ツールプロバイダのオープンコミュニティであるEclipse Foundation, Inc.により構築された開発ツール統合のためのオープンプラットフォームです。