Microsoft/alguidelines
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

deploy: 9e06f72056

Browse source
This commit is contained in:
TheDoubleH 2022-02-11 17:30:04 +00:00
parent de09820554
commit e4f08bf9a7
187 changed files with 6620 additions and 6342 deletions
Download patch file Download diff file Expand all files Collapse all files

146
navpatterns/1-patterns/multi-page-list/index.html
View file

@ -5,16 +5,16 @@
<meta name=generator content="Hugo 0.92.1">
<meta name=description content>
<title>Multi-Page List :: AL Guidelines</title>
<link href=/css/nucleus.css?1644506468 rel=stylesheet>
<link href=/css/fontawesome-all.min.css?1644506468 rel=stylesheet>
<link href=/css/featherlight.min.css?1644506468 rel=stylesheet>
<link href=/css/perfect-scrollbar.min.css?1644506468 rel=stylesheet>
<link href=/css/auto-complete.css?1644506468 rel=stylesheet>
<link href=/css/theme.css?1644506468 rel=stylesheet>
<link href=/css/theme-blue.css?1644506468 rel=stylesheet>
<link href=/css/variant.css?1644506468 rel=stylesheet>
<link href=/css/print.css?1644506468 rel=stylesheet media=print>
<script src=/js/jquery.min.js?1644506468></script>
<link href=/css/nucleus.css?1644600599 rel=stylesheet>
<link href=/css/fontawesome-all.min.css?1644600599 rel=stylesheet>
<link href=/css/featherlight.min.css?1644600599 rel=stylesheet>
<link href=/css/perfect-scrollbar.min.css?1644600599 rel=stylesheet>
<link href=/css/auto-complete.css?1644600599 rel=stylesheet>
<link href=/css/theme.css?1644600599 rel=stylesheet>
<link href=/css/theme-blue.css?1644600599 rel=stylesheet>
<link href=/css/variant.css?1644600599 rel=stylesheet>
<link href=/css/print.css?1644600599 rel=stylesheet media=print>
<script src=/js/jquery.min.js?1644600599></script>
<style>:root #header+#content>#left>#rlblock_left{display:none!important}</style>
</head>
<body data-url=/navpatterns/1-patterns/multi-page-list/>
@ -32,9 +32,9 @@ ALGuidelines.Dev
<input data-search-input id=search-by type=search placeholder=Search...>
<span data-search-clear><i class="fas fa-times"></i></span>
</div>
<script src=/js/lunr.min.js?1644506468></script>
<script src=/js/auto-complete.js?1644506468></script>
<script src=/js/search.js?1644506468></script>
<script src=/js/lunr.min.js?1644600599></script>
<script src=/js/auto-complete.js?1644600599></script>
<script src=/js/search.js?1644600599></script>
</div>
<div class=highlightable>
<ul class=topics>
@ -250,11 +250,11 @@ ALGuidelines.Dev
<ul>
<li>
<ul>
<li><a href=#abstract><strong>Abstract</strong></a></li>
<li><a href=#description><strong>Description</strong></a></li>
<li><a href=#usage><strong>Usage</strong></a></li>
<li><a href=#nav-specific-example><strong>NAV Specific Example</strong></a></li>
<li><a href=#nav-usages--anchor3><strong>NAV Usages</strong><a href=http://sharepointemea/sites/DynamicsNAV/Wiki/Nav%20Wiki%20Documents/NAV%20App%20Patterns/NAV%20App%20Patterns%20for%20Review/Multi-Page%20List.docx#_msocom_7> </a></a></li>
<li><a href=#abstract>Abstract</a></li>
<li><a href=#description>Description</a></li>
<li><a href=#usage>Usage</a></li>
<li><a href=#nav-specific-example>NAV Specific Example</a></li>
<li><a href=#nav-usages>NAV Usages</a></li>
</ul>
</li>
</ul>
@ -267,10 +267,9 @@ ALGuidelines.Dev
<main id=body-inner>
<h1>Multi-Page List</h1>
<p><em>By Bogdana Botez at Microsoft Development Center Copenhagen</em></p>
<p>__</p>
<h3 id=abstract><strong>Abstract</strong></h3>
<h3 id=abstract>Abstract</h3>
<p>This pattern describes how to open a related document (or card) page from a list page, for the case when there can be more than one pages associated to the rows of the list page.</p>
<h3 id=description><strong>Description</strong></h3>
<h3 id=description>Description</h3>
<p>The example below illustrates the connection of a List Page with multiple Document Pages, while the second example links the List Page with Card Pages.</p>
<p><a href=Multi-page-list-img-1.jpg><img src=Multi-page-list-img-1.jpg alt=" "></a></p>
<p>The records contained in a list page have an associated page, which is specified in the CardPageID property of the list page. The NAV infrastructure assures the following scenarios are in place, without the need to add any explicit C/AL code:</p>
@ -279,61 +278,66 @@ ALGuidelines.Dev
<li>The &ldquo;Edit&rdquo; action is available on the ribbon as well as in the right-click context menu of the list page rows. Invoking this action, opens the related card page.</li>
</ol>
<p>However, there are situations when rows of the list page can correspond to different pages each (either cards or documents). For example, consider a list page containing 3 rows, requiring the following behaviour:</p>
<p>Row1</p>
<p>Opens page ID 1</p>
<p>Row2</p>
<p>Opens page ID 2</p>
<p>Row3</p>
<p>Opens page ID 3</p>
<table>
<thead>
<tr>
<th></th>
<th></th>
</tr>
</thead>
<tbody>
<tr>
<td>Row1</td>
<td>Opens page ID 1</td>
</tr>
<tr>
<td>Row2</td>
<td>Opens page ID 2</td>
</tr>
<tr>
<td>Row3</td>
<td>Opens page ID 3</td>
</tr>
</tbody>
</table>
<p>This situation is not handled automatically by NAV. There is no possibility to specify more than one CardPageID in the list page properties. Furthermore, there is no possibility to specify one or more document page IDs on the list page. Therefore, those cases need to be handled explicitly by the C/AL developer.</p>
<h3 id=usage><strong>Usage</strong></h3>
<h3 id=usage>Usage</h3>
<p>The solution used in NAV implementations is at the list page level, as following:</p>
<ol>
<li>The property CardPageID of the list page remains undefined.</li>
<li>An action named &ldquo;Show Document&rdquo; or &ldquo;Card&rdquo; is created on the Navigate tab, with the properties:</li>
</ol>
<li>
<p>The property CardPageID of the list page remains undefined.</p>
</li>
<li>
<p>An action named &ldquo;Show Document&rdquo; or &ldquo;Card&rdquo; is created on the Navigate tab, with the properties:</p>
<ul>
<li>Image = EditLines</li>
<li>Promoted = Yes</li>
<li>ShortCutKey = Shift+F7</li>
</ul>
<ol>
<li>The OnAction trigger for the Card action, contains explicit logic to run the targeted card page. It can, for example, be a CASE statement, which invokes PAGE.RUN(&mldr;) based on an enumeration field of the current row.</li>
</li>
<li>
<p>The OnAction trigger for the Card action, contains explicit logic to run the targeted card page. It can, for example, be a CASE statement, which invokes PAGE.RUN(&mldr;) based on an enumeration field of the current row.</p>
</li>
</ol>
<h3 id=nav-specific-example><strong>NAV Specific Example</strong></h3>
<h3 id=nav-specific-example>NAV Specific Example</h3>
<p>For example, the NAV page Sales List (page ID 45), which displays the Sales Header Table (table ID 36), chooses which card to open, based on the Document Type field. This is an option field, which can have the following values: Quote, Order, Invoice, Credit Memo, Blanket Order, Return Order. For each document type, the related card page must be opened.</p>
<p><a href=Multi-page-list-img-2.jpg><img src=Multi-page-list-img-2.jpg alt=" "></a></p>
<p>For this purpose, a new action (&ldquo;Card&rdquo;) is added to the Sales List page. The OnAction trigger of this new action contains the page selection logic:</p>
<pre><code>CASE &quot;Document Type&quot; OF
&quot;Document Type&quot;::Quote:
PAGE.RUN(PAGE::&quot;Sales Quote&quot;,Rec);
&quot;Document Type&quot;::Order:
PAGE.RUN(PAGE::&quot;Sales Order&quot;,Rec);
&quot;Document Type&quot;::Invoice:
PAGE.RUN(PAGE::&quot;Sales Invoice&quot;,Rec);
&quot;Document Type&quot;::&quot;Return Order&quot;:
PAGE.RUN(PAGE::&quot;Sales Return Order&quot;,Rec);
&quot;Document Type&quot;::&quot;Credit Memo&quot;:
PAGE.RUN(PAGE::&quot;Sales Credit Memo&quot;,Rec);
&quot;Document Type&quot;::&quot;Blanket Order&quot;:[
][anchor2]
PAGE.RUN(PAGE::&quot;Blanket Sales Order&quot;,Rec);
END;
</code></pre>
<h3 id=nav-usages--anchor3><strong>NAV Usages</strong><a href=http://sharepointemea/sites/DynamicsNAV/Wiki/Nav%20Wiki%20Documents/NAV%20App%20Patterns/NAV%20App%20Patterns%20for%20Review/Multi-Page%20List.docx#_msocom_7> </a></h3>
<div class=highlight><pre tabindex=0 style=color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4><code class=language-al data-lang=al><span style=color:#66d9ef>CASE</span> &#34;Document Type&#34; <span style=color:#66d9ef>OF</span>
&#34;Document Type&#34;::Quote:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Sales Quote&#34;,Rec<span style=color:#f92672>)</span>;
&#34;Document Type&#34;::<span style=color:#66d9ef>Order</span>:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Sales Order&#34;,Rec<span style=color:#f92672>)</span>;
&#34;Document Type&#34;::Invoice:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Sales Invoice&#34;,Rec<span style=color:#f92672>)</span>;
&#34;Document Type&#34;::&#34;Return Order&#34;:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Sales Return Order&#34;,Rec<span style=color:#f92672>)</span>;
&#34;Document Type&#34;::&#34;Credit Memo&#34;:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Sales Credit Memo&#34;,Rec<span style=color:#f92672>)</span>;
&#34;Document Type&#34;::&#34;Blanket Order&#34;:
<span style=color:#66d9ef>PAGE</span><span style=color:#f92672>.</span>RUN<span style=color:#f92672>(</span><span style=color:#66d9ef>PAGE</span>::&#34;Blanket Sales Order&#34;,Rec<span style=color:#f92672>)</span>;
<span style=color:#66d9ef>END</span>;
</code></pre></div><h3 id=nav-usages>NAV Usages</h3>
<p>Some of the NAV implementations of this pattern can be found in the following pages:</p>
<ol>
<li>Sales List (45) and Sales List Archive (5159)</li>
@ -354,12 +358,12 @@ END;
<div style=left:-1000px;overflow:scroll;position:absolute;top:-1000px;border:none;box-sizing:content-box;height:200px;margin:0;padding:0;width:200px>
<div style=border:none;box-sizing:content-box;height:200px;margin:0;padding:0;width:200px></div>
</div>
<script src=/js/clipboard.min.js?1644506468></script>
<script src=/js/perfect-scrollbar.min.js?1644506468></script>
<script src=/js/perfect-scrollbar.jquery.min.js?1644506468></script>
<script src=/js/jquery.svg.pan.zoom.js?1644506468></script>
<script src=/js/featherlight.min.js?1644506468></script>
<script src=/js/modernizr.custom-3.6.0.js?1644506468></script>
<script src=/js/relearn.js?1644506468></script>
<script src=/js/clipboard.min.js?1644600599></script>
<script src=/js/perfect-scrollbar.min.js?1644600599></script>
<script src=/js/perfect-scrollbar.jquery.min.js?1644600599></script>
<script src=/js/jquery.svg.pan.zoom.js?1644600599></script>
<script src=/js/featherlight.min.js?1644600599></script>
<script src=/js/modernizr.custom-3.6.0.js?1644600599></script>
<script src=/js/relearn.js?1644600599></script>
</body>
</html>