Webから隠しCheckbox Fieldを保存した際にTextになる障害
Web ApplicationでCheckbox FieldのText List(複数値)が、保存後にText(単一値)に変わってしまうという障害です。
Domino 9.0以降でこの問題は発生しますので、Domino 9.0.xにVersion Upしてから問題が発生したという場合は、この問題に該当する可能性が高いです。
Domino 9.0以降では、CheckboxなどのText List Fieldの選択肢として、カンマ(",")を含む値が許されるように変更が行われました。
例えば、Checkboxの選択肢として、"abc, def"というような値を設定出来るというものです。
しかし、この仕様変更により、副作用が発生しています。
発生条件は以下となります。
1) Webから文書を保存するApplicationであること
2) Checkbox Fieldが複数値の値を指定できる状態になっていること
3) Checkbox Fieldが文書の状態によって非表示制御されていること
4) Checkbox Fieldが非表示の状態の時にWeb Clientから保存処理が実行されること
この条件の場合に、Checkbox FieldのText List(複数値)がText(単数値)に変換され、保存されてしまうというものです。
例えば、Checkboxに"a","b","c"という値が設定されていた場合で、このFieldが保存時に非表示にされていて、Web Clientから保存すると、"a, b, c"という値になって保存されてしまいます。
この問題はNotes Clientから利用した場合は発生しません。
Web Applicationで、入力時には編集可能なCheckbox Fieldを表示して、Userが選択肢をチェックして保存した際には問題はありませんが、この文書を別のUserが処理する際に、編集可能なCheckbox Fieldを非表示にして、表示用の計算結果FieldでCheckboxで選択されている内容を表示するような制御を行っている場合に発生しますので、承認処理などを伴うWorkflow Applicationで発生する場合が多い問題です。
IBMのDomino 9.0 Fix Listにこの修正の記述がありますので、参照頂ければと思います。
ここに記載されているように、Notes.iniに
DominoSingleValueListField=0
を設定して、Domino ServerをRestartすると、パラメーターが有効になり、Dominoの動作が8.5.x以前の動作に戻り、問題を解消することが可能です。
但し、このパラメーターを設定すると、Domino 9.0以降でサポートされた選択肢に","を含む値を使うことが出来なくなりますので、ご注意ください。
両立させたい場合には、Web Application側で対応する必要があります。
例えば、WebQuerySave Agentで保存されるCheckbox Fieldの値がTextになっている訳ですから、LotusScriptで","を分離記号としてSplitしてからTrimしてしまうことで問題を回避できます。
Splitだけでは、値の先頭にSpaceが入ってしまうことがありますので、Trimすることが重要です。
皆さんも、Domino 9にVersion UpしてからWeb Applicationの動きがおかしいという現象に出会った場合は、この問題に該当しないかを調査してください。
Domino 9.0以降でこの問題は発生しますので、Domino 9.0.xにVersion Upしてから問題が発生したという場合は、この問題に該当する可能性が高いです。
Domino 9.0以降では、CheckboxなどのText List Fieldの選択肢として、カンマ(",")を含む値が許されるように変更が行われました。
例えば、Checkboxの選択肢として、"abc, def"というような値を設定出来るというものです。
しかし、この仕様変更により、副作用が発生しています。
発生条件は以下となります。
1) Webから文書を保存するApplicationであること
2) Checkbox Fieldが複数値の値を指定できる状態になっていること
3) Checkbox Fieldが文書の状態によって非表示制御されていること
4) Checkbox Fieldが非表示の状態の時にWeb Clientから保存処理が実行されること
この条件の場合に、Checkbox FieldのText List(複数値)がText(単数値)に変換され、保存されてしまうというものです。
例えば、Checkboxに"a","b","c"という値が設定されていた場合で、このFieldが保存時に非表示にされていて、Web Clientから保存すると、"a, b, c"という値になって保存されてしまいます。
この問題はNotes Clientから利用した場合は発生しません。
Web Applicationで、入力時には編集可能なCheckbox Fieldを表示して、Userが選択肢をチェックして保存した際には問題はありませんが、この文書を別のUserが処理する際に、編集可能なCheckbox Fieldを非表示にして、表示用の計算結果FieldでCheckboxで選択されている内容を表示するような制御を行っている場合に発生しますので、承認処理などを伴うWorkflow Applicationで発生する場合が多い問題です。
IBMのDomino 9.0 Fix Listにこの修正の記述がありますので、参照頂ければと思います。
ここに記載されているように、Notes.iniに
DominoSingleValueListField=0
を設定して、Domino ServerをRestartすると、パラメーターが有効になり、Dominoの動作が8.5.x以前の動作に戻り、問題を解消することが可能です。
但し、このパラメーターを設定すると、Domino 9.0以降でサポートされた選択肢に","を含む値を使うことが出来なくなりますので、ご注意ください。
両立させたい場合には、Web Application側で対応する必要があります。
例えば、WebQuerySave Agentで保存されるCheckbox Fieldの値がTextになっている訳ですから、LotusScriptで","を分離記号としてSplitしてからTrimしてしまうことで問題を回避できます。
Splitだけでは、値の先頭にSpaceが入ってしまうことがありますので、Trimすることが重要です。
皆さんも、Domino 9にVersion UpしてからWeb Applicationの動きがおかしいという現象に出会った場合は、この問題に該当しないかを調査してください。
DB Replica IDを書き換える? -6-
<話題の履歴>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
DB Replica IDを書き換える? -4-
DB Replica IDを書き換える? -5-
前回は、DB PropertyのReplicaIDとC-APIが返すTIMEDATEの値の関係を見てみました。
今回は、一度変更してしまったReplicaIDをDBの作成日から戻せるかどうかを検討してみたいと思います。
ReplicaIDを元に戻すためには、前回見たように、0.01秒単位で時間が取得できるかどうかにかかっています。
ところが、DB Propertyで表示されている時間は秒単位までしかありません。
このDB Propertyで表示されている日時は、NotesDatabase ClassのCreated Propertyの値ですので、先ずはこのPropertyを調べてみることにします。
Designer Helpに記載されているように、Created PropertyはDate形式のVariantを返してきます。
このDate型の戻り値は、"YYYY/MM/DD HH:MM:SS"の形式で返され、秒単位以下の値を返してくれることはありません。
これでは、ReplicaIDを再生することは出来ません。
C-APIのFunctionも少し探してみましたが、TIMEDATE形式で作成日を返してくれるようなFunctionも見つかりませんでした(探し方が足りないのかも知れません)。
これは、諦めるしかないのかも知れません。
元に戻したい場合は、変更前のTIMEDATEの値を保存しておくか、ReplicaIDの値を保存しておき、それを使って戻すしかなさそうです。
蛇足ですが、Document UNIDも文書の作成日とランダムな日付値から成り立っていて、C-APIで作成日を取得することは可能ですが、実際には作成日でなく、Replica DBへの文書の追加日が返されてきます。
皆さんも、文書のPropertyを確認した際に、作成日、追加日、最終更新日が確認できるのをご存知だと思います。
C-APIを使って書かれたApplicationは皆さんの通常の環境であれば殆ど無いと思いますが、今は使われているかどうか分かりませんが、Just SystemのCB SearchがC-APIを駆使して作成されていました。
ご存知のように、CB Searchは曖昧検索が出来て、作成日などで絞り込みが出来ますが、C-APIが返す作成日(つまり、Replica DBへの追加日)を利用していたことで、Replica DBを検索対象にすると適切な作成日が取得できないという問題もありました。
これを回避するために、DBをOS Copyしたりしていた場合もありましたが、昔は、OS CopyしたDBの場合、ReplicaIDもDBIIDも全く同じDBとなり、Replicaで障害が発生したこともありました。今ではこの障害はFixされていると思いますが、基本的にはReplicaをOS Copyで配置することは推奨されていません。
このシリーズでReplicaIDの値の書き換えを行いましたがWeb Siteで紹介されていたSampleのように、他のDBのReplicaIDを移植することもこの応用で簡単に出来てしまいます。
こういった方法は様々な応用が出来ると思いますので、皆さんも活用してみてください。
<終わり>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
DB Replica IDを書き換える? -4-
DB Replica IDを書き換える? -5-
前回は、DB PropertyのReplicaIDとC-APIが返すTIMEDATEの値の関係を見てみました。
今回は、一度変更してしまったReplicaIDをDBの作成日から戻せるかどうかを検討してみたいと思います。
ReplicaIDを元に戻すためには、前回見たように、0.01秒単位で時間が取得できるかどうかにかかっています。
ところが、DB Propertyで表示されている時間は秒単位までしかありません。
このDB Propertyで表示されている日時は、NotesDatabase ClassのCreated Propertyの値ですので、先ずはこのPropertyを調べてみることにします。
Designer Helpに記載されているように、Created PropertyはDate形式のVariantを返してきます。
このDate型の戻り値は、"YYYY/MM/DD HH:MM:SS"の形式で返され、秒単位以下の値を返してくれることはありません。
これでは、ReplicaIDを再生することは出来ません。
C-APIのFunctionも少し探してみましたが、TIMEDATE形式で作成日を返してくれるようなFunctionも見つかりませんでした(探し方が足りないのかも知れません)。
これは、諦めるしかないのかも知れません。
元に戻したい場合は、変更前のTIMEDATEの値を保存しておくか、ReplicaIDの値を保存しておき、それを使って戻すしかなさそうです。
蛇足ですが、Document UNIDも文書の作成日とランダムな日付値から成り立っていて、C-APIで作成日を取得することは可能ですが、実際には作成日でなく、Replica DBへの文書の追加日が返されてきます。
皆さんも、文書のPropertyを確認した際に、作成日、追加日、最終更新日が確認できるのをご存知だと思います。
C-APIを使って書かれたApplicationは皆さんの通常の環境であれば殆ど無いと思いますが、今は使われているかどうか分かりませんが、Just SystemのCB SearchがC-APIを駆使して作成されていました。
ご存知のように、CB Searchは曖昧検索が出来て、作成日などで絞り込みが出来ますが、C-APIが返す作成日(つまり、Replica DBへの追加日)を利用していたことで、Replica DBを検索対象にすると適切な作成日が取得できないという問題もありました。
これを回避するために、DBをOS Copyしたりしていた場合もありましたが、昔は、OS CopyしたDBの場合、ReplicaIDもDBIIDも全く同じDBとなり、Replicaで障害が発生したこともありました。今ではこの障害はFixされていると思いますが、基本的にはReplicaをOS Copyで配置することは推奨されていません。
このシリーズでReplicaIDの値の書き換えを行いましたがWeb Siteで紹介されていたSampleのように、他のDBのReplicaIDを移植することもこの応用で簡単に出来てしまいます。
こういった方法は様々な応用が出来ると思いますので、皆さんも活用してみてください。
<終わり>
DB Replica IDを書き換える? -5-
<話題の履歴>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
DB Replica IDを書き換える? -4-
前回は、ReplicaIDの書き換えを行ってみました。
今回は、前回ちょっと触れたDB作成日とReplicaIDについて試してみます。
これまで見て頂いたように、ReplicaIDというのはGMT時間(勿論、GMTからの差異情報も持っています)でDBの中に保存されています。
文書のUNIDなども同様なのですが、Notesは時間をKeyにして出来ているSystemなのです。
最近は行われないと思いますが、2000年問題対応の時に、OS時間を未来に設定してテストするということが行われていました。
これは、テスト環境だから実施できることであり、もし、本番環境で時間を進めてしまうようなことがあれば、NotesはSystem的に未来のDBや文書を生成することになり、時間を戻しても正常なDBではなくなってしまうのです。
話しが逸れましたが、再度ReplicaInfoで持っているGMTのTIMEDATEとReplicaIDの関係を見てみたいと思います。
前回までTestしていたDBは一旦削除して新しいDBを作成して試して行くことにします。
新規に作成したDBは以下のような作成日/ReplicaIDになっています。

以前紹介したように、日時からReplicaIDを生成する@関数が提供されています。
では、この新規作成したDBの作成日時からReplicaIDを生成してみましょう。
DB Propertyの値を使ってReplicaIDを生成する訳ですが、簡単に行う場合は、DB Propertyの作成日時を控えておき、@関数で以下のように書くと可能です。
@Text(@ToTime("2016/01/07 15:13:02") ; "*")
しかし、これで生成されたReplicaIDは実際に作成したDBのReplicaIDとは異なっています。
上記の例の場合は、以下の値が返されます。
49257F33:002226F8
ここで想像できるのは、ReplicaIDは日時から生成されていることは事実ですが、他にも何か関係する要素が存在するということです。
では、このDBのReplicaInfoの値を参照してみます。

ReplicaIDの部分は、最初の2つで、以下となっています。
2238267,1227194163
これは、通常の10進数表示なので、16進数に変換してみます。
C-APIのTIMEDATEの定義はDWORDですので、16進数の8桁に揃えて表記します。
0022273B,49257F33
これでお分かり頂けたと思いますが、UIのDB Propertyで確認できるReplicaIDはC-APIで参照可能な値を、
2番目の値:1番目の値
という形で並べているのです。
C-APIのTIMEDATEとDB Propertyで確認できるReplicaIDの関係がこれで分かりました。
C-APIのTIMEDATEはtime/dateという順番で並べているのですが、ReplicaIDはdate/timeという並びになっているのです。
皆さんもご存知の通り、日本時間でDBを作成すると、ReplicaIDは"4925"から始まりますので、Dateの最初の部分にはGMTからの差分情報、後半部分に日付を保持していると思われます。
実際に、日付を1日プラスして@関数でReplicaIDを生成すると、+1された値になることが分かります。
@Text(@ToTime("2016/01/01 00:00:00") ; "*") 49257F2C:005265C0
@Text(@ToTime("2016/01/02 00:00:00") ; "*") 49257F2D:005265C0
実際は、最初の1 ByteがTimeZone情報で残りの3 Bytesが紀元前4713年1月1日からの経過日数なのですが、2 Byte目は余りにも日数が多いので現在は"25"固定のような状態になっているだけです。
詳しく解説すると、1 Byte目は、
bit 7 :DayLight Saving(サマータイムの実施)
bit 6 :GMTからの±(+の場合は1、-の場合は0)
bit 5-4:GMTからの差異(分)
bit 3-0:GMTからの差異(時間)
となっていて、日本の場合は、bit 6 = 1、bit 3-0 = 9となり、1 Byte目の値は"49"になるという訳です。
では、時間の方はどうでしょうか?
@関数で試してみると、以下のように値が返ってきます。
@Text(@ToTime("2016/01/01 00:00:00") ; "*") 49257F2C:005265C0
@Text(@ToTime("2016/01/01 00:00:01") ; "*") 49257F2C:00526624
@Text(@ToTime("2016/01/01 00:00:02") ; "*") 49257F2C:00526688
1秒ずらずごとに、十進数で100が増えていることが分かります。
つまり、時間は、0.01秒単位まで保持しているということです。
これで、最初に日付からReplicaID生成を行った際に実際のReplicaIDと一致しなかったことが理解できます。
詳しくは、IBM Technoteにも記載されていますので、参照ください。
今回は、DB PropertyのReplicaIDとC-APIが返すTIMEDATEの値の関係を見てみました。
次回は、一度変更してしまったReplicaIDをDBの作成日から戻せるかどうかを試してみたいと思います。
<続く>
DB Replica IDを書き換える? -1-
DB Replica IDを書き換える? -2-
DB Replica IDを書き換える? -3-
DB Replica IDを書き換える? -4-
前回は、ReplicaIDの書き換えを行ってみました。
今回は、前回ちょっと触れたDB作成日とReplicaIDについて試してみます。
これまで見て頂いたように、ReplicaIDというのはGMT時間(勿論、GMTからの差異情報も持っています)でDBの中に保存されています。
文書のUNIDなども同様なのですが、Notesは時間をKeyにして出来ているSystemなのです。
最近は行われないと思いますが、2000年問題対応の時に、OS時間を未来に設定してテストするということが行われていました。
これは、テスト環境だから実施できることであり、もし、本番環境で時間を進めてしまうようなことがあれば、NotesはSystem的に未来のDBや文書を生成することになり、時間を戻しても正常なDBではなくなってしまうのです。
話しが逸れましたが、再度ReplicaInfoで持っているGMTのTIMEDATEとReplicaIDの関係を見てみたいと思います。
前回までTestしていたDBは一旦削除して新しいDBを作成して試して行くことにします。
新規に作成したDBは以下のような作成日/ReplicaIDになっています。

以前紹介したように、日時からReplicaIDを生成する@関数が提供されています。
では、この新規作成したDBの作成日時からReplicaIDを生成してみましょう。
DB Propertyの値を使ってReplicaIDを生成する訳ですが、簡単に行う場合は、DB Propertyの作成日時を控えておき、@関数で以下のように書くと可能です。
@Text(@ToTime("2016/01/07 15:13:02") ; "*")
しかし、これで生成されたReplicaIDは実際に作成したDBのReplicaIDとは異なっています。
上記の例の場合は、以下の値が返されます。
49257F33:002226F8
ここで想像できるのは、ReplicaIDは日時から生成されていることは事実ですが、他にも何か関係する要素が存在するということです。
では、このDBのReplicaInfoの値を参照してみます。

ReplicaIDの部分は、最初の2つで、以下となっています。
2238267,1227194163
これは、通常の10進数表示なので、16進数に変換してみます。
C-APIのTIMEDATEの定義はDWORDですので、16進数の8桁に揃えて表記します。
0022273B,49257F33
これでお分かり頂けたと思いますが、UIのDB Propertyで確認できるReplicaIDはC-APIで参照可能な値を、
2番目の値:1番目の値
という形で並べているのです。
C-APIのTIMEDATEとDB Propertyで確認できるReplicaIDの関係がこれで分かりました。
C-APIのTIMEDATEはtime/dateという順番で並べているのですが、ReplicaIDはdate/timeという並びになっているのです。
皆さんもご存知の通り、日本時間でDBを作成すると、ReplicaIDは"4925"から始まりますので、Dateの最初の部分にはGMTからの差分情報、後半部分に日付を保持していると思われます。
実際に、日付を1日プラスして@関数でReplicaIDを生成すると、+1された値になることが分かります。
@Text(@ToTime("2016/01/01 00:00:00") ; "*") 49257F2C:005265C0
@Text(@ToTime("2016/01/02 00:00:00") ; "*") 49257F2D:005265C0
実際は、最初の1 ByteがTimeZone情報で残りの3 Bytesが紀元前4713年1月1日からの経過日数なのですが、2 Byte目は余りにも日数が多いので現在は"25"固定のような状態になっているだけです。
詳しく解説すると、1 Byte目は、
bit 7 :DayLight Saving(サマータイムの実施)
bit 6 :GMTからの±(+の場合は1、-の場合は0)
bit 5-4:GMTからの差異(分)
bit 3-0:GMTからの差異(時間)
となっていて、日本の場合は、bit 6 = 1、bit 3-0 = 9となり、1 Byte目の値は"49"になるという訳です。
では、時間の方はどうでしょうか?
@関数で試してみると、以下のように値が返ってきます。
@Text(@ToTime("2016/01/01 00:00:00") ; "*") 49257F2C:005265C0
@Text(@ToTime("2016/01/01 00:00:01") ; "*") 49257F2C:00526624
@Text(@ToTime("2016/01/01 00:00:02") ; "*") 49257F2C:00526688
1秒ずらずごとに、十進数で100が増えていることが分かります。
つまり、時間は、0.01秒単位まで保持しているということです。
これで、最初に日付からReplicaID生成を行った際に実際のReplicaIDと一致しなかったことが理解できます。
詳しくは、IBM Technoteにも記載されていますので、参照ください。
今回は、DB PropertyのReplicaIDとC-APIが返すTIMEDATEの値の関係を見てみました。
次回は、一度変更してしまったReplicaIDをDBの作成日から戻せるかどうかを試してみたいと思います。
<続く>