{"id":105,"date":"2011-07-22T10:58:33","date_gmt":"2011-07-22T08:58:33","guid":{"rendered":"http:\/\/hasselba.ch\/blog\/?p=105"},"modified":"2012-04-02T13:43:44","modified_gmt":"2012-04-02T11:43:44","slug":"xpages-inmemory-agents","status":"publish","type":"post","link":"https:\/\/hasselba.ch\/blog\/?p=105","title":{"rendered":"XPages & InMemory-Agents"},"content":{"rendered":"

Mit InMemory-Agents lassen sich Agenten wunderbar in XPage-Applikationen integrieren. Die XPage wartet, bis der Agent durchgelaufen ist, und \u00fcber den Documentcontext kann eine bidirektionale Kommunikation zwischen den beiden\u00a0 stattfinden. Ohne irgendwelche mehr oder minder dubiose Workarounds f\u00fcr das Zwischenspeichern von Werten (z.B. Speichern des Dokumentes, Arbeiten mit Profildokumenten, usw.) k\u00f6nnen auf diesem Weise bestehende LotusScript-Agenten in eine XPage integriert werden:<\/p>\n

Hier ein kleines Beispiel mit einem Button, der einen Agent startet, und dessen Ergebnis auswertet :<\/p>\n

<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<xp:view xmlns:xp=\"http:\/\/www.ibm.com\/xsp\/core\">\r\n   <xp:button value=\"Label\" id=\"button1\">\r\n       <xp:eventHandler event=\"onclick\" submit=\"true\"\r\n       refreshMode=\"complete\">\r\n         <xp:this.action><![CDATA[#{javascript:\r\n            var document = database.createDocument();\r\n            var agent = database.getAgent(\"InMemoryAgent\");\r\n            agent.runWithDocumentContext( document );<\/span>\r\n            print( document.getItemValueString(\"InMemReturn\") );<\/span>\r\n            }]]>\r\n         <\/xp:this.action>\r\n      <\/xp:eventHandler>\r\n   <\/xp:button>\r\n<\/xp:view><\/pre>\n
[In Rot: Der Aufruf des Agenten. Der Code nach dem Aufruf wird erst nach Laufen des Agenten ausgef\u00fchrt ]<\/em><\/p>\n
Der LotusScript-Agent f\u00fcr dieses Beispiel schreibt den aktuellen Zeitstempel in das \u00fcbergebene Dokument:<\/p>\n
Option Public\r\nOption Declare\r\n\r\nSub Initialize\r\n Dim session As New NotesSession\r\n Dim doc As NotesDocument\r\n\r\n Set doc = session.Documentcontext\r\n doc.Appenditemvalue \"InMemReturn\", CStr(Now)\r\n\r\nEnd Sub<\/pre>\n
Der print-Befehl in der obigen XPage wird erst nach der Verarbeitung des Agenten ausgef\u00fchrt; auf der Serverkonsole wird der aktuelle Datumsstring ausgegeben.<\/p>\n
Nat\u00fcrlich kann es sich auch um einen Java-Agenten handeln, doch f\u00fcr beide gilt, da\u00df der Haken „Run as Web user“ aktiviert sein mu\u00df:<\/p>\n
\"\"<\/p>\n
Ist der Haken nicht aktiviert, erh\u00e4lt man ansonsten eine im ersten Moment nichtssagende Fehlermeldung serviert:<\/p>\n
Exception occured calling\r\nNotesAgent.runWithDocumentContext (lotus.domino.local.Document) null<\/pre>\n
\"\"<\/p>\n
Die Meldung verwirrt im ersten Moment, und es ist das erste Mal, da\u00df sich im Stack Trace<\/span> eine wirklich aussagekr\u00e4ftige Information wiederfindet (man mu\u00df etwas suchen, hier stark verk\u00fcrzt):<\/p>\n
(…)
\ncom.ibm.designer.runtime.domino.adapter.LCDEnvironment.doService(LCDEnvironment.java:304)
\ncom.ibm.designer.runtime.domino.adapter.LCDEnvironment.service(LCDEnvironment.java:261)
\ncom.ibm.domino.xsp.bridge.http.engine.XspCmdManager.service(XspCmdManager.java:291)
\nNotesException: Unable to pass doc context – Inner agent must run as webuser<\/strong>
\nlotus.domino.local.Agent.runWithDocumentContext(Unknown Source)
\ncom.ibm.xsp.script.DominoHelper$5.run(DominoHelper.java:154)
\n(…)<\/p>\n
[In Fett: Die erste aussagekr\u00e4ftige Stack Trace-Meldung. Es geht doch, liebe IBM!]<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"
Mit InMemory-Agents lassen sich Agenten wunderbar in XPage-Applikationen integrieren. Die XPage wartet, bis der Agent durchgelaufen ist, und \u00fcber den Documentcontext kann eine bidirektionale Kommunikation zwischen den beiden\u00a0 stattfinden. Ohne irgendwelche mehr oder minder dubiose Workarounds f\u00fcr das Zwischenspeichern von … Weiterlesen →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[21,1,20,74],"tags":[79,7,80,5,3],"class_list":["post-105","post","type-post","status-publish","format-standard","hentry","category-agenten","category-allgemein","category-lotus-script","category-xpages","tag-agenten","tag-domino","tag-lotus-script","tag-ssjs","tag-xpages"],"_links":{"self":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/105","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=105"}],"version-history":[{"count":7,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/105\/revisions"}],"predecessor-version":[{"id":604,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/105\/revisions\/604"}],"wp:attachment":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=105"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=105"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=105"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}