C フォーム・バージョン制御ユーティリティ

この付録では、フォーム・バージョン制御ユーティリティの有効範囲、コンテンツおよび説明を示します。次の内容について説明します。

FVCユーティリティの有効範囲

次の表に、このユーティリティで実装される機能の有効範囲を示します。

機能 実装（○/×） コメント

プロセス・フォーム・バージョンのアップグレード

○

ターゲット・フォーム・バージョンが存在し、かつアクティブなフォーム・バージョンであることを確認してください。

子フォーム・バージョンのアップグレード

○

子フォーム・バージョンは、アクティブな親フォームに属する子フォームに、自動的にアップグレードされます。

親フォームの値のアップグレード

○

ターゲット・フォーム・バージョンが存在し、かつアップグレード対象の値を持つフィールドが含まれていることを確認してください。

子フォームの値のアップグレード

○

ターゲット子フォームが存在し、かつユーザーに対してその子フォームがプロビジョニングされていることを確認してください。

子フォームの値の挿入

○

アクティブな親フォームに属する子フォーム・バージョンに、挿入対象のフィールドが存在することを確認してください。

機能	実装（○/×）	コメント
プロセス・フォーム・バージョンのアップグレード	○	ターゲット・フォーム・バージョンが存在し、かつアクティブなフォーム・バージョンであることを確認してください。
子フォーム・バージョンのアップグレード	○	子フォーム・バージョンは、アクティブな親フォームに属する子フォームに、自動的にアップグレードされます。
親フォームの値のアップグレード	○	ターゲット・フォーム・バージョンが存在し、かつアップグレード対象の値を持つフィールドが含まれていることを確認してください。
子フォームの値のアップグレード	○	ターゲット子フォームが存在し、かつユーザーに対してその子フォームがプロビジョニングされていることを確認してください。
子フォームの値の挿入	○	アクティブな親フォームに属する子フォーム・バージョンに、挿入対象のフィールドが存在することを確認してください。

FVCユーティリティのコンテンツ

次の表に、FVCユーティリティを構成するファイルの名前とパス、および説明を示します。

ファイル名（パス付き） 説明

<XLCLIENT_HOME>¥ lib¥xlFvcUtil.jar

このjarファイルには、フォーム・バージョン制御ユーティリティを実行するのに必要な、このユーティリティのクラスが含まれます。

<XLCLIENT_HOME>¥xlFvcUtil.ear

このearファイルには、フォーム・バージョン制御ユーティリティを実行するのに必要な、このユーティリティのクラスが含まれます。このearファイルは、WebSphere launchClientユーティリティの実行用に同梱されています。

<XLCLIENT_HOME>¥fvc.properties

このファイルには、ソースおよびターゲットのフォーム・バージョン、それらのフィールドと値、および子フォームの情報に関するすべての構成プロパティが含まれます。

<XLCLIENT_HOME>¥fvcutil.cmd
<XLCLIENT_HOME>¥fvcutil_websphere.cmd

これらのファイルは、Windowsシステムでフォーム・バージョン制御ユーティリティを実行するためのcmdスクリプトおよびシェル・スクリプトです。fvcutil.cmdを実行する場合、コマンドライン引数としてOracle Identity Managerデータベースの管理者パスワードを指定する必要があります。

ファイル名（パス付き）	説明
<XLCLIENT_HOME>¥ lib¥xlFvcUtil.jar	このjarファイルには、フォーム・バージョン制御ユーティリティを実行するのに必要な、このユーティリティのクラスが含まれます。
<XLCLIENT_HOME>¥xlFvcUtil.ear	このearファイルには、フォーム・バージョン制御ユーティリティを実行するのに必要な、このユーティリティのクラスが含まれます。このearファイルは、WebSphere launchClientユーティリティの実行用に同梱されています。
<XLCLIENT_HOME>¥fvc.properties	このファイルには、ソースおよびターゲットのフォーム・バージョン、それらのフィールドと値、および子フォームの情報に関するすべての構成プロパティが含まれます。
<XLCLIENT_HOME>¥fvcutil.cmd <XLCLIENT_HOME>¥fvcutil_websphere.cmd	これらのファイルは、Windowsシステムでフォーム・バージョン制御ユーティリティを実行するためのcmdスクリプトおよびシェル・スクリプトです。fvcutil.cmdを実行する場合、コマンドライン引数としてOracle Identity Managerデータベースの管理者パスワードを指定する必要があります。

FVCユーティリティの説明

フォーム・バージョン制御ユーティリティは、カスタム・プロセス・フォームのバージョン番号フィールドおよび追加のプロセス・フォーム・フィールドのデータを更新するために設計されています。このユーティリティは、コマンド・コンソールから起動され、ログイン用のコマンドライン・パラメータおよびプロパティ・ファイルを使用して動作します。ユーザーは、Oracle Identity Managerデータベースの管理者パスワードを入力するように求められます。このパラメータのプロパティおよびユーザーのログインとパスワードの妥当性が検証され、エラーが発生した場合には、それを通知する適切なエラー・メッセージが作成されます。

リリース・ノート

システム要件に従い、ユーティリティは、ステータスが「Revoked」でないオブジェクトのプロセス・フォームのみを更新します。
このユーティリティには、フォーム・フィールド値を更新する必要があるにもかかわらずフォーム・バージョンを変更できない場合の、特別なプロビジョニングが含まれています。この場合は、<version to>パラメータと<version from>パラメータが同じであることが必要です。エラーが作成されるかわりに、指定したバージョンのフィールド値が更新され、バージョン値自体は変更されません。
このユーティリティには、子レコードの挿入を許可する機能は含まれていません。1つの子表レコードは、単一の子表フィールドとみなされます。たとえば、fvc.propertiesファイルに次のエントリが存在するとします。

Child;UD_CF3_FIELD7;tiger;Insert

Child;UD_CF3_FIELD8;mad;Insert

Child;UD_CF3_FIELD9;me2;Insert

この場合は、3つのフィールドに対して前述の値を持つ単一の子レコードが作成および挿入されるかわりに、子表に3つの異なる行が作成されます。
fvc.propertiesファイルのToVersionプロパティに「Active Version」の値が割り当てられている場合は、カスタム・プロセス・フォームの更新のみに、このユーティリティを使用できます。
新しいフィールドのデフォルト値は、プロパティ・ファイルで定義する必要があります。