You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@isis.apache.org by da...@apache.org on 2016/05/17 19:01:31 UTC
[4/6] isis-site git commit: splitting out config properties into
sections
http://git-wip-us.apache.org/repos/asf/isis-site/blob/44ddd889/content/guides/rgcfg.html
----------------------------------------------------------------------
diff --git a/content/guides/rgcfg.html b/content/guides/rgcfg.html
index d2a9d10..13aa76c 100644
--- a/content/guides/rgcfg.html
+++ b/content/guides/rgcfg.html
@@ -993,8 +993,10 @@ for Apache Isis and contribute back to the project)</p>
</tr>
</table>
</div>
+<div class="sect2">
+<h3 id="_rgcfg_configuring-core_domain-events">5.1. Domain Events</h3>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 4. Core Configuration Properties</caption>
+<caption class="title">Table 4. Core Configuration Properties for Domain Events</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 16.6666%;">
@@ -1011,31 +1013,6 @@ for Apache Isis and contribute back to the project)</p>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.objects.</code><br>
-<code>editing</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
-(<code>true</code>)</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether objects' properties and collections can be edited directly (for objects annotated with <a href="rgant.html#_rgant-DomainObject_editing"><code>@DomainObject#editing()</code></a>); see <a href="#_rgcfg_configuring-core_isis-objects-editing">below</a> for further discussion.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.persistor.</code><br>
-<code>disableConcurrencyChecking</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
-(<code>false</code>)</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Disables concurrency checking globally. <br></p>
-</div>
-<div class="paragraph">
-<p>Only intended for "emergency use" as a workaround while pending fix/patch to Apache Isis itself. (Note that there is no "datanucleus" in the property).</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.reflector.facet.</code><br>
<code>actionAnnotation.</code><br>
<code>domainEvent.postForDefault</code></p>
@@ -1061,29 +1038,36 @@ for Apache Isis and contribute back to the project)</p>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.reflector.facet.</code><br>
-<code>cssClass.patterns</code></p>
+<code>propertyAnnotation.</code><br>
+<code>domainEvent.postForDefault</code></p>
</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">regex:css1, regex2:css2,…​</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
+(<code>true</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Comma separated list of key:value pairs, where the key is a regex matching action names (eg <code>delete.*</code>) and the value is a <a href="http://getbootstrap.com/css/">Bootstrap</a> CSS button class (eg <code>btn-warning) to be applied (as per `@CssClass()</code>) to all action members matching the regex.<br></p>
-</div>
-<div class="paragraph">
-<p>See <a href="ugfun.html#_ugfun_how-tos_ui-hints_action-icons-and-css">UI hints</a> for more details.</p>
+<p>Whether an event should be posted if <a href="rgant.html#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a> is not specified (is set to <code>PropertyDomainEvent.Default</code>).</p>
</div></div></td>
</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facet.</code><br>
-<code>cssClassFa.patterns</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">regex:fa-icon,regex2:fa-icon2,…​</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Comma separated list of key:value pairs, where the key is a regex matching action names (eg <code>create.*</code>) and the value is a <a href="http://fortawesome.github.io/Font-Awesome/icons/">font-awesome</a> icon name (eg <code>fa-plus</code>) to be applied (as per <code>@CssClassFa()</code>) to all action members matching the regex.<br></p>
+</tbody>
+</table>
</div>
-<div class="paragraph">
-<p>See <a href="ugfun.html#_ugfun_how-tos_ui-hints_action-icons-and-css">UI hints</a> for more details.</p>
-</div></div></td>
+<div class="sect2">
+<h3 id="_rgcfg_configuring-core_lifecycle-events">5.2. Lifecycle Events</h3>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 5. Core Configuration Properties for Lifecycle Events</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 16.6666%;">
+<col style="width: 50.0001%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Value<br>
+(default value)</th>
+<th class="tableblock halign-left valign-top">Description</th>
</tr>
+</thead>
+<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.reflector.facet.</code><br>
@@ -1175,6 +1159,27 @@ for Apache Isis and contribute back to the project)</p>
<p>Whether an event should be posted if <a href="rgant.html#_rgant-DomainObject_updatedLifecycleEvent"><code>@DomainObject#updatedLifecycleEvent()</code></a> is not specified (is set to <code>ObjectUpdatedEvent.Default</code>).</p>
</div></div></td>
</tr>
+</tbody>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_rgcfg_configuring-core_ui-events">5.3. UI Events</h3>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 6. Core Configuration Properties for UI Events</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 16.6666%;">
+<col style="width: 50.0001%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Value<br>
+(default value)</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.reflector.facet.</code><br>
@@ -1211,104 +1216,27 @@ for Apache Isis and contribute back to the project)</p>
<p>Whether an event should be posted if <a href="rgant.html#_rgant-DomainObjectLayout_titleUiEvent"><code>@DomainObjectLayout#titleUiEvent()</code></a> is not specified (is set to <code>TitleUiEvent.Default</code>).</p>
</div></div></td>
</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facet.</code><br>
-<code>filterVisibility</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
-(<code>true</code>)</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether objects should be filtered for visibility.<br></p>
-</div>
-<div class="paragraph">
-<p>See <a href="#_rgcfg_configuring-core_filterVisibility">section below</a> for further discussion.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facet.</code><br>
-<code>propertyAnnotation.</code><br>
-<code>domainEvent.postForDefault</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
-(<code>true</code>)</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether an event should be posted if <a href="rgant.html#_rgant-Property_domainEvent"><code>@Property#domainEvent()</code></a> is not specified (is set to <code>PropertyDomainEvent.Default</code>).</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facets</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code></p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Fully qualified class names of a custom implementation of <code>ProgrammingModel</code> interface.<br></p>
-</div>
-<div class="paragraph">
-<p>See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facets.</code><br>
-<code>exclude</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Fully qualified class names of (existing, built-in) facet factory classes to be included to the programming model.<br></p>
-</div>
-<div class="paragraph">
-<p>See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.facets.</code><br>
-<code>include</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Fully qualified class names of (new, custom) facet factory classes to be included to the programming model.<br>
-See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.</code><br>
-<code>layoutMetadataReaders</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Fully qualified class names of classes to be instantiated to read layout metadata, as used in for <a href="ugfun.html#_ugfun_object-layout_dynamic">dynamic layout</a>s.<br></p>
-</div>
-<div class="paragraph">
-<p>See <a href="ugbtb.html#_ugbtb_programming-model_layout-metadata-reader">Layout Metadata Reader</a> for more information.</p>
-</div></div></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.validator</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code></p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Custom implementation of <code>MetaModelValidator</code> (in the <code>org.apache.isis.core.metamodel.specloader.validator</code> package)<br></p>
+</tbody>
+</table>
</div>
-<div class="paragraph">
-<p>See <a href="ugbtb.html#_ugbtb_programming-model_custom-validator">Custom Validator</a> to learn more.</p>
-</div></div></td>
-</tr>
+<div class="sect2">
+<h3 id="_rgcfg_configuring-core_services">5.4. Services</h3>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 7. Core Configuration Properties for Services</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 16.6666%;">
+<col style="width: 50.0001%;">
+</colgroup>
+<thead>
<tr>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p><code>isis.reflector.validator.</code><br>
-<code>allowDeprecated</code></p>
-</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
-(<code>true</code>)</p></td>
-<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether deprecated annotations or naming conventions are tolerated or not. If not, then a metamodel validation error will be triggered, meaning the app won’t boot (fail-fast).</p>
-</div></div></td>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Value<br>
+(default value)</th>
+<th class="tableblock halign-left valign-top">Description</th>
</tr>
+</thead>
+<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services</code></p>
@@ -1342,7 +1270,7 @@ See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the prog
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>ignoreSafe</code>, <code>none</code> (<code>all</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
-<p>Whether actions should be automatically reified into commands (for actions annotated with <a href="rgant.html#_rgant-Action_command"><code>@Action(command=CommandReification.AS_CONFIGURED)</code></a>. <br></p>
+<p>Whether action invocations should be automatically reified into commands (for actions annotated with <a href="rgant.html#_rgant-Action_command"><code>@Action(command=CommandReification.AS_CONFIGURED)</code></a>. <br></p>
</div>
<div class="paragraph">
<p><code>ignoreQueryOnly</code> is an alias for <code>ignoreSafe</code>.</p>
@@ -1351,6 +1279,16 @@ See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the prog
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
+<code>command.properties</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code> (<code>all</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>(<code>1.13.0-SNAPSHOT</code>) Whether property edits should be automatically reified into commands (for properties annotated with <a href="rgant.html#_rgant-Property_command"><code>@Property(command=CommandReification.AS_CONFIGURED)</code></a>. <br></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.services.</code><br>
<code>container.disableAutoFlush</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
@@ -1375,7 +1313,7 @@ See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the prog
<p><code>isis.services.</code><br>
<code>ContentNegotiation-</code><br>
<code>ServiceXRoDomainType</code><br>
-.prettyPrint</p>
+.<code>prettyPrint</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
(depends)</p></td>
@@ -1523,7 +1461,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
<p><code>isis.services.</code><br>
<code>publish.actions</code></p>
</div></div></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>ignoreSafe</code>, <code>none</code> (<code>all</code>)</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>ignoreSafe</code>, <code>none</code> (<code>none</code>)</p></td>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p>Whether actions should be automatically published (for actions annotated with <a href="rgant.html#_rgant-Action_publishing"><code>@Action(publishing=Publishing.AS_CONFIGURED)</code></a>.<br></p>
</div></div></td>
@@ -1531,6 +1469,16 @@ FQCN (<code><em>guava</em></code>)</p></td>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.services.</code><br>
+<code>publish.properties</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>all</code>, <code>none</code> (<code>none</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>(<code>1.13.0-SNAPSHOT</code>) Whether properties should be automatically published (for properties annotated with <a href="rgant.html#_rgant-Action_publishing"><code>@Property(publishing=Publishing.AS_CONFIGURED)</code></a>.<br></p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.services.</code><br>
<code>ServicesInstallerFromAnnotation.</code><br>
<code>packagePrefix</code></p>
</div></div></td>
@@ -1555,6 +1503,164 @@ FQCN (<code><em>guava</em></code>)</p></td>
<p>See <a href="ugbtb.html#_ugbtb_i18n">i18n support</a> to learn more about the translation service.</p>
</div></div></td>
</tr>
+</tbody>
+</table>
+</div>
+<div class="sect2">
+<h3 id="_rgcfg_configuring-core_other">5.5. Other Config Properties</h3>
+<table class="tableblock frame-all grid-all spread">
+<caption class="title">Table 8. Other Core Configuration Properties</caption>
+<colgroup>
+<col style="width: 33.3333%;">
+<col style="width: 16.6666%;">
+<col style="width: 50.0001%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Value<br>
+(default value)</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.objects.</code><br>
+<code>editing</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
+(<code>true</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Whether objects' properties and collections can be edited directly (for objects annotated with <a href="rgant.html#_rgant-DomainObject_editing"><code>@DomainObject#editing()</code></a>); see <a href="#_rgcfg_configuring-core_isis-objects-editing">below</a> for further discussion.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.persistor.</code><br>
+<code>disableConcurrencyChecking</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
+(<code>false</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Disables concurrency checking globally. <br></p>
+</div>
+<div class="paragraph">
+<p>Only intended for "emergency use" as a workaround while pending fix/patch to Apache Isis itself. (Note that there is no "datanucleus" in the property).</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facet.</code><br>
+<code>cssClass.patterns</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex:css1, regex2:css2,…​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Comma separated list of key:value pairs, where the key is a regex matching action names (eg <code>delete.*</code>) and the value is a <a href="http://getbootstrap.com/css/">Bootstrap</a> CSS button class (eg <code>btn-warning) to be applied (as per `@CssClass()</code>) to all action members matching the regex.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugfun.html#_ugfun_how-tos_ui-hints_action-icons-and-css">UI hints</a> for more details.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facet.</code><br>
+<code>cssClassFa.patterns</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">regex:fa-icon,regex2:fa-icon2,…​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Comma separated list of key:value pairs, where the key is a regex matching action names (eg <code>create.*</code>) and the value is a <a href="http://fortawesome.github.io/Font-Awesome/icons/">font-awesome</a> icon name (eg <code>fa-plus</code>) to be applied (as per <code>@CssClassFa()</code>) to all action members matching the regex.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugfun.html#_ugfun_how-tos_ui-hints_action-icons-and-css">UI hints</a> for more details.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facet.</code><br>
+<code>filterVisibility</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
+(<code>true</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Whether objects should be filtered for visibility.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="#_rgcfg_configuring-core_filterVisibility">section below</a> for further discussion.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facets</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Fully qualified class names of a custom implementation of <code>ProgrammingModel</code> interface.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facets.</code><br>
+<code>exclude</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Fully qualified class names of (existing, built-in) facet factory classes to be included to the programming model.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.facets.</code><br>
+<code>include</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Fully qualified class names of (new, custom) facet factory classes to be included to the programming model.<br>
+See <a href="ugbtb.html#_ugbtb_programming-model_finetuning">finetuning the programming model</a> for more details.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.</code><br>
+<code>layoutMetadataReaders</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code>,<code>FQCN2</code>,…​</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Fully qualified class names of classes to be instantiated to read layout metadata, as used in for <a href="ugfun.html#_ugfun_object-layout_dynamic">dynamic layout</a>s.<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugbtb.html#_ugbtb_programming-model_layout-metadata-reader">Layout Metadata Reader</a> for more information.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.validator</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>FQCN</code></p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Custom implementation of <code>MetaModelValidator</code> (in the <code>org.apache.isis.core.metamodel.specloader.validator</code> package)<br></p>
+</div>
+<div class="paragraph">
+<p>See <a href="ugbtb.html#_ugbtb_programming-model_custom-validator">Custom Validator</a> to learn more.</p>
+</div></div></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p><code>isis.reflector.validator.</code><br>
+<code>allowDeprecated</code></p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>true</code>,<code>false</code><br>
+(<code>true</code>)</p></td>
+<td class="tableblock halign-left valign-top"><div><div class="paragraph">
+<p>Whether deprecated annotations or naming conventions are tolerated or not. If not, then a metamodel validation error will be triggered, meaning the app won’t boot (fail-fast).</p>
+</div></div></td>
+</tr>
<tr>
<td class="tableblock halign-left valign-top"><div><div class="paragraph">
<p><code>isis.viewers.</code><br>
@@ -1588,8 +1694,9 @@ FQCN (<code><em>guava</em></code>)</p></td>
</tr>
</tbody>
</table>
+</div>
<div class="sect2">
-<h3 id="_rgcfg_configuring-core_filterVisibility">5.1. Filtering visibility</h3>
+<h3 id="_rgcfg_configuring-core_filterVisibility">5.6. Filtering visibility</h3>
<div class="paragraph">
<p>The framework provides the <code>isis.reflector.facet.filterVisibility</code> configuration property that influences whether a returned object is visible to the end-user:</p>
</div>
@@ -1645,7 +1752,9 @@ FQCN (<code><em>guava</em></code>)</p></td>
</div>
</div>
<div class="paragraph">
-<p>Filtering is supported by the Wicket viewer, and by the <a href="rgsvc.html#<em>rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper’s execution mode is _not</em> "skip rules"). However the Restful Objects viewer does <em>not</em> currently support filtering.</p>
+<p>Filtering is supported by the <a href="ugvw.html">Wicket viewer</a> and the <a href="ugvro.html">Restful Objects viewer</a>, and also
+by the <a href="rgsvc.html#_rgsvc_api_WrapperFactory"><code>WrapperFactory</code></a> domain service (provided the wrapper’s execution
+mode is <em>not</em> "skip rules").</p>
</div>
<div class="admonitionblock note">
<table>
@@ -1655,10 +1764,13 @@ FQCN (<code><em>guava</em></code>)</p></td>
</td>
<td class="content">
<div class="paragraph">
-<p>In order for the framework to perform this filtering of collections, be aware that the framework takes a <em>copy</em> of the original collection, filters on the collection, and returns that filtered collection rather than the original.</p>
+<p>In order for the framework to perform this filtering of collections, be aware that the framework takes a <em>copy</em> of the
+original collection, filters on the collection, and returns that filtered collection rather than the original.</p>
</div>
<div class="paragraph">
-<p>There are no major side-effects from this algorithm, other than the fact that the referenced objects will (most likely) need to be resolved in order to determine if they are visible. This could conceivably have a performance impact in some cases.</p>
+<p>There are no major side-effects from this algorithm, other than the fact that the referenced objects will (most likely)
+need to be resolved in order to determine if they are visible. This could conceivably have a performance impact in
+some cases.</p>
</div>
</td>
</tr>
@@ -1666,7 +1778,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
</div>
</div>
<div class="sect2">
-<h3 id="_rgcfg_configuring-core_isis-objects-editing">5.2. <code>objects.editing</code></h3>
+<h3 id="_rgcfg_configuring-core_isis-objects-editing">5.7. <code>objects.editing</code></h3>
<div class="paragraph">
<p>This configuration property in effect allows editing to be disabled globally for an application:</p>
</div>
@@ -1680,7 +1792,7 @@ FQCN (<code><em>guava</em></code>)</p></td>
</div>
</div>
<div class="sect2">
-<h3 id="_rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition">5.3. <code>propertyLayout.labelPosition</code></h3>
+<h3 id="_rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition">5.8. <code>propertyLayout.labelPosition</code></h3>
<div class="paragraph">
<p>If you want a consistent look-n-feel throughout the app, eg all property labels to the top, then it’d be rather
frustrating to have to annotate every property.</p>
@@ -1727,7 +1839,7 @@ frustrating to have to annotate every property.</p>
<div class="sect3">
<h4 id="_configuration_properties_for_apache_isis_itself">6.1.1. Configuration Properties for Apache Isis itself</h4>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 5. JDO/DataNucleus Objectstore Configuration Properties</caption>
+<caption class="title">Table 9. JDO/DataNucleus Objectstore Configuration Properties</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 16.6666%;">
@@ -1780,7 +1892,7 @@ frustrating to have to annotate every property.</p>
<div class="sect3">
<h4 id="_configuration_properties_passed_through_directly_to_datanucleus">6.1.2. Configuration Properties passed through directly to DataNucleus.</h4>
<table class="tableblock frame-all grid-all spread">
-<caption class="title">Table 6. JDO/DataNucleus Objectstore Configuration Properties</caption>
+<caption class="title">Table 10. JDO/DataNucleus Objectstore Configuration Properties</caption>
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 16.6666%;">
@@ -2102,9 +2214,14 @@ isis.persistor.datanucleus.impl.javax.jdo.option.ConnectionPassword=</code></pre
</li>
<li><a href="#_rgcfg_configuring-core">5. Configuring Core</a>
<ul class="sectlevel2">
-<li><a href="#_rgcfg_configuring-core_filterVisibility">5.1. Filtering visibility</a></li>
-<li><a href="#_rgcfg_configuring-core_isis-objects-editing">5.2. <code>objects.editing</code></a></li>
-<li><a href="#_rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition">5.3. <code>propertyLayout.labelPosition</code></a></li>
+<li><a href="#_rgcfg_configuring-core_domain-events">5.1. Domain Events</a></li>
+<li><a href="#_rgcfg_configuring-core_lifecycle-events">5.2. Lifecycle Events</a></li>
+<li><a href="#_rgcfg_configuring-core_ui-events">5.3. UI Events</a></li>
+<li><a href="#_rgcfg_configuring-core_services">5.4. Services</a></li>
+<li><a href="#_rgcfg_configuring-core_other">5.5. Other Config Properties</a></li>
+<li><a href="#_rgcfg_configuring-core_filterVisibility">5.6. Filtering visibility</a></li>
+<li><a href="#_rgcfg_configuring-core_isis-objects-editing">5.7. <code>objects.editing</code></a></li>
+<li><a href="#_rgcfg_configuring-core_isis-viewers-propertyLayout-labelPosition">5.8. <code>propertyLayout.labelPosition</code></a></li>
</ul>
</li>
<li><a href="#_rgcfg_configuring-datanucleus">6. Configuring DataNucleus</a>