Takenoff Labs

開発をやっていると、フィールドの値を変更・削除したいケースが頻繁に発生すると思います。ちょっとした変更なのにいちいちエージェントを作るのは面倒ですし、そのエージェントがゴミとして残ってしまってうっとうしくなる場合もあると思います。

そのような、ちょっとした変更・削除を行うソフトを開発してみましたので、使いたい人は使ってみてください。

概要

本ソフトを起動すると、以下のような画面になります。

大まかには、以下のようなことができます。

• 複数文書のフィールド値を一括置換・削除できます。（文書が開いている場合は、その文書が対象となります）
• 新規フィールドフィールド名を直接入力することにより、新規フィールドを追加することができます。
• 置換後の型（文字列、数値、日付/時刻、複数値）を選択できます。
• フィールドの属性・フラグ（作成者、読者、名前、Summary）を指定できます。
• @関数式を使用することにより、複雑な条件での値置換をすることができます。

動作環境

本ソフトは R6.0x 以上のノーツクライアントで動作します。
R5 は動作対象外、R8 はテスト環境を作っていないのでテストしていません
R8 で動いたよーという方はコメントをいただけるとうれしいです。（2009/10/05： R8での動作を確認しました）。

また、本ソフトはHTAを使用してますので、IE6 以上がインストールされていて、HTAが動作する環境であることも必要です。
ウイルスソフトや会社の環境によっては、動かない場合もあるかもしれませんので、あしからず。 （要望があれば VB 版を作るかも？）

（ちなみに、IE8 環境でもまだ試しておりませんので、こちらも動いたよーという方はコメントをいただけるとうれしいです。（2010/05/23追記： k2n0r1 さんに動作確認していただきました。k2n0r1 さん、ありがとうございます！）ちなみに、HTA にした理由は、会社の環境が VB などがインストールされていない場合が多いので、その場合でもソースをいじれるようにしたかったためです。）

ライセンス

当ソフトはフリーソフトです。
ご自分で使用する分には、ソースを変更してもかまいません。

ただし著作権は takenoff が保有しておりますので、名前を騙って再配布するような行為はやめてください。

既知の問題・注意事項

• 複数値の場合、値に「;」が含まれると、初期値が「;」で分割されてしまいます。
  （初期値だけが問題で、置換する際に値を元に戻せば問題ありません。）
  これは言語の問題のようで、今のところ解決できません……。（2009/10/05： この問題は Ver.1.01 で解決しました。ただし、改行を含む複数値については、区切り文字が改行なので、改行で分割されてしまいます。）
• フィールドを選択したときに右側のペインに表示される初期値は、選択している文書のうち、作成日が最も古い文書の値となります。
  ハイライトしている文書の値ではないので注意してください。
• ソフトを起動した後にビューや文書を切り替えないようにしてください。
  処理対象のビューや文書は、あくまでソフトを起動したときに表示されていたものが対象となります。
• R8 で、複数文書を選択しても1文書しか置換できない現象が発生することがあるようです。原因は不明ですが、ノーツを再起動したり、何度か当ソフトを起動していると、いつの間にか直るようです……orz （2009/10/05追記）
• 暗号化されたアイテムは、暗号を解読できる場合は、復号化後のデータに置換されます。（2012/08/20追記）

免責事項

当ソフトを使用したことによって発生した損害については、作者は一切賠償責任を負わないものとさせていただきます。

特に、このソフトの性格上、誤った操作によりフィールド値を不正に書き換えたりしてしまうと、取り返しのつかないことになることもあります。
（ありがちなのが、読者名フィールドに誤った値を入れて、誰も文書を見られなくなってしまった……など。フルアクセスアドミニストレータ権限があればなんとかなりますが、この権限がないと文書が復活できなくなります（＞ ＜））

必ずテストを行った上で、ご自身の責任において使用するようにしてください。

インストール方法

1. 以下のリンクから Zipファイルをダウンロードします。

batchcnv105.zip をダウンロード （約8KB）

2. Zipファイルをノーツデータディレクトリに解凍します。
（Zipファイルにはパスワードがかかっています（一般ユーザーに使用されると困るツールなので（＾＾； ）。パスワードは、「"0"を入れておくと文書を保存できなくなる特殊フィールド名」です。大文字小文字を区別しますのでご注意を） パスワードがどうしても解らない方は、こちらをご覧ください。

（2009/10/05： Zip ファイルを落とすことに抵抗がある方は、http://takenoff.com/files/software/｛パスワードの文字列｝/batchcnv.html にアクセスし、表示されたソースコードをコピーして、テキストエディタにペーストし、「.hta」の拡張子で保存してください。）

3. ノーツクライアントを起動し、[ファイル]メニュー → [プリファレンス] → [ツールバーの設定] を実行して表示されるダイアログで、[カスタマイズ] → [新規] → [ボタン] をクリックします。

4. 「ツールバーボタンの編集」ダイアログで、ボタン名と式を入力します。

式は、以下のように入力してください。（2010/01/18追記： パスの説明を「C:\\～」から「file:///C:/～」に変更しました。）

@Command([Execute]; "mshta"; "file:///｛ノーツデータディレクトリのパス｝/batchcnv.hta")

（設定例）ノーツデータディレクトリが C:\Program Files\Lotus\Notes の場合、以下のようになります（パスにスペースを含む場合は、%20とします）。

@Command([Execute]; "mshta"; "file:///C:/Program%20Files/Lotus/Notes/Data/batchcnv.hta")

5. ダイアログで[OK]をクリックすれば、インストール完了です。

（※上記の方法は、R6、R7 の方法です。R8 ではどうなのか不明……。（2009/10/05： R8 では [プリファレンス] ダイアログの [ツールバー] → [カスタマイズ] の画面でボタンを追加できます。操作方法はほぼ R6 と同じです。））

アンインストール方法

ノーツデータディレクトリの batchcnv.hta と、インストール時に作成したツールバーのボタンを削除すればOKです。

一般的な使用方法

1. ビューを開き、対象の文書にチェックマークを付けます。
（1文書のみの場合でも、必ず付けてください（2010/01/18追記： Ver.1.02から、1文書の場合はチェックは不要になりました）。また、プレビューペインは閉じておいてください。）

2. インストール時に作成したツールバーボタンをクリックします。

3. フィールド一覧からフィールドを選択し、右側の入力欄で値を書き換え、[置換]ボタンをクリックします。（フィールドを削除したい場合は、フィールドを選択して[削除]ボタンをクリックしてください。削除時は、右側の入力欄の入力内容は無視されます。）

• フィールド一覧にないフィールドや、フィールドを新規作成したい場合は、フィールド一覧の上の入力欄に、直接フィールド名を入力してください。
• $が付くフィールドは、フィールド一覧には表示されません。（が、直接入力すれば、取り扱うことも可能です。ただし、$UpdatedByのように変更できないものは、このツールでも変更できません）（2009/10/05： Ver.1.01 から、$付きフィールドもフィールド一覧に表示するようにしました（代わりに警告文を左下に表示）。ただし、あくまで $UpdatedBy のようなフィールドは置換・削除できません。）
• フィールド数が500を超える場合は、パフォーマンスの都合上、初期状態ではフィールド一覧が表示されません。フィールド一覧を表示するには、左下に表示されるリンクをクリックしてください。
• リッチテキストは削除のみに対応しています。 リッチテキストフィールドを選択した場合は、その旨のアラートが表示されます。（2009/10/05： Ver.1.01 から、ポップアップのアラートは表示せず、左下に警告メッセージを表示するよう、変更されています。置換・削除動作に変更はありません（置換した場合は、単なるテキストになる）。）

4. 確認メッセージで[はい]を選択すれば、置換（または削除）が実行されます。

• [キャンセル]ボタンにて処理を途中でキャンセルすることもできます。
• 当然ながら、実行ユーザーが編集権限を持たない文書に対して実行しても、エラーとなります。

その他の機能

フィールドの型を指定する

「文字列」「数値」「日付/時刻」を選択することにより、フィールドの型を変更することができます。（既存のフィールドを選択した場合は、型の初期値は自動的に判定されます。）

複数値かどうかを指定する

「複数値」にチェックを入れると、複数値として値をセットすることができます。

区切り文字は改行を使用してください。（したがって、複数値の各項目中に改行が含まれるデータについては、本ソフトでは扱うことはできません。（式を使用すれば可能ですが））

（既存のフィールドを選択した場合は、複数値フィールドの場合、初期値として自動的にチェックが入ります。また、読者名、作成者、名前を選択した場合も、自動的にチェックが入ります（名前系のフィールドで改行が入ることは基本的にないため）。）

フィールドフラグを指定する

「作成者」「読者」「名前」「Summary」のいずれか（または複数）にチェックを入れることにより、フィールドフラグを変更できます。

「作成者」「読者」「名前」を選択した場合で、ユーザーIDを入力する場合は、基準書式（CN=が付くやつ）で入力するようにしてください。「作成者」「読者」の場合は、1文字でも間違えるとエラいことになる可能性があるので、充分に注意してください。

「Summary」は、ビューに表示するかどうかのフラグです。フォームにフィールドがある場合は、基本的にチェックを入れたままにします。

（既存のフィールドを選択した場合は、これらのフラグは、初期値として自動的にチェックが入ります。）

@関数式で置換する

「@関数式」を選択すると、@関数式によって値を置換することができます。

右側の入力欄には、値の変わりに@関数式を入力してください。

その戻り値が該当のフィールドにセットされます。

（例1）Subject の値を Subject の先頭3文字にするには、以下の式を入力します。

@Left(Subject; 3)

（例2）Flag の値が"1"の場合は FieldA の値を、それ以外は FieldB の値をセットする場合は、以下の式を入力します。

@If(Flag = "1"; FieldA; FieldB)

• @Command や、UI系の関数（@Promptなど）は使用することはできません。
• @ThisValue や @ThisName も使用できません。
• 「@関数式」を選択すると「文字列」「数値」「日付/時刻」「複数値」の項目が非表示となります。これは、@関数式の戻り値によって型や複数値かどうかが決まるからです。

【注意事項】（2009/05/17追記）

@関数式を使った置換では、COM の機能を使用しています。が、R6.0.0～R6.0.3 のノーツクライアントでは、インストーラーの不具合により、デフォルトでは COM の機能が使用できません。COM の機能を使えるようにするには、コマンドプロンプトで以下のコマンドを実行して、COM をレジストリに登録する必要があります。

regsvr32 "｛ノーツディレクトリのパス｝\nlsxbe.dll"

また、@関数式による置換を行う際に、パスワードを要求されることがあります。パスワードダイアログを表示しないようにするには、ノーツクライアントで [ファイル]メニュー → [セキュリティ] → [ユーザーセキュリティ] で表示されるダイアログの [基本]タブにある、「他のNotesベースのプログラムでパスワードプロンプトを表示しない」にチェックを入れてください。（ただし、これによってセキュリティは低下します。）

文書を保存せずに置換（Ver1.02～）

「文書を保存」のチェックを外すと、文書を保存せずに置換できます。「文書の保存」チェックボックスは、文書を開いている場合のみ選択できます（ビューから置換する場合は、グレイアウトされます）。

謝辞

本ソフトについて、有益なアドバイスと、一部改修をしてくださったN尾さん、ソフトを使用してくれたA社のみなさん、ありがとうございましたm(_ _)m

変更履歴

(No Ratings Yet)

読み込み中...

トラックバックURL :