不思議なGroup転送とLocation転送 -3-
<話題の履歴>
前回は、Group文書やLocation文書の送信処理について見てみました。
今回は、送信された文書の登録処理を調べてみます。
ではまず、ImportのButtonの設計を参照してみます。
GroupのInportを例に見てみましょう。
InportのButtonには以下のLotusScript Codeが書かれています。
Sub Click(Source As Button)
'Begin DNT
Set workspace = New NotesUIWorkspace
Set session = New NotesSession
Set uidoc = workspace.currentdocument
Set sourcedoc = uidoc.document
Forall aBook In session.AddressBooks
Call aBook.open("", "")
If aBook.IsPrivateAddressBook Then
Dim destDb As New notesdatabase("", aBook.filename)
Exit Forall
End If
End Forall
Set destview = destdb.GetView ("Groups")
Call destview.Refresh
key$ = uidoc.FieldGetText("ListName")
Set destdoc = destview.Getdocumentbykey(key$, True)
Dim newname As String
Dim action As String
Dim enter As String
Dim found As Integer
If destdoc Is Nothing Then
Set destdoc = New Notesdocument(destdb)
destdoc.ListName = sourcedoc.ListName(0)
Else
Select Case Messagebox(xLMsgAlreadyExists + Chr(10) + Chr(10) + xLMsgAlreadyExists2 , 3 + 32, xLTitle + ": " + Key$)
Case 6 'ID_YES (Replace)
destdoc.ListName = sourcedoc.ListName(0)
Case 7 'ID_NO (Rename)
found = 1
Do While found = 1
newname = Inputbox$(xLMsgNewName, xLTitle2)
If newname = "" Then Exit Sub
Set destdoc = destview.Getdocumentbykey(newname, True)
If destdoc Is Nothing Then
found = 0
End If
Loop
Set destdoc = New Notesdocument(destdb)
destdoc.ListName = newname
Case Else
Exit Sub
End Select
End If
Call sourcedoc.CopyAllItems( destdoc, True )
destdoc.Form = "Group"
destdoc.Type = "Group"
If newname <> "" Then
destdoc.ListName = newname
End If
Call destdoc.RemoveItem( "Subject" )
Call destdoc.RemoveItem( "SaveOptions" )
Call destdoc.RemoveItem( "Sent" )
Call destdoc.RemoveItem( "SendTo" )
Call destdoc.RemoveItem( "CopyTo" )
Call destdoc.RemoveItem( "From" )
Call destdoc.RemoveItem( "GMessage" )
Call destdoc.RemoveItem( "$Title" )
If destdoc.hasitem("$Signature") Then
Call destdoc.RemoveItem( "$Signature" )
End If
If destdoc.hasitem("$Signature_StoredForm") Then
Call destdoc.RemoveItem( "$Signature_StoredForm" )
End If
If destdoc.hasitem("$Sig$Form") Then
Call destdoc.RemoveItem( "$Sig$Form" )
End If
If destdoc.hasitem("Readers") Then
Call destdoc.RemoveItem( "Readers")
End If
Call destdoc.Save(True, False)
Messagebox xLMsgSaved , 64, xLTitle3 + destDoc.getitemvalue("ListName")(0)
'End DNT
End Sub
要するに、Importする際に同じ名前のGroupが存在していた場合は別の名前でImportするように要求してから、Formを"Group"に設定して、かつTypeも"Group"に設定してから、Mailとして送信されてきた際のGroup文書には必要が無いFieldを削除してしまうというCodeになっています。
何故か前回の記事で紹介した"Type" Fieldを再度加えていたりしますし、送信時のCodeでSignを行っているにも関わらず、Signを削除していたりして全く意味不明な状態です。
更に、"Readers" Fieldの削除などを行っていますが、これは当たり前で、それ以外にListOwnerやLocalAdminをそのまま残しているのも気になります。
削除Fieldに関しては、本当にこれだけのField削除でこと足りるのでしょうか?
前回紹介したように、このMail文書にはForm設計が格納されている訳です。
実際に送信されてきたGroup文書を参照してみましょう。
このようにかなり大きな容量のMailが届いています。
Propertyを見てみましょう。
Form設計が格納されていますので、かなりのFieldが存在します。
しかし、上記に紹介したImportのLotusScriptのCodeで削除されているのは一部のFieldだけであり、これらのForm設計のFieldは残ったままGroup文書に書き込まれてしまうことになります。
Import処理を行ってみます。
このActionを実行することで、GroupのImportが実行されます。
自分自身に送信していますので、Groupは既に存在する状態ですので、以下のようにCheckが行われてAlertが表示されます。
「いいえ」で返答して、Group名の指定を行います。
これで、以下のようにGroupが保存されます。
以下のように、Group文書が登録されたことが確認できます。
さて、この文書のPropertyからFieldの内容を確認してみましょう。
当たり前の結果ですが、以下のように不要なFieldが残ったままの汚いGroup文書が出来ていることが確認できます。
文書の容量を確認すると以下の通りです。
これでは無駄なFieldが格納された文書を生成しているだけです。
実際のGroup文書は容量が2KBとかだと思われますが、このような状態になるのは非常に問題だと思いますし、これを更に他人に転送した場合を考えると、酷い状況になります。
何故このような処理をしているのか??と考えてしまいます。
他にも、Personal Addressbookの設計には首をかしげざるを得ない設計要素が存在しています。
例えば、以下のようなFunctionがLotusScript Libraryに登録されていたりするのです。
Function GetString ( StringType As Integer) As String
Select Case StringType
Case 1 ' Msgbox message for field validation
GetString = "姓、または会社名のいずれかを入力する必要があります。"
Case 2 ' Msgbox title for field validation
GetString = "フィールドのデータが不正です"
Case 3 'used in MailLibrary and VCardLib
getString = "エラー"
Case 4 'used in MailLibrary and VCardLib
getString = "現在のロケーションで、メールデータベースが正しく開けることを確認してください。"
Case 5 'used in MailLibrary and VCardLib
getString = "メールファイルを開けません。"
Case 6 'used in VCardLib
getString = "連絡先"
Case 7 'used in VCardLib
getString = "連絡先の vCard を転送します"
Case 8 'used in VCardLib
getString = "転送する連絡先を 1 つ以上選択する必要があります。"
Case 9 'used in VCardLib
getstring = "vCard の転送"
End Select
End Function
単にMessage Stringを取得する為のFunctionなのですが、これはConstで定義すれば良い話で、Functionにする必要があるのか??と思うのは私だけでしょうか?
開発にPriorityがあって、Base Code/Mail Temlate開発/Directoryなどと順序付けがされているのかも知れません。
しかし、これだけ酷いCodeを書く担当者を雇って、それもそのCodeを見ることもなく世の中に晒しているIBMは何を考えているのか理解が出来ません。
このCodeに非常に深い意味があるのなら良いですが・・・・
Mail Tempalteでも不思議に思うCodeは数多く存在しますが、Personal AddressbookのCodeは非常に酷い状況であることは確かでしょう。
今回は、Group転送のCodeを確認してみました。
次回は、もっと悲惨な状況になるであろうLocation文書の転送Codeを試してみます。
iNotes 9をCustomizeしてみよう! -6-
<話題の履歴>
前回は、IBMが提供しているSample Codeを元に新規Menuの追加を行ってみました。
今回は、少し役立つCustomizeを考えてみます。
みなさんの環境でも、Notesに届いたMailを携帯などのMobile Deviceに転送するということを行われてきたと思います。
しかし、Smart Phoneが主流となった今では、Mailの転送は行わず、Securityの保たれた安全な方法でServerに保存されたMailを閲覧したり、Smart PhoneにDownloadしてSmart PhoneのApplicationで閲覧するのが主流となっています。
Notes/Dominoで言うと、Notes Travelerがその代表的な物です。
Notes/DominoはMail Ruleが提供されてから、受信したMailに対する処理が出来るようになり、MailのCopyを送信することも出来るようになっています。
iNotesでもMail Ruleが使えるようになっていますが、会社によってはSecurityの観点から勝手にMailを外部に転送することを許可していない場合もあることでしょう。
となると、このMail Ruleによる外部へのMail転送は禁止しなければ運用が出来なくなります。
或は、Mailを転送すると、誤ったAddressに転送設定してLoopさせてしまうことを心配される方もいらっしゃるかも知れません。
実はRuleによるMail転送に関しては、Mail Ruleで送信したMailはFromの値を入れない状態で転送されるようになっています。
これにより転送先のAddressが無効であったとしても、相手先のPost MasterからNon Delivvery Reportが戻って来ることはないのです。
この設定は、Notes.iniで制御が可能になっており、以下の設定が可能です。
詳細は、IBMのTechnote を参照ください。
RouterUserRuleForwardReversePath=n
0:デフォルト値です。SMTPOriginator フィールド に NULL が設定されます(デフォルト値)。
1:SMTPOriginator フィールドに元のメールの送信者のアドレスがそのまま引き継がれます。送信エラーレポートは元のメッセージ送信者に送られます。
2:SMTPOriginator フィールドに元のメールの受信者のアドレスが設定されます(これを設定する場合は、メールループが発生する可能性があることに注意してください)。
3:SMTPOriginator フィールドに、元のメールの受信者のアドレスの前に "nobounce" という文字列が追加されて設定されます。そのため、送信エラーレポートは元のメッセージ送信者には送られません。
前置きが長くなりましたが、iNotesでMail RuleによるMailのCopy転送を禁止したいという要望はあることでしょう。
標準の状態では、以下のように設定ができてしまいます。
この機能のCustomizeを行うには、Forms9_x.nsfでは変更はできず、基本機能が入ったForms9.nsfのCustomizeが必要になります。
この「次の宛先にコピーを送信」という言葉が入った設計要素を探すことが出来れば、Customizeする場所の特定が出来る訳ですが、最初に紹介したように、iNotesではMessageなどの定数は全てEncodeされた状態で、dwa_ja.propertiesに格納されています。
まず、以前紹介したEncode/DecodeのSite で「次の宛先にコピーを送信」をEncodeすると、Unicodeで"\u6b21\u306e\u5b9b\u5148\u306b\u30b3\u30d4\u30fc\u3092\u9001\u4fe1"となることが分かります。
この文字をdwa_ja.propertiesの中を探すと以下が定義されていることが分かります。
L_RULES_ACT_SND_CPY_TO=\u6b21\u306e\u5b9b\u5148\u306b\u30b3\u30d4\u30fc\u3092\u9001\u4fe1
つまり、設計要素の中では、"L_RULES_ACT_SND_CPY_TO"という定数が使われてCodingされているハズです。
Domino Designerの検索機能を使ってこの文字を検索すると、以下のように結果が表示されます。
つまり、"s_RuleEditCode" Formにこの定義が行われていることが分かるのです。
念の為に、Mail TemplateのRule設定のFormである"(RulesDlg) | Mailrule"のAction Fieldを確認すると、以下のようになってることが分かります。
これで、修正個所は"s_RuleEditCode" Formの以下の部分であることが分かるのです。
<dwa:string id="L_RULES_ACT_SND_CPY_TO"/> + "|B"
この部分が、Notesの"(RulesDlg) | Mailrule"のAction Fieldの選択肢を生成している部分と同じ処理を行っている部分ですので、この部分を削除してやれば選択肢に現れなくなるハズです。
この修正は、UIの表示の選択肢を削除しているだけで実際のLogic修正を伴わないため非常にRiskの少ない変更となります。
実際にこの部分を削除してやると、以下のようにRuleの設定から選択肢が消えます。
これで、Mail Ruleから「次の宛先にコピーを送信」のActionを消すことが出来、UserにこのActionを選択不可能にすることが出来るのです。
余談ですが、以前のNotes Clientの場合はこんな面倒なことは不要だったハズです。
Server Configuration Documentの設定で「コピーを送信」のActionを禁止することができ、これを設定するとNotes ClientのMail Ruleでは「コピーを送信」が消え去っていました(古いVersionの環境がありませんので昔の記憶)し、Server Configuration Documentの設定にはそのように記載されています。
ところが、Notes 9 Mail Templateの場合は、Server Configuration Documentで設定しても、RuleのAction選択肢からは消えなくなってしまっているようです。
このServer Configuration Documentの設定をすると、NotesやiNotesのMail Ruleで設定したとしても、Mail Ruleの「コピーを送信」のActionは動くことはありませんが、残念ながら表示からは消えないようなのです。
今回は、Mail Ruleから「次の宛先にコピーを送信」Actionを利用不可にするCustomizeを行ってみました。
次回は、Address DialogのCustomizeを行ってみたいと思います。
不思議なGroup転送とLocation転送 -2-
<話題の履歴>
前回は、Location文書やGroup文書の機能を簡単に見てみました。
今回は、試しながら内容を細かく見てみたいと思います。
前回も紹介した送信Buttonに書かれているLotusScriptですが、単にUI Documentから"Type"(Person/Group/Databaseなどが入る) Fieldを消してSend(True)しているだけです。
Sub Click(Source As Button)
Dim Workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = Workspace.currentdocument
Dim doc As NotesDocument
Set doc = uidoc.document
Dim y As Integer
doc.Sent = "Yes" 'DNT
Call doc.RemoveItem( "Type" )
Call doc.Send (True)
Forall x In doc.SendTo
y = y + 1
End Forall
Print xMsg & doc.ListName(0)
Call uidoc.CLOSE
End Sub
しかし、なぜ、Type Fieldを削除するのでしょうか?
これは後々見てみたいと思いますが、Send(True)により、このMailにはForm設計が含まれて送られることになります。
Mail DBに"TransferGroup"や"TransferLocation"のFormが無いことを前提に、Form設計を格納して送付する仕様のようなのですが、Mail Templateの設計を覗いてみると、"TransferGroup" Formは存在し、"TransferLocation" Formは存在しないという非常に中途半端な状態になっています。
IBMさんは一体何がしたかったのか??と疑問になってえしまいます。
Forall x In doc.SendTo
y = y + 1
End Forall
に関しては、全く意味がなさそうで、何人に送ったのかをカウントしているだけですが、どこでも使われていません。
また、doc.Sent = "Yes" 'DNT も何か重要な意味があるのでしょうか?
単に、送付済Flagを立てているだけのようですが、このFieldを判断して処理しているような部分は見当たりません。
これも非常に不思議な状態です。
送信時にType Fieldだけを削除していることから、このFormの中にはGroup文書やLocation文書に必要な様々なFieldが存在しているハズです。
これは、Viewの設計の「送信」Buttonの設計を見てみると分かります。
Group ViewのButtonを参照すると、以下のようなCodeが書かれています。
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim bedoc As NotesDocument
Dim rtnval As Integer
Set session = New NotesSession
Set sourcedb = session.CurrentDatabase
Set documents = sourcedb.UnprocessedDocuments
Set sourcedoc = documents.GetFirstDocument
If documents.count > 1 Then
rtnval = Msgbox (groupMsg1, 64, msgTitle)
Exit Sub
Elseif documents.count < 1 Then
Messagebox groupMsg2 , 64, msgTitle
Exit Sub
End If
' If Not (sourcedoc Is Nothing) Then
' If Not (sourcedoc.Type(0) = "Group") Then
' Messagebox "You can only send Group documents (Distribution Lists) at this time. You have currently selected a " & sourcedoc.Type(0) & " document.", 49, "Send Group Document"
' Exit Sub
' End If
' End If
Call workspace.composedocument("","","TransferGroup") 'DNT
Set uidoc = workspace.currentdocument
Dim sentdoc As Notesdocument
Set sentdoc = uidoc.document
Call sourcedoc.CopyAllItems( sentdoc, True )
Call sentdoc.replaceitemvalue("ExcludeFromView", "")
sentdoc.form = "TransferGroup" 'DNT
sentdoc.SIGNONSEND = True
sentdoc.subject = groupMsg3 & sentdoc.ListName(0)
Call uidoc.Reload
End Sub
つまり、送信するGroupは1回に1文書のみで、Group文書のField(Item)を全て"TransferGroup" FormにCopyした後に、"ExcludeFromView"の値を消しています。
"ExcludeFromView" Fieldは、Mailの中で使われるFieldで、"A"や"D"といった値が入っているFieldです。
どのように使われているかというと、iNotesはMail DBの中にAddressbookを持っていて、Person文書やGroup文書などAddressbookのEntryには"A"が格納されますし、更にNotesでもCalendar Profile以外のProfile文書はMail DBの文書として格納されているため、"D"が設定されています。
Mailを表示するViewやFolderにこれらの文書が表示されては困りますので、、"ExcludeFromView" Fieldの値で判断してViewやFolderの表示から除外しているのです。
ここでこのFieldを削除している意味は、iNotesのMail DBに保存したAddressbookとNotesのPersonal AddressbookはReplicatorによって同期させることが可能になっていますので、iNotesで作成されたAddressbook EntryをReplicaすると、"ExcludeFromView" Fieldが入って来るので、それに対応して削除しているという訳です。
つまり、このViewのButtonから作成される文書内には、元となる文書の殆どのFieldがCopyされるという訳です。
Group文書の場合はFieldの数は知れていますが、Location文書の場合はどうでしょう?
Location文書は様々な設定があり、Field数も半端ではありません。
しかし、Location文書の場合も同様なCodeが書かれており、全てのFieldをCopyする仕様です。
ここで賢明な皆さんは気が付かれるかも知れませんが、Location文書に保持しているFieldというのは、Location文書のForm設計に定義されたFieldだけではないのです。
Location文書の文書のPropertyを見ると分かりますが、様々なSystem Fieldが格納されています。
これは実際の例ですが、Mail ServerやMail Fileの履歴を持ったりしています。
この例にはありませんが、ServerにAccessした際のIPやFQDNを保存するFieldも存在するのです。
これらのFieldを全てCopyして送信するということは好ましいことではないと思います。
しかし、これらのFieldをLocation文書やGroup文書の登録時にちゃんと消していれば問題はない訳です。
これはImportするButtonをCheckすると分かると思います。
今回は、Group文書やLocation文書の送信処理について見てみました。
次回は、送信された文書の登録処理を調べてみます。












