永続性データストアシーケンスのカスタマイズ

Windchill で使用するための新しいデータストアシーケンスを作成します。

Windchill はデータストアスキーマオブジェクトを使用してシーケンスを実装します。Oracle では、シーケンススキーマオブジェクトとして直接実装されます。SQLServer では、テーブルとアクセスストアドプロシージャとして実装されます。

• このマニュアルでは、Windchill データストアディレクトリ、<Windchill_ホーム>/db にアクセスでき、ターゲットデータストアの DDL スクリプトを実行する権限を持つことを前提としています。

• モデリングされたカスタマイズ手順では、Windchill Java アノテーションのシーケンスのサポートが正常にインストールされ、設定されていることを前提としています。

このソリューションの最終結果は、データストアシーケンスの作成です。

Windchill Java アノテーションを使用して、シーケンスクラスをモデリングします。

エレメント	タイプ	説明
<MySequence>	Java クラス	Windchill でデータストアシーケンスを表すクラス。

1. <MySequence> を拡張するクラス <MySequence> を <MyPackage> に作成します。

2. "GenAsDatastoreSequence" のアノテーションプロパティとシーケンスプロパティをアノテーションの引数として指定します。デフォルトの値が設定されていない場合は、初期シード値および増加値を指定します。たとえば、シード値が 1000 で増分が 100 の場合、結果の Java ソースファイルは次のようになります。

import com.ptc.windchill.annotations.metadata.GenAsDatastoreSequence;
@GenAsDatastoreSequence (objectName="mySequence", seed=1000, increment=100)
public class MySequence extends _MySequence {
}

3. <MyPackage> の <MySequence>.java クラスをコンパイルします。

4. DDL スクリプトを生成します。

5. シーケンス DDL を実行します。Windchill シェルで次を実行します。<WindchillHome>/db/execute_sql_script.bat <MyPackage>/create_<MySequence>_ sequence.sql

手順 - Oracle でのモデリングされていないデータストアシーケンスの作成

モデリングされていないシーケンスを作成すると、Windchill イントロスペクション情報にデータベーススキーマオブジェクトが含まれません。したがって、この情報に依存するツール (Windu、更新ツールなど) はこれらのオブジェクトを Windchill と無関係として扱います。

1. シーケンス DDL スクリプト "create_<MySequence>_sequence.sql" を "<Windchill_ホーム>/db/sql" ディレクトリに作成します。マルチバイトシステムの場合、ディレクトリ "<Windchill_ホーム>/db/sql3" を使用します。

2. このスクリプトに次の行を追加します。<MySequence>、<MySequenceSeed>、および <MySequenceIncrement> はそれぞれ置き換えます。

3. シーケンス DDL を実行します。Windchill シェルで次を実行します。<WindchillHome>/db/execute_sql_script.bat create_<MySequence>_sequence.sql

手順 - SQL サーバーでのモデリングされていないデータストアシーケンスの作成

1. シーケンス DDL スクリプト "create_<MySequence>_sequence.sql" を "<Windchill_ホーム>/db/sqlServer" ディレクトリに作成します。

2. このスクリプトに次の行を追加します。<MySequence>、<MySequenceSeed>、および <MySequenceIncrement> はそれぞれ置き換えます。

CREATE TABLE wt_sequence_<MySequence>(dummy
CHAR(1),
value BIGINT IDENTITY(<MySequenceSeed>, <MySequenceIncrement>))
go
CREATE PROCEDURE wt_get_next_sequence_<MySequence>
@returnValue BIGINT OUTPUT
AS
INSERT wt_sequence_<MySequence> (dummy) VALUES ('x')
SELECT @returnValue = SCOPE_IDENTITY()
go

3. シーケンス DDL を実行します。Windchill シェルで <WindchillHome>/db/execute_sql_script.bat create_<MySequence>_sequence.sql <DB_USERNAME> <DB_PASSWORD> を実行します。

前述の基本手順では、シーケンスクラスを作成しました。このシーケンスの次の値を入手するには、PersistenceManager.getNextSequence(Class) を渡す <MyPackage>.<MySequence>.class メソッドを使用します。

前述のモデリングされていない手順では、シーケンスはデータストアに直接作成されています。このシーケンスの次の値を入手するには、文字列定数 <MySequence> を渡す PersistenceManager.getNextSequence(String) メソッドを使用します。

シーケンス値は Windchill コード内のさまざまな領域で使用されます。Where-Used Tool および Javadoc の wt.fc.DatastoreSequence のサブクラスに関する記述を参照してください。

次に示すのは、1 で始まり、間隔が 20 の partNumber シーケンスのスクリプト例です。

CREATE TABLE wt_sequence_partNumber (dummy
CHAR(1), value BIGINT IDENTITY(1,20))
go
CREATE PROCEDURE wt_get_next_sequence_partNumber @returnValue BIGINT OUTPUT
AS
INSERT wt_sequence_<MySequence> (dummy) VALUES ('x')
SELECT @returnValue = SCOPE_IDENTITY()
go