http://git-wip-us.apache.org/repos/asf/isis-site/blob/97af7e5f/content/guides/ugvro/ugvro.html ---------------------------------------------------------------------- diff --git a/content/guides/ugvro/ugvro.html b/content/guides/ugvro/ugvro.html index f7ddf13..12c7cfb 100644 --- a/content/guides/ugvro/ugvro.html +++ b/content/guides/ugvro/ugvro.html @@ -243,6 +243,7 @@ table.CodeRay td.code>pre{padding:0} </div> </form> </div> + <p class="nav navbar-text navbar-right small">v1.16.1</p> </div> </div> </nav> @@ -2017,7 +2018,7 @@ findCustomer.get({<span class="key">queryString</span>: JSON.stringify(findCusto <footer class="footer"> <div class="container"> <div class="row"> - <p class="text-center small text-muted"> Copyright © 2010~2017 The Apache Software Foundation, licensed under the Apache License, v2.0. <br> Apache, the Apache feather logo, Apache Isis, and the Apache Isis project logo are all trademarks of The Apache Software Foundation. </p> + <p class="text-center small text-muted"> Copyright © 2010~2018 The Apache Software Foundation, licensed under the Apache License, v2.0. <br> Apache, the Apache feather logo, Apache Isis, and the Apache Isis project logo are all trademarks of The Apache Software Foundation. </p> </div> </div> </footer>
http://git-wip-us.apache.org/repos/asf/isis-site/blob/97af7e5f/content/guides/ugvro/ugvro.pdf ---------------------------------------------------------------------- diff --git a/content/guides/ugvro/ugvro.pdf b/content/guides/ugvro/ugvro.pdf index c77b605..611ac97 100644 --- a/content/guides/ugvro/ugvro.pdf +++ b/content/guides/ugvro/ugvro.pdf @@ -4,8 +4,8 @@ << /Title (Restful Objects Viewer) /Creator (Asciidoctor PDF 1.5.0.alpha.11, based on Prawn 1.3.0) /Producer (Asciidoctor PDF 1.5.0.alpha.11, based on Prawn 1.3.0) -/CreationDate (D:20180108224956+00'00') -/ModDate (D:20180108224956+00'00') +/CreationDate (D:20180222223053+00'00') +/ModDate (D:20180222223053+00'00') >> endobj 2 0 obj http://git-wip-us.apache.org/repos/asf/isis-site/blob/97af7e5f/content/guides/ugvw/ugvw.html ---------------------------------------------------------------------- diff --git a/content/guides/ugvw/ugvw.html b/content/guides/ugvw/ugvw.html index 227deef..c39bd49 100644 --- a/content/guides/ugvw/ugvw.html +++ b/content/guides/ugvw/ugvw.html @@ -243,6 +243,7 @@ table.CodeRay td.code>pre{padding:0} </div> </form> </div> + <p class="nav navbar-text navbar-right small">v1.16.1</p> </div> </div> </nav> @@ -1365,24 +1366,39 @@ table.CodeRay td.code>pre{padding:0} <div class="paragraph"> <p>The <code>Xxx.layout.xml</code> file is just the serialized form of a <a href="../rgcms/rgcms.html#_rgcms_classes_layout"><code>Grid</code></a> layout class defined within Apache Isis' applib. These are JAXB-annotated classes with corresponding XSD schemas; the upshot of that is that IDEs such as IntelliJ and Eclipse can provide "intellisense", making iteasy to author such layout files.</p> </div> - <div class="admonitionblock note"> - <table> - <tbody> - <tr> - <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> - <td class="content"> - <div class="paragraph"> - <p>It is also possible to describe layouts using a <code>.layout.json</code> file. However, <code>.layout.json</code> support is deprecated; the <code>.layout.xml</code> file also enables much more sophisticated layouts than those afforded by <code>.layout.json</code>.</p> - </div> - <div class="paragraph"> - <p>If you have an application with older <code>.layout.json</code> files, then it is possible to download initial <code>.layout.xml</code> files using the <a href="../rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService"><code>LayoutService</code></a> (exposed as an action on the prototyping menu). The <code>.layout.json</code> file will be ignored once a <code>.layout.xml</code> file is present.</p> - </div> </td> - </tr> - </tbody> - </table> + <div class="sect3"> + <h4 id="_search_algorithm_library_support">3.2.1. Search Algorithm (Library Support)</h4> + <div class="paragraph"> + <p>For a given domain object <code>Xxx</code> the framework initially searches for a file (on the classpath) called <code>Xxx.layout.xml</code>.</p> + </div> + <div class="paragraph"> + <p>If this canât be found, then the framework will search for a file named <code>Xxx.layout.fallback.xml</code>. If present, this will be used instead.</p> + </div> + <div class="paragraph"> + <p>This therefore allows libraries that provide a domain entities/view models (for example, the (non-ASF) <a href="http://platform.incode.org">Incode Platform</a> modules) to define the UI of these objects using a layout file, while still allowing the consuming application to override that layout if it so requires.</p> + </div> + <div class="admonitionblock note"> + <table> + <tbody> + <tr> + <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> + <td class="content"> + <div class="paragraph"> + <p>It is also possible to describe layouts using a <code>.layout.json</code> file. However, <code>.layout.json</code> support is deprecated; the <code>.layout.xml</code> file also enables much more sophisticated layouts than those afforded by <code>.layout.json</code>.</p> + </div> + <div class="paragraph"> + <p>If you have an application with older <code>.layout.json</code> files, then it is possible to download initial <code>.layout.xml</code> files using the <a href="../rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService"><code>LayoutService</code></a> (exposed as an action on the prototyping menu).</p> + </div> + <div class="paragraph"> + <p>The <code>.layout.json</code> file will be ignored once a <code>.layout.xml</code> file is present.</p> + </div> </td> + </tr> + </tbody> + </table> + </div> </div> <div class="sect3"> - <h4 id="_grids_vs_components">3.2.1. Grids vs Components</h4> + <h4 id="_grids_vs_components">3.2.2. Grids vs Components</h4> <div class="paragraph"> <p>The layout file distinguishes between two types of element:</p> </div> @@ -1400,13 +1416,13 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="_screencast">3.2.2. Screencast</h4> + <h4 id="_screencast">3.2.3. Screencast</h4> <div class="paragraph"> <p>This <a href="https://www.youtube.com/watch?v=MxewC5Pve5k">screencast</a> describes the feature.</p> </div> </div> <div class="sect3"> - <h4 id="_examples">3.2.3. Examples</h4> + <h4 id="_examples">3.2.4. Examples</h4> <div class="paragraph"> <p>Probably the easiest way to understand dynamic XML layouts is by example. For this weâll use the <code>ToDoItem</code> from the (non-ASF) <a href="http://github.com/isisaddons/isis-app-todoapp">Isis addons' todoapp</a>:</p> </div> @@ -1570,7 +1586,7 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="__ugvw_layout_file-based_unreferenced">3.2.4. Unreferenced Members</h4> + <h4 id="__ugvw_layout_file-based_unreferenced">3.2.5. Unreferenced Members</h4> <div class="paragraph"> <p>As noted in the preceding discussion, several of the gridâs regions have either an <code>unreferencedActions</code>, <code>unreferencedCollections</code> or <code>unreferencedProperties</code> attribute.</p> </div> @@ -1598,7 +1614,7 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="_more_advanced_features">3.2.5. More advanced features</h4> + <h4 id="_more_advanced_features">3.2.6. More advanced features</h4> <div class="paragraph"> <p>This section decribes a number of more features useful in more complex layouts.</p> </div> @@ -1731,7 +1747,7 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="_migrating_from_earlier_versions">3.2.6. Migrating from earlier versions</h4> + <h4 id="_migrating_from_earlier_versions">3.2.7. Migrating from earlier versions</h4> <div class="paragraph"> <p>As noted earlier on, it is possible to download layout XML files using the <a href="../rgsvc/rgsvc.html#_rgsvc_metadata-api_LayoutService"><code>LayoutService</code></a> (exposed on the prototyping menu); this will download a ZIP file of layout XML files for all domain entities and view models. Alternatively the layout XML for a single domain object can be downloaded using the <a href="../rgcms/rgcms.html#_rgcms_classes_mixins_Object">mixin action</a> (contributed to every domain object).</p> </div> @@ -1803,7 +1819,7 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="_domain_services">3.2.7. Domain Services</h4> + <h4 id="_domain_services">3.2.8. Domain Services</h4> <div class="paragraph"> <p>For more information about layouts, see:</p> </div> @@ -1816,7 +1832,7 @@ table.CodeRay td.code>pre{padding:0} </div> </div> <div class="sect3"> - <h4 id="_required_updates_to_the_dom_project_s_pom_xml">3.2.8. Required updates to the dom projectâs pom.xml</h4> + <h4 id="_required_updates_to_the_dom_project_s_pom_xml">3.2.9. Required updates to the dom projectâs pom.xml</h4> <div class="paragraph"> <p>Any <code>.layout.xml</code> files must be compiled and available in the classpath. Ensure the following is defined in the dom projectâs <code>pom.xml</code>:</p> </div> @@ -4995,7 +5011,7 @@ cssClassUiEvent = DemoObject.CssClassUiEvent.class <footer class="footer"> <div class="container"> <div class="row"> - <p class="text-center small text-muted"> Copyright © 2010~2017 The Apache Software Foundation, licensed under the Apache License, v2.0. <br> Apache, the Apache feather logo, Apache Isis, and the Apache Isis project logo are all trademarks of The Apache Software Foundation. </p> + <p class="text-center small text-muted"> Copyright © 2010~2018 The Apache Software Foundation, licensed under the Apache License, v2.0. <br> Apache, the Apache feather logo, Apache Isis, and the Apache Isis project logo are all trademarks of The Apache Software Foundation. </p> </div> </div> </footer>