{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"This method sends a message to a previously displayed Rich Display File screen and then waits for the user to respond or for the screen's onmessage event to automatically respond. It allows applications to update screen content without re-rendering the entire screen.","type":"text"}]},{"type":"paragraph","content":[{"text":"The message can be received using the record format's ","type":"text"},{"text":"onmessage","type":"text","marks":[{"type":"code"}]},{"text":" event.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parameter","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Message","type":"text","marks":[{"type":"em"}]},{"text":" - the message can be supplied using any primitive JavaScript value, including Strings, Objects, and Arrays","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"section","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"0bcd2e42-d63d-4ffb-8fe8-036ecfc82790"},"schemaVersion":{"value":"1"},"title":"Section"}}},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Showing the Progress During Long Running Operations","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"50%

javascriptUsing display.screen.executeMessage()

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"50%"}},"macroMetadata":{"macroId":{"value":"f1a607f9-20f3-4b0f-8599-67b59a7d20ce"},"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Using display.screen.executeMessage()","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"// Read entire products file\nproductsp.positionTo(pjs.START);\nproductsp.fetchNext();\nwhile (!productsp.endOfData()) { \n display.myscreen.executeMessage(\"Processing product#: \" + prid);\n productsp.fetchNext();\n}\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"50%

javascriptSample onmessage Event

\" + message;\n pui.click(); // sends control back to server after rendering message\n}]]>

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"50%"}},"macroMetadata":{"macroId":{"value":"54b2f99a-88f5-4522-beda-79b58d6f79bd"},"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sample onmessage Event","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"if (typeof message === \"string\") {\n getObj(\"progressBox\").innerHTML += \"
\" + message;\n pui.click(); // sends control back to server after rendering message\n}","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"section","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"686cf16a-01a2-4728-8014-381ba8947e4b"},"schemaVersion":{"value":"1"},"title":"Section"}}},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Validate ","type":"text"},{"text":"Without","type":"text","marks":[{"type":"em"}]},{"text":" Reloading the Screen","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"50%

javascriptUsing display.screen.executeMessage()

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"50%"}},"macroMetadata":{"macroId":{"value":"59be94b7-1c8f-428a-af1c-b02c8fa291ef"},"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Using display.screen.executeMessage()","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"display.dataentry.execute();\nvar msg = validate();\nwhile (msg != null) {\n display.dataentry.executeMessage(msg);\n msg = validate();\n}\n \nfunction validate() {\n // Server-side data entry validation logic goes here\n customersp.getRecord(custid);\n if (!customersp.found()) {\n return \"You entered an invalid customer id\";\n }\n return null;\n}\n","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"50%

javascriptSample onmessage Event

","nestedContent":{"type":"doc","content":[{"type":"bodiedExtension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"column","parameters":{"macroParams":{"width":{"value":"50%"}},"macroMetadata":{"macroId":{"value":"d32939aa-f097-4777-8dbe-d524d517e8c1"},"schemaVersion":{"value":"1"},"title":"Column"}}},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Sample onmessage Event","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"javascript"},"content":[{"text":"alert(message);","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}],"version":1},"reason":"A column macro in a rich body macro can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.macro.core","extensionKey":"widget","parameters":{"macroParams":{"overlay":{"value":"youtube"},"_template":{"value":"com/atlassian/confluence/extra/widgetconnector/templates/youtube.vm"},"width":{"value":"640px"},"url":{"value":"https://www.youtube.com/watch?v=BrP0nhdbI-8"},"height":{"value":"360px"}},"macroMetadata":{"macroId":{"value":"c503c6fe-bc9a-49af-8b87-1c731b39d660"},"schemaVersion":{"value":"1"},"placeholder":[{"type":"image","data":{"url":"/plugins/servlet/widgetconnector/placeholder?thumb=https://img.youtube.com/vi/BrP0nhdbI-8/mqdefault.jpg&overlay=youtube&width=640&height=360"}}],"title":"Widget Connector"}}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}