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

View file

@ -5,16 +5,16 @@
<meta name=generator content="Hugo 0.92.1">
<meta name=description content>
<title>Use Text Constants :: AL Guidelines</title>
<link href=/css/nucleus.css?1644506469 rel=stylesheet>
<link href=/css/fontawesome-all.min.css?1644506469 rel=stylesheet>
<link href=/css/featherlight.min.css?1644506469 rel=stylesheet>
<link href=/css/perfect-scrollbar.min.css?1644506469 rel=stylesheet>
<link href=/css/auto-complete.css?1644506469 rel=stylesheet>
<link href=/css/theme.css?1644506469 rel=stylesheet>
<link href=/css/theme-blue.css?1644506469 rel=stylesheet>
<link href=/css/variant.css?1644506469 rel=stylesheet>
<link href=/css/print.css?1644506469 rel=stylesheet media=print>
<script src=/js/jquery.min.js?1644506469></script>
<link href=/css/nucleus.css?1644600600 rel=stylesheet>
<link href=/css/fontawesome-all.min.css?1644600600 rel=stylesheet>
<link href=/css/featherlight.min.css?1644600600 rel=stylesheet>
<link href=/css/perfect-scrollbar.min.css?1644600600 rel=stylesheet>
<link href=/css/auto-complete.css?1644600600 rel=stylesheet>
<link href=/css/theme.css?1644600600 rel=stylesheet>
<link href=/css/theme-blue.css?1644600600 rel=stylesheet>
<link href=/css/variant.css?1644600600 rel=stylesheet>
<link href=/css/print.css?1644600600 rel=stylesheet media=print>
<script src=/js/jquery.min.js?1644600600></script>
<style>:root #header+#content>#left>#rlblock_left{display:none!important}</style>
</head>
<body data-url=/navpatterns/3-cal-coding-guidelines/localizability/use-text-constants/>
@ -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?1644506469></script>
<script src=/js/auto-complete.js?1644506469></script>
<script src=/js/search.js?1644506469></script>
<script src=/js/lunr.min.js?1644600600></script>
<script src=/js/auto-complete.js?1644600600></script>
<script src=/js/search.js?1644600600></script>
</div>
<div class=highlightable>
<ul class=topics>
@ -257,33 +257,30 @@ ALGuidelines.Dev
<h1>Use Text Constants</h1>
<p>Pass user messages using Text Constants. It makes translation easy.</p>
<p>Bad code</p>
<pre><code>ImportAttachmentQst@1021 : TextConst 'ENU=&quot;Import attachment &quot;';
...
IF CONFIRM(ImportAttachmentQst + Caption +'?',TRUE) THEN BEGIN
</code></pre>
<p>Good code</p>
<pre><code>ImportAttachmentQst@1021 : TextConst 'ENU=&quot;Import attachment %1?&quot;';
...
IF CONFIRM(STRSUBSTNO(ImportAttachmentQst, Caption),TRUE) THEN BEGIN
</code></pre>
<p>Bad code</p>
<pre><code>...
IF NOT
CONFIRM(
STRSUBSTNO(
'Difference on Periodic entries: %1 on %2' +
'Do you want to continue?',Balance,Date),
TRUE)
THEN
ERROR('Program terminated by the user');
</code></pre>
<p>Good code</p>
<pre><code>DiffOnPeriodEntiesQst@100 : TextConst 'ENU=&quot;Difference on Periodic entries: %1 on %2\\ Do you want to continue?&quot;';
ProgramTerminatedErr@200 : TextConst 'ENU=&quot;Program terminated by the user&quot;';
...
IF NOT CONFIRM(STRSUBSTNO(DiffOnPeriodEntiesQst,Balance,Date),TRUE) THEN
ERROR(ProgramTerminatedErr);
</code></pre>
<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>ImportAttachmentQst@<span style=color:#ae81ff>1021</span> : <span style=color:#66d9ef>TextConst</span> <span style=color:#e6db74>&#39;ENU=&#34;Import attachment &#34;&#39;</span>;
<span style=color:#f92672>...
</span><span style=color:#f92672></span><span style=color:#66d9ef>IF</span> CONFIRM<span style=color:#f92672>(</span>ImportAttachmentQst + Caption +<span style=color:#e6db74>&#39;?&#39;</span>,TRUE<span style=color:#f92672>) </span><span style=color:#66d9ef>THEN</span> <span style=color:#66d9ef>BEGIN</span>
</code></pre></div><p>Good code</p>
<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>ImportAttachmentQst@<span style=color:#ae81ff>1021</span> : <span style=color:#66d9ef>TextConst</span> <span style=color:#e6db74>&#39;ENU=&#34;Import attachment %1?&#34;&#39;</span>;
<span style=color:#f92672>...
</span><span style=color:#f92672></span><span style=color:#66d9ef>IF</span> CONFIRM<span style=color:#f92672>(</span>STRSUBSTNO<span style=color:#f92672>(</span>ImportAttachmentQst, Caption<span style=color:#f92672>)</span>,TRUE<span style=color:#f92672>) </span><span style=color:#66d9ef>THEN</span> <span style=color:#66d9ef>BEGIN</span>
</code></pre></div><p>Bad code</p>
<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:#f92672>...
</span><span style=color:#f92672> </span><span style=color:#66d9ef>IF</span> <span style=color:#f92672>NOT</span>
CONFIRM<span style=color:#f92672>(
</span><span style=color:#f92672> </span>STRSUBSTNO<span style=color:#f92672>(
</span><span style=color:#f92672> </span><span style=color:#e6db74>&#39;Difference on Periodic entries: %1 on %2&#39;</span> +
<span style=color:#e6db74>&#39;Do you want to continue?&#39;</span>,Balance,<span style=color:#66d9ef>Date</span><span style=color:#f92672>)</span>,
TRUE<span style=color:#f92672>)
</span><span style=color:#f92672> </span><span style=color:#66d9ef>THEN</span>
ERROR<span style=color:#f92672>(</span><span style=color:#e6db74>&#39;Program terminated by the user&#39;</span><span style=color:#f92672>)</span>;
</code></pre></div><p>Good code</p>
<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>DiffOnPeriodEntiesQst@<span style=color:#ae81ff>100</span> : <span style=color:#66d9ef>TextConst</span> <span style=color:#e6db74>&#39;ENU=&#34;Difference on Periodic entries: %1 on %2\\ Do you want to continue?&#34;&#39;</span>;
ProgramTerminatedErr@<span style=color:#ae81ff>200</span> : <span style=color:#66d9ef>TextConst</span> <span style=color:#e6db74>&#39;ENU=&#34;Program terminated by the user&#34;&#39;</span>;
<span style=color:#f92672>...
</span><span style=color:#f92672> </span><span style=color:#66d9ef>IF</span> <span style=color:#f92672>NOT</span> CONFIRM<span style=color:#f92672>(</span>STRSUBSTNO<span style=color:#f92672>(</span>DiffOnPeriodEntiesQst,Balance,<span style=color:#66d9ef>Date</span><span style=color:#f92672>)</span>,TRUE<span style=color:#f92672>) </span><span style=color:#66d9ef>THEN</span>
ERROR<span style=color:#f92672>(</span>ProgramTerminatedErr<span style=color:#f92672>)</span>;
</code></pre></div>
<footer class=footline>
</footer>
</main>
@ -296,12 +293,12 @@ ERROR(ProgramTerminatedErr);
<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?1644506469></script>
<script src=/js/perfect-scrollbar.min.js?1644506469></script>
<script src=/js/perfect-scrollbar.jquery.min.js?1644506469></script>
<script src=/js/jquery.svg.pan.zoom.js?1644506469></script>
<script src=/js/featherlight.min.js?1644506469></script>
<script src=/js/modernizr.custom-3.6.0.js?1644506469></script>
<script src=/js/relearn.js?1644506469></script>
<script src=/js/clipboard.min.js?1644600600></script>
<script src=/js/perfect-scrollbar.min.js?1644600600></script>
<script src=/js/perfect-scrollbar.jquery.min.js?1644600600></script>
<script src=/js/jquery.svg.pan.zoom.js?1644600600></script>
<script src=/js/featherlight.min.js?1644600600></script>
<script src=/js/modernizr.custom-3.6.0.js?1644600600></script>
<script src=/js/relearn.js?1644600600></script>
</body>
</html>