CUT Light User Manual
<!-- If the browser does not support frames put the first topic content here --> <div class="WordSection1"> <p class="MsoNormal" align="center" style='text-align:center'> <i><span style='font-size:24.0pt;color:#993300'>CUT Light</span></i> <span style= 'font-size:24.0pt;color:#0070C0'>.<b>NET</b></span> <span style= 'font-size:24.0pt;color:#993300'>UFL</span><span style= 'font-size:24.0pt'> <br /></span> <span style= 'font-size:14.0pt'>User Function Library for Barcodes, Images, SQL, Totals of Totals, Memory, Excel, Text, Font, ini Files, Registry, Windows, Time Zones, Geo, Web, HTML, email, ZATCA, JSON, etc.</span></p> <p class="MsoTitle"><span style= 'font-size:14.0pt;font-weight:normal'> </span></p> <p class="MsoTitle"> </p> <p class="MsoNormal" align="center" style='text-align:center'> <span class="MsoHyperlink"><b><a href= "http://www.milletsoftware.com/">www.MilletSoftware.com</a></b></span></p> <p class="MsoTitle"><span style= 'font-size:12.0pt'> </span></p> <p class="MsoTitle"><span style='font-size:12.0pt'>Version 6.4.9133</span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'>(October 2023)<br /> <br /></span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'>By</span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'> </span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'>Ido Millet</span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'><br /> <br /> 5275 Rome Court, Erie PA 16509<br /></span><a name= "_Hlt490206814"></a><a href= "mailto:ido@MilletSoftware.com"><span style= 'font-size:11.0pt'>ido@MilletSoftware.com</span></a><span style= 'font-size:11.0pt;font-weight:normal'><br /> (814) 825-6009</span></p> <p class="MsoTitle"><span style= 'font-size:11.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 8.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 8.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <u><span style= 'font-size: 12.0pt;font-weight:normal'>Disclaimer:</span></u><span style='font-size:12.0pt; font-weight:normal'> These component and accompanying files are provided "as-is" by Ido Millet without assuming any responsibility for harm to computer systems, software, or data with which these files are used.</span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style= 'font-size: 12.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 12.0pt'>Notes:</span> <span style= 'font-size:12.0pt;font-weight:normal'><br /> The functions are prefixed with '</span><span style= 'font-size:12.0pt; font-family:"Courier New";color:#0070C0'>ufl</span><span style='font-size:12.0pt; font-weight:normal'>' (or '</span><span style= 'font-size:12.0pt;font-family: "Courier New";color:#0070C0'>fl</span><span style='font-size:12.0pt;font-weight: normal'>' for legacy functions).<br /> To simplify the discussion, the user manual typically ignores that prefix.<br /> <br /> Use the 64-bit version with Crystal Reports 2020 and any other application using the 64-bit Crystal runtime.<br /> Use the 32-bit version with all older versions of Crystal Designer and with any 32-bit Crystal runtime.<br /></span><span style= 'font-size:12.0pt'>You can install and use both the 32-bit as well as the 64-bit versions on the same machine</span><span style= 'font-size:12.0pt;font-weight:normal'>.<br /> <br /></span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style= 'font-size: 12.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 8.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 8.0pt;font-weight:normal'> </span></p> <p class="MsoTitle" align="left" style='text-align:left'> <span style='font-size: 12.0pt;font-weight:normal'><br /> <br /></span></p> </div> <span style= 'font-size:8.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <div class="WordSection2"> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821010">Introduction<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>9</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821011">Install / Uninstall<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>10</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821012">Windows & Miscelleneous<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>11</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821013">uflBatchFileRun() <span style= 'color:windowtext;display:none;text-decoration:none'>11</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821014">uflBitWiseAnd() <span style= 'color:windowtext;display:none;text-decoration:none'>11</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821015">uflClipboardSetText() <span style= 'color:windowtext;display:none;text-decoration:none'>12</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821016">uflCmdRun() <span style= 'color:windowtext;display:none;text-decoration:none'>12</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821017">uflCreateGUID() <span style= 'color:windowtext;display:none;text-decoration:none'>12</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821018">uflCultureInfoName() <span style= 'color:windowtext;display:none;text-decoration:none'>12</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821019">uflEXERun() <span style= 'color:windowtext;display:none;text-decoration:none'>13</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821020">uflFormatValue() <span style= 'color:windowtext;display:none;text-decoration:none'>14</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821021">uflGetDiskSerialNumber() <span style= 'color:windowtext;display:none;text-decoration:none'>15</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821022">uflGetEnvironmentVar() <span style= 'color:windowtext;display:none;text-decoration:none'>15</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821023">uflGetMachineIPAddress() <span style= 'color:windowtext;display:none;text-decoration:none'>15</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821024">uflGetMachineName() <span style= 'color:windowtext;display:none;text-decoration:none'>16</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821025">uflNormDist() <span style= 'color:windowtext;display:none;text-decoration:none'>16</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821026">uflGetRegisteredCompanyName() <span style='color:windowtext;display:none;text-decoration:none'>16</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821027">uflGetUser() <span style= 'color:windowtext;display:none;text-decoration:none'>16</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821028">uflNewKey() <span style= 'color:windowtext;display:none;text-decoration:none'>16</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821029">Avoiding Duplicate Processing (New Approach) <span style= 'color:windowtext;display:none;text-decoration:none'>17</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821030">uflKeySetNewItem() <span style= 'color:windowtext;display:none;text-decoration:none'>17</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821031">uflKeySetClear() <span style= 'color:windowtext;display:none;text-decoration:none'>18</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821032">uflLookupAddEntry() <span style= 'color:windowtext;display:none;text-decoration:none'>19</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821033">uflLookupGetEntry() <span style= 'color:windowtext;display:none;text-decoration:none'>19</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821034">uflLookupResetEntries() <span style= 'color:windowtext;display:none;text-decoration:none'>20</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821035">uflVisualCutRun() <span style= 'color:windowtext;display:none;text-decoration:none'>20</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821036">uflSleep() <span style= 'color:windowtext;display:none;text-decoration:none'>21</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821037">Images<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>22</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821038">uflGetImageProperties() <span style= 'color:windowtext;display:none;text-decoration:none'>22</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821039">uflImageResize() <span style= 'color:windowtext;display:none;text-decoration:none'>23</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821040">uflImageReorient() <span style= 'color:windowtext;display:none;text-decoration:none'>24</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821041">uflImageCrop() <span style= 'color:windowtext;display:none;text-decoration:none'>25</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821042">uflImageColorRemap() <span style= 'color:windowtext;display:none;text-decoration:none'>26</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821043">Fixing black background in png files<span style= 'color:windowtext;display:none;text-decoration: none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>27</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821044">uflFile2Image() <span style= 'color:windowtext;display:none;text-decoration:none'>28</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821045">Barcodes<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>30</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821046">uflBBarcodeQR() <span style= 'color:windowtext;display:none;text-decoration:none'>31</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821047">Adding Colors<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>31</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821048">Adding a Logo<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>32</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821049">Removing Padding<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>32</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821050">Using utf-8 as character set <span style= 'color:windowtext;display:none;text-decoration:none'>32</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821051">uflZatcaEncode() <span style= 'color:windowtext;display:none;text-decoration:none'>33</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821052">uflBBarcodeGS1() <span style= 'color:windowtext;display:none;text-decoration:none'>34</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821053">uflBBarcodePDF417() <span style= 'color:windowtext;display:none;text-decoration:none'>35</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821054">uflBBarcodeDataMatrix () <span style= 'color:windowtext;display:none;text-decoration:none'>36</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821055">uflBBarcodeAztec() <span style= 'color:windowtext;display:none;text-decoration:none'>37</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821056">uflBBarcode39() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821057">uflBBarcode93() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821058">uflBBarcode128() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821059">uflBBarcodeITF() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821060">uflBBarcodeCodeBar() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821061">uflBBarcodeMSI() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821062">uflBBarcodePlessey() <span style= 'color:windowtext;display:none;text-decoration:none'>38</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821063">uflBBarcodeUpcA() <span style= 'color:windowtext;display:none;text-decoration:none'>39</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821064">uflBBarcodeUpcE() <span style= 'color:windowtext;display:none;text-decoration:none'>39</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821065">uflBBarcodeUpcEanExtension() <span style= 'color:windowtext;display:none;text-decoration:none'>39</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821066">uflBBarcodeEAN8() <span style= 'color:windowtext;display:none;text-decoration:none'>39</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821067">uflBBarcodeEAN13() <span style= 'color:windowtext;display:none;text-decoration:none'>39</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821068">Charts<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>40</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821069">uflBulletChart() <span style= 'color:windowtext;display:none;text-decoration:none'>41</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821070">uflGaugeRadial() <span style= 'color:windowtext;display:none;text-decoration:none'>43</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821071">uflSparkLine() <span style= 'color:windowtext;display:none;text-decoration:none'>44</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821072">String/Text/JSON<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>45</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821073">uflPopulateTemplate() <span style= 'color:windowtext;display:none;text-decoration:none'>45</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821074">uflExpandStringwithEnvironmentVar() <span style= 'color:windowtext;display:none;text-decoration:none'>45</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821075">uflReplaceAccentedChars() <span style= 'color:windowtext;display:none;text-decoration:none'>45</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821076">uflEncode() <span style= 'color:windowtext;display:none;text-decoration:none'>46</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821077">uflDecode() <span style= 'color:windowtext;display:none;text-decoration:none'>47</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821078">uflDecode2ImageFile() <span style= 'color:windowtext;display:none;text-decoration:none'>48</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821079">uflHex2Ascii() <span style= 'color:windowtext;display:none;text-decoration:none'>49</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821080">uflHex2Number() <span style= 'color:windowtext;display:none;text-decoration:none'>49</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821081">uflConvertRTF2Text() <span style= 'color:windowtext;display:none;text-decoration:none'>50</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821082">uflConvertRTFFileToText() <span style= 'color:windowtext;display:none;text-decoration:none'>50</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821083">uflJsonGet() <span style= 'color:windowtext;display:none;text-decoration:none'>51</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821084">Regular Expressions<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>53</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821085">uflRegExpIsMatch() <span style= 'color:windowtext;display:none;text-decoration:none'>53</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821086">uflRegExpMatch() <span style= 'color:windowtext;display:none;text-decoration:none'>53</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821087">uflRegExpReplace() <span style= 'color:windowtext;display:none;text-decoration:none'>53</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821088">File<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821089">uflFileAge() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821090">uflFileAge2() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821091">uflFileCompare() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821092">uflFileCopy() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821093">uflFileDelete () <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821094">uflFileExists() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821095">uflFileRename() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821096">uflFileJustName() <span style= 'color:windowtext;display:none;text-decoration:none'>54</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821097">uflFileJustPath() <span style= 'color:windowtext;display:none;text-decoration:none'>55</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821098">uflFileListFromWildCards() <span style= 'color:windowtext;display:none;text-decoration:none'>56</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821099">uflFileUnzip() <span style= 'color:windowtext;display:none;text-decoration:none'>57</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821100">uflGetTempFolder() <span style= 'color:windowtext;display:none;text-decoration:none'>57</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821101">Text File<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>58</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821102">uflFileAddText() <span style= 'color:windowtext;display:none;text-decoration:none'>58</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821103">uflFileAddText2() <span style= 'color:windowtext;display:none;text-decoration:none'>60</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821104">uflFileAddTextKey() <span style= 'color:windowtext;display:none;text-decoration:none'>61</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821105">uflLookupText() <span style= 'color:windowtext;display:none;text-decoration:none'>61</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821106">uflFileGetText() <span style= 'color:windowtext;display:none;text-decoration:none'>62</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821107">uflFileGetTextUTF8() <span style= 'color:windowtext;display:none;text-decoration:none'>62</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821108">ini/registry<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>63</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821109">uflGetINIValue() <span style= 'color:windowtext;display:none;text-decoration:none'>63</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821110">uflGetINIValueSegment() <span style= 'color:windowtext;display:none;text-decoration:none'>63</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821111">uflSetINIValue() <span style= 'color:windowtext;display:none;text-decoration:none'>64</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821112">uflINISectionDelete() <span style= 'color:windowtext;display:none;text-decoration:none'>64</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821113">uflGetRegistryString() <span style= 'color:windowtext;display:none;text-decoration:none'>65</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821114">GMT/Local and Time-Related<span style= 'color:windowtext;display:none;text-decoration: none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>66</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821115">uflGMTtoLocalMinutes() <span style= 'color:windowtext;display:none;text-decoration:none'>66</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821116">uflGMTtoLocal() <span style= 'color:windowtext;display:none;text-decoration:none'>66</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821117">Evaluating Report Processing Elapsed Time<span style= 'color:windowtext;display:none;text-decoration: none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>66</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821118">uflGMTtoZone() <span style= 'color:windowtext;display:none;text-decoration:none'>68</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821119">uflSecondsToTimeString() <span style= 'color:windowtext;display:none;text-decoration:none'>69</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821120">uflTimeStringToSeconds() <span style= 'color:windowtext;display:none;text-decoration:none'>69</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821121">uflNumberToDate() <span style= 'color:windowtext;display:none;text-decoration:none'>69</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821122">Message/Input Boxes<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>70</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821123">uflMessageBoxOK() <span style= 'color:windowtext;display:none;text-decoration:none'>70</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821124">uflMessageBoxYesNo() <span style= 'color:windowtext;display:none;text-decoration:none'>70</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821125">uflInputBox() <span style= 'color:windowtext;display:none;text-decoration:none'>71</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821126">uflInputBox2Command() <span style= 'color:windowtext;display:none;text-decoration:none'>72</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821127">Web / HTML / Google / Translate<span style= 'color:windowtext;display:none;text-decoration: none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>73</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821128">uflHTMLfile2RTFfile() <span style= 'color:windowtext;display:none;text-decoration:none'>73</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821129">uflHTMLstring2RTFFile() <span style= 'color:windowtext;display:none;text-decoration:none'>74</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821130">uflHTMLString2Txtfile() <span style= 'color:windowtext;display:none;text-decoration:none'>75</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821131">uflhttpFileExists() <span style= 'color:windowtext;display:none;text-decoration:none'>76</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821132">uflhttpExists() <span style= 'color:windowtext;display:none;text-decoration:none'>76</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821133">uflhttpFileDownload() <span style= 'color:windowtext;display:none;text-decoration:none'>77</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821134">uflhttpFileDownloadRename() <span style= 'color:windowtext;display:none;text-decoration:none'>77</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821135">uflhttpFileParse() <span style= 'color:windowtext;display:none;text-decoration:none'>78</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821136">uflhttpToImage() <span style= 'color:windowtext;display:none;text-decoration:none'>79</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821137">Web URL Example<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>79</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821138">File URL Example<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>80</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821139">Simple File Path Example<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>80</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821140">Fixing 'Old Browser' error <span style= 'color:windowtext;display:none;text-decoration:none'>80</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821141">uflhttpCallServiceGetTokens() <span style='color:windowtext;display:none;text-decoration:none'>83</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821142">uflGoogleSentiment() <span style= 'color:windowtext;display:none;text-decoration:none'>84</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821143">uflGoogleTranslate() <span style= 'color:windowtext;display:none;text-decoration:none'>85</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821144">uflNumber2Arabic() <span style= 'color:windowtext;display:none;text-decoration:none'>86</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821145">uflIpDot2Long() <span style= 'color:windowtext;display:none;text-decoration:none'>87</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821146">uflIpLong2Dot() <span style= 'color:windowtext;display:none;text-decoration:none'>87</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821147">uflPing() <span style= 'color:windowtext;display:none;text-decoration:none'>87</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821148">SQL<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>88</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821149">uflExecuteSQLCanConnect() <span style= 'color:windowtext;display:none;text-decoration:none'>88</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821150">uflExecuteSQLNoReturn() <span style= 'color:windowtext;display:none;text-decoration:none'>89</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821151">Avoiding Duplicate Processing (old approach) <span style= 'color:windowtext;display:none;text-decoration:none'>91</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821152">uflSQLNoReturn() <span style= 'color:windowtext;display:none;text-decoration:none'>92</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821153">uflExecuteSQLReturnValue() <span style= 'color:windowtext;display:none;text-decoration:none'>93</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821154">Example with a Connection String<span style= 'color:windowtext;display:none;text-decoration: none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>94</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821155">uflSQLReturnValue() <span style= 'color:windowtext;display:none;text-decoration:none'>95</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821156">uflExecuteSQLReturnFile() <span style= 'color:windowtext;display:none;text-decoration:none'>96</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821157">uflExecuteSQLReturnDelimited() <span style= 'color:windowtext;display:none;text-decoration:none'>97</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821158">uflExecuteSQLReturnDelimitedSegment() <span style= 'color:windowtext;display:none;text-decoration:none'>98</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821159">Totals of Totals<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>100</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821160">uflTotalStore() <span style= 'color:windowtext;display:none;text-decoration:none'>101</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821161">uflTotalLookup() <span style= 'color:windowtext;display:none;text-decoration:none'>102</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821162">uflTotalsReset() <span style= 'color:windowtext;display:none;text-decoration:none'>102</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821163">uflTotalofTotals() <span style= 'color:windowtext;display:none;text-decoration:none'>103</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821164">uflTotalPercentile() <span style= 'color:windowtext;display:none;text-decoration:none'>104</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821165">uflTotalRank() <span style= 'color:windowtext;display:none;text-decoration:none'>105</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821166">uflTotalNth() <span style= 'color:windowtext;display:none;text-decoration:none'>106</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821167">Geo<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>107</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821168">uflDistance() <span style= 'color:windowtext;display:none;text-decoration:none'>107</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821169">uflDistanceByZip5() <span style= 'color:windowtext;display:none;text-decoration:none'>107</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821170">uflDistanceByZipUK() <span style= 'color:windowtext;display:none;text-decoration:none'>107</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821171">uflDistanceByZip() <span style= 'color:windowtext;display:none;text-decoration:none'>108</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821172">uflGetLatLongFromZip() <span style= 'color:windowtext;display:none;text-decoration:none'>109</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821173">uflGetLatLongFromZip5() <span style= 'color:windowtext;display:none;text-decoration:none'>109</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821174">uflGoogleAddress2LatLong() <span style= 'color:windowtext;display:none;text-decoration:none'>110</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821175">uflGoogleDrivingTimeDistance() <span style= 'color:windowtext;display:none;text-decoration:none'>111</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821176">Excel<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>112</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821177">uflGetXLSValue() <span style= 'color:windowtext;display:none;text-decoration:none'>112</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821178">uflSetXLSValue() <span style= 'color:windowtext;display:none;text-decoration:none'>112</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821179">uflGetXLSOutput() <span style= 'color:windowtext;display:none;text-decoration:none'>112</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821180">uflXLSLookUp() <span style= 'color:windowtext;display:none;text-decoration:none'>113</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821181">uflXlsGetValue() <span style= 'color:windowtext;display:none;text-decoration:none'>113</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821182">uflXlsSetValue() <span style= 'color:windowtext;display:none;text-decoration:none'>114</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821183">Font<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>115</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821184">uflGetTextWidth() <span style= 'color:windowtext;display:none;text-decoration:none'>115</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821185">uflGetFontSizeToFitText() <span style= 'color:windowtext;display:none;text-decoration:none'>115</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821186">uflGetTextHeight() <span style= 'color:windowtext;display:none;text-decoration:none'>115</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821187">uflGetTextNumberOfLines() <span style= 'color:windowtext;display:none;text-decoration:none'>115</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821188">Encryption<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>116</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821189">uflBlowFishEncrypt() <span style= 'color:windowtext;display:none;text-decoration:none'>116</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821190">uflBlowFishDecrypt() <span style= 'color:windowtext;display:none;text-decoration:none'>116</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821191">uflBlowFishDecryptSegment() <span style= 'color:windowtext;display:none;text-decoration:none'>117</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821192">Email<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>118</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821193">uflEmailSetOptionsIniFile() <span style= 'color:windowtext;display:none;text-decoration:none'>118</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821194">uflSetEmailSaveEncryptedPassword() <span style= 'color:windowtext;display:none;text-decoration:none'>119</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821195">uflEmailSend() <span style= 'color:windowtext;display:none;text-decoration:none'>119</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821196">Full Example<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>120</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821197">Specifying Multiple (Simple/Composite) Email Addresses<span style= 'color:windowtext; display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>121</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821198">Specifying Email Distribution Lists in Text Files<span style= 'color:windowtext;display: none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>121</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821199">Specifying Email Distribution Lists in SQL Queries<span style= 'color:windowtext; display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>122</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821200">Attaching Multiple Files<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>122</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821201">Specifying a Different Character Set <span style= 'color:windowtext;display:none;text-decoration:none'>123</span></a></span></p> <p class="MsoToc3"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821202">Queuing Emails & The smtpQ Service<span style= 'color:windowtext;display:none; text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>123</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821203">uflIsValidEmail() <span style= 'color:windowtext;display:none;text-decoration:none'>123</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821204">uflIsValidEmails() <span style= 'color:windowtext;display:none;text-decoration:none'>123</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821205">Legacy Functions<span style= 'color:windowtext;display:none;text-decoration:none'>.</span> <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821206">flHoursFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821207">flMinutesFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821208">flSecondsFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821209">flSHHMMFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821210">flHHMMPMFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>124</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821211">flHHMMSSFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>125</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821212">flHHMMSSPMFromSecsSinceMidnight() <span style= 'color:windowtext;display:none;text-decoration:none'>125</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821213">flDayOfYear() <span style= 'color:windowtext;display:none;text-decoration:none'>125</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821214">flWeekOfYear() <span style= 'color:windowtext;display:none;text-decoration:none'>125</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821215">flTIME() <span style= 'color:windowtext;display:none;text-decoration:none'>125</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821216">Update History<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821217">Version 6.4.9133 (October 10, 2023): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821218">Version 6.4.9131 (August 6, 2023): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821219">Version 6.4.9127 (July 12, 2023): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821220">Version 6.4.9127 (June 23, 2023): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821221">Version 6.4.9123 (April 8, 2023): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821222">Version 6.4.9117 (November 30, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821223">Version 6.4.9117 (November 30, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821224">Version 6.4.9114 (September 9, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821225">Version 6.4.9112 (July 2, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821226">Version 6.4.9106 (May 12, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>126</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821227">Version 6.4.9105 (April 18, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821228">Version 6.4.9103 (March 29, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821229">Version 6.4.9102 (February 19, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821230">Version 6.4.9101 (February 8, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821231">Version 6.4.9098 (January 11, 2022): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821232">Version 6.4.9098 (December 3, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821233">Version 6.4.9095 (October 3, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821234">Version 6.4.9092 (August 6, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821235">Version 6.4.9090 (May 17, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821236">Version 6.4.9087 (April 23, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>127</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821237">Version 6.4.9085 (March 23, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821238">Version 6.4.9079 (January 7, 2021): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821239">Version 6.4.9078 (August 16, 2020): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821240">Version 6.4.9077 (July 2, 2020): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821241">Version 6.4.9076 (July 1, 2020): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821242">Version 6.4.9074 (May15, 2020): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821243">Version 6.4.9072 (April 6, 2020): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821244">Version 6.4.9069 (12/20/2019): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821245">Version 6.4.9068 (11/23/2019): <span style= 'color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821246">Version 6.4.9067 (5/16/2019): <span style='color:windowtext;display:none;text-decoration:none'>128</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821247">Version 6.4.9066 (3/18/2019): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821248">Version 6.4.9064 (1/24/2019): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821249">Version 6.4.9061 (1/18/2019): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821250">Version 6.4.9059 (9/23/2018): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821251">Version 6.4.9043 (7/3/2018): <span style= 'color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821252">Version 6.4.9042 (6/25/2018): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821253">Version 6.4.9041 (6/2/2018): <span style= 'color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821254">Version 6.4.9040 (5/16/2018): <span style='color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821255">Version 6.4.9038 (4/3/2018): <span style= 'color:windowtext;display:none;text-decoration:none'>129</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821256">Version 6.4.9037 (2/24/2018): <span style='color:windowtext;display:none;text-decoration:none'>130</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821257">Version 6.4.9036 (10/21/2017): <span style= 'color:windowtext;display:none;text-decoration:none'>130</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821258">Version 6.4.9035 (10/21/2017): <span style= 'color:windowtext;display:none;text-decoration:none'>131</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821259">Version 6.4.9034 (10/18/2017): <span style= 'color:windowtext;display:none;text-decoration:none'>131</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821260">Version 6.4.9031 (9/15/2017): <span style='color:windowtext;display:none;text-decoration:none'>131</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821261">Version 6.4.9029 (7/27/2017): <span style='color:windowtext;display:none;text-decoration:none'>131</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821262">Version 6.4.9025 (6/21/2017): <span style='color:windowtext;display:none;text-decoration:none'>131</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821263">Version 6.4.9024 (5/30/2017): <span style='color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821264">Version 6.4.9019 (4/8/2017): <span style= 'color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821265">Version 6.4.9018 (2/17/2017): <span style='color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821266">Version 6.4.9017 (10/26/2016): <span style= 'color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821267">Version 6.4.9014 (10/17/2016): <span style= 'color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821268">Version 6.4.9012 (10/11/2016): <span style= 'color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821269">Version 6.4.9011 (9/11/2016): <span style='color:windowtext;display:none;text-decoration:none'>132</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821270">Version 6.4.9009 (8/28/2016): <span style='color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821271">Version 6.4.9008 (8/3/2016): <span style= 'color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821272">Version 6.4.9007 (4/26/2016): <span style='color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821273">Version 6.4.9006 (4/13/2016): <span style='color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821274">Version 6.4.9005 (3/19/2016): <span style='color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821275">Version 6.4.9004 (2/24/2016): <span style='color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821276">Version 6.4.9001 (10/12/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821277">Version 6.4.8002 (9/26/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821278">Version 6.4.6005 (9/19/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821279">Version 6.4.6001 (8/13/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>133</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821280">Version 6.4.4001 (8/5/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>134</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821281">Version 6.4.2001 (6/4/2015): <span style= 'color:windowtext;display:none;text-decoration:none'>134</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821282">Version 6.3.1006 (4/1/2015) <span style= 'color:windowtext;display:none;text-decoration:none'>134</span></a></span></p> <p class="MsoToc2"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821283">Version 6.3.1 (1/2/2015): Released .NET version. <span style= 'color:windowtext;display:none;text-decoration:none'>134</span></a></span></p> <p class="MsoToc1"><span class="MsoHyperlink"><a href= "start.htm#_Toc147821284">Known Issues and Limitation<span style= 'color:windowtext;display:none;text-decoration:none'>..</span> <span style= 'color:windowtext;display:none;text-decoration:none'>135</span></a></span></p> <p class="MsoTitle" align="left" style='text-align:left'> </p> <b><span style= 'font-size:16.0pt;font-family:"Times New Roman",serif; color:maroon'><br clear="all" style='page-break-before:always' /></span></b> <h1><a name="_Toc147821010"></a><a name= "_Toc519529255"></a><a name="_Toc509669390"></a><a name= "_Toc506904354"></a><a name="_Toc502988794"></a><a name= "_Toc502915223"></a><a name="_Toc502588207"></a><a name= "_Toc502587265"></a><a name="_Toc502510225"></a><a name= "_Toc502508620"></a><a name="_Toc502422874"></a><a name= "_Toc502421956"></a><a name="_Toc502335337"></a><a name= "_Toc502334882"></a><a name="_Toc502315906"></a><a name= "_Toc502315688"></a><a name="_Toc502315601"></a><a name= "_Toc502315416"></a><a name="_Toc501975016"></a><a name= "_Toc501974947"></a><a name="_Toc501974101"></a><a name= "_Toc501973377"></a><a name="_Toc501973286"></a><a name= "_Toc501973151"></a><a name="_Toc501970026">Introduction</a></h1> <p class="MsoNormal"> </p> <p class="MsoNormal"><b><i>CUT Light</i></b> functions are used in Crystal Report formulas/expressions for use cases such as:</p> <p class="MsoIndexHeading"> </p> <ol style='margin-top:0in' start="1" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>E-mail</span></b> dynamic-content messages from within any section of a Crystal report via <b>SMTP</b> (used by e-mail clients such as Eudora, Outlook, Outlook Express, Netscape Messenger, Pegasus Mail, etc.). <br /> <br /> A variety of options are supported including multiple recipients, CC Recipients, BCC recipients, and attachment files. <br /> These options can be specified by using the <b>EmailSet()</b> function call within a Crystal formula and by appending more elements or more text via follow-up <b>EmailAdd()</b> function calls before triggering the email via an <b><i>EmailSend</i></b> function call. </li> </ol> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <ol style='margin-top:0in' start="2" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Aggregate/Lookup/Rank Totals</span></b> (totals of totals)</li> </ol> <p class="MsoListParagraph"><b><span style= 'font-size:14.0pt;color:#993300'> </span></b></p> <ol style='margin-top:0in' start="3" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Append Content to Text Files</span></b> <br /> Note: this can be used to take snapshots of information each time the report runs (for example, via Visual CUT scheduled processing). Another Crystal report can then use the text file as a data source for information across multiple snapshots.</li> </ol> <p class="MsoNormal"> </p> <ol style='margin-top:0in' start="4" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Read Content of Text/RTF/HTML Files</span></b><b><span style= 'font-size:16.0pt; color:#993300'><br /></span></b> Provide the file path & name as an argument to the <b><i>FileGetText()</i></b> function and get the file content as a string. You can use Crystal's formatting options to interpret the string as RTF or HTML. You can also use Crystal's string search and manipulation functions to lookup values inside the text file.</li> </ol> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>5.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Check a File Exists (Local or Web)</span></b></p> <p class="MsoListParagraph"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>6.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Execute SQL statements against any ODBC data source</span></b></p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>7.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Lookup & Set Values in *.ini files</span></b></p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>8.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Lookup Values in the Registry</span></b></p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>9.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Replace Accented Characters with Regular Ones</span></b></p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>10.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Convert GMT/UTC to Local or Specified Time Zone<br /> <br /></span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>11.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Compute Distance between Points</span></b> (by zip codes or by Lat/Long)</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>12.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Trigger another Application via a Command Line</span></b></p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>13.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Trigger Message & Input Boxes Based On Report Content</span></b></p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>14.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Embed Input from User in Command Line Calls</span></b></p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>15.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Trigger Report Processing by Visual CUT or DataLink Viewer</span></b></p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>16.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Convert HTML to RTF for Better Rendering in Crystal</span></b></p> <p class="MsoListParagraph"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-size:14.0pt'>17.<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b><span style='font-size:14.0pt;color:#993300'>Convert HEX strings to Values</span></b></p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:#993300'> </span></b></p> <ol style='margin-top:0in' start="18" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Get the 'User Name' & 'PC Name' Running the Report</span></b><b><span style= 'font-size:16.0pt;color:#993300'><br /></span></b> Note: this can be used to impose row-level security or to address data access tracking requirements such as those imposed by HIPAA.<a name= "_Toc519529257"></a><a name="_Toc509669392"></a><a name= "_Toc506904356"></a><a name="_Toc502988796"></a><a name= "_Toc502915225"></a><a name="_Toc502588209"></a><a name= "_Toc502587267"></a><a name="_Toc502510227"></a><a name= "_Toc502508622"></a><a name="_Toc502422876"></a><a name= "_Toc502421958"></a><a name="_Toc502335339"></a><a name= "_Toc502334884"></a><a name="_Toc502315908"></a><a name= "_Toc502315690"></a><a name="_Toc502315603"></a><a name= "_Toc502315418"></a><a name="_Toc501975018"></a><a name= "_Toc501974949"></a><a name="_Toc501974103"></a><a name= "_Toc501973379"></a><a name="_Toc501973288"></a><a name= "_Toc501973153"></a><a name="_Toc501970028"></a></li> </ol> <p class="MsoListParagraph"> </p> <ol style='margin-top:0in' start="19" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Encrypt/Decrypt Text</span></b></li> </ol> <p class="MsoListParagraph"> </p> <ol style='margin-top:0in' start="20" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Call Web Services and Return Values</span></b></li> </ol> <p class="MsoListParagraph"><b><span style= 'font-size:14.0pt;color:#993300'> </span></b></p> <ol style='margin-top:0in' start="21" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Resize or Crop Images<br /> <br /></span></b></li> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Generate barcodes without special fonts</span></b></li> </ol> <p class="MsoNormal" style='margin-left:.5in'> </p> <ol style='margin-top:0in' start="23" type="1"> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Generate Bullet Charts, Sparklines, and advanced Gauges<br /> <br /></span></b></li> <li class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#993300'>Regular Expressions</span></b><br /> <br /></li> <li class="MsoNormal">And more…<br /> <br /> <br /> <br /></li> </ol> <h1><a name="_Toc147821011">Install</a> / Uninstall</h1> <p class="MsoNormal"><i> </i></p> <p class="MsoNormal" style='margin-left:.25in'>Follow the instruction received via email.<br /> <br /> After the installation, the formula editor within Crystal should show the new functions under Additional Functions, COM and .NET UFLs.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821012">Windows & Miscelleneous</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821013"></a><a name= "_uflNewKey()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BatchFileRun()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (<b>BatchFilePath</b>, <b>Arguments</b>, <b>Visibility</b>)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers batch file passing to it optional arguments and controlling the visibility of the batch file window. If Visibility is set to "Hidden" the process window is hidden. Otherwise, it is visible.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> Note: if there's a chance your arguments might contain special characters that interfere with passing them to the batch file (these include commas, spaces, <, >, ^, |) pass the arguments by enclosing them in single quotes within the double quotes like this: <br /> <span style= 'font-family:"Courier New"'>uFLBatchFileRun("C:\Batch\test.cmd", <span style='background:yellow'>'</span>"Jane Doe"<span style= 'background:yellow'>'</span>, "Normal")<br /></span>Then, handle the remaining double-quotes on the receiving side.<br /> <br /> <u>Returns:</u> 'Done' or error message. </p> <p class="MsoNormal"> </p> <p class="Bullet2" style='text-indent:0in'>Note: use of <b>CmdRun()</b> or <b>BatchFileRun()</b> requires a 1-time user permission to trigger such functions. The permission is stored as an entry in the <b><i>CUT_Light_Options.ini</i></b> file.</p> <p class="Bullet2" style='text-indent:0in'></p> <table cellpadding="0" cellspacing="0" align="left"> <tr> <td width="24" height="0"></td> </tr> <tr> <td></td> <td><img width="482" height="204" src= "CUT_Light_NET_User_Manual_files/image001.png" alt= "Title: Permission dialog for CmdRun or BatchFileRun - Description: 1-time Permission dialog for CmdRun or BatchFileRun." /></td> </tr> </table> <br clear="all" /> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821014"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BitWiseAnd()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> (Integer1, Integer2)</p> <p class="MsoNormal" style='text-indent:.25in'> </p> <p class="MsoNormal"><u>Returns:</u> The result (as Integer) of a BitWise AND operation on the two input integers.<br /> <br /> For example: <b>BitWiseAnd(13, 6)</b></p> <p class="MsoNormal">Returns: <b>4</b></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821015"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ClipboardSetText()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (TextToSet)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='text-indent:.25in'> <u>Returns:</u> The text specified as an argument.<br /> <br /> For example: <b>ClipboardSetText</b> (ToText({Invoice.Invoice_N},0,'')<br /> <br /></p> <p class="MsoNormal" style='text-indent:.25in'><span style= 'color:#0070C0'> </span></p> <h2><a name="_Toc147821016"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>CmdRun()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (CommandLineArguments)<br /> This function triggers Cmd.exe passing to it a command line.<br /> <u>Returns:</u> 'Done' or error message. </p> <p class="MsoNormal" style='margin-left:.25in'><br /> See comments above <b>1<sup>st</sup>-time permission</b> and <b>special characters</b> in section about <b>BatchFileRun()</b> above.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function is very similar to EXERun except that the EXE is Cmd.exe and you don't need to figure out the path to that executable and how to trigger it without leaving a command window open.<br /> <br /> For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-family:"Courier New"; background:yellow'>uFLCmdRun("del c:\temp\*.tmp")</span></b><b><span style= 'font-family:"Courier New"'><br /></span></b>would delete all files with .tmp extensions in the temp folder.<br /> <br /></p> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821017"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>CreateGUID()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> none <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> a GUID as string.<br /> <br /> Example: CreateGuid() <br /> returns: <b>{E0DDC73A-E7FA-484A-A640-4DC79315AA16}</b><br /> <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821018"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>CultureInfoName()</a><br /> <br /></h2> <p class="MsoNormal">Arguments: none<br /> <u>Returns:</u> the name of the computer's culture (aka Locale).<br /> <br /> For example, if the computer is locates in the USA, uflCultureInfoName() returns 'en-US'</p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif;color:#0070C0'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#0070C0'> </span></b></p> <h2><a name="_Toc147821019"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>EXERun()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (ExePath, CommandLineArguments)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers another application (EXE or Bat or Cmd file),<br /> passing to it a command line.<br /> <br /> <u>Returns:</u> 'Done' if the executable was found in the specified path. Otherwise, returns an error message. </p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>This function is very similar to VisualCutRun, except that it is free to call any application (not just Visual CUT). You can still use the ExeRun to call Visual CUT. For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-family:"Courier New"; background:yellow'>ExeRun ("C:\Program Files\Visual CUT\Visual CUT.exe", "-e ""C:\Program Files\Visual CUT\Visual_CUT.rpt"" ""Parm1:1996""")</span></b></p> <p class="MsoNormal" style='margin-left:.25in'>Triggers processing of the Visual_CUT.rpt sample report, overriding the saved parameter value with a value of 1996. <br /> <br /> Note that each double (<b><span style= 'font-family:"Courier New";background: yellow'>"</span></b>) quotes in the command line, must be duplicated (<b><span style= 'font-family:"Courier New";background:yellow'>""</span></b>) within the formula so it is recognized as such.<br /> <br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821020"></a><a name= "_uflFormatValue()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FormatValue()</h2> <p class="MsoNormal"> </p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'><br /></span><span style= 'background:yellow'>Value</span></b> (Dbl): the number to convert/format as string. Use cDbl() if input type is not Double</p> <p class="MsoNormal"><br /> <b><span style='background:aqua'>FromType</span></b> (string): only '<b><span style='background:aqua'>Millimeters</span></b>' or <span style='background:aqua'>'<b>Inches</b>'</span> are currently supported</p> <p class="MsoNormal"><b> </b></p> <p class="MsoNormal"><b><span style= 'background:#FABF8F'>ToType</span></b> (string): only <b><span style='background:#FABF8F'>'Imperial'</span> is currently supported</b></p> <p class="MsoNormal"><b> </b></p> <p class="MsoNormal"><b><span style= 'background:lime'>Denominator</span></b> (integer): control precision (2, 4, <b><span style='background:lime'>8</span></b>, 16, 32, or 64) of fractions such as 5' 11 3/<b><span style= 'background:lime'>8</span></b>" <br /> <br /> <b><span style='background:#B2A1C7'>Separator</span></b> (string): <span style='background:#B2A1C7'>" "</span> for no separator produces 5' 11 5/8" while <span style= 'background:#B2A1C7'>"-"</span> produces 5'<b><span style= 'font-size:14.0pt'>-</span></b>11 5/8".<br /> <b><br /> <span style='background:fuchsia'>Options</span></b> (string): Leave as blank (<b>""</b>).<br /> <br /> <u>Returns:</u> a string formatting the value or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "<br /></span><br /> For example, this formula expression: <br /> <span style='font-family:"Calibri",sans-serif'> </span> <b><span style= 'font-size:11.0pt'> </span></b><b><span style= 'font-family:"Calibri",sans-serif; color:#3333FF'>uFLFormatValue</span></b><span style='font-family:"Calibri",sans-serif'>(</span><b><span style='background:yellow'>71.6</span></b><span style='font-size:9.5pt;font-family:Consolas;color:black'>,</span> <b><span style='background:aqua'>"Inches"</span></b><span style= 'font-size: 9.5pt;font-family:Consolas;color:black'>,</span> <b><span style= 'background: #FABF8F'>"Imperial"</span></b><span style= 'font-size:9.5pt; font-family:Consolas;color:black'>,</span> <b><span style='background:lime'>8</span></b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>,</span> <b><span style='background:#B2A1C7'>" "</span></b><span style= 'font-size:9.5pt; font-family:Consolas;color:black'>,</span> <b><span style='background:fuchsia'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>);<br /> returns:</span> <b><span style= 'font-size:14.0pt;font-family:"Calibri",sans-serif'>5' 11 5/8"<br /></span></b><span style= 'font-family:"Calibri",sans-serif'>and</span></p> <p class="MsoNormal"><span style= 'font-family:"Calibri",sans-serif'> </span> <b><span style= 'font-size:11.0pt'> </span></b><b><span style= 'font-family:"Calibri",sans-serif; color:#3333FF'>uFLFormatValue</span></b><span style='font-family:"Calibri",sans-serif'>(</span><b><span style='background:yellow'>42</span></b><span style='font-size: 9.5pt;font-family:Consolas;color:black'>,</span> <b><span style= 'background: aqua'>"Millimeters"</span></b><span style= 'font-size:9.5pt; font-family:Consolas;color:black'>,</span> <b><span style= 'background:#FABF8F'>"Imperial"</span></b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>,</span> <b><span style='background:lime'>16</span></b><span style= 'font-size:9.5pt;font-family: Consolas;color:black'>,</span> <b><span style='background:#B2A1C7'>" "</span></b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>,</span> <b><span style='background:fuchsia'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>);<br /> returns:</span> <b><span style= 'font-size:14.0pt;font-family:"Calibri",sans-serif'> 1 11/16"<br /> <br /></span></b></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-family:"Courier New"'> </span></b></p> <h2><a name="_Toc147821021"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetDiskSerialNumber()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>Arguments: (FormatAsHex)</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Returns: the serial number of the current disk drive. <br /> If the FormatAsHex argument is set to True, the number is returned formatted as HEX. <br /> <br /> <u>Returns:</u> a String displaying the serial number of the current disk drive<br /> as a number (e.g. <b>-1808600113</b>) or as Hex (e.g. <b>9432F3CF</b>)</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <h2><a name="_Toc147821022"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetEnvironmentVar()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (VariableName)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The environment variable value for the specified variable name. </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal">Note: typical environment variable names include:</p> <p class="MsoNormal" style='margin-left:.5in'>AppData</p> <p class="MsoNormal" style='margin-left:.5in'>LOCALAPPDATA</p> <p class="MsoNormal" style='margin-left:.5in'>PATH</p> <p class="MsoNormal" style='margin-left:.5in'>ProgramFiles</p> <p class="MsoNormal" style='margin-left:.5in'> CommonProgramFiles<br /> SystemDrive<br /> WinDir<br /> UserDomain<br /> UserProfile</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>GetEnvironmentVar ("AppData")</span></b></p> <p class="MsoNormal" style='margin-left:.25in'>returns a value such as:<br /> <b><span style= 'background:yellow'>C:\Users\ido\AppData\Roaming</span><br /> <br /> <br /></b></p> <h2><a name="_Toc147821023"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetMachineIPAddress()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>No arguments. <br /> <u>Returns:</u> a String with the IP Address of the machine where the Crystal report is running.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br clear="all" style='page-break-before:always' /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821024"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetMachineName()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>No arguments. <br /> <u>Returns:</u> a String with the PC name where the Crystal report is running.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <h2><a name="_Toc147821025"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>NormDist()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (x, mean, std)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> the cumulative probability for the value x under a normal distribution with the specified mean and standard deviation.<br /> <br /> For example: NormDist(7, 5, 2) = 0.8413<br /> <br /></p> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h2><a name="_Toc147821026"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetRegisteredCompanyName()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>No arguments. <br /> <u>Returns:</u> a String with the Windows Registered Company Name.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <h2><a name="_Toc147821027"><span style= 'color:#0070C0'>ufl</span>GetUser()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>No arguments. <br /> <u>Returns:</u> a String with the ID of the user logged to the PC.<br /> <br /> Note: among other things, this can be used to address data access tracking requirements such as those imposed by <b><i>HIPAA</i></b> (<i>Health Insurance Portability and Accountability Act</i>). By using <b><i>GetUser()</i></b> and <b><i>FileAddText()</i></b> you can log to a text file information about who accessed what patient information and on what date.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <h2><a name="_Toc147821028"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>NewKey()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (KeyString)<br /> <br /> <u>Returns:</u> <br /> <b>True</b> if the string is a new key (a NewKey() call hasn't been issued for it within<br /> the same report preview session). In which case the KeyString gets added to an internal set of keys that is reset only when a new report preview is triggered.<br /> <b>False</b>, if the KeyString is already in the internal set of keys.</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>This function can be used to <b>avoid duplicate processing</b> and to compute <b>Distinct Sums</b>.<br /> <br /></p> <h3><br /> <a name="_Toc147821029">Avoiding Duplicate Processing (New Approach)</a></h3> <p class="MsoNormal" style='margin-left:.25in'><br /> Crystal might evaluate the same formula multiple times, as it renders the page content (particularly when Keep Together properties cause shifting of page content from one page to another). To avoid duplicate processing of CUT Light function, you can use the NewKey() above to ensure the same process is not triggered twice. Here is an example:<br /> <br /></p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; font-family:"Courier New"'>WhilePrintingRecords;</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; font-family:"Courier New"'>IF ufl<b>NewKey</b>({Product_Type.Product Type Name}) Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; font-family:"Courier New"'> FileAddText("c:\temp\testNewkey.txt",<br /> {Product_Type.Product Type Name}, False, True)</span></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> This formula writes to text file only if the NewKey() function confirms that the current Product Type Name hasn't been processed yet. <br /> <br /></p> <p class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#0070C0'> </span></b></p> <h2><a name="_Toc147821030"></a><a name= "_uflKeySetNewItem()"></a><span style= 'color:#0070C0'>ufl</span>KeySetNewItem()<br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>Arguments (sKey)<br /> <u>Returns:</u> "DUP" if the key is already in the key set (no duplicates allowed in the set).</p> <p class="MsoNormal" style='margin-left:.25in'> "OK" if the key was added to the key set because it is not a duplicate<br /> or error message if unexpected failure occurs.<br /> <br /> This function is similar to the ufl<b>NewKey</b>() function but it is faster, consumes less memory, and can be combined with <span class="MsoHyperlink"><a href= "start.htm#_uflKeySetClear()">ufl<b>KeySetClear</b>()</a></span> to reset the key collection.</p> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif;color:#0070C0'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"><a name= "_uflKeySetClear()"></a><b><span style='font-size: 14.0pt;color:#0070C0'> </span></b></p> <h2><a name="_Toc147821031"><span style= 'color:#0070C0'>ufl</span>KeySetClear()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>Arguments (no arguments)<br /> <u>Returns:</u> "OK" or error message if unexpected failure occurs.<br /> <br /> This function resets the unique key set populated by ufl<b>KeySetNewItem</b>() calls.<br /> <br /> For example, this image below shows that in the Group Header (for Employee ID) we reset the key Set using ufl<b>KeySetClear()</b>. Then, in the detail section, we use ufl<b>KeySetNewItem</b>() to differentiate between encountering each customer id for the first time ("OK") as opposed to repeat encounters ("DUP").</p> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <p class="MsoNormal"><img border="0" width="624" height="490" id= "Picture 10" src="CUT_Light_NET_User_Manual_files/image002.jpg" alt="image" name="Picture 10" /><b><span style= 'color:#0070C0'> <br /> <br /> <br /> <br clear="all" style='page-break-before:always' /></span></b></p> <h2><a name="_Toc51239330"></a><a name="_Toc51239329"></a><a name= "_Toc147821032"><span style= 'color:#0070C0'>ufl</span>LookupAddEntry()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>Arguments (sKey, sValue)<br /> <u>Returns:</u> "OK" if the Key-Value pair was successfully added to memory.<br /> <br /> Use ToText() in your formula to convert non-string Key or Value data<br /> If the Key already exists, the entry gets replaced with the new Value.<br /> <br /> Example of subreport <b>loading</b> total payments by Customer into Key-Value pairs in memory:<br /> <img border="0" width="624" height="137" id="Picture 1" src= "CUT_Light_NET_User_Manual_files/image003.png" alt= "Title: LookupAddEntry Sample - Description: Example of subreport loading total payments by Customer into Key-Value pairs in memory" name="Picture 1" /><br /> <br /></p> <h2><a name="_Toc147821033"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>LookupGetEntry()</a><br /> <br /></h2> <p class="MsoNormal" style='margin-left:.25in'>Arguments (sKey)<br /> <u>Returns:</u> The Value from matching Key-Value pair found in memory or "Entry Not Found".</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Example of a main report <b>getting</b> values that were loaded by the subreport above<br /> (note that the subreport can reside in a suppressed section):<br /> <img border="0" width="624" height="152" id="Picture 4" src= "CUT_Light_NET_User_Manual_files/image004.png" alt= "Title: LookupGetEntry Sample - Description: Example of a main report getting values that were loaded by the subreport" name="Picture 4" /><br /> <br /></p> <p class="MsoNormal"><img border="0" width="359" height="196" id= "Picture 5" src="CUT_Light_NET_User_Manual_files/image005.png" alt= "Title: Results from LookupGetEntry - Description: Report Preview showing Results from LookupGetEntry" name="Picture 5" /><br /> <span style='color:#0070C0'><br clear="all" style= 'page-break-before:always' /></span></p> <h2><a name="_Toc147821034"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>LookupResetEntries()</a><br /> <br /></h2> <p class="MsoNormal">Arguments: none<br /> <u>Returns:</u> "OK" or error message<br /> <br /> Used to reset all entries previously set via LookupAddEntry() calls.<br /> This is useful in cases where a user runs multiple reports without closing the reporting software (Crystal, DataLink Viewer, …) between reports.<br /> <br /></p> <p class="MsoNormal"><br /> <br /></p> <h2><a name="_Toc147821035"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>VisualCutRun()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (VisualCUTExePath, CommandLineArguments)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers processing of another report by Visual CUT. Visual CUT is a Crystal Report Manager package developed by Millet Software (<span class="MsoHyperlink"><a href= "http://www.milletsoftware.com/">www.MilletSoftware.com</a></span>).<br /> <br /> A typical scenario for using this functionality is running a report on Crystal Enterprise (or another software package), and <b>using the viewing of that report as a trigger mechanism for exporting, printing, and/or e-mailing of information in another report.</b></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> 'Done' if the Visual CUT executable was found in the specified path. Otherwise, returns an error message. </p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-family:"Courier New"; background:yellow'>VisualCutRun ("C:\Program Files\Visual CUT\Visual CUT.exe", "-e ""C:\Program Files\Visual CUT\Visual_CUT.rpt"" ""Parm1:1996""")</span></b><b><span style= 'font-family: "Courier New"'><br /> <br /></span></b>Triggers processing of the Visual_CUT.rpt sample report, overriding the saved parameter value with a value of 1996. <br /> <br /> Note that each double (<b><span style= 'font-family:"Courier New";background: yellow'>"</span></b>) quotes in the command line, must be duplicated (<b><span style= 'font-family:"Courier New";background:yellow'>""</span></b>) within the formula so it is recognized as such.<br /> <br /> <br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821036"></a><a name= "_uflSleep()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Sleep()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Milliseconds as Integer)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function injects a delay of the specified number of milliseconds.<br /> <u>Returns:</u> 'OK'</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula tries to confirm access to a remote machine.<br /> If it fails, it tries up to 2 more times, injecting a 3-seconds delay between each try.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-family:"Courier New"; background:yellow'> </span></b></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; font-family:"Courier New"'>Local NumberVar Tries := 0 ;<br /> Local StringVar Result :=</span> <b><span style= 'font-size:11.0pt;font-family: "Courier New";color:blue'>uFLPing</span></b> <span style= 'font-size:11.0pt; font-family:"Courier New"'>("<span style= 'color:#A31515'>74.125.67.100</span>", "") ;<br /> While result = "FALSE" AND Tries < 2 DO<br /> (</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; font-family:"Courier New"'> </span> <b><span style= 'font-size:11.0pt; font-family:"Courier New";color:blue'>uFLSleep</span></b> <span style='font-size:11.0pt;font-family:"Courier New"'>(3000) ;<br /> Result := </span> <b><span style= 'font-size:11.0pt;font-family:"Courier New"; color:blue'>uFLPing</span></b><span style='font-size:11.0pt;font-family:"Courier New"'>("<span style='color:#A31515'>74.125.67.100</span>", "") ;<br /> Tries := Tries + 1 ; </span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; font-family:"Courier New"'>);<br /> Result ;<br /></span> <span style= 'font-size:11.0pt;font-family:"Courier New"'><br /> <br /></span><span style='font-family:"Courier New"'><br /> <br /> <br /> <br /> <br /></span></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> <br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h1><a name="_Toc147821037">Images</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821038"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetImageProperties()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (image file path & name) <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> Width/Height (in pixels) string.<br /> <br /> Example: <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>GetImageProperties("c:\temp\MyLogo.jpg") </span> <br /> returns: <b>90</b>/<b>111</b><br /> <br /> <b>Notes:</b><br /> - If image file in not found, the function returns "File Not Found"<br /> - Supported image types are: JPEG, JPG, GIF, BMP and PNG<br /> - If image type is not supported, the function returns "Image Type Not Supported"</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><a name="_uflImageResize()"></a><span style= 'font-size:14.0pt; color:#0070C0'> </span></p> <h2><a name="_Toc147821039"></a><a name= "_uflImageResize()_1"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ImageResize()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<b>url</b> or <b>image file path & name</b>, new image file path & name, Width, Height,<br /> MaintainProportion, Options) <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The path to the new resized image file.<br /> <br /> Example: uflI<span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>mageResize("c:\Logo.jpg","c:\temp\Logo.png",180, 222, TRUE, "[AvoidAntiAliasing]") </span> <br /> returns: <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>"c:\Temp\Logo.png" (the path the new resized image file</span><br /> <br /> <b>Notes:</b></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Width & Height in pixels. For no change in size, set to <b>0, 0</b></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Image file path and name <b>can be a URL</b>. For example: uFLImageResize("<span style= 'background:yellow'>http://acme/Glider.jpg</span>", "c:\temp\Glider.jpg", 1600, 900, False, "")</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> If <b><i>MaintainProportion</i></b> is set to TRUE, the image is resized to best fit within the specified dimensions.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> You can <b>convert on the fly between image formats</b> by specifying a different file extension. For example to convert from jpg to png:<br /> uflImageResize("c:\temp\A.<b>jpg</b>", "c:\temp\B.<b>png</b>", 180, 222, True, "")<br /> Supported Source Formats: BMP, JPEG, PNG, TIFF, GIF<br /> Supported Output Formats: BMP, JPEG, PNG</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style='background:yellow'>Options:</span> leave the Options argument blank ("") or include some of these options:</p> <p class="MsoListParagraph" style= 'margin-left:1.25in;text-indent:-.25in'><span style= 'font-family:"Courier New"'>o<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>[Center]</b> to center a proportionally resized image within the width & height using white as the fill color for the remaining vertical or horizontal margins.<br /> note: this stops Crystal from distorting the image when '<b><i>Can Grow</i></b>' is False.</p> <p class="MsoListParagraph" style= 'margin-left:1.25in;text-indent:-.25in'><span style= 'font-family:"Courier New"'>o<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>[AvoidAntiAliasing]</b> to avoid anti-aliasing</p> <p class="MsoListParagraph" style= 'margin-left:1.25in;text-indent:-.25in'><span style= 'font-family:"Courier New"'>o<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>[Reorient_EXIF]</b> to reorient the image based on embedded EXIF code:<br /> <img border="0" width="596" height="176" id="Picture 25" src= "CUT_Light_NET_User_Manual_files/image006.png" alt="image" name= "Picture 25" /> <br /> <a name="_uflImageCrop_()"></a><a name="_uflImageCrop()"></a><br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821040"></a><a name= "_uflImageCrop()_1"></a><a name= "_uflImageReorient()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ImageReorient()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<b><span style='background:yellow'>url</span></b> <span style='background:yellow'>or <b>image file path & name</b></span>, <span style='background:aqua'>new image file path & name</span>,<br /> <span style='background:lime'>Reorient_Directive</span>, <span style='background:lightgrey'>Options</span>) <br /> <br /></p> <p class="MsoNormal" style='text-autospace:none'><u>Returns:</u> The path to the new resized image file (or an error starting with ***)<br /> <br /> Rotations are clockwise. Reorient_Directive can be one of these:<br /> "<span style='background:lime'>Rotate90FlipNone</span>", "<span style='background:lime'>Rotate180FlipNone</span>", "<span style='background:lime'>Rotate270FlipNone</span>"<br /> "<span style='background:lime'>RotateNoneFlipX</span>", "<span style='background:lime'>Rotate90FlipX</span>", "<span style= 'background:lime'>Rotate180FlipX</span>", "<span style= 'background:lime'>Rotate270FlipX</span>"</p> <p class="MsoNormal" style='text-autospace:none'><br /> Example: uflI<span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>mageReorient</span><span style='font-size:9.5pt;font-family:Consolas; color:black'>(</span><span style='font-size:10.0pt;font-family:"Verdana",sans-serif'>"<span style='background:yellow'>https://www.milletsoftware.com/images/DataLinkViewer/Data_Viz2.jpg</span>",</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Verdana",sans-serif'> "<span style='background:aqua'>c:\temp\DLV_Data_Vizualizer.png</span>", "<span style='background:lime'>Rotate90FlipNone</span>", <span style='background: lightgrey'>""</span></span><span style= 'font-size:10.0pt;font-family: "Verdana",sans-serif;color:black'>)</span> <span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:black'> </span> <br /> <br /> returns: <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>"</span> <span style= 'font-size:10.0pt;font-family:"Verdana",sans-serif; background:aqua'> c:\temp\DLV_Data_Vizualizer.png</span> <span style= 'font-size: 10.0pt;font-family:"Arial",sans-serif;color:black'>" (the path the new resized image file</span><br /> <br /></p> <p class="MsoNormal">Notes:<br /> - you can convert between image formats by specifying a different file extension.<br /> Supported Source Formats are: BMP, JPEG, PNG, TIFF, GIF<br /> Supported Output Formats are: BMP, JPEG, PNG<br /> <br /> - Leave the Options argument blank (<span style= 'background:lightgrey'>""</span>)<br /> <br /> <br /> <br /> <b><span style='color:#0070C0'><br clear="all" style= 'page-break-before:always' /></span></b></p> <h2><a name="_Toc147821041"></a><a name= "_uflImageCrop()_2"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ImageCrop()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<b>url</b> or <b>imagefile path & name</b>, new image file path & name,<br /> TopLeftX, TopLeftY, Width, Height,<br /> Options) <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <u>Returns:</u> The path to the new resized image file.<br /> If error occurs, the path is to an image of the error text.<br /> <br /> Example: to crop a bullet chart where the scale was hidden, the following call:<br /> <b>uFLImageCrop</b>("c:\temp\Bullet_" & {Employee.Last Name} & ".bmp", "c:\temp\Bullet_" & {Employee.Last Name} & "_Cropped.bmp", 20, 5, 310, 35, "");<br /> converted this image<br /> <img border="0" width="352" height="82" id="Picture 9" src= "CUT_Light_NET_User_Manual_files/image007.jpg" alt="image" name= "Picture 9" /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'>To this cropped image:<br /> <img border="0" width="312" height="37" id="Picture 15" src= "CUT_Light_NET_User_Manual_files/image008.jpg" alt="image" name= "Picture 15" /><br /> This allowed generating the report shown in this <span class= "MsoHyperlink"><a href="https://www.screencast.com/t/4MWItrMvs1E4" target="_blank">image</a></span>.<br /> <br /> <b>Notes:</b></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> To <span style='background:yellow'>auto-crop</span> an image (remove white margins):</p> <p class="MsoListParagraph" style= 'margin-left:1.25in;text-indent:-.25in; line-height:110%'> -<span style= 'font:7.0pt "Times New Roman"'> </span> set TopLeftX and TopLeftY to <b><span style= 'background:yellow'>-999</span></b></p> <p class="MsoListParagraph" style= 'margin-left:1.25in;text-indent:-.25in; line-height:110%'> -<span style= 'font:7.0pt "Times New Roman"'> </span> set Width & Height to <b><span style= 'background:yellow'>-999</span></b> if after-crop content should be returned as is. Otherwise, the after-crop content would be resized.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> TopLeftX and TopLeftY indicate the top-left corner where the cropped content should be copied from in pixels. Width & Height indicate the width and height of the cropped content to be copied, starting from the top left corner. In pixels. With 75 DPI resolution, 75 pixels = 1 inch.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Image file path and name can be a URL. For example: "<span class= "MsoHyperlink"><span style= 'color:black;text-decoration:none'>https://acme/Glider.jpg</span></span>"</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> You can convert on the fly between image formats by specifying a different file extension for the new image.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Include <b>[AvoidAntiAliasing]</b> in Options text to avoid anti-aliasing<br /> <br /></p> <p class="MsoNormal"><b><span style='color:#0070C0'><br /> <br clear="all" style='page-break-before:always' /></span></b></p> <h2><a name="_Toc147821042"></a><a name= "_uflImageColorRemap()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ImageColorRemap()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<b>url</b> or <b>imagefile path & name</b>, new image file path & name,<br /> FromToColors,<br /> Options) <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <u>Returns:</u> The path to the new re-colored image file or the text of an error message.<br /> </p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'>The FromToColors argument is constructed as an array of RGB pairs, like these:<br /> <span style= 'line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='line-height:110%;font-family:Consolas;color:red'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515;background:yellow'>>></span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='font-size:9.5pt;line-height:110%;font-family:Consolas;color:#A31515'> </span> (convert black to red)<b><span style= 'font-size:9.5pt;line-height:110%;font-family:Consolas; color:#A31515'><br /> </span></b><span style= 'line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515;background:yellow'>>></span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>204</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>204</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>"</span> (convert white to light red)<br /> - or, including the Opacity element before the RGB elements:<br /> <span style= 'line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='line-height:110%;font-family:Consolas;color:black'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:red'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515;background:yellow'>>></span><span style='line-height:110%;font-family:Consolas;color:black'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>0</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='font-size:9.5pt;line-height:110%;font-family:Consolas;color:#A31515'> </span> (convert black to red)<b><span style= 'font-size:9.5pt;line-height:110%;font-family:Consolas; color:#A31515'><br /> </span></b><span style= 'line-height:110%;font-family:Consolas;color:#A31515'>"</span><span style='line-height:110%;font-family:Consolas;color:black'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515;background:yellow'>>></span><span style='line-height:110%;font-family:Consolas;color:black'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:red'>255</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#00B050'>204</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>,</span><span style='line-height:110%;font-family:Consolas;color:#17365D'>204</span><span style='line-height:110%;font-family:Consolas;color:#A31515'>"</span> (convert white to light red)<br /> <br /> Either of these alternatives result in the following transformation:</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <img border="0" width="331" height="146" id="Picture 20" src= "CUT_Light_NET_User_Manual_files/image009.png" alt="image" name= "Picture 20" /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> Here is an example of a Crystal formula that generates the QR Code (in Black & White) and then transforms the image to red on light red:<br /> <br /> <b><span style= 'color:#2B1DE1'>uFLBBarcodeQR</span></b>({@TextContent}, "", False, "L", 224, 224, 0, "c:\temp\" & {@ProductType} & "_QR.png");</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> </p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <b><span style= 'color:#2B1DE1'>uFLImageColorRemap</span></b>("c:\temp\" & {@ProductType} & "_QR.png",</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> "c:\temp\" & {@ProductType} & "_QR_Red.png",</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> ["0,0,0>>255,0,0","255,255,255>>255,204,204"],</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> "");<br /> <br /> <b>Notes:</b></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Including the Opacity argument is needed only if you wish to change opacity.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Leave the Options argument blank (""). It is included to support future functionality<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h3><a name="_Toc147821043">Fixing black background in png files</a></h3> <p class="MsoNormal" style='line-height:110%'> </p> <p class="MsoNormal" style='line-height:110%'>A typical problem in using png files in a Crystal report is that transparent background shows up as black.</p> <p class="MsoNormal" style='line-height:110%'> </p> <p class="MsoNormal" style='line-height:110%'>The image below demonstrates how changing transparent and black to opaque and white solves the problem:<br /> <br /> <img border="0" width="624" height="402" id="Picture 37" src= "CUT_Light_NET_User_Manual_files/image010.jpg" alt="image" name= "Picture 37" /></p> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <h2><a name="_Toc147821044"></a><a name= "_uflFile2Image()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>File2Image()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<br /> <b> </b> <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>SourceFile</span>:</b> currently, only PDF files are supported,<br /> <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>PageN</span></b>: the page number to target for conversion to image,<br /> <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>LocalFilePathName</span></b><span style='font-size:9.5pt;font-family:Consolas;color:black'>:</span> the path and name of the image file (png, jpg, jpeg, or bmp),<span style= 'font-size:9.5pt; font-family:Consolas;color:black'><br /> </span> <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>Width</span></b> (pixels), <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>Height</span></b> (pixels), <br /> <b><span style= 'font-size:9.5pt;font-family:Consolas;color:black'>MaintainProportion</span></b><span style='font-size:9.5pt;font-family:Consolas;color:black'>:</span> set to True to maintain the source page proportions,<br /> Options: leave blank (“”) <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <u>Returns:</u> The path to the new resized image file.<br /> If error occurs, the path is to an image of the error text.<br /> <br /> This allows you to simply use this function in the ‘Graphic Location’ expression for a static image, so Crystal replaces it on the fly with the path to the generated image.<br /> <br /> Example: Crystal report before Graphic Location expression:</p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> </p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <img border="0" width="624" height="410" id="Picture 22" src= "CUT_Light_NET_User_Manual_files/image011.png" alt="image" name= "Picture 22" /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'>And after using the function in the ‘Graphic Location’ expression:<br /> <br /> <img border="0" width="624" height="409" id="Picture 23" src= "CUT_Light_NET_User_Manual_files/image012.png" alt="image" name= "Picture 23" /></p> <p class="MsoNormal" style='margin-left:.25in;line-height:110%'> <br /> <b><br /> Notes:</b></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style= 'font-size:14.0pt;line-height:110%;font-family: Symbol;color:#0070C0'> ·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Width & Height indicate the width and height of the resized image.<br /> Set both to 0 if you wish to maintain the size of the source page.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in; line-height:110%'> <span style= 'font-size:14.0pt;line-height:110%;font-family: Symbol;color:#0070C0'> ·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Leave the Options argument blank (""). It is included to support future functionality<br /> <br /> <b><span style='color:#0070C0'><br clear="all" style= 'page-break-before:always' /></span></b></p> <h1><a name="_Toc147821045">Barcodes</a></h1> <p class="MsoNormal"> </p> <p class="MsoNormal">CUT Light can generate <b>17 types of barcodes</b>. The function generated the image on the fly and return the path to that image file for use in the graphic location expression of a dummy image so it gets replaced by the new image . The process is <b>very fast</b> and provides several advantages:</p> <p class="MsoListParagraph" style='text-indent:-.25in'> <b>1.<span style= 'font:7.0pt "Times New Roman"'> </span></b> <b>No dependency on special fonts</b></p> <p class="MsoListParagraph" style='text-indent:-.25in'> <b>2.<span style= 'font:7.0pt "Times New Roman"'> </span></b> Can<b>rotate the image</b> using <span class= "MsoHyperlink"><a href="start.htm#_uflImageCrop()_1">uflImageReorient()</a></span></p> <p class="MsoListParagraph" style='text-indent:-.25in'> 3.<span style= 'font:7.0pt "Times New Roman"'> </span> On failure (e.g. unacceptable value to encode) the barcode image is replaced with an <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png"> image of the error message</a></span>. This <b>simplifies troubleshooting</b> (e.g. bad value to encode).<br /> <br /></p> <p class="MsoNormal"><img border="0" width="624" height="664" id= "Picture 41" src="CUT_Light_NET_User_Manual_files/image013.png" alt="image" name="Picture 41" /><br clear="all" style= 'page-break-before:always' /></p> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821046"></a><a name= "_uflBBarcodeQR()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeQR()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (TextContent(), CharacterSet, DisableECI, ErrorCorrectionLevel,</p> <p class="MsoNormal" style='margin-left:.25in'> ImageWidth, ImageHeight, AddedMargin, LocalFilePathName)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png" target="_blank">image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate a QR Code image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent()</span></b> divides the desired content into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the <span class="MsoHyperlink"><a href= "start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:#EAF1DD'>CharacterSet</span>:</b> leave blank <b>""</b> to use the default ("ISO-8859-1"). Use <b>"</b><b>utf-8"</b> for Arabic etc. <b><br /> <span style='background:#DBE5F1'>DisableECI</span></b> (Boolean): Use <b>False</b>, unless CharacterSet is "<b>utf-8</b>" and reading fails<br /> <b><span style= 'background:#F2DBDB'>ErrorCorrectionLevel</span></b>: <b>"L"</b> for Low (default), "M" - Medium, "Q" - Quartile, "H" – High<br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: size (height = width) of the image in pixels.<br /> <b><span style='background:#CCC0D9'>AddedMargin</span></b>: set to -1 to remove the white margin (aka "quiet zone") around the barcode. Set to <b>0</b> to generate the default quiet zone around the barcode.<br /> Set to <b>-999</b> to avoid any white padding (might cause fuzzy edges due to forced scaling).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>,<b>.jpg or .jpeg</b></p> <p class="MsoNormal" style='margin-left:.25in'><b><br /></b>The QR barcode shown in the <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal" style='margin-left:.25in;background:white'> <span style='color:blue'>uFL<b><span style= 'background:yellow'>BB</span></b>arcodeQR</span><span style= 'background:#E5DFEC'>(<span style= 'background:yellow'>{@Text}</span></span>, <span style= 'background:#EAF1DD'>""</span>, <span style= 'background: #DBE5F1'>False</span>, <span style= 'background:#F2DBDB'>"L"</span>, <span style= 'background:lime'>112</span>, <span style= 'color:#002060;background:lime'>112</span>, <span style= 'background:#CCC0D9'>0</span>, <span style= 'background:aqua'>"c:\temp\Competition.png"</span>)</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoListParagraph" style='text-indent:-.25in'><span style= 'font-family: Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> A QR Code can specify the full content of an email message. See <span class="MsoHyperlink"><a href= "http://www.labnol.org/internet/email/learn-mailto-syntax/6748/" target="_blank">link1</a></span> and <span class= "MsoHyperlink"><a href= "http://www.labnol.org/internet/email-with-qr-code/19610/" target= "_blank">link2</a></span>.</p> <p class="MsoListParagraph" style= 'text-indent:-.25in;line-height:110%'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> With 75 DPI screen resolution, 75 pixels = 1 inch.<br /> <br /></p> <h3><a name="_Toc147821047">Adding Colors</a></h3> <p class="MsoNormal" style='line-height:110%'>You can add color using <span class="MsoHyperlink"><a href= "start.htm#_uflImageColorRemap()">uflImageColorRemap()</a></span> function:<br /> <img border="0" width="307" height="136" id="Picture 11" src= "CUT_Light_NET_User_Manual_files/image014.png" alt="image" name= "Picture 11" /></p> <p class="MsoNormal" style='line-height:110%'> </p> <h3><a name="_Toc147821048">Adding a Logo</a></h3> <p class="MsoNormal" style='line-height:110%'>When generating the QR Code image, if the target folder contains an image called <b><span style='background:yellow'>QR_Overlay_Logo.png</span></b>, CUT Light automatically centers and overlays.</p> <p class="MsoNormal" style='line-height:110%'> </p> <p class="MsoNormal" style='line-height:110%'>Make sure the Logo image is smaller than the QR Code.<br /> <br /> Also, increase the <b><i>ErrorCorrectionLevel</i></b> argument to ensure successful reading. In the example below, the <b><i>ErrorCorrectionLevel</i></b> argument is set to ‘<b>Q</b>’.<br /> <br /></p> <p class="MsoNormal"><img border="0" width="588" height="121" id= "Picture 24" src="CUT_Light_NET_User_Manual_files/image015.png" alt="image" name="Picture 24" /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h3><a name="_Toc147821049"></a><a name= "_Removing_Padding"></a>Removing Padding</h3> <p class="MsoNormal">Even with <b><span style= 'background:#CCC0D9'>AddedMargin</span></b> set to -1, the generated image might have some white padding.<br /> To remove the padding, you can set the <b><span style= 'background:#CCC0D9'>AddedMargin</span></b> to <b><span style= 'color:red'>-999</span></b>:<br /> <img border="0" width="624" height="127" id="Picture 31" src= "CUT_Light_NET_User_Manual_files/image016.png" alt="image" name= "Picture 31" /></p> <p class="MsoNormal"><br /> <br /></p> <h3><a name="_Toc147821050">Using utf-8 as character set</a></h3> <p class="MsoNormal">If you set <b><span style= 'background:#EAF1DD'>CharacterSet</span></b> to "utf-8" you may need to set <b><span style= 'background:#DBE5F1'>DisableECI</span></b> to True:<br /> <img border="0" width="508" height="125" id="Picture 32" src= "CUT_Light_NET_User_Manual_files/image017.png" alt="image" name= "Picture 32" /> </p> <p class="MsoNormal"><br /> <br /> <br /> <br clear="all" style='page-break-before:always' /></p> <h2><a name="_Toc147821051"></a><a name= "_uflZatcaEncode()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ZatcaEncode()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style='background:yellow'>SellerName</span>, <span style='background:lime'>VatNumber</span>, <span style= 'background:aqua'>InvoiceDateTime</span>, <span style= 'background:#FBD4B4'>InvoiceTotal</span>, <span style= 'background: #CCC0D9'>Vat</span>, Options)<br /> Returns: encoded Base64 string or, ‘***’ followed by the error message. For example:<br /> <span style='color:blue'>uflZatcaEncode</span> (<span style= 'background:yellow'>{@SellerName}</span>, "<span style= 'background:lime'>123</span>", "<span style= 'background:aqua'>2021-12-01T11:18:30Z</span>", <span style= 'background:#FBD4B4'>150.2</span>, <span style= 'background:#CCC0D9'>8.75</span>, "") returns:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:11.0pt'>‘</span></b><b><span style= 'font-size:8.0pt'>AQ/Zhdit2YXYryDYudi32KgCAzEyMwMUMjAyMS0xMi0wMVQxMToxODozMFoEBTE1MC4yBQQ4Ljc1’</span></b></p> <p class="MsoNormal" style='margin-left:.25in'>Which you can pass as the text content for <span style= 'color:blue'>uflBBarcodeQR</span>().<br /> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>SellerName</span> a String (for example, <img border="0" width="75" height="16" id="Picture 29" src= "CUT_Light_NET_User_Manual_files/image018.png" alt="image" name= "Picture 29" />)<br /> <span style='background:lime'>VatNumber</span> a String</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:aqua'>InvoiceDateTime</span> String as Zulu ISO8601 format. Leave blank (<span style='background:aqua'>""</span>) for current UTC time.<br /> <span style='background:#FBD4B4'>InvoiceTotal</span> must be passed in as a Double. Use Crystal’s CDbl() function if necessary.<br /> <span style='background:#CCC0D9'>Vat</span> must be passed in as a Double. Use Crystal’s CDbl() function if necessary.</p> <p class="MsoNormal" style='margin-left:.25in'>Options: leave blank. Reserved for future use.<br /> <br /> <img border="0" width="624" height="180" id="Picture 34" src= "CUT_Light_NET_User_Manual_files/image019.png" alt="image" name= "Picture 34" /></p> <p class="MsoNormal"><span style= 'font-family:Wingdings;color:#222222;background: white'>à</span><span style='font-family:"Arial",sans-serif;color:#222222; background:white'><br /> </span><a href= "https://www.milletsoftware.com/images/CUT%20Light/ZATCA_Scan_Result.png"><span style='font-family:"Arial",sans-serif;color:#222222;background:white; text-decoration:none'><img border="0" width="323" height="358" id="Picture 33" src= "CUT_Light_NET_User_Manual_files/image020.png" alt="image" name= "Picture 33" /></span></a><span style= 'font-family:"Arial",sans-serif;color:#222222;background:white'><br /> <br /></span></p> <p class="MsoNormal"><span style= 'font-family:"Arial",sans-serif;color:#222222; background:white'> </span></p> <h2><a name="_Toc147821052"></a><a name= "_uflBBarcodeGS1()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeGS1()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style= 'background:yellow'>TextContent</span>,<b><span style= 'background:#EAF1DD'>BarcodeType</span></b>, <span style= 'background: lime'>ImageWidth</span>, <span style= 'background:lime'>ImageHeight</span>, <b><span style= 'background:#CCC0D9'>AddedMargin</span></b>, <span style= 'background: lightgrey'>ShowText</span>, <span style= 'background:aqua'>LocalFilePathName</span>, Options)<br /> <u><br /></u>This function allows you to generate a <b>GS1-128 Barcode</b> image so you can then load the image into a picture object using a dynamic Graphic Location expression.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent()</span></b> divides the desired content into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the section discussing the HTML2Image() function. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.<br /> Within the text content:<br /> <b><span style= 'font-size:13.5pt;font-family:"Arial",sans-serif;color:#222222; background:lime'> ~</span></b><span style= 'font-family:"Arial",sans-serif; color:#222222'> </span>character indicates where FNC1 character should be inserted as a field separator<span style= 'font-family:"Arial",sans-serif; color:#222222'><br /></span><b><span style='font-size:13.5pt;font-family:"Arial",sans-serif; color:#222222;background:aqua'>^</span></b> character indicates where a new field starts without needing the special field separator</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:#EAF1DD'>BarcodeType</span>:</b> currently, only <b>"Code128"</b> is supports. <b><br /> <span style='background:#DBE5F1'>DisableECI</span></b> (Boolean): Use <b>False</b>, unless CharacterSet is "UTF-8" and reading fails<br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: size of the image in pixels.<br /> <b><span style='background:#CCC0D9'>AddedMargin</span></b>: extra white margin in points. Typically, set to <b><span style= 'background:#CCC0D9'>30</span></b></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:fuchsia'>ShowText</span>: True/False. set to True to show a nicely formatted text below.<br /> <b><span style='background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>, <b>.jpg or .jpeg</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>Options:</b> leave as blank: ""</p> <p class="MsoNormal" style='margin-left:.25in'><b><br /></b>The GS1 Code 128 barcode in the sample image below was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:blue'>uFL<b><span style= 'background:yellow'>BB</span></b>arcodeGS1</span><span style= 'background: yellow'>("0200000000000023</span><b><span style= 'font-size:13.5pt; font-family:"Arial",sans-serif;color:#222222;background:aqua'>^</span></b><span style='background:yellow'>11171115</span><b><span style='font-size:13.5pt; font-family:"Arial",sans-serif;color:#222222;background:aqua'>^</span></b><span style='background:yellow'>3700456000</span><b><span style='font-size:13.5pt; font-family:"Arial",sans-serif;color:#222222;background:lime'>~</span></b><span style='background:yellow'>10664202"</span>,<br /> <b><span style='background:#EAF1DD'>"Code128"</span></b>, <b><span style='background:lime'>300</span></b>, <b><span style= 'background:lime'>80</span></b>, <b><span style= 'background:#CCC0D9'>30</span></b>, <span style= 'background: fuchsia'>True</span>, <span style= 'background:aqua'>"c:\temp\GS1_Code128_test.png"</span>, "")<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><img border="0" width="626" height="135" id="Picture 40" src= "CUT_Light_NET_User_Manual_files/image021.png" alt="image" name= "Picture 40" /><br /> <br /> <br /> <br /> <br /> <br /> <br /></p> <h2><a name="_Toc147821053"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodePDF417()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (TextContent(), CharacterSet, DisableECI, ErrorCorrectionLevel,</p> <p class="MsoNormal" style='margin-left:.25in'> ImageWidth, ImageHeight, AddedMargin, Compact, Compaction,<br /> LocalFilePathName)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png" target="_blank">image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate a PDF-417 barcode image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent()</span></b> divides the desired content into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the section discussing the HTML2Image() function. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:#EAF1DD'>CharacterSet</span>:</b> leave blank <b>""</b> to use the default ("ISO-8859-1") <b><br /> <span style='background:#DBE5F1'>DisableECI</span></b> (Boolean): Use <b>False</b>, unless CharacterSet is "UTF-8" and reading fails<br /> <b><span style= 'background:#F2DBDB'>ErrorCorrectionLevel</span></b>: "L0" to "L8" (<b>"L2"</b> is default)<br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: size of the image in pixels.<br /> <b><span style='background:#CCC0D9'>AddedMargin</span></b>: extra white margin in points. Typically, set to <b>0</b><br /> <b><span style='background:#FABF8F'>Compact</span></b> (Boolean): True or False<br /> <b><span style='background:#FABF8F'>Compaction</span></b>: "AUTO", "BYTE", "TEXT" or "NUMERIC". Default is <b>"AUTO"</b><br /> <br /> <b><span style='background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>, <b>.jpg or .jpeg</b></p> <p class="MsoNormal" style='margin-left:.25in'><b><br /></b>The PDF-417 barcode in the <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:blue'>uFL<b><span style= 'background:yellow'>BB</span></b>arcodePDF417</span><span style= 'background:#E5DFEC'>(<span style= 'background:yellow'>{@TextContent}</span></span>, <span style= 'background:#EAF1DD'>""</span>, <span style= 'background: #DBE5F1'>False</span>, <span style= 'background:#F2DBDB'>"L"</span>, <span style= 'background:lime'>300</span>, <span style= 'color:#002060;background:lime'>124</span>, <span style= 'background:#CCC0D9'>0</span>, False, "", <span style= 'background:aqua'>"c:\temp\" & {@ProductType} & "_PDF417.png"</span>)</p> <p class="MsoNormal" style='margin-left:.25in'><br /> Notes:</p> <p class="MsoListParagraph" style='text-indent:-.25in'><span style= 'font-family: Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> If height > width, the barcode is rendered vertically instead of horizontally.</p> <p class="MsoListParagraph" style= 'text-indent:-.25in;line-height:110%'><span style= 'font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> With 75 DPI screen resolution, 75 pixels = 1 inch.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821054"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeDataMatrix ()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (TextContent(), DefaultEncodation, Shape,</p> <p class="MsoNormal" style='margin-left:.25in'> ImageWidth, ImageHeight, LocalFilePathName)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png" target="_blank">image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate a Data Matrix barcode image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent()</span></b> divides the desired content into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the section discussing the HTML2Image() function. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:#EAF1DD'>DefaultEncodation</span>:</b> leave blank <b>""</b> <span style='font-size:11.0pt'>or "ASCII", "Base256", "C40", "EDIFACT", "Text", "X12"<b><br /></b></span><b><span style= 'background:#DBE5F1'>Shape</span></b>: Leave blank "", or use "Rectangle" or "Square" to force the shape.<br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: size (height = width) of the image in pixels.</p> <p class="MsoListParagraph" style='line-height:110%'> With 75 DPI screen resolution, 75 pixels = 1 inch.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>,<b>.jpg or .jpeg</b></p> <p class="MsoNormal" style='margin-left:.25in'><b><br /></b>The Data Matrix barcode in the <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:blue'>uFLBBarcodeDataMatrix</span><span style= 'background:#E5DFEC'>(<span style= 'background:yellow'>{@TextContent}</span></span>, <span style= 'background:#EAF1DD'>""</span>, <span style= 'background: #DBE5F1'>""</span>, <span style= 'background:lime'>81</span>, <span style= 'color:#002060;background:lime'>81</span>,<br /> <span style='background:aqua'>"c:\temp\" & {@ProductType} & "_QR.png"</span>)</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821055"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeAztec()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (TextContent(), Layers, ImageWidth, ImageHeight, LocalFilePathName)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png"> image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate an Aztec barcode image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent()</span></b> divides the desired content into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the section discussing the HTML2Image() function. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:#EAF1DD'>Layers</span>:</b> a number -- not Text! For most use cases, set the number to zero (0). This automatically sets the number of layers to the minimum required to render the content. <b><span style='font-size:11.0pt'><br /></span><span style= 'background:lime'>ImageWidth</span></b>, <b><span style= 'background:lime'>ImageHeight</span></b>: size (height = width) of the image in in pixels.</p> <p class="MsoListParagraph" style='line-height:110%'> With 75 DPI screen resolution, 75 pixels = 1 inch.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>,<b>.jpg or .jpeg</b></p> <p class="MsoNormal" style='margin-left:.25in'><b><br /></b>The Aztec barcode in the <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:blue'>uFLBBarcodeAztec</span> <span style= 'background:#E5DFEC'>(<span style= 'background:yellow'>{@TextContent}</span></span>, <span style= 'background:#EAF1DD'>0</span>, <span style= 'background:lime'>81</span>, <span style= 'color:#002060;background:lime'>81</span>,<br /> <span style='background:aqua'>"c:\temp\" & {@ProductType} & "_Aztec.png"</span>)</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821056"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcode39()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style= 'background:yellow'>TextContent</span>,<span style= 'background:lime'>ImageWidth</span>, <span style= 'background:lime'>ImageHeight</span>, <span style= 'background:lightgrey'>ShowText</span>, <span style= 'background: aqua'>LocalFilePathName</span>)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png"> image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate a Code 39 barcode image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent</span> is</b> the desired content.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:11.0pt'><br /></span><span style= 'background:lime'>ImageWidth</span></b>, <b><span style= 'background:lime'>ImageHeight</span></b>: size of the image in pixels.</p> <p class="MsoListParagraph" style='line-height:110%'> With 75 DPI screen resolution, 75 pixels = 1 inch.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <span style='background:lightgrey'>ShowText</span>: set to TRUE to display the text below the barcode.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>,<b>.jpg or .jpeg</b></p> <p class="MsoNormal"><b><br /></b>The Code 39 barcode shown in this <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal"> </p> <p class="MsoNormal"><span style='color:blue'>uFLBBarcode39</span> <span style='background:#E5DFEC'>(<span style= 'background:yellow'>Ucase({Product_Type.Product Type Name}) & " 123"</span></span>, <span style='background:lime'>300</span>, <span style='background:lime'>80</span>, <span style= 'background:lightgrey'>True</span>, <span style= 'background:aqua'>"c:\temp\" & {@ProductType} & "_Code39.png"</span>)</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821057"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcode93()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821058"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcode128()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821059"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeITF()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821060"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeCodeBar()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821061"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeMSI()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821062"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodePlessey()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcode39()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821063"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeUpcA()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Arguments:</u> (<span style= 'background:yellow'>TextContent</span>,<span style= 'background:lime'>ImageWidth</span>, <span style= 'background:lime'>ImageHeight</span>, <span style= 'background:#F2DBDB'>AddedMargin</span>, <span style= 'background: lightgrey'>ShowText</span>, <span style= 'background:aqua'>LocalFilePathName</span>)<br /> <u><br /></u><b>B</b>arcode version returns "OK" or error message <span style='color:red'>(might be removed in future release)</span><br /> <b><span style='background:yellow'>BB</span></b>arcode version is easier to use: it returns path to image of barcode or <span class= "MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcode_Image_with_Error_Text.png"> image of error</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to generate a UPC-A barcode image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png">example</a></span>).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:yellow'>TextContent</span> is</b> the desired content.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:11.0pt'><br /></span><span style= 'background:lime'>ImageWidth</span></b>, <b><span style= 'background:lime'>ImageHeight</span></b>: size of the image in in pixels.</p> <p class="MsoListParagraph" style='line-height:110%'> With 75 DPI screen resolution, 75 pixels = 1 inch.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <span style='background:#F2DBDB'>AddedMargin</span>: extra margin to add to the sides of the barcode<br /> <br /> <span style='background:lightgrey'>ShowText</span>: set to TRUE to display the text below the barcode.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b> specified a <u>unique</u> file path & name of the barcode image file. That path & file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report. File extension must be <b>.png</b>, <b>.bmp</b>,<b>.jpg or .jpeg</b></p> <p class="MsoNormal"><b><br /></b>The UPC-A barcode shown in this <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/CUT_Light_Barcodes.png" target= "_blank">example report image</a></span> was generated with the following expression in the Graphic Location of the image object:</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='text-autospace:none'><span style= 'color:blue'>uFLBBarcodeUpcA</span> <span style= 'background:#E5DFEC'>(</span><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:black;background:yellow'>"01234567899"</span><span style='font-size:10.0pt;font-family:"Arial",sans-serif;color:black'>,</span> <span style='background:lime'>300</span>, <span style= 'background:lime'>80</span><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black'>, <span style='background:#F2DBDB'>0</span>,</span> <span style= 'background:lightgrey'>True</span><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black'>,</span></p> <p class="MsoNormal" style='text-autospace:none'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:black;background:aqua'> "c:\temp\" & "Test" & "_UpcA.png"</span><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black'>)</span></p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821064"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeUpcE()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcodeUpcA()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821065"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeUpcEanExtension()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcodeUpcA()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821066"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeEAN8()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcodeUpcA()</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821067"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BBarcodeEAN13()</a></h2> <p class="MsoNormal">Same instructions and arguments as <span style='color:#0070C0'>ufl</span>BBarcodeUpcA()<br /> <br /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821068">Charts</a></h1> <p class="MsoNormal"> </p> <p class="MsoNormal"><img border="0" width="695" height="520" id= "Picture 12" src="CUT_Light_NET_User_Manual_files/image022.jpg" alt="image" name="Picture 12" /></p> <p class="MsoNormal"> </p> <p class="MsoNormal">The functions in this section generate Gauge, Bullet Charts, or Sparklines as images that gets inserted on the fly into the report via the 'Graphic Location' expression of a picture object.<br /> <br /> Each function takes a set of arguments and returns the path to the generated image. If an error occurs, the generated image provides the text of the error message.<br /> <br /></p> <p class="MsoNormal">The image above shows examples of these charts.</p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821069"></a><a name= "_uflBulletChart()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BulletChart()</h2> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Arguments:</u> (<span style='background:lime'>ImageWidth</span>, <span style='background:lime'>ImageHeight</span>, <span style= 'background:yellow'>Caption</span>, <span style= 'background:#F2DBDB'>RangeValues,</span> <span style= 'background: lime'>MeasureValue</span>, <span style= 'background:yellow'>ComparativeValue</span>, <span style= 'background:fuchsia'>Style</span>, <span style= 'background:aqua'>LocalFilePathName</span>, <span style= 'color:red'>Options</span>)<br /> <u><br /></u>Returns <span style= 'background:aqua'>LocalFilePathName</span> to image of chart or image of error (facilitates troubleshooting).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Generate a bullet chart image for loading via Graphic Location expression.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: in pixels. if height > width -> vertical orientation.</p> <p class="MsoListParagraph" style='line-height:110%'> With 75 DPI screen resolution, 75 pixels = 1 inch. <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>Caption</span></b> (typically, should leave blank and use Crystal text/formula object for caption).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:#F2DBDB'>RangeValues:</span> <span style= 'background:white'>start value + 3 values for end of each color/shade range. Like</span> <span style='background:#F2DBDB'>[0, 35, 70, 120]</span><br /> <br /> <span style='background:lime'>MeasureValue</span>: the <b>KPI value</b> to plot as a long bar<br /> <br /> <span style='background:yellow'>ComparativeValue</span>: value for <b>short reference bar</b> <br /> <br /> <span style='background:fuchsia'>Style</span>: currently, "Color1" or "Gray1"<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b>: a <u>unique</u> file path & name of the chart image file to be loaded into the Crystal report via a picture <i>Graphic Location</i> expression. <b>.png</b>, <b>.bmp</b>, <b>.jpg or .jpeg<br /> <span style='color:red'><br /> Options</span>: "[ReverseColors]"</b> reverses the order of colors ("Good" is lower numbers).<br /> <b>"[HideScale]"</b> causes the scale to be hidden.<br /> Combined with <span class="MsoHyperlink"><b><a href= "start.htm#_uflImageCrop()">uflImageCrop()</a></b></span> this allows reports like the <span class="MsoHyperlink"><span style= 'background: yellow'><a href= "https://www.screencast.com/t/4MWItrMvs1E4" target= "_blank">image</a></span></span> shown below:<br /> <br /></p> <p class="MsoNormal">The bullet charts shown in this <span class= "MsoHyperlink"><span style='background:yellow'><a href= "https://www.screencast.com/t/SiHneNh2aso">image</a></span></span> were generated with 'Graphic Location' expressions such as:</p> <p class="MsoNormal" style='text-autospace:none'> uFLBulletChart(<span style='background:lime'>80</span>, <span style='background:lime'>350</span>, <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black;background: yellow'> ""</span>, <span style='background:#F2DBDB'>[0, 35, 70, 120]</span>, <span style= 'background:lime'>cdbl({Employee.Salary}/1000)</span>, <span style= 'background:yellow'>55</span>, <span style= 'background:fuchsia'>"Color1"</span>,</p> <p class="MsoNormal" style='text-autospace:none'> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black;background: aqua'> "c:\temp\" & {Employee.Last Name} & ".bmp"</span>, <span style='color:red'>""</span>);<br /> <br /> The cropped bullet charts in the image below use this 'Graphic Location' expression:<br /> <br /> Global numbervar array BulletRangeValues := [0, 35, 70, 120]; </p> <p class="MsoNormal" style='text-autospace:none'>Local numbervar ComparisonValue := 55; </p> <p class="MsoNormal" style='text-autospace:none'>IF instr({Employee.Position}, "President") > 0 Then (BulletRangeValues := [0, 70, 100, 120];</p> <p class="MsoNormal" style='text-autospace:none'> ComparisonValue := 110); // Fuller, the president gets different ranges and benchmark.<br /> // Blank caption and hidden scale.</p> <p class="MsoNormal" style='text-autospace:none'> <b>uFLBulletChart</b>(<span style='background:lime'>350</span>, <span style='background:lime'>80</span>, <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black;background: yellow'> ""</span>, <span style= 'background:#F2DBDB'>BulletRangeValues</span>, <span style= 'background:lime'>cdbl({Employee.Salary}/1000</span>),</p> <p class="MsoNormal" style='text-autospace:none'> <span style='background:yellow'>ComparisonValue</span>, <span style='background:fuchsia'>"Gray1"</span>,</p> <p class="MsoNormal" style='text-autospace:none'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:black;background:aqua'> "c:\temp\HGBullet_" & {Employee.Last Name} & ".bmp"</span>,"<span style='color:red'>[HideScale]</span>");<br /> // Crop the image to allow tight side-by-side layout</p> <p class="MsoNormal" style='text-autospace:none'> <b>uFLImageCrop</b>("c:\temp\HGBullet_" & {Employee.Last Name} & ".bmp", "c:\temp\HGBullet_" & {Employee.Last Name} & "_Cropped.bmp", 20, 5, 310, 35, "");</p> <p class="MsoNormal" style='text-autospace:none'>In the report below, the cropped version of the image is shown in GF1a. An uncropped version with scale visible is in GF1b. Using onlastrecord logic, GF1a is suppressed and GF1b is visible for the last group in the report.<br /> <br /> <img border="0" width="624" height="643" id="Picture 18" src= "CUT_Light_NET_User_Manual_files/image023.jpg" alt="image" name= "Picture 18" /><br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821070"></a><a name= "_uflGaugeRadial()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GaugeRadial()</h2> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Arguments:</u> (<span style='background:yellow'>Caption</span>, <span style='background:#F2DBDB'>RangeValues,</span> <span style= 'background:#C2D69B'>NeedleValues</span>, <span style= 'background:fuchsia'>XML options file</span>,<br /> <span style='background:aqua'>LocalFilePathName</span>, <span style='color:red'>Options</span>)<br /> <u><br /></u>Returns <span style= 'background:aqua'>LocalFilePathName</span> to image of chart or image of error (facilitates troubleshooting).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Generate a Radial Gauge image for loading via Graphic Location expression.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <span style='background:yellow'>Caption:</span> can be left blank if you wish to overlay a label using a Crystal field/formula. Can insert new line character for multi-line caption.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:#F2DBDB'>RangeValues:</span> <span style= 'background:white'>an array of numeric values specifying start of each color band + the end value.<br /></span> <span style= 'background:yellow'><br /></span><span style= 'background:#C2D69B'>Needle Values</span>: an array of numbers or a single value for the main needle. Last number is always considered to be the value for the main needle.<br /> <br /> <span style='background:fuchsia'>XML options file</span>: an XML file provides <b>image size</b> and many <b>design options</b>.<br /> Contact Millet Software for consulting to generate the XML file with other options.<br /> Or you can tweak the XML file yourself (e.g., using notepad).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b>: a <u>unique</u> file path & name of the chart image file to be loaded into the Crystal report via a picture <i>Graphic Location</i> expression. <b>.png</b>, <b>.bmp</b>, <b>.jpg or .jpeg<br /> <span style='color:red'><br /> Options</span>: for future use. leave blank</b></p> <p class="MsoNormal"><b><br /></b>The radial gauge shown in the <span class="MsoHyperlink"><a href= "https://www.screencast.com/t/SiHneNh2aso">image</a></span> at the start of this chapter was generated with the following expression in the 'Graphic Location' of the picture object:</p> <p class="MsoNormal" style='text-autospace:none'><br /> Global numbervar array <span style= 'background:#F2DBDB'>RangeValues</span> := [0, 35, 70, 120];</p> <p class="MsoNormal" style='text-autospace:none'>Local numbervar array <span style='background:#C2D69B'>NeedleValues</span> := [55, Cdbl({Employee.Salary}/1000)];</p> <p class="MsoNormal" style='text-autospace:none'><b><span style= 'color:#1F497D'>uFLGaugeRadial</span></b><span style= 'background:yellow'>("New Orders Value ($K)"</span>,</p> <p class="MsoNormal" style='text-autospace:none'> <span style='background:#F2DBDB'>RangeValues</span>, <span style= 'background:#C2D69B'>NeedleValues</span>, <span style= 'background:fuchsia'>"C:\TEMP\Gauge3.xml"</span>,</p> <p class="MsoNormal" style='text-autospace:none'> <b><span style='background:aqua'>"c:\temp\" & {Employee.Last Name} & ".bmp"</span></b>, <b><span style= 'color:red'>""</span></b>);<br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821071"></a><a name= "_uflSparkLine()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SparkLine()</h2> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Arguments:</u> (<span style='background:lime'>ImageWidth</span>, <span style='background:lime'>ImageHeight</span>, <span style= 'background:#F2DBDB'>Values,</span> Type, <span style= 'background:fuchsia'>Style</span>, <span style= 'background: aqua'>LocalFilePathName</span>, <span style= 'color:red'>Options</span>)<br /> <u><br /></u>Returns <span style= 'background:aqua'>LocalFilePathName</span> to image of chart or image of error (facilitates troubleshooting).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Generate a sparkline image for loading via Graphic Location expression.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='background:lime'>ImageWidth</span></b>, <b><span style='background:lime'>ImageHeight</span></b>: in pixels. if height > width -> vertical orientation.</p> <p class="MsoNormal" style='margin-left:.25in'> With 75 DPI screen resolution, 75 pixels = 1 inch.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:#F2DBDB'>Values:</span> <span style= 'background:white'>an array of numeric values.<br /></span> <span style='background:yellow'><br /> Type</span>: "Line", "Column" or "WinLoss"<br /> <br /> <span style='background:fuchsia'>Style</span>: currently ignored. Leave as blank text ("")<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:aqua'>LocalFilePathName</span></b>: a <u>unique</u> file path & name of the chart image file to be loaded into the Crystal report via a picture <i>Graphic Location</i> expression. <b>.png</b>, <b>.bmp</b>, <b>.jpg or .jpeg<br /> <span style='color:red'><br /> Options</span>: for future use. leave blank</b></p> <p class="MsoNormal"><b><br /></b>The sparklines shown at the top of the <span class="MsoHyperlink"><a href= "https://www.screencast.com/t/SiHneNh2aso">image</a></span> above were generated with 'Graphic Location' expressions such as:</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='text-autospace:none'><b><span style= 'color:#1F497D'>uFLSparkLine</span></b>(<span style= 'background:lime'>130</span>, <span style= 'background:lime'>58</span>, <span style= 'background:#F2DBDB'>[1200, 700, 800, 1400, 1600, 850, 600]</span>, <span style='background:yellow'>"Column"</span>, <span style= 'background: fuchsia'>""</span>,</p> <p class="MsoNormal" style='text-autospace:none'> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:black;background: aqua'> "c:\temp\Sparkline_Column.bmp"</span><span style= 'color:black'>,</span> <span style='color:red'>""</span>);</p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821072">String/Text/JSON</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821073"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>PopulateTemplate()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (<span style='background:yellow'>Template</span>, <span style= 'color:red'>ArgumentsArray</span>, <span style= 'color:#00B050'>EmptyReplacement</span>)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The result of substituting placeholders ({0}, {1}, {2), …) in the Template string with the corresponding entries in the ArgumentsArray. Null or empty arguments are replaced with the EmptyReplacement string.<br /> If the result is longer than 510 characters: <span style= 'font-size:9.5pt; font-family:Consolas;color:#A31515;background:white'> "Result is Longer than 510 characters"</span></p> <p class="MsoNormal" style='margin-left:.25in'><br /> Assume, for example, that you wish to build the syntax for an HTML table row with 3 elements: First Name, Last Name, and Middle Initial. The following formula:</p> <p class="MsoNormal" style='margin-left:.25in'> <b>PopulateTemplate</b>("<span style= 'background:yellow'><TR><TD><b><span style= 'color:red'>{0}</span></b></TD><TD><b><span style= 'color:red'>{1}</span></b></TD><TD><b><span style= 'color: red'>{2}</span></b></TD></TR></span>",<br /> ["Ido", "Millet", ""], "<b><span style= 'color:#00B050'>&nbsp;</span></b>")</p> <p class="MsoNormal" style='margin-left:.25in'>would return the following string:<br /> <b><span style= 'font-family:"Courier New"'><TR><TD><span style= 'color:red'>Ido</span></TD><TD><span style= 'color:red'>Millet</span></TD><TD><span style= 'color:#00B050'>&nbsp;</span></TD></TR></span><br /> </b><br /> Note: instead of specifying an array of strings, you can pass in an array string variable.<br /> For example: <b>PopulateTemplate</b>("<span style= 'background:yellow'><TR><TD><b><span style= 'color:red'>{0}</span></b></TD><TD><b><span style= 'color: red'>{1}</span></b></TD><TD><b><span style= 'color:red'>{2}</span></b></TD></TR></span>",<br /> <b>MyStringArrayVar</b>, "<b><span style= 'color:#00B050'>&nbsp;</span></b>")</p> <p class="MsoNormal" style='margin-left:.25in'><b><br /> <br /></b></p> <h2><a name="_Toc147821074"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExpandStringwithEnvironmentVar()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (InputString)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The input string after expanding any references to environment variables within it to their dynamic values. </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'> <b>ExpandStringwithEnvironmentVar<span style= 'background:yellow'>(</span>"%UserName% -> %temp%")<span style= 'background:yellow'><br /></span></b>returns the following on my PC (where my user id is ixm7):<br /> <b><span style='font-family:"Courier New"'>ixm7 -> C:\Users\ixm7\AppData\Local\Temp</span><br /> <br /></b></p> <h2><a name="_Toc147821075"></a><a name= "_uflReplaceAccentedChars()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ReplaceAccentedChars()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (String)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function replaces all accented characters in the input string with their non-accented versions (for example, ê/ë/è/é <span style= 'font-family:Wingdings'>à</span> e). Upper & lower case are preserved.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> the converted string. </p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821076"></a><a name= "_uflEncode_()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Encode()</h2> <p class="MsoNormal" style='margin-left:.25in'> <u>Arguments:</u><br /> <b><span style= 'background:yellow'>TextContent()</span></b> as String Array<br /> <b><span style= 'background:aqua'>EncodeType</span></b> as String (currently, only <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Barcode128"</span>, <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Base64"</span>, or <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Hex"</span> are supported)<br /> <b><span style= 'background:fuchsia'>EncodeOptions</span></b> (to encode an integer value, set to <span style= 'font-size:9.5pt;font-family:Consolas; color:#A31515'>"</span>Integer_x2<span style='font-size:9.5pt;font-family: Consolas;color:#A31515'>"</span>) where x2 is the <span class="MsoHyperlink"><a href= "https://docs.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings?redirectedfrom=MSDN"> format</a></span>.<br /> <b><span style= 'background:#FFC000'>SegmentN</span></b> as integer<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function combines the string array into a single string, encodes, and returns the requested segment.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> a string with the encoded string or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Sample Code:<br /> <br /> <span style='color:#0070C0'>Local StringVar</span> TextContent := "Text To Encode";</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Local StringVar array</span> MyStringArray;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>IF Len</span>(TextContent) = 0 <span style= 'color:#0070C0'>Then</span></p> <p class="MsoNormal" style='margin-left:.25in'>(<span style= 'color:#0070C0'>redim</span> MyStringArray [1];</p> <p class="MsoNormal" style='margin-left:.25in'> MyStringArray[1] = "";)</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Else</span></p> <p class="MsoNormal" style='margin-left:.25in'>( <span style='color:#0070C0'>Local numbervar</span> segments := <span style='color:#0070C0'>RoundUp</span>(<span style= 'color:#0070C0'>Len</span>(TextContent)/254);</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>redim</span> MyStringArray [segments];</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>Local numbervar</span> index ;</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>for</span> index := 0 <span style= 'color:#0070C0'>to</span> segments - 1 <span style= 'color:#0070C0'>step</span> 1 <span style= 'color:#0070C0'>do</span></p> <p class="MsoNormal" style='margin-left:.25in'> (MyStringArray[index + 1] := <span style='color:#0070C0'>mid</span>(TextContent, 1 + (index * 254) , 254)) ;</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Local</span> <span style= 'color:#0070C0'>StringVar</span> sResult;</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>NumberVar</span> i;</p> <p class="MsoNormal" style='margin-left:.25in'>i := 1;</p> <p class="MsoNormal" style='margin-left:.25in'>// Keep appending segments of 254 characters until we reach the end</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>while</span> <b><span style= 'color:#0070C0'>uFLEncode</span></b>(<span style= 'background: yellow'>MyStringArray</span>, <span style= 'background:aqua'>"Barcode128"</span> , <span style= 'background:fuchsia'>""</span>, <span style= 'background: #FFC000'>i</span>) <> "" <span style= 'color:#0070C0'>Do</span></p> <p class="MsoNormal" style='margin-left:.25in'>( sResult := sResult + <b><span style='color:#0070C0'>uFLEncode</span></b>(<span style= 'background:yellow'>MyStringArray</span>, <span style= 'background:aqua'>"Barcode128"</span> , <span style= 'background:fuchsia'>""</span>, <span style= 'background:#FFC000'>i</span>);</p> <p class="MsoNormal" style='margin-left:.25in'>i := i + 1</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'>sResult;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <h2><a name="_Toc147821077"></a><a name= "_uflDecode_()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Decode()</h2> <p class="MsoNormal" style='margin-left:.25in'> <u>Arguments:</u><br /> <b><span style= 'background:yellow'>TextContent()</span></b> as String Array<br /> <b><span style= 'background:aqua'>EncodeType</span></b> as String (currently, only <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Base64"</span> or<span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Hexadecimal"</span> are supported)<br /> <b><span style= 'background:fuchsia'>EncodeOptions</span></b> (leave as blank <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>""</span>)<br /> <b><span style= 'background:#FFC000'>SegmentN</span></b> as integer<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function combines the string array into a single string, decodes, and returns the requested segment. For example, <b>uflDecode</b><span style= 'font-size:9.5pt;font-family:Consolas; color:black'>({</span><span style='font-size:9.5pt;font-family:Consolas; color:#A31515'>"VGVzdDEyMzQ="</span><span style='font-size:9.5pt; font-family:Consolas;color:black'>},</span> <span style= 'font-size:9.5pt; font-family:Consolas;color:#A31515'>"Base64"</span><span style='font-size:9.5pt;font-family:Consolas;color:black'>,</span> <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>""</span><span style='font-size:9.5pt;font-family:Consolas;color:black'>, 1))<br /></span> returns <span style= 'font-size:9.5pt;font-family:Consolas;color:black'><b>Test1234</b></span></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> the decoded string or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Sample Code:<br /> <br /> <span style='color:#0070C0'>Local StringVar</span> TextContent := "Text To Decode";</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Local StringVar array</span> MyStringArray;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>IF Len</span>(TextContent) = 0 <span style= 'color:#0070C0'>Then</span></p> <p class="MsoNormal" style='margin-left:.25in'>(<span style= 'color:#0070C0'>redim</span> MyStringArray [1];</p> <p class="MsoNormal" style='margin-left:.25in'> MyStringArray[1] = "";)</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Else</span></p> <p class="MsoNormal" style='margin-left:.25in'>( <span style='color:#0070C0'>Local numbervar</span> segments := <span style='color:#0070C0'>RoundUp</span>(<span style= 'color:#0070C0'>Len</span>(TextContent)/254);</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>redim</span> MyStringArray [segments];</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>Local numbervar</span> index ;</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>for</span> index := 0 <span style= 'color:#0070C0'>to</span> segments - 1 <span style= 'color:#0070C0'>step</span> 1 <span style= 'color:#0070C0'>do</span></p> <p class="MsoNormal" style='margin-left:.25in'> (MyStringArray[index + 1] := <span style='color:#0070C0'>mid</span>(TextContent, 1 + (index * 254) , 254)) ;</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Local</span> <span style= 'color:#0070C0'>StringVar</span> sResult;</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>NumberVar</span> i;</p> <p class="MsoNormal" style='margin-left:.25in'>i := 1;</p> <p class="MsoNormal" style='margin-left:.25in'>// Keep appending segments of 254 characters until we reach the end</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>while</span> <b><span style= 'color:#0070C0'>uFLDecode</span></b>(<span style= 'background: yellow'>MyStringArray</span>, <span style= 'background:aqua'>"Base64"</span> , <span style= 'background:fuchsia'>""</span>, <span style= 'background: #FFC000'>i</span>) <> "" <span style= 'color:#0070C0'>Do</span></p> <p class="MsoNormal" style='margin-left:.25in'>( sResult := sResult + <b><span style='color:#0070C0'>uFLDecode</span></b>(<span style= 'background:yellow'>MyStringArray</span>, <span style= 'background:aqua'>"Base64"</span> , <span style= 'background:fuchsia'>""</span>, <b><span style= 'background: #FFC000'>i</span></b>);</p> <p class="MsoNormal" style='margin-left:.25in'>i := i + 1</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'>sResult;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <h2><a name="_Toc147821078"></a><a name= "_uflDecode2ImageFile()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Decode2ImageFile()</h2> <p class="MsoNormal" style='margin-left:.25in'> <u>Arguments:</u><br /> <b><span style= 'background:yellow'>TextContent()</span></b> as String Array<br /> <b><span style= 'background:aqua'>EncodeType</span></b> as String (currently, only <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Base64"</span> or<span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"Hexadecimal"</span> are supported)<br /> <b><span style= 'background:lime'>LocalFilePathName</span></b> as String (e.g. <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"c:\temp\test.png"</span>)<br /> <b><span style= 'background:fuchsia'>Options</span></b> (leave as blank <span style='font-size:9.5pt;font-family:Consolas;color:#A31515'>""</span>)<br /> <br /> This function is typically used to convert Base64 or Hexadecimal content stored in the database to an image file for dynamic loading into a report. The loading is typically done via the 'Graphic Location' expression of a dummy image. If image resizing is desired, use the ImageResize() function.<br /> <br /> <u>Returns:</u> the path to the newly created image file.<br /> If an error occurs, the image contains the text of the error fitted to an image sized 200x200.<br /> <br /> Sample Code:<br /> <br /> <span style='color:#0070C0'>Local StringVar</span> TextContent := {Product.Image};</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Local StringVar array</span> MyStringArray;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>IF Len</span>(TextContent) = 0 <span style= 'color:#0070C0'>Then</span></p> <p class="MsoNormal" style='margin-left:.25in'>(<span style= 'color:#0070C0'>redim</span> MyStringArray [1];</p> <p class="MsoNormal" style='margin-left:.25in'> MyStringArray[1] = "";)</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#0070C0'>Else</span></p> <p class="MsoNormal" style='margin-left:.25in'>( <span style='color:#0070C0'>Local numbervar</span> segments := <span style='color:#0070C0'>RoundUp</span>(<span style= 'color:#0070C0'>Len</span>(TextContent)/254);</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>redim</span> MyStringArray [segments];</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>Local numbervar</span> index ;</p> <p class="MsoNormal" style='margin-left:.25in'> <span style='color:#0070C0'>for</span> index := 0 <span style= 'color:#0070C0'>to</span> segments - 1 <span style= 'color:#0070C0'>step</span> 1 <span style= 'color:#0070C0'>do</span></p> <p class="MsoNormal" style='margin-left:.25in'> (MyStringArray[index + 1] := <span style='color:#0070C0'>mid</span>(TextContent, 1 + (index * 254) , 254)) ;</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'color:#0070C0'>uFLDecode2ImageFile</span></b>(<span style= 'background:yellow'>MyStringArray</span>, <span style= 'background:aqua'>"Base64"</span>, <span style= 'background:lime'>"c:\temp\" + {Product.ID} + ".png"</span>, <span style='background:fuchsia'>""</span>);</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> <br /></p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821079"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Hex2Ascii()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (String)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function takes hex string eg "ed0972ba628b29f0ec" and returns its ascii equivalent</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> the ascii string</p> <p class="MsoNormal"><br /> <br /></p> <h2><a name="_Toc147821080"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Hex2Number()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (String)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function takes hex string (for example "000130D") and returns its numeric value<br /> (4877 in this case)</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> the numeric value of the hex string.<br /> <br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821081"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ConvertRTF2Text()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (RTFText() as String Array, SegmentN as integer)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function converts RTF Text to Plain Text and returns the Nth 254-character segment from the result. See sample <span class= "MsoHyperlink"><a href= "http://screencast.com/t/dmL1w16KHb">image</a></span>.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b>RTFText</b> argument divides the RTF string into an array with 254-charcter segments.<br /> In the example below, the {@RTF} content gets chopped into a MyStringArray using the code in <span style= 'color:#C00000'>red</span>. The code in blue then calls <b><span style='color:#1F497D'>uFLConvertRTF2Text(MyStringArray, i)</span></b> in a loop until no more segments are returned.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>Local StringVar array MyStringArray;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>IF Len({@RTF}) = 0 Then</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>(redim MyStringArray [1];</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> MyStringArray[1] = "";)</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>Else</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>( Local numbervar segments := RoundUp(Len({@RTF})/254);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> redim MyStringArray [segments];</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> Local numbervar index ;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> for index := 0 to segments - 1 step 1 do</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> (MyStringArray[index + 1] := mid({@RTF}, 1 + (index * 254) , 254)) ;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>);</span></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>Local StringVar sResult;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>NumberVar i;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>i := 1;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#00B050'>// Keep appending segments of 254 characters until we reach the end</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>while uFLConvertRTF2Text(MyStringArray, i) <>"" Do</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>(</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>sResult := sResult + uFLConvertRTF2Text(MyStringArray, i);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>i := i + 1</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>sResult;</span></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <h2><a name="_Toc147821082"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ConvertRTFFileToText()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (RTFFile, TextFile)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function takes an RTF File and converts it to a plain text file.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> "OK" or failure message (e.g. "RTF File not found").<br /> <br clear="all" style='page-break-before:always' /></p> <h2><a name="_Toc147821083"></a><a name= "_uflJsonGet()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>JsonGet()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (<span style='background:yellow'>JsonText()</span> as String Array, <span style='background:aqua'>JsonPath</span> as String, <span style='background: lime'>RequestType</span> as String, <span style='background:fuchsia'>SegmentN</span> as integer, <span style='background:#FBD4B4'>Options</span> as String)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> This function locates the content found at the specified path. It returns the Nth 254-character segment from the result. Errors are returned following a '* ' prefix.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> The <span style='background:yellow'>JsonText()</span> argument divides the JSON content into an array with 254-charcter segments.<br /> Or you can simply pass the full JSON content as a single string.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> The <span style='background:aqua'>JsonPath</span> argument specifies the path to the desired content. See examples <span class="MsoHyperlink"><a href= "https://www.example-code.com/vbnet/json_paths.asp">here</a></span>.<br /> The path "<b><span style= 'background:aqua'>mixture.arrayA[2].fruit</span></b>" locates a top-level element called "<span style= 'background:aqua'>mixture</span>",<br /> within that a sub-element called "<span style= 'background:aqua'>arrayA</span>",<br /> within that, the <span style= 'background:aqua'>3<sup>rd</sup></span> array object (indexing is zero-based, so 2 points to the 3<sup>rd</sup> element),<br /> and within that, the value of the "<span style= 'background:aqua'>fruit</span>" element. So it returns "kiwi".<br /> <br /> RequestType can be: "<span style='background:lime'>STRINGOF</span>" (returns the targeted content as flattened string)<br /> or "<span style='background:lime'>SIZEOFARRAY</span>" (returns number of elements in the targeted array)<br /> <br /> <b><u>Simple Sample (no String Array, Getting just the 1<sup>st</sup> output segment):<br /></u><span style= 'color:#1F497D'>uFLJsonGet</span></b>(<span style= 'background: yellow'>{@JSON}</span>, "<span style= 'background:aqua'>mixture.arrayA[2].fruit</span>", "<span style= 'background:lime'>STRINGOF</span>", <span style= 'background:fuchsia'>1</span>, "")<br /> <br /> <b><u>Complex Sample (with String Array as input and collecting output segments:</u></b> <br /> the code below calls <b><span style= 'color:#1F497D'>uFLJsonGet(<span style= 'background:yellow'>MyStringArray</span>, <span style= 'background:fuchsia'>i</span>, "")</span></b> in a loop until no more segments are returned.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>Local StringVar myString := {@JSON}; <br /> Local StringVar array <span style= 'background:yellow'>MyStringArray</span>;<br /> IF Len(myString) = 0 Then</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> (redim MyStringArray [1]; <br /> MyStringArray[1] = "";)</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>Else ( Local numbervar segments := RoundUp(Len(myString)/254);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> redim MyStringArray [segments];</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> Local numbervar index ;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> for index := 0 to segments - 1 step 1 do</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> (MyStringArray[index + 1] := mid(myString, 1 + (index * 254) , 254)) ;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>Local StringVar sResult; NumberVar i; <br /> i := 1;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#00B050'>// Keep appending segments of 254 characters until we reach the end</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>while <b>uFLJsonGet</b>(<b><span style= 'background:yellow'>MyStringArray</span></b>, "</span><b><span style= 'background:aqua'>mixture.arrayA[2].fruit</span>"</b><span style= 'color:#1F497D'>,</span> "<span style= 'background:lime'>STRINGOF</span>", <span style= 'color:#1F497D'><b><span style='background:fuchsia'>i</span></b>, "") <>"" Do (sResult := sResult + <b>uFLJsonGet</b>(<b><span style= 'background:yellow'>MyStringArray</span></b>, "</span><b><span style= 'background:aqua'>mixture.arrayA[2].fruit</span>"</b><span style= 'color:#1F497D'>,</span> "<span style= 'background:lime'>STRINGOF</span>", <span style= 'color:#1F497D'><b><span style='background:fuchsia'>i</span></b>, ""); <br /> i := i + 1);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#1F497D'>sResult;</span></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <p class="MsoNormal">This image demonstrates the logic:<br /> <br /> <span style='color:#1F497D'><img border="0" width="689" height= "574" id="Picture 38" src= "CUT_Light_NET_User_Manual_files/image024.jpg" alt="image" name= "Picture 38" /></span><span style= 'color:#1F497D'> <br /></span><b><span style= 'font-size:16.0pt;color:maroon'><br /> <br /> <br /></span></b></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821084">Regular Expressions</a></h1> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>In the following 3 functions, strInput() can be either a simple string or an array of strings that divides long text into an array with up to 254-charcter elements.<br /> You can see example of how content can be chopped into such an array in the <span class="MsoHyperlink"><a href= "start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821085"></a><a name= "_uflRegExpIsMatch()"></a><span style= 'color:#0070C0'>ufl</span>RegExpIsMatch()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (strInput(), Pattern)<br /> This function takes an input string and matches it to Regular Expression pattern,<br /> <br /> <u>Returns:</u> True if the input string matches the RegExp pattern.<br /> <br /> For example, the following formula returns True because the string matches the RegExp pattern for valid emails:</p> <p class="MsoNormal" style='margin-left:.5in'> <b>uFLRegExpisMatch</b>("ido@MilletSoftware.com",</p> <p class="MsoNormal" style='margin-left:.5in'> "[\w+-]+(?:\.[\w+-]+)*@[\w+-]+(?:\.[\w+-]+)*(?:\.[a-zA-Z]{2,4})")<br /> <br /> <br /></p> <h2><a name="_Toc147821086"></a><a name= "_uflRegExpMatch()"></a><span style= 'color:#0070C0'>ufl</span>RegExpMatch()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (strInput(), Pattern)<br /> <br /> <u>Returns:</u> This function searches the strInput and returns the first substring that matches the pattern.<br /> <br /> For example, the following formula returns "ido@MilletSoftware.com" because it's the first substring matching a valid email address pattern:</p> <p class="MsoNormal" style='margin-left:.5in'> <b>uFLRegExpMatch</b>("His email address is ido@MilletSoftware.com.",<br /> "[\w+-]+(?:\.[\w+-]+)*@[\w+-]+(?:\.[\w+-]+)*(?:\.[a-zA-Z]{2,4})")</p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821087"></a><a name= "_uflRegExpReplace()"></a><span style= 'color:#0070C0'>ufl</span>RegExpReplace()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (strInput(), Pattern, Replacement)<br /> <br /> <u>Returns:</u> This function searches the strInput and replace strings that match a pattern with a replacement string.<br /> <br /> For example, the following formula returns<br /> <b>"His Social Security Number is ***-**-****"</b><br /> because every digit was replaced with a '*':<br /> <br /> <b>uFLRegExpReplace</b>("His Social Security Number is 123-45-6789", "\d", "*")<br /> <br /> <br /> <br clear="all" style='page-break-before:always' /></p> <h1><a name="_Toc147821088">File</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821089"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileAge()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileName)<br /> <u>Returns:</u> Age of file in <b>minutes</b>.<br /> <b>- 1</b> if the given file path & name doesn't exists.<br /> <br /></p> <h2><a name="_Toc147821090"></a><a name= "_uflFileAge2()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileAge2()</h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileName, Type)<br /> Type can be: ‘<b><i>CreationTime</i></b><i>’</i>, ‘<b><i>LastAccessTime</i></b><i>’</i>, or ‘<b><i>LastWriteTime</i></b><i>’</i><br /> <u>Returns:</u> Age of file in <b>minutes</b>.<br /> <b>- 1</b> if the given file path & name doesn't exists.<br /> - <b>10</b> if the Type argument is not recognized.<br /> -100 for Unauthorized Access Exception<br /> -200 for Path Too Long exception <br /> <br /></p> <h2><a name="_Toc147821091"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileCompare()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (file1, file2)<br /> <u>Returns:</u> False if the 2 files are not the same (or are missing/inaccessible).<br /> Trues: if the <u>content</u> of the 2 files is the same.<br /> <br /></p> <h2><a name="_Toc147821092"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileCopy()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileToCopy, DestinationFile)<br /> <u>Returns:</u> "OK", "File Not Found", "Destination File Already Exists", or error message.<br /> Note: use FileExists()/FileDelete() to ensure the destination file doesn't already exist.<br /> <br /></p> <h2><a name="_Toc147821093"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileDelete ()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileToDelete)<br /> <u>Returns:</u> "OK", "File Not Found", or Error message if the delete fails<br /> <br /></p> <h2><a name="_Toc147821094"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileExists()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileName)<br /> <u>Returns:</u> If the given file path & name exists, returns TRUE. Otherwise, returns FALSE.<br /> <br /></p> <h2><a name="_Toc147821095"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileRename()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileToRename, NewName)<br /> <u>Returns:</u> "OK", "File Not Found" or Error message if rename fails.<br /> Note: use FileExists()/FileDelete() to ensure the new file name doesn't already exist.<br /> <br /></p> <h2><a name="_Toc147821096"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileJustName()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (FileName)<br /> <u>Returns:</u> file <b>name</b> without the path.<br /> <br /></p> <h2><a name="_Toc147821097"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileJustPath()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (FileName)<br /> <u>Returns:</u> file <b>path</b> without the name.<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821098"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileListFromWildCards()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (FileName(s), Delimiter, Segment_N, Recursive)<br /> <br /> Notes:</p> <p class="MsoNormal" style='margin-left:.75in;text-indent:-.25in'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> the FileName argument can include one or more path and wild card patterns separated by the specified Delimiter. The second element in such a delimited list can drop the path if it uses the path of the element before it. For example, <b>c:\Mail\Attach\*.xls;*.pdf</b></p> <p class="MsoNormal" style='margin-left:.75in;text-indent:-.25in'> <span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> If Recursive is set to True, the search process recurses down into subfolders</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <u>Returns:</u> A delimited list of all files matching the specified FileName(s) patterns. Breaking the file list content into segments of 254 characters each, the function returns the segment number specified by the Segment_N argument. <br /> If the specified file path & name doesn't exist, an empty string is returned. <br /> <br /> In Crystal, you can load the entire file list into a string variable using the following code:</p> </div> <p class="MsoNormal" style='margin-left:.25in'>StringVar sFile;</p> <p class="MsoNormal" style='margin-left:.25in'>NumberVar i;</p> <p class="MsoNormal" style='margin-left:.25in'>i := 1;</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// Keep appending segments of 254 characters to the sFile string until</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// we reach the end of the file List</span></p> <p class="MsoNormal" style='margin-left:.25in'>while FileListFromWildCards("c:\mail\attach\*.xls;*.sav",";", i ,False ) <>"" Do</p> <p class="MsoNormal" style='margin-left:.25in'>(</p> <p class="MsoNormal" style='margin-left:.25in'>sFile := sFile + FileListFromWildCards("c:\mail\attach\*.xls;*.sav",";", i ,False );</p> <p class="MsoNormal" style='margin-left:.25in'>i := i + 1</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// Return the resulting string</span></p> <p class="MsoNormal" style='margin-left:.25in'>sFile;</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// to show each file on a new line, replace delimiter with NewLine + CarriageReturn.</span></p> <p class="MsoNormal" style='margin-left:.25in'>//Replace(sFile, ";", Chr(10) + Chr(13));</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> To check for the existence of files matching a wild card expression, you can use a Crystal formula like this:<br /> IF Len(<b>FileListFromWildCards</b>("c:\temp\*.zip", ",", 1, False)) > 0 Then True Else False</p> <p class="MsoNormal"><b><i><span style= 'font-size:14.0pt'> </span></i></b></p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2> </h2> <h2><a name="_Toc147821099"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileUnzip()</a></h2> <p class="MsoNormal"><u>Arguments:</u> (FileToUnzip, <span style= 'background: #B8CCE4'>DestinationFolder</span>, <span style= 'background:#E5B8B7'>Password</span>, Type, Options)<br /> <u>Returns:</u> "OK", "File Not Found", "ZIP Open Problem", "Password Problem" or error message.<br /> <br /> If the <b><span style= 'background:#B8CCE4'>DestinationFolder</span></b> doesn't exist, the function takes care of creating it.<b><br /> <span style='background:#E5B8B7'>Password</span></b> argument is optional. Set it to <b>""</b> if the zip file is not password protected.<br /> Set the <b>Type</b> argument to <b>"ZIP"</b> (though currently it is assumed to be that)<br /> Leave the <b>Options</b> argument as <b>""</b> (it is reserved for future enhancements).<br /> <br /> Example without password:<br /> <b>uFLFileUnzip("c:\temp\test.zip", <span style= 'background:#B8CCE4'>"c:\temp\"</span>, <span style= 'background:#E5B8B7'>""</span>, "ZIP", "");</b></p> <p class="MsoNormal"><br /> Example with password:<br /> <b>uFLFileUnzip("c:\temp\test_Pass.zip", <span style= 'background: #B8CCE4'>"c:\temp\"</span>, <span style= 'background:#E5B8B7'>"abc123"</span>, "ZIP", "");<br /> <br /></b></p> <h2><a name="_Toc147821100"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetTempFolder()</a></h2> <p class="MsoNormal"><u>Arguments:</u> None<br /> <br /> <u>Returns:</u> The path to the user's temp folder (without a closing "\")<br clear="all" style='page-break-before:always' /></p> <h1><a name="_Toc147821101">Text File</a></h1> <h2><a name="_Toc147821102"></a><a name= "_uflFileAddText()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileAddText()</h2> <p class="MsoNormal" style='margin-left:.5in'>Arguments: (FileName, <span style='background:yellow'>TextToAdd()</span>, <span style= 'background:aqua'>DeleteFileBeforeAdd</span>, <span style= 'background:lime'>CarriageReturnAfterAdd</span> )<br /> <u>Returns:</u> TRUE if successful, otherwise FALSE.</p> <p class="MsoNormal"><b><i><span style= 'font-size:14.0pt'> </span></i></b></p> <p class="MsoNormal" style='margin-left:.25in'>Adds text to a given file (file path and name). <br /> If the file doesn't exist it gets created automatically.</p> <p class="MsoNormal" style='margin-left:.25in'>If the directory doesn't exist, it gets created automatically.<br /> Note: use <b>CHR(34)</b> in <b><i>TextToAdd</i></b> argument to generate <b>double quotes</b> in the text output.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>TextToAdd()</span> argument can be either simple string (up to 254 characters) or an array of such strings. You can see example of how long test can be chopped into such an array in the first example below. The array elements are combined to a single line in the target text file.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>If <b><span style= 'background: aqua'>DeleteBeforeAdd</span></b> is TRUE – deletes the file before appending the text.<br /> Note: the deleted file is moved to the recycle bin where it can be recovered.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>If <b><span style= 'background: lime'>CarriageReturnAfterAdd</span></b> is set to FALSE, follow-up calls to this function would add content to the same line (allowing "wide" exports beyond the 254 character limitation of String variables). </p> <p class="MsoNormal" style='margin-left:.25in'>You can use the <b><i>FileAddText()</i></b> function to generate your own log or export files from within Crystal formulas. <br /> <br /> A specific example would be a situation where after using the functions below to electronically burst and e-mail customers their invoices, you want to update the database with information about which invoices were emailed. You can write to a text file the invoice numbers that were included in the operation and use that file to update a Status column in the INVOICE table using an Update query (WHERE INVOICE_N IN the set of invoice</p> <p class="MsoNormal" style='margin-left:.25in'>numbers…).</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>An example of using the string array approach to write a very long line in a single call:</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><b>StringVar MyText := {@LongTextLine};</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>local stringvar array <span style= 'background:yellow'>MyStringArray</span>;</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>IF Len(MyText) = 0 Then</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>(redim MyStringArray [1];</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> MyStringArray[1] = "";)</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b>Else</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b>( Local numbervar segments := RoundUp(Len(MyText)/254);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> redim MyStringArray [segments];</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> Local numbervar index ;</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> for index := 0 to segments - 1 step 1 do</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> (MyStringArray[index + 1] := mid(MyText, 1 + (index * 254) , 254)) ;</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> </b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#0070C0'>FileAddText</span> (TargetFile, <span style='background:yellow'>MyStringArray</span>, <span style= 'background:aqua'>False</span>, <span style= 'background:lime'>True</span>);</b></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> Here is an example of using the older approach (no string array for content) whereby the content is broken to multiple calls:</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><b>StringVar MyText := {@LargeText};</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>StringVar TargetFile := "c:\temp\test.txt";</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#00B050'>// chop and write the text in 254 character segments</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>While Len(MyText) > 254 Do</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> (<br /> <span style='color:#0070C0'>FileAddText</span> (TargetFile, Left(MyText, 254), False, False);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> MyText := Mid(MyText, 255);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> );</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#00B050'>// write the remaining small segment</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#0070C0'>FileAddText</span> (TargetFile, MyText, <span style='background:aqua'>False</span>, <span style= 'background:lime'>False</span>);</b></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <p class="MsoNormal"><br /> Here is an example of using FileAddText to write to a log file:</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt'> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// The FileAddText() can be used to create any customized text logging/export <br /> // you can embed this functionality inside IF THEN logic to log information</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// only when certain conditions in the report are met.</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'> <b><span style='font-size:14.0pt'><br /> FileAddText(</span></b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// File to add text to</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'> <b>"c:\temp\My_Log.txt",</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// Text added to the file</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'> <b>"Product Type: " + {Product_Type.Product Type Name} + ", " + Cstr(CurrentDateTime), </b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// FALSE = Don't delete this file before adding the text</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'> <b><span style='background:aqua'>FALSE</span>,</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'><b>// TRUE = add a CrLf at the end of the added text, so next call starts on new line.</b></p> <p class="MsoIndexHeading" style='border:none;padding:0in'> <b><span style='background:lime'>TRUE</span>);</b></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821103"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileAddText2()</a></h2> <p class="MsoNormal" style='margin-left:.5in'>Arguments: (FileName, TextToAdd(), DeleteFileBeforeAdd, CarriageReturnAfterAdd,<br /> <span style='background:yellow'>Encoding</span>, <span style= 'background:aqua'>EmitBOM</span>, <span style= 'background:lime'>Options</span>)<br /> <u>Returns:</u> TRUE if successful, otherwise FALSE.</p> <p class="MsoNormal"><b><i><span style= 'font-size:14.0pt'> </span></i></b></p> <p class="MsoNormal" style='margin-left:.25in'>This function is same as uflFileAddTest() except for 3 additional arguments:<br /> <br /> <span style='background:yellow'>Encoding</span> (string): any of the Character Encoding names listed <span class= "MsoHyperlink"><a href= "https://cknotes.com/chilkat-charsets-character-encodings-supported/"> here</a></span>. For example, “utf-8”<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:aqua'>EmitBOM</span> (Boolean): If True, then the BOM (also known as a preamble), is emitted<br /> for charsets that define a BOM (such as “utf-8”, “utf-16”, and “utf-32”).<br /> <br /> <span style='background:lime'>Options</span> (String): set to blank text (<b>""</b>). This is reserved for future functionality.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821104"></a><a name= "_uflFileAddTextKey()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileAddTextKey()</h2> <p class="MsoNormal" style='margin-left:.5in'>Arguments: (FileName, TextToAdd, DeleteFileBeforeAdd, CarriageReturnAfterAdd,<br /> <b><span style='color:red'>Key2AvoidDuplication</span></b> )</p> <p class="MsoNormal" style='margin-left:.5in'><u><br /> Returns:</u> TRUE if successful, otherwise FALSE.</p> <p class="MsoNormal" style='margin-left:.5in'>Same as FileAddText above but requires a unique String value in <b><span style= 'color:red'>Key2AvoidDuplication</span></b> argument. If that value was already used in a prior call within the same report preview, the process is skipped. The idea is to avoid duplication in cases where report pagination causes the formula evaluation to be duplicated.<br /> <br /> Note: <b>FileAddTextKey()</b> is just a convenient alternative to using a <b>NewKey()</b> test before calling <b>FileAddText()</b>.<br /> <br /> Note: use <span class="MsoHyperlink"><a href= "start.htm#_uflKeySetClear()">uflKeySetClear()</a></span> to reset the keys between consecutive report previews.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821105"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>LookupText()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (FileName, String2Match, ExactMatch)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>The file name should include the <b>full path</b> to a text file with Key|||Value pairs like this:<br /> <br /></p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.5in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> Key1|||Value1<br /> Key2|||Value2</p> <p class="MsoNormal" style='border:none;padding:0in'>…</p> </div> <p class="MsoNormal"><br /> <u>Returns:</u> the Value from the first line where the Key matches the Strings2Match argument.<br /> <br /> ExactMatch is a Boolean argument: if it is True, the Key must match the String2Match on all characters (though the matching is not case sensitive). If ExactMatch is False, the process assumes a match if the key is found anywhere within the String2Match.<br /> <br /> This function can be used to let end users maintain branching logic for a string formula without needing to change the formula within Crystal.<br /> <br clear="all" style='page-break-before:always' /></p> <h2><a name="_Toc147821106"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileGetText()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (FileName, Segment_N)<br /> Note: the file name should include the <b>full path</b> to the file.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <u>Returns:</u> Breaking the file content into segments of 254 characters each, the function returns the segment number specified by the Segment_N argument. If the specified file path & name doesn't exist, an empty string is returned. <br /> <br /> In Crystal, you can load the entire file content into a string variable using the following code:</p> </div> <p class="MsoNormal" style='margin-left:.25in'>StringVar sFile;</p> <p class="MsoNormal" style='margin-left:.25in'>NumberVar i;</p> <p class="MsoNormal" style='margin-left:.25in'>i := 1;</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// Keep appending segments of 254 characters to the sFile string until</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// we reach the end of the file</span></p> <p class="MsoNormal" style='margin-left:.25in'>while FileGetText( "c:\temp\test.ini", i) <>"" Do</p> <p class="MsoNormal" style='margin-left:.25in'>(</p> <p class="MsoNormal" style='margin-left:.25in'>sFile := sFile + FileGetText( "c:\temp\test.ini", i);</p> <p class="MsoNormal" style='margin-left:.25in'>i := i + 1</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:green'>// Return the resulting string</span></p> <p class="MsoNormal" style='margin-left:.25in'>sFile;</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> Note: if the file contains HTML or RTF text (rather than plain text) you can take advantage of Crystal's formatting options to <b>interpret the string returned by the formula as HTML or RTF</b>. Also, be sure to use Crystal's "<b>Can Grow</b>" formatting option where appropriate.<br /> <br /> <br /> <br /></p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821107"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>FileGetText<span style='color:red'>UTF8</span>()</a></h2> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal"> Same as FileGetText() except that it works with text files with <b>UTF-8 encoding</b>. <br /> <br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821108">ini/registry</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821109"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetINIValue()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileName, SectionName, KeyName)<br /> <br /> <u>Returns:</u> The String value found in the ini file, under the given section for the specified key. Returns "Failed INI Lookup" if the lookup fails. <br /> <br /> <br /> <br /></p> <h2><a name="_Toc147821110"></a><a name= "_uflGetINIValueSegment()"></a><span style= 'color:#0070C0'>ufl</span>GetINIValue<span style= 'color:red'>Segment</span>()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (FileName, SectionName, KeyName, SegmentN, FailedLookupMessage)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function is just like GetINIValue() (see detail above) but it <b>allows you to retrieve strings that are longer than 254 characters by breaking the operation into segments</b>.<br /> <br /> It also allows you to specify the string to return if the ini entry was not found.<br /> <b><span style='background:yellow'>""</span></b> (as shown in the examples below) would return blank text</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><br /> <u>Returns:</u><br /> Breaking the resulting string into segments of 254 characters each, the function returns the segment number specified by the SegmentN argument. In Crystal, you load the entire result into a string variable using the following code:<br /> <br /></p> </div> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>WhilePrintingRecords;</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>StringVar</span> sResult;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>StringVar</span> sSegment;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>NumberVar</span> i;</p> <p class="MsoNormal" style='border:none;padding:0in'>i := 1;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#00B050'>// Keep appending segments of 254 characters to the sResult string until reaching the end</span></p> <p class="MsoNormal" style='border:none;padding:0in'>sSegment := <span style= 'color:#0070C0'>uflGetINIValueSegment</span>("c:\test\text.ini","Options","Long_Greeting", I, <span style='background:yellow'>""</span>);</p> <p class="MsoNormal" style='border:none;padding:0in'>while sSegment <>"" Do</p> <p class="MsoNormal" style='border:none;padding:0in'>(</p> <p class="MsoNormal" style='border:none;padding:0in'> sResult := sResult + sSegment;</p> <p class="MsoNormal" style='border:none;padding:0in'> i := i + 1;</p> <p class="MsoNormal" style='border:none;padding:0in'> sSegment := <span style= 'color:#0070C0'>uflGetINIValueSegment</span>("c:\test\text.ini","Options","Long_Greeting", I, <span style='background:yellow'>""</span>)</p> <p class="MsoNormal" style='border:none;padding:0in'>);</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#00B050'>// Return the resulting string</span></p> <p class="MsoNormal" style='border:none;padding:0in'>sResult;</p> </div> <p class="MsoNormal"><br /> <b><span style='color:#0070C0'><br clear="all" style= 'page-break-before:always' /></span></b></p> <h2><a name="_Toc147821111"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SetINIValue()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (FileName, SectionName, KeyName, KeyValue)<br /> <br /> <u>Returns:</u> TRUE if Successful – FALSE if failed. <br /> <br /> Writes the String value specified in "KeyValue" to the specified ini file, Section, and Key. If the path exists but the ini file doesn't – the function creates the ini file. If the section and/or key don't exist, they get created.<br /> <br /> <br /></p> <h2><a name="_Toc147821112"></a><a name= "_uflINISectionDelete()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>INISectionDelete()</h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (iniFile, SectionName2Delete)<br /> <br /> <u>Returns:</u> "TRUE" if Successful<br /> "***Missing INI File" if ini file wasn't found<br /> Error message (starting with ***) if the process failed due to other issue<br /> <br /> Deletes the specified section, and all its entries, from the specified ini file path & name.<br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821113"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetRegistryString()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Branch, Key_Name, Value_Name, Default)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The registry string value if it was found. If the registry value could not be found, the Default value is returned. </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal">Note: possible Branch values are:</p> <p class="MsoNormal" style='margin-left:.5in'>HKEY_CLASSES_ROOT</p> <p class="MsoNormal" style='margin-left:.5in'>HKEY_CURRENT_USER</p> <p class="MsoNormal" style='margin-left:.5in'> HKEY_LOCAL_MACHINE</p> <p class="MsoNormal" style='margin-left:.5in'> HKEY_CURRENT_CONFIG</p> <p class="MsoNormal" style='margin-left:.5in'>HKEY_USERS</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>GetRegistryString ("HKEY_CURRENT_USER",<br /> "Environment", "Temp", "Not Found")</span></b></p> <p class="MsoNormal" style='margin-left:.25in'>returns the following value on my PC:<br /> <b><span style= 'color:red'>%USERPROFILE%</span>\AppData\Local\Temp<br /> <br /> <br /></b></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821114">GMT/Local and Time-Related</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821115"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GMTtoLocalMinutes()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> None<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> The a String providing the number of minutes between Local and Universal (GMT) time, taking into consideration Daylight Saving Time periods and the PC time zone setup. If the function fails to find the value, it returns "Failed"</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>For example, on my PC (Eastern Standard Time) GMTtoLocalMinutes() returns "240" or "300" depending on Daylight Saving Time.</p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <h2><a name="_Toc147821116"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GMTtoLocal()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (GMTEpoch)<br /> <br /> <u>Returns:</u> Local time as Epoch (number of seconds since 1970/01/01).<br /> taking into consideration Daylight Saving Time periods and the PC time zone setup.</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Web log files and databases frequently store DateTime information as Greenwich Mean Time (GMT) or Coordinated Universal Time (UTC). In your Crystal reports, you may need to display this DateTime information as Local Time. </p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Since UFL's don't support DateTime arguments, this function requires that you pass the GMT DateTime argument as Epoch (number of seconds since 1970/01/01). Assuming you have a GMT DateTime field called <b>{GMTDateTime}</b> you can convert it to Epoch using this formula:<br /> <b><span style='font-size:14.0pt'>DateDiff("s", datetime(1970,01,01), {GMTDateTime})</span></b></p> <p class="MsoNormal" style='margin-left:.5in'><b><span style= 'font-size:14.0pt'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in'>The function returns the Local Time as Epoch as well. Assuming the Formula returning the Local Time as Epoch is called {@LocalTimeEpoch} you can convert the Local Time result back to DateTime format using the following formula:<br /> <b><span style='font-size:14.0pt'>DateAdd("s", {@LocalTimeEpoch} , datetime(1970,01,01))<br /></span></b><br /> You can combine the conversion steps into a single formula such as:<br /> <b><span style='font-size:14.0pt'>DateAdd("s",<br /> GMTtoLocal(DateDiff("s", datetime(1970,01,01), {GMTDateTime}) ) , datetime(1970,01,01))</span></b></p> <p class="MsoNormal" style='margin-left:.5in'><b><span style= 'font-size:14.0pt'> </span></b></p> <h3><a name="_Toc147821117">Evaluating Report Processing Elapsed Time</a></h3> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Since Crystal evaluates <b><i>CurrentDateTime</i></b> only once for each report, you can't evaluate the time it took a report to process using Crystal functions. <br /> <br /> If you pass a zero (or a negative number) to the <b>GMTToLocal()</b> function, it returns the current system date & time. This is <b>useful for timing report processing</b>.</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Place the following formula in the report header to <b>capture the start time</b>:<br /> <b>WhilePrintingRecords;</b></p> <p class="MsoNormal" style='margin-left:.5in'><b> DateTimeVar ldt_start;</b></p> <p class="MsoNormal" style='margin-left:.5in'><b> ldt_start := DateAdd("s", GMTtoLocal(0), datetime(1970,01,01));</b></p> <p class="MsoNormal" style='margin-left:.5in'><br /> And place the following formula in the report footer to <b>display the elapsed time</b>:<br /> <b>WhilePrintingRecords;</b></p> <p class="MsoNormal" style='margin-left:.5in'><b> DateTimeVar ldt_start;</b></p> <p class="MsoNormal" style='margin-left:.5in'><b> DateDiff("s", ldt_start, DateAdd("s", GMTtoLocal(0), datetime(1970,01,01)));</b></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <p class="MsoNormal" style='margin-left:.5in'> </p> <h2><a name="_Toc147821118"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GMTtoZone()</a></h2> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (GMTEpoch, ToZone)<br /> <br /> <u>Returns:</u> Specified zone's time as Epoch (number of seconds since 1970/01/01).<br /> <br /> This function is very similar to the <b><i>GMTtoLocal()</i></b> function described above except that instead of automatically detecting the local time zone on the user's PC, it converts the specified GMT/UTC time to time at the specified time zone.<br /> <br /> Possible values for the <b><i>ToZone</i></b> argument are:</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <div align="center"> <table class="MsoNormalTable" border="0" cellspacing="0" cellpadding="0" width="0" style= 'width:369.0pt;border-collapse:collapse'> <tr style='height:13.5pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; padding:.75pt .75pt 0in 2.15pt;height:13.5pt'> <p class="MsoNormal"><b><span style= 'font-size:10.0pt;font-family:"Tahoma",sans-serif'>Time Zone Name</span></b></p> </td> <td width="71" nowrap="nowrap" valign="bottom" style= 'width:53.0pt;border:solid windowtext 1.0pt; border-left:none;padding:.75pt .75pt 0in 2.15pt;height:13.5pt'> <p class="MsoNormal"><b><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif'>Offset</span></b></p> </td> <td width="19" nowrap="nowrap" valign="bottom" style= 'width:14.0pt;padding:.75pt .75pt 0in 2.15pt; height:13.5pt'> <p class="MsoNormal"><b><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif'> </span></b></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; padding:.75pt .75pt 0in 2.15pt;height:13.5pt'> <p class="MsoNormal"><b><span style= 'font-size:10.0pt;font-family:"Tahoma",sans-serif'>Time Zone Name</span></b></p> </td> <td width="80" nowrap="nowrap" valign="bottom" style= 'width:60.0pt;border:solid windowtext 1.0pt; border-left:none;padding:.75pt .75pt 0in 2.15pt;height:13.5pt'> <p class="MsoNormal"><b><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif'>Offset</span></b></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Tonga</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+13:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>E. Africa</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+03:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>New Zealand</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+12:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>GTB Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Fiji</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+12:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>E. Europe</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central Pacific Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+11:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Egypt</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>E. Australia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+10:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>South Africa</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>AUS Eastern Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+10:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="xl22" style='margin:0in;margin-bottom:.0001pt'> <span style='font-family:"Tahoma",sans-serif'>FLE Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>West Pacific Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+10:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Israel</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Tasmania</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+10:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>W. Europe</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Vladivostok</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+10:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central Europe</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Cen. Australia Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+09:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Romance Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>AUS Central Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+09:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central European Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Tokyo</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+09:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>W. Central Africa Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Korea</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+09:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>GMT Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Yakutsk</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+09:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Azores</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>China</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+08:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Cape Verde</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-01:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>North Asia</span> <span style='font-size:8.0pt;font-family:"Tahoma",sans-serif'>East Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+08:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Mid-Atlantic Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-02:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Singapore</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+08:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>E. South America</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-03:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>W. Australia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+08:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>SA Eastern Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-03:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Taipei</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+08:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Greenland</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-03:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>SE Asia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+07:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Newfoundland</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-03:30</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>North Asia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+07:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Atlantic Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-04:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Myanmar</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+06:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>SA Western Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-04:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>N. Central Asia Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+06:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Pacific SA Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-04:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central Asia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+06:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>SA Pacific Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-05:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Sri Lanka Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+06:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Eastern Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-05:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Nepal</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+05:45</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central America</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-06:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>India</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+05:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-06:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Ekaterinburg Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+05:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Mexico</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-06:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>West Asia</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+05:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Canada</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Central Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-06:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Afghanistan</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+04:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Mountain Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-07:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Arabian Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+04:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Pacific Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-08:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Caucasus</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+04:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Alaskan Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-09:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Iran</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+03:30</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><b><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Hawaiian Standard Time</span></b></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-10:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Arabic Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+03:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Samoa</span> <span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-11:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Arab Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+03:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Dateline Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT-12:00</span></p> </td> </tr> <tr style='height:11.25pt'> <td width="156" valign="top" style= 'width:117.0pt;border:solid windowtext 1.0pt; border-top:none;padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'>Russian Standard Time</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'border-top:none;border-left:none;border-bottom: solid windowtext 1.0pt;border-right:solid windowtext 1.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'>GMT+03:00</span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> <td width="167" valign="top" style= 'width:125.0pt;padding:.75pt .75pt 0in 2.15pt; height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Tahoma",sans-serif'> </span></p> </td> <td nowrap="nowrap" valign="bottom" style= 'padding:.75pt .75pt 0in 2.15pt;height:11.25pt'> <p class="MsoNormal"><span style= 'font-size:8.0pt;font-family:"Arial",sans-serif'> </span></p> </td> </tr> </table> </div> <p class="MsoNormal"><u><br /> Note:</u> <b><i>GMTtoZone()</i></b> properly handles Daylight Saving Time periods at the specified zone.</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <h2><a name="_Toc147821119"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SecondsToTimeString()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Seconds, Format)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> seconds converted to a time string formatted according to the format argument.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> For example,<br /> uflSecondsToTimeString(3800, "HH:mm") returns "01:03"<br /> uflSecondsToTimeString(3800, "HH:mm:ss") returns "01:03:20"<br /> <br /> Note: use HH rather than hh in the time string in order to avoid cases where 0 hours is formatted as 12 hours.<br /> <br /> <br /></p> <h2><a name="_Toc147821120"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TimeStringToSeconds()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (TimeString, formatted as hh:mm:ss)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> time string converted to seconds.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> For example,<br /> uflTimeStringToSeconds("01:03:20") returns 3,800.00<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821121"></a><a name= "_uflNumberToDate()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>NumberToDate()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (number reflecting date as 6 (yyMMdd) or 8 (yyyyMMdd) digits.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> the corresponding Date.<br /> If input is invalid, returns null date, which Crystal interprets as Dec 30, 1899.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> For example,<br /> uflNumberToDate (20210428) returns <b>4/28/2021</b>. This is <b>8-digit case</b>.<br /> uflNumberToDate (210428) returns <b>4/28/2021</b>. This is <b>6 digit case</b>.<br /> uflNumberToDate (2021<span style='background:fuchsia'>2804</span>) returns <b>12/30/1899.</b> This is <b>invalid input case</b>.<br /> <br /> <br /> <br /> <br /> <br /> <br /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821122">Message/Input Boxes</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821123"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>MessageBoxOK()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Message, Title)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers a message box with an OK button. <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> Ignore the return value</p> <p class="MsoNormal" style='margin-left:.25in'><br /> A typical scenario for using this functionality is to display a message in a runtime environment that doesn't support Crystal Report alerts. <br /> <br /> For example, the following Crystal formula:<br /> <span style='background:yellow'>IF Sum ({Purchase.Net})> 100000 THEN <b>MessageBoxOK</b>("Net Amount Is Greater than $100,000" & Chr(10) & Chr(13) & "Please Contact the Authorities!"", "Alert: Net Amount is Too Big")</span></p> <p class="MsoNormal" style='margin-left:.25in'>Triggers a message box if the grand total of the Net amount is more than 100,000.<br /> <br /></p> <h2><a name="_Toc147821124"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>MessageBoxYesNo()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Message, Title)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers a message box with a YES and NO buttons. <br /> <br /> <u>Returns:</u><br /> 1 if the user clicked YES and<br /> 0 if the user clicked "NO" </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>A typical scenario for using this functionality is to condition further processing in the report on a user response, but only in specific situations (a regular parameter would prompt the user under all conditions). <br /> <br /> For example, the following Crystal formula:<br /> <span style='background:yellow'>IF Sum ({Purchase.Net})> 100000 AND <b>MessageBoxYesNo</b>("Do you wish to email an alert to the appropriate manager?", "Alert: Net Amount is Too Big")=1 THEN</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>(</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>// the following code block would have detailed information causing an email to be triggered</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>EmailSet(…);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>EmailAdd(…);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>EmailSend;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>);</span><br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Triggers an email message if the grand total of the Net amount is more than 100,000 and the user responded positively to the message box.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2><a name="_Toc147821125"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>InputBox()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Prompt, Title, DefaultText)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function triggers an Input Box allowing the user to enter text. <br /> <br /> <u>Returns:</u><br /> Blank text if the user clicks Cancel<br /> The user-entered text (up to 254 characters) if the user clicks OK </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>A typical scenario for using this functionality is to add comments to areas in the report that show exceptional (good/bad) performance. This is something that standard report parameters cannot do because:<br /> a) parameters always get triggered while InputBox() can be conditionally triggered, and<br /> b) parameters return fixed values, while InputBox() can be triggered multiple times (for example, once for each record or group with an exceptional value). <br /> <br /> For example, the following Crystal formula:<br /> <span style='background:yellow'>IF {@L1_Returns}> 0.15 THEN</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>InputBox({Product_Type.Product Type Name} & " has high % Returns." & chr(13) & "Please explain.", "High % Returns for " & {Product_Type.Product Type Name},</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:yellow'>"% Returns for " & {Product_Type.Product Type Name} & " is high because ");</span><br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Triggers the following Input Box:<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><img border="0" width="363" height="152" id="Picture 2" src= "CUT_Light_NET_User_Manual_files/image025.png" alt= "Title: InputBox Sample dialog" name="Picture 2" /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2><a name="_Toc147821126"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>InputBox2Command()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Prompt, Title, DefaultText, ExePath, CommandLine1, CommandLine2, CommandLine3, DebugWindow)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function and the first 4 arguments behaves just like the InputBox function (described above). However, it is used to trigger another executable (just like the ExeRun function described above) and insert the user's input into the command line passed to the executable. </p> <p class="MsoNormal" style='margin-left:.25in'>The 3 command line arguments allow you to construct a command line that is longer than 254 characters (the function simply combines the 3 arguments into a single command line. The DebugWindow argument (True or False) allows you to request a display of the resulting command line (useful for debugging purposes).<br /> <br /> <u>Returns:</u></p> <p class="MsoNormal" style='margin-left:.25in'>Error message if the ExePath doesn't find an exe file in the specified location.<br /> "No Input - Processing Skipped" if the user clicks Cancel or input was blank.<br /> The user-entered text (up to 254 characters) if the user clicks OK </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>A possible scenario for using this functionality is to trigger printing of information on the report via a call to DataLink Viewer and another report, passing the product name as a parameter and the number of copies as an Input from the user. <br /> <br /> For example, the following Crystal formula (placed in a Group Footer for Product Type):</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>InputBox2Command("The Revenue for: " & {Product_Type.Product Type Name}</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>& " is: " & Sum ({@value}, {Product_Type.Product Type Name}) & Chr(10) &</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>"Volume was: " & Sum({Orders_Detail.Quantity}, {Product_Type.Product Type Name}) & Chr(10) & chr(10) & "Please Specify How Many Printouts:",<br /> "Print Report for " & {Product_Type.Product Type Name}, "1",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>"C:\Program Files\DataLink Viewer 9\DataLink_Viewer_9.exe",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>"-v ""C:\Program Files\DataLink Viewer 9\Product Type Catalog V9.rpt"" ""Parm1:" + {Product_Type.Product Type Name} + """",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:10.0pt; font-family:"Courier New"'>" ""Printer:Default"" ""Print_Copies:<b><span style= 'background:yellow'>{%Input}</span></b>""", "", False);</span></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Would prompt the user with the following dialog:</p> <p class="MsoNormal" align="center" style= 'margin-left:.25in;text-align:center'><br /> <img border="0" width="363" height="152" id="Picture 3" src= "CUT_Light_NET_User_Manual_files/image026.png" alt= "Title: InputBox2Command Sample dialog" name="Picture 3" /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>It would then replace the {%Input} token in the command line with the value provided by the user, so DataLink Viewer would print the information for that Product Type with the specified number of copies.</p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2> </h2> <h1><a name="_Toc147821127">Web / HTML / Google / Translate</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821128"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>HTMLfile2RTFfile()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (HTMLfile, RTFfile)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function converts an HTML file (the 1<sup>st</sup> argument) to an RTF file (the 2<sup>nd</sup> argument). <br /> <br /> <u>Returns:</u><br /> "OK" or "Failed"</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Since Crystal's support for RTF is more advanced than its support for HTML, a typical scenario for using this functionality is to display HTML files by converting them to RTF and using RTF rather than HTML interpretation for the formula. <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula takes the CUT_Light.htm file, converts it to CUT_Light.rtf, and then uses the <b>FileGetText()</b> function to bring in the resulting RTF text.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b>uflHTMLfile2RTFFile ("c:\temp\CUT_Light.htm", "c:\temp\CUT_Light.rtf");</b></p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b>StringVar sFile;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>NumberVar i;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>i := 1;</b></p> <p class="MsoNormal" style='margin-left:.25in'>// Keep appending segments of 254 characters to the sFile string until done</p> <p class="MsoNormal" style='margin-left:.25in'><b>while uflFileGetText( "c:\temp\CUT_Light.rtf", i) <>"" Do</b></p> <p class="MsoNormal" style='margin-left:.25in'> <b> (sFile := sFile + uflFileGetText( "c:\temp\CUT_Light.rtf", i);</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>i := i + 1);</b></p> <p class="MsoNormal" style='margin-left:.25in'>// Return the resulting string</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b>sFile;</b><br /> <br /></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>The left display is HTML with a numbered list shown as RTF in Crystal.<br /> The right display is the original HTML shown as HTML in Crystal. <br /> <img border="0" width="487" height="100" id="Picture 6" src= "CUT_Light_NET_User_Manual_files/image027.png" alt= "Title: HTMLfile2RTFfile sample - Description: Preview shows support for bullets." name="Picture 6" /><br /> Note that some aspects of the formatting are lost in the Crystal HTML interpretation:</p> <p class="MsoNormal" style='margin-left:.25in'><br /> For a description of RTF rendering limitations in Crystal Reports, see:</p> <p class="MsoNormal" style='margin-left:.25in'><span class= "MsoHyperlink"><span style='font-size:10.0pt'><a href= "https://www.sdn.sap.com/irj/servlet/prt/portal/prtroot/com.sap.km.cm.docs/oss_notes_boj/sdn_oss_boj_erq/sap%28bD1lbiZjPTAwMQ==%29/bc/bsp/spn/scn_bosap/notes" target="_blank">SAP Note 1214798 - What RTF tags are supported in Crystal Reports?</a><br /></span></span><br /> For a description of HTML rendering limitations in Crystal Reports, see:<br /> <span class="MsoHyperlink"><span style='font-size:10.0pt'><a href= "https://apps.support.sap.com/sap/support/knowledge/public/en/1217084" target="_blank">SAP Note 1217084 - What are the supported HTML tags and attributes with HTML Text Interpretation?</a></span></span></p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2><a name="_Toc147821129"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>HTMLstring2RTFFile()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (HTMLstring, RTFFile)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function converts an HTML string (the 1<sup>st</sup> argument) to an RTF file (the 2<sup>nd</sup> argument). <br /> <br /> <u>Returns:</u> "OK" or "Failed"</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Since Crystal's support for RTF is more advanced than its support for HTML, a typical scenario for using this functionality is to display HTML string (stored in a database column) by converting it to RTF and using RTF rather than HTML interpretation for the formula. <br /> Note: <span class="MsoHyperlink"><a href= "start.htm#_uflHTML2Image()">uflHTML2Image()</a></span> provides a more powerful solution.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula takes the html string in {Customer.Comments}, converts it to CUT_Light.rtf, and then uses the <b>FileGetText()</b> function to bring in the resulting RTF text.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b>uflHTMLstring2RTFFile ({Customer.Comments}, "c:\temp\CUT_Light.rtf");</b></p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b>StringVar sFile;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>NumberVar i;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>i := 1;</b></p> <p class="MsoNormal" style='margin-left:.25in'>// Keep appending segments of 254 characters to the sFile string until done</p> <p class="MsoNormal" style='margin-left:.25in'><b>while uflFileGetTextutf8( "c:\temp\CUT_Light.rtf", i) <>"" Do</b></p> <p class="MsoNormal" style='margin-left:.25in'> <b> (sFile := sFile + uflFileGetTextutf8( "c:\temp\CUT_Light.rtf", i);</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>i := i + 1);</b></p> <p class="MsoNormal" style='margin-left:.25in'>// Return the resulting string</p> <p class="MsoNormal" style='margin-left:.25in'><b>sFile;</b><br /> </p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>The left display is HTML with a numbered list shown as RTF in Crystal.<br /> The right display is the original HTML shown as HTML in Crystal. <br /> <img border="0" width="487" height="100" id="Picture 7" src= "CUT_Light_NET_User_Manual_files/image027.png" alt= "Title: HTMLstring2RTFFile - Description: Sample report preview" name="Picture 7" /><br /> Note that some aspects of the formatting are lost in the Crystal HTML interpretation:</p> <p class="MsoNormal" style='margin-left:.25in'><br /> For a description of RTF rendering limitations in Crystal Reports, see:</p> <p class="MsoNormal" style='margin-left:.25in'><span class= "MsoHyperlink"><a href= "http://support.businessobjects.com/library/kbase/articles/c2011504.asp"> http://support.businessobjects.com/library/kbase/articles/c2011504.asp</a></span></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>For a description of HTML rendering limitations in Crystal Reports, see:<br /> <span class="MsoHyperlink"><a href= "https://apps.support.sap.com/sap/support/knowledge/public/en/1217084"> https://apps.support.sap.com/sap/support/knowledge/public/en/1217084</a></span></p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h2><a name="_Toc147821130"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>HTMLString2Txtfile()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style= 'background:yellow'>HTMLString</span>(), <span style= 'background:lime'>Txtfile</span>, <span style= 'background:aqua'>Options</span>)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function converts an HTML string (the 1<sup>st</sup> argument) to a Text file (the 2<sup>nd</sup> argument). <br /> <br /> <u>Returns:</u><br /> "OK" or "Failed"</p> <p class="MsoNormal" style='margin-left:.25in'><br /> If the HTML string is less the 254 characters, you can simply use it as the <span style='background:yellow'>HTMLString</span> argument. Otherwise, pass is as an arrays with elements of up to 254-charcter each. You can see example of how content can be chopped into such an array in the <span class= "MsoHyperlink"><a href="start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> The <span style='background:lime'>TxtFile</span> argument should specify a path that is recognized by Microsoft Word as a trusted folder.<br /> <br /> Leave the <span style='background:aqua'>Options</span> argument blank (""). It is set a side for future use.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This allows you to convert a large HTML string to plain text.</p> <p class="MsoNormal" style='margin-left:.25in'>For example, the following Crystal formula takes a large HTML string, converts it to a text file, and then uses the <b>FileGetText()</b> function to bring in the resulting text file.</p> <p class="MsoNormal" style='margin-left:.25in'> --------------------------------------<br /> <b>NumberVar i;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>StringVar HTMLString;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>HTMLString</span> := {@HTML_String};</b></p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'color:#0070C0'>HTMLstring2TxtFile</span>(<span style= 'background:yellow'>HTMLString</span>, "<span style= 'background: lime'>c:\temp\HTMLasText.txt</span>", <span style= 'background:aqua'>""</span>);</b></p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'>// -- Get the Text File Content</p> <p class="MsoNormal" style='margin-left:.25in'><b>StringVar sFile;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>i := 1;</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>// Keep appending segments of 254 characters to the sFile string until done</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>while FileGetText( "c:\temp\HTMLasText.txt", i) <>"" Do</b></p> <p class="MsoNormal" style='margin-left:.25in'> <b> (sFile := sFile + FileGetText( "c:\temp\HTMLasText.txt", i);</b></p> <p class="MsoNormal" style='margin-left:.25in'> <b> i := i + 1);</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>// Return the resulting string</b></p> <p class="MsoNormal" style='margin-left:.25in'><b>sFile;</b><br /> --------------------------------------<br clear="all" style= 'page-break-before: always' /></p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821131"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpFileExists()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (File URL)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function checks if a specified file exists on the web. <br /> <br /> <u>Returns a String:</u><br /> "No Response from Web Site" if the web site didn't respond<br /> "TRUE" if the file exists<br /> "FALSE" if the file doesn't exist</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b><u>Note:</u> y</b>ou may specify the path to the file in various ways:</p> <p class="MsoNormal" style='margin-left:.5in'><br /> <b><u>Without http://</u></b><br /> httpFileExists("www.MilletSoftware.com/Download/MyFile.zip")</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'><b><u>With http:// or https://</u></b></p> <p class="MsoNormal" style='margin-left:.5in'> httpFileExists("https://www.MilletSoftware.com/Download/MyFile.zip")</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'><b><u>As FTP location<br /></u></b>httpFileExists("ftp://ftp.cac.psu.edu/pub/thesis-packages/win/PsuThesiFull.exe")<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821132"></a><a name= "_uflhttpExists()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpExists()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (File URL)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function checks if a specified url exists. <br /> <br /> <u>Returns a String:</u><br /> "TRUE" if the url exists and is accessible<br /> "FALSE" or http response Status Code otherwise<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><br /> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821133"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpFileDownload()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (File URL, LocalFilePathName)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function download a file on the web to a specified local file path and name. <br /> <br /> <u>Returns a String:</u><br /> Error message if the download process failed<br /> OK if the download succeeded</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b><u>Note:</u></b> you may specify the path to the web file in various ways, as described in httpFileExists above.<br /> <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821134"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpFileDownloadRename()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (File URL, LocalFilePathName, RenameToServerFileName)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function is useful when<br /> a) the remote file name is unknown (the url responds with a download of an unknown file)</p> <p class="MsoNormal" style='margin-left:.25in'>In that case, use a temp file name in the 2<sup>nd</sup> argument, and set the 3<sup>rd</sup> argument to TRUE<br /> - or -</p> <p class="MsoNormal" style='margin-left:.25in'>b) when you wish to download a known file name to a different file name<br /> In that case, set the 3<sup>rd</sup> argument to FALSE<br /> <br /> <u>Returns a String:</u><br /> Error message if the download process failed<br /> <b>Remote File Name</b> if the download succeeded</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b><u>Note:</u></b> you may specify the path to the web file in various ways, as described in httpFileExists above.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal"><br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821135"></a><a name= "_uflhttpFileParse()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpFileParse()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (URL, Targets(), Attribute, delimiter, Segment_N, Options, AuthInfo)<br /> <br /></p> <p class="MsoNormal">This function is useful when you need to extract text from a web page.<br /> The <b>URL</b> argument sets the full path to the web page.<br /> The <b>Targets()</b> argument can be a single string or an array of strings with either:<br /> <b>xPath</b> directives for targeting certain element(s) within the web page. OR<br /> <b>From/To</b> Token directives such as: <span style= 'font-size:9.5pt; font-family:Consolas;color:#A31515'>"<b><span style='background:yellow'>[{</span><span style='background:aqua'>From_Token</span><span style='background:yellow'>}]->[{</span></b><span style='background:aqua'>?To_Token</span><b><span style='background:yellow'>}]</span></b>"</span><br /> The <b>Attribute</b> path specifies the attribute within the target element that should be returned.<br /> Use <span style= 'font-family:Consolas'>"</span>InnerText<span style= 'font-family:Consolas'>"</span> or <span style= 'font-family:Consolas'>"</span>InnerHtml<span style= 'font-family:Consolas'>"</span> to get those aspects of the targeted node.<br /> The <b>delimiter</b> argument sets the separator between multiple parsing results.<br /> The <b>Segment_N</b> argument allows handling of results longer than 254 characters.<br /> The <b><i>Options</i></b> and <b><i>AuthInfo</i></b> arguments are not yet in use. Set to empty string (<span style= 'font-family:Consolas'>""</span>).<br /> <br /> <b><u>Returns:</u></b><br /> Error message (starting with ***) if the process failed.<br /> Otherwise, breaking the resulting string into segments of 254 characters each, the function returns the segment number specified by the <b>Segment_N</b> argument. In Crystal, you can load the entire result into a string variable using code like the sample provided for <span class="MsoHyperlink"><a href= "start.htm#_uflExecuteSQLReturnDelimitedSegment">uflExecuteSQLReturnDelimitedSegment()</a></span>.<br /> <br /> <b><u>Example 1:</u></b> extract from a product catalog web page the path to the product’s image.<br /> The information resides in the following div:<br /> <span style='font-family:"Courier New"'><<b>div</b> class="<span style= 'color:#C00000'>product-image</span>"><figure></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New"'> <img <b>src</b>=<span style= 'background:yellow'>"/images/large/SS-400.jpg"</span> alt="SS-100-1-2BT"></span></p> <p class="MsoNormal"><span style='font-family:"Courier New"'> </figure></div><br /> <br /></span>The following function call will return the text in yellow, using xPath directive, looking for div sections with a class of 'product-detail-image'. Within those, img nodes and their "src" attribute:<span style= 'font-family:"Courier New"'><br /></span><span style= 'font-family:Consolas;color:black'>httpFileParse(</span><span style='font-family:Consolas;color:#A31515'>"https://www.acme.com/catalog?part=SS-400-1"</span><span style='font-family:Consolas;color:black'>,<br /> </span><span style= 'font-family:Consolas;color:#A31515'>"//div[@class='product-image']//img"</span><span style='font-family:Consolas;color:black'>,</span> <span style= 'font-family: Consolas;color:#A31515'>"src"</span><span style= 'font-family:Consolas; color:black'>,</span> <span style= 'font-family:Consolas;color:#A31515'>"||"</span><span style= 'font-family:Consolas;color:black'>, 1,</span> <span style= 'font-family: Consolas;color:#A31515'>""</span><span style= 'font-family:Consolas'>, <span style= 'color:#A31515'>""</span><span style='color:black'>)<br /> <br /></span></span>Alternatively, you can use this From/To token directive:<br /> <span style= 'font-family:Consolas;color:black'>httpFileParse(</span><span style='font-family:Consolas;color:#A31515'>"https://www.acme.com/catalog?part=SS-400-1"</span><span style='font-family:Consolas;color:black'>,<br /> </span><span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"<b><span style='background:yellow'>[{</span></b><span style='background:aqua'>data-src=""</span><b><span style='background:yellow'>}]->[{</span></b><span style='background:aqua'>?impolicy=superZoom</span><b><span style='background:yellow'>}]</span></b>"</span><span style='font-family: Consolas;color:black'>,</span> <span style= 'font-family:Consolas;color:#A31515'>"src"</span><span style= 'font-family:Consolas;color:black'>,</span> <span style= 'font-family: Consolas;color:#A31515'>"||"</span><span style= 'font-family:Consolas; color:black'>, 1,</span> <span style= 'font-family:Consolas;color:#A31515'>""</span><span style= 'font-family:Consolas'>, <span style= 'color:#A31515'>""</span><span style= 'color:black'>)<br /></span></span><span style='color:black'>Note that a single literal</span> <span style= 'font-size:9.5pt;color:#A31515;background:aqua'>"</span> <span style='color:black'>in the tokens must be escaped, becoming</span><span style= 'font-size:9.5pt;color:#A31515'><span style= 'background:aqua'>""</span></span><span style= 'color: black'><br /></span><span style= 'font-family:Consolas;color:black'><br /></span>Example 2: get hyperlink text for all anchor tags within li items within div marked as a class of 'row submenu':<br /> <span style= 'font-size:11.0pt;font-family:Consolas;color:black'>httpFileParse(</span><span style='font-size:11.0pt;font-family:Consolas;color:#A31515'>"https://www.acme.com/catalog?part=SS-400-1"</span><span style='font-size:11.0pt;font-family:Consolas;color:black'>,</span> <span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515'>"//div[@class='row submenu']//li//a"</span><span style= 'font-size:11.0pt;font-family:Consolas; color:black'>,</span> <span style= 'font-size:11.0pt;font-family:Consolas; color:#A31515'>"InnerText"</span><span style='font-size:11.0pt; font-family:Consolas;color:black'>,</span><span style='font-size:11.0pt; font-family:Consolas;color:#A31515'>"||"</span><span style='font-size:11.0pt;font-family:Consolas;color:black'>, 1,</span> <span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515'>""</span><span style='font-size:11.0pt;font-family:Consolas;color:black'>,</span> <span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515'>""</span><span style='font-size:11.0pt;font-family:Consolas;color:black'>)</span><span style='font-family:Consolas;color:black'><br /> <br /></span>Web resources provide many tutorials & solutions for xPath logic.<br /> Note: You can use <span class="MsoHyperlink"><a href= "start.htm#_uflhttpExists()">httpFileExists()</a></span> to check for existence of the web page or image files.<span style= 'font-family: Consolas;color:black'><br /> <br /> <br /></span></p> <h2><a name="_Toc147821136"></a><a name= "_uflhttpToImage()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpToImage()</h2> <p class="MsoNormal" style='margin-left:.25in'>Use this function to download a web page as an image file. You can then bring the image into the report via dynamic reference to image path.</p> <p class="MsoNormal" style='margin-left:.25in'><u><span style= 'text-decoration: none'> </span></u></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (<span style='background:#FBD4B4'>URL</span>, <span style= 'background:lime'>LocalFilePathName</span>, <span style= 'background:#B8CCE4'>ImageType</span>, <span style= 'background: #CCC0D9'>ImageWidth</span>, <span style= 'background:yellow'>Wait4Load</span>)<br /> <br /> <span style='background:#FBD4B4'>URL</span><b>:</b> can be specified in 3 ways (<span style='background:#FBD4B4'>web url</span>, <span style='background:#FBD4B4'>file:///</span>, or <span style='background:#FBD4B4'>simple file path</span>).<br /> <b><span style='background:lime'>LocalFilePathName</span>:</b> the path and name for the generated image file.</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:#B8CCE4'>ImageType</span> can be "BPM", "JPG", or "PNG"</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:#CCC0D9'>ImageWidth</span> width of the browser page (in pixels) used to render. Set to zero (0) to ignore.<br /> <span style='background:yellow'>Wait4Load</span> in <b>milliseconds</b>, allowing the web page to fully load before being captured as image. Set to zero (0) to ignore. For one use case, a value of 1500 worked well.<br /> <br /> <u>Returns a String:</u><br /> "Invalid URL" if the url doesn't exist or gets redirected<br /> Error message if the process failed<br /> <b>"OK"</b> Otherwise</p> <p class="MsoNormal"><br /> Note: you can use <span class="MsoHyperlink"><a href= "start.htm#_uflImageCrop()_2">uflImageCrop()</a></span> to crop or remove white space.</p> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h3><a name="_Toc147821137">Web URL Example</a></h3> <p class="MsoNormal" style='margin-left:.5in'><br /> <br /></p> <p class="MsoNormal" style='margin-left:.5in'> <b>uflhttpToImage</b>(<span style= 'background:#FBD4B4'>'https://www.milletsoftware.com/CUT_Light.htm'</span>,</p> <p class="MsoNormal" style='margin-left:.5in'><span style= 'background:lime'>'C:\temp\dash.png'</span>, '<span style= 'background:#B8CCE4'>PNG</span>', <span style= 'background:#CCC0D9'>955</span>, <span style= 'background:yellow'>1500</span>);<br /> <br /> This generates the following image:<br /> <img border="0" width="568" height="279" id="Picture 8" src= "CUT_Light_NET_User_Manual_files/image028.jpg" alt="image" name= "Picture 8" /></p> <p class="MsoNormal" style='margin-left:.5in'><br /> <br /></p> <h3><a name="_Toc147821138">File URL Example</a><span style= 'background:#FBD4B4'><br /> <br /></span></h3> <p class="MsoNormal" style='margin-left:.5in'> <b>uflhttpToImage</b>('<span style= 'background:#FBD4B4'>file:///C:/TEMP/ Pivot.htm</span>', <span style='background:lime'>'C:\temp\ Pivot.JPG'</span>, '<span style='background: #B8CCE4'>JPG</span>', <span style= 'background:#CCC0D9'>1045</span>, <span style= 'background:yellow'>0</span>);</p> <p class="MsoNormal" style='margin-left:.5in'><img border="0" width="534" height="185" id="Picture 36" src= "CUT_Light_NET_User_Manual_files/image029.png" alt= "https://content.screencast.com/users/IdoMillet/folders/Jing/media/bcce3bbc-3ab1-4496-a5e7-553a7d9511bd/2017-05-21_0915.png" name="Picture 36" /><br /> <br /></p> <h3><a name="_Toc147821139">Simple File Path Example</a></h3> <p class="MsoNormal" style='margin-left:.5in'><b><span style= 'background:aqua'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in'>Same as above; CUT Light takes care of converting to file:///):<br /> <b>uflhttpToImage</b>('<span style= 'background:#FBD4B4'>C:\TEMP\Pivot.htm</span>', <span style= 'background:lime'>'C:\temp\ Pivot.JPG'</span>, '<span style= 'background:#B8CCE4'>JPG</span>', <span style= 'background:#CCC0D9'>1045</span>, <span style= 'background:yellow'>0</span>);<br /> <br /></p> <h3><a name="_Toc147821140"></a><a name= "_Fixing_'Old_Browser'"></a>Fixing 'Old Browser' error</h3> <p class="MsoNormal"> </p> <p class="MsoNormal">For some websites, the image might show an error text indicating that '<span style='background:#FDE9D9'>You appear to be using a very old browser that doesn't allow our site to work properly</span>'. The solution is to set a value in the registry to indicate the application should default to a later version of Browser Compatibility.<br /> <b>Warning:</b> changing registry values should be done by an Administrator!<br /> <br /> For a <b>32-bit application</b>, such as <b>Crystal 2016</b>, open:<br /> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:#222222; background:white'> Computer\HKEY_LOCAL_MACHINE\SOFTWARE\<b>WOW6432Node</b>\Microsoft\Internet Explorer\<br /> Main\FeatureControl\FEATURE_BROWSER_EMULATION<br /></span>For a <b>64-bit application</b> such as <b>Crystal 2020</b>, open:<br /> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif;color:#222222; background:white'> Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\<br /> Main\FeatureControl\FEATURE_BROWSER_EMULATION<br /> <br /> Set a Dword value for the application name, like this:<br /> <img border="0" width="551" height="207" id="Picture 35" src= "CUT_Light_NET_User_Manual_files/image030.png" alt="image" name= "Picture 35" /><br /> <br /> <br /></span><a name="_uflHTML2Image()"></a><b><span style= 'color:#0070C0'>ufl</span></b>HTML2Image()</p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (HTML(), LocalFilePathName, ImageType, ImageWidth)<br /> <u><br /> Returns a String:</u><br /> Error message if the process failed<br /> <b>OK</b> Otherwise<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function overcomes limitations with how Crystal interprets HTML. Instead, it converts the HTML to an image so you can then load the image into a picture object using a dynamic Graphic Location expression:<br /> <br /> <img border="0" width="638" height="453" id="Picture 30" src= "CUT_Light_NET_User_Manual_files/image031.png" alt="image" name= "Picture 30" /> </p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b>LocalFilePathName</b> specified the file path and name of the image file. Typically, the same path and file name is then used to set the dynamic Graphic Location path to load the image into the Crystal report.</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><b><br /> ImageType</b> can be "BPM", "JPG", or "PNG"<br /> <b><br /> ImageWidth</b> allows you to control the width (in pixels) of the browser page used to render the HTML content before it gets converted to an image. HTML elements specified as percent of web page width would adapt to that width. Set to zero (0) to ignore.<br /> <br /> <b>HTML()</b> argument divides the HTML string into an array with 254-charcter segments.<br /> In the example below, the HTML_Table string gets chopped into such an array using the code in <span style='color:#C00000'>red</span>. <br /> <br /></p> </div> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#00B050'>// Note: Content of HTML Table is established by other formulas</span></p> <p class="MsoNormal" style='margin-left:.25in'>Stringvar HTML_Table <b>;</b></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#00B050'>// Convert the HTML to an array with 254-character text segments</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>local stringvar array MyStringArray;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>IF Len(HTML_Table) = 0 Then</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>(redim MyStringArray [1];</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> MyStringArray[1] = "";)</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>Else</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>( Local numbervar segments := RoundUp(Len(HTML_Table)/254);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> redim MyStringArray [segments];</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> Local numbervar index ;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> for index := 0 to segments - 1 step 1 do</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'> (MyStringArray[index + 1] := mid(HTML_Table, 1 + (index * 254) , 254)) <b>;</b></span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'color:#C00000'>);</span></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <b>uFLHTML2Image</b>(MyStringArray, "c:\temp\" & {@ProductType} & ".bmp", "BMP", 400) <b>;</b></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'>"c:\temp\" & {@ProductType} & ".bmp" <b>;</b> <span style= 'color:#00B050'>// Graphic Location set to the resulting image file</span></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821141"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>httpCallServiceGetTokens()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (URL, Tokens)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Calls a web service, such as SMS, passing argument values in the url. The Tokens argument (containing the names of the tokens separated by '<span style='background:yellow'>||</span>' allows the function to return the values of those tokens found in the XML returned from the web service.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns</u> a '<span style='background:yellow'>||</span>' delimited string with the values of the named tokens<br /> or Error message if failed<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;text-autospace:none'> Example, for triggering a message via an SMS service: <span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:blue'>uFLhttpCallServiceGetTokens</span><span style='font-size:10.0pt;font-family:"Arial",sans-serif;color:black'>("https://sveve.no/SMS/SendMessage?user=user1&passwd=shh&from=TK-Helpdesk&reply=false&to=94271234&msg=Test%20of%20uflhttpCallServiceGetTokens()",</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif;color:maroon'>"msg_ok_count<span style='background:yellow'>||</span>id" <br /> </span> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif'>This call (if dummy password and phone number are replaced with real values) returns: <span style='color:maroon'>1<span style= 'background:yellow'>||</span>5554836</span><br /> where <span style='color:maroon'>1</span> is the count of successful messages, and <span style='color:maroon'>5554836</span> is the id.<br /> <br /></span></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821142"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GoogleSentiment()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (<span style='background:yellow'>sourceText()</span>, <span style= 'background:aqua'>contentType</span>, <span style= 'background:lime'>Options</span>)<br /> <u>Returns a String:</u> with 2 numbers (<b><i>score</i></b> and <b><i>magnitude</i></b>) separated by '||' (e.g. <span style= 'background:yellow'>-0.6||1.2</span>)<br /> Error message (starting with ***) if the process failed. Or just "||" is API key is restricted to certain IP addresses and the machine is not one of them.<br /> <br /> See <span class="MsoHyperlink"><a href= "https://www.screencast.com/t/mErti9l6V4n" target="_blank">sample image</a></span> showing a report with results for several text scenarios.</p> <p class="MsoListParagraph" style='text-indent:-.25in'> 1.<span style= 'font:7.0pt "Times New Roman"'> </span> <b><i>Score</i></b> reflects overall sentiment ranging from -1 (super negative) to +1 (super positive).</p> <p class="MsoListParagraph" style='text-indent:-.25in'> 2.<span style= 'font:7.0pt "Times New Roman"'> </span> <b><i>Magnitude</i></b> reflects total emotional content.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>A neutral <b>score</b> (around 0.0) indicates a low-emotion document, or may indicate mixed emotions, with both high positive and negative values which cancel each out. Use <b>magnitude</b> values to tell the difference between these cases. <b>A truly neutral documents will have a low magnitude value, while mixed documents will have higher magnitude values</b>. For more detail about interpreting these numbers, see this <span class="MsoHyperlink"><a href= "https://cloud.google.com/natural-language/docs/basics#interpreting_sentiment_analysis_values" target="_blank">Google documentation</a></span>. <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b>The Google service is free for the first 5,000 requests per month.</b> If a request contains more than 1,000 characters, each 1,000 character segment counts as a request.<br /> The cost for going beyond the free quota is very low and described here:</p> <p class="MsoNormal" style='margin-left:.25in'><span class= "MsoHyperlink"><a href= "https://cloud.google.com/natural-language/pricing">https://cloud.google.com/natural-language/pricing</a></span></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>The <b>language of the source text is auto-detected</b>. A list of supported languages is provided here: <span class="MsoHyperlink"><a href= "https://cloud.google.com/natural-language/docs/languages">https://cloud.google.com/natural-language/docs/languages</a></span></p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>To enable the service, you need to follow <span class="MsoHyperlink"><a href= "https://cloud.google.com/docs/authentication/api-keys" target= "_blank">Google's Instructions</a></span> to create a cloud project, enable billing, and get your API Key. You then need to set an entry in <b>CUT_Light_Options.ini.</b> For the 32-bit version of CUT Light, create that file here:<br /> C:\Program Files (x86)\Millet Software\CUT_Light_NET_32\CUT_Light_Options.ini<br /> The entry should look like this (use your own API key of course):<br /> -----------<br /> [Options]<br /> <b>GoogleAPI_NaturalLanguage</b>=AIzaSyC4C22Af4XQ…<br /> -----------<br /> <br /> <b><span style='background:yellow'>sourceText()</span></b> divides the text you wish to translate into an array with 254-charcter segments. You can see example of how content can be chopped into such an array in the section discussing the <span class= "MsoHyperlink"><a href= "start.htm#_uflHTML2Image()">HTML2Image()</a></span> function.<br /> As shown in the sample image, i<b>f the content is less the 254 characters, you can simply use it as-is without converting it to an array</b>.<br /> <br /> <span style='background:aqua'>contentType</span> supports only two options: "HTML" or "Plain_Text"<br /> <br /> <span style='background:lime'>Options</span>: should be left blank (<span style='font-family:"Courier New"'>""</span>). It is not yet used. </p> <p class="MsoNormal" style='margin-left:.25in'><br /> <b><span style='color:#0070C0'><br clear="all" style= 'page-break-before:always' /></span></b></p> <h2><a name="_Toc147821143"></a><a name= "_uflGoogleTranslate()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GoogleTranslate()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (sourceText(), sourceLanguage, targetLanguage, Segment_N)<br /> <u>Returns a String:</u><br /> Error message (starting with ***) if the process failed<br /> The Nth segment of the translated text otherwise<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>You can translate any amount of text using the paid ($20 for 1 million characters) Google Translate service. This service supports <span class= "MsoHyperlink"><a href= "https://cloud.google.com/translate/docs/languages">more than 100 languages</a></span>.<br /> To enable the service, you need to follow <span class= "MsoHyperlink"><a href= "https://cloud.google.com/translate/v2/quickstart">Google's Instructions</a></span> to create a cloud project, enable billing, and get your API Key. You then need to set an entry in <b>CUT_Light_Options.ini.</b> For the 32-bit version of CUT Light, create that file here:<br /> C:\Program Files (x86)\Millet Software\CUT_Light_NET_32\CUT_Light_Options.ini<br /> The entry should look like this (use your own API key of course):<br /> -----------<br /> [Options]<br /> <b>GoogleAPI_TranslateKey</b>=AIzaSyC4C22Af4XQ…<br /> <b>No_Change</b>=Millet Software||Cool||DataLink Viewer||Visual CUT<br /> -----------<br /> The <b>No_Change</b> entry indicates what text elements should be exempt from translation.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>sourceText()</span></b> divides the text into an array with 254-charcter segments. See how content is chopped into such an array in the section discussing the <span class= "MsoHyperlink"><a href= "start.htm#_uflHTML2Image()">HTML2Image()</a></span> function.<br /> As shown in the example below, i<b>f the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> See <span class="MsoHyperlink"><a href= "http://screencast.com/t/vNoeQAGwt">example</a></span> showing English text (in black) translated to Spanish (in blue), using the following formula:<br /> <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif'>---------------------</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>Local StringVar sResult;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>Local StringVar sSegment;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>Local NumberVar i;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>i := 1;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>// Keep appending segments of 254 characters to the sResult string until reaching the end</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>sSegment := uFLGoogleTraslate({Instructions.Description}, "English", "Spanish", i );</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>while sSegment <>"" AND Left(sSegment,3) <> "***" DO</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>(</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>sResult := sResult + sSegment;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>i := i + 1;</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>sSegment := uFLGoogleTraslate({Instructions.Description}, "English", "Spanish", i );</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>);</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>// Return the resulting string</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'>sResult;<br /> ---------------------<br /></span><br /> Note: the translation result is <span style= 'background:aqua'>HTML-encoded</span> (e.g. <span style= 'font-family:"Arial",sans-serif;color:blue;background:white'>‘&’</span> -> <span style= 'font-family:"Arial",sans-serif;color:blue;background: white'>&amp;</span>) so turn on HTML interpretation for the formula field: right-click, Format Field, Paragraph tab,<br /> <span style='background:aqua'>set the Text Interpretation option to <b>HTML Text</b></span>.<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821144"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>Number2Arabic()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments: (</u><b><span style= 'font-size:11.0pt;font-family:Consolas;color:black;background:white'>InputNumber</span></b> <span style='font-size:11.0pt;font-family:Consolas;color:black'>as Double</span>, <b>CurrencyCode</b> as String)<br /> <u>Returns a String:</u><br /> Error message (starting with ***) if the process failed<br /> The number converted to Arabic words for specified currency otherwise. See <span class="MsoHyperlink"><a href= "https://www.screencast.com/t/RpMBO8WUBz" target="_blank">image sample</a></span>.<br /> <br /> Allowed Currency Codes are: "<span style= 'font-size:11.0pt;font-family: Consolas;color:#A31515;background:white'>Syria", "UAE</span><span style= 'font-size:11.0pt;font-family:Consolas;color:#A6A6A6;background:white'>", "</span><span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515; background:white'>SaudiArabia</span><span style='font-size:11.0pt;font-family: Consolas;color:#A6A6A6;background:white'>", "</span><span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515;background:white'>Tunisia</span><span style='font-size:11.0pt;font-family:Consolas;color:#A6A6A6;background:white'>", "</span><span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515; background:white'>Qatar</span><span style='font-size:11.0pt;font-family:Consolas; color:#A6A6A6;background:white'>", "</span><span style= 'font-size: 11.0pt;font-family:Consolas;color:#A31515;background:white'>Kuwait</span><span style='font-size:11.0pt;font-family:Consolas;color:#A6A6A6;background:white'>", "</span><span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515; background:white'>Egypt</span><span style='font-size:11.0pt;font-family:Consolas; color:#A31515'>,</span> <span style= 'font-size:11.0pt;font-family:Consolas; color:black'>or</span> <span style= 'font-size:11.0pt;font-family:Consolas; color:#A31515'>"Gold"<br /> <br /></span>To express the fraction value as N/100, follow the currency name with <b><span style= 'background:yellow'>||V2</span></b> like this: "SaudiArabia<b><span style= 'background:yellow'>||V2</span></b>" See <span class= "MsoHyperlink"><a href= "https://www.screencast.com/t/vlzdavyyi3dU">sample image</a></span>.<span style= 'font-size:11.0pt;font-family:Consolas;color:#A31515'><br /> <br /></span><span style='font-size:11.0pt;color:black'>For example, this formula:<br /></span><b><span style= 'font-size:11.0pt;color:blue'>uFLNumber2Arabic</span></b><span style='font-size:11.0pt;color:black'>(186.87, "</span><span style= 'font-size:11.0pt;color:#C00000'>SaudiArabia</span><span style= 'font-size:11.0pt;color:black'>")</span></p> <p class="MsoNormal" style='margin-left:.25in'>Returns this: </p> <p class="MsoNormal" align="center" dir="rtl" style= 'text-align:center;direction: rtl;unicode-bidi:embed'><span lang= "AR-SA" style= 'font-size:14.0pt;font-family: "Tahoma",sans-serif;color:black' xml:lang="AR-SA">فقط مائة وستة وثمانون ريالاً سعودياً و سبع وثمانون هللة لا غير</span><span dir="ltr" style= 'font-size:14.0pt;font-family:"Tahoma",sans-serif;color:black'>.</span><span dir="ltr" style= 'font-size:11.0pt;font-family:"Tahoma",sans-serif; color:black'><br /> <br /></span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; color:black'>And this formula:<br /></span><b><span style= 'font-size:11.0pt;color:blue'>uFLNumber2Arabic</span></b><span style='font-size:11.0pt;color:black'>(186.87, "</span><span style= 'font-size:11.0pt;color:#C00000'>SaudiArabia<b><span style= 'background: yellow'>||V2</span></b></span><span style= 'font-size:11.0pt;color:black'>")</span></p> <p class="MsoNormal" style='margin-left:.25in'>Returns this:</p> <p class="MsoNormal" align="center" style= 'margin-left:.25in;text-align:center'><img border="0" width="423" height="32" id="Picture 17" src= "CUT_Light_NET_User_Manual_files/image032.png" alt="image" name= "Picture 17" /><br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; color:black'>Notes:</span></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-size:11.0pt;font-family:Symbol;color:black'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style='font-size:11.0pt;color:black'>Since the first argument must be of Double data type, currency data types must be converted to double like this:</span> <b><span style= 'font-size:11.0pt;color:blue'>uFLNumber2Arabic</span></b><span style='font-size:11.0pt;color:black'>(</span><b><span style='font-size:11.0pt; color:blue'>cDbl</span></b><span style='font-size:11.0pt;color:black'>({Orders.Order Amount}), "</span><span style= 'font-size:11.0pt;color:#C00000'>SaudiArabia</span><span style= 'font-size:11.0pt;color:black'>")</span></p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'><span style= 'font-size:11.0pt;font-family:Symbol;color:black'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style='font-size:11.0pt;color:black'>This functionality is done all locally – no need for internet connectivity.</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; color:black'><br /> <br /> <br /> <br /> <br /> <br /></span></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821145"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>IpDot2Long()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (String)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Converts IP address such as "192.168.1.2" to its numeric value (3232235778)<br /> <br /> <br /></p> <h2><a name="_Toc147821146"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>IpLong2Dot()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Number)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Converts IP address number such as 3232235778 to its dot notation ("192.168.1.2")<br /> <br /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"><img border="0" width="624" height="169" id= "Picture 16" src="CUT_Light_NET_User_Manual_files/image033.png" alt="Title: IpLong2Dot Sample - Description: Sample of Converting IP address number such as 3232235778 to its dot notation." name="Picture 16" /><br /> <br /> <br /> <br /></p> <h2><a name="_Toc147821147"></a><a name= "_uflPing()"></a><span style='color:#0070C0'>ufl</span>Ping()</h2> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments:</u> (<b><i>HostNameOrAddress</i></b> as String, <b><i>Options</i></b> as String)<br /> Note: Leave Options as blank ("")<br /> <br /> <u>Returns:</u> If the host is accessible, returns <b><i>TRUE</i></b>. Otherwise, returns <b><i>FALSE</i></b>.</p> <p class="MsoNormal" style='text-indent:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Examples:<br /> <b><span style='font-size:11.0pt;color:blue'>uFLPing</span></b> ("google.com", "") returns TRUE<br /> <b><span style='font-size:11.0pt;color:blue'>uFLPing</span></b> ("googllllle.com", "") returns FALSE<br /> <b><span style='font-size:11.0pt;color:blue'>uFLPing</span></b> ("<span style='color:#A31515'>74.125.67.100</span>", "") returns TRUE</p> <p class="MsoNormal"> </p> <p class="MsoNormal"><br /> <br clear="all" style='page-break-before:always' /></p> <h1><a name="_Toc147821148">SQL</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821149"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExecuteSQLCanConnect()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (ODBC DSN or OLEDB Connection String, User ID, Password)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function tests whether a connection can be made to a database: an <b>ODBC DSN</b> (even one that is not used by the Crystal report) or any <b>OLEDB Connection String</b>.<br /> <br /> You may use such a test before calling other ExecuteSQL statements.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u><br /> "TRUE" or an error message if connection to the database failed.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Note: you may refer to a saved encrypted password by its name if you also own Visual CUT and you copy the entry from the DataLink_Viewer.ini file to the CUT_Light.ini file like this:</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>[Options]<br /></span><b><span style= 'font-size:10.0pt'>Encrypted_Password_DB</span></b><span style= 'font-size:10.0pt'>=64D26BF23E2C830AE2BE0A8EAC689353159D5618ED8D5D45</span><br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h2><a name="_Toc147821150"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExecuteSQLNoReturn()</a></h2> <p class="MsoNormal" style='margin-left:.25in'> <u><br /></u><span style='color:red'>Note: uflSQLNoReturn() provides a newer function with similar functionality.<br /> <br /></span></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (ODBC DSN or OLEDB Connection String,<br /> User ID, Password, sql1(), sql2(), sql3(), sql4(), sql5())<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function executes a SQL statement against any <b>ODBC DSN</b> (even one that is not used by the Crystal report) or any <b>OLEDB Connection String</b>. If the SQL statement is longer than 254 characters, break it into segments across up to 5 sql "segments". <br /> The idea is to Update, Delete, or Insert records as a byproduct of viewing a Crystal report.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> "OK" or an error message if failed.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> If the sql statement is not properly constructed (e.g., missing single or double quotes) you may get a "Memory Full" message from Crystal. In such a case, examine and adjust the sql statement.</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>sql1() –to- sql5()</span></b> arguments can further divide very long sql statements into arrays with up to 254-charcter elements. You can see example of how content can be chopped into such an array in the <span class= "MsoHyperlink"><a href="start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>If you email me a request for a sample report, I will email you an rpt file that demonstrates this functionality. Below are two formulas from that report as examples you can follow:<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>The formula increments the "Last Year's Sales" column in the Customer table by $1:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLNoReturn ("Xtreme Sample Database","","","Update ""Customer"" SET ""Last Year's Sales"" = ""Last Year's Sales"" + 1 WHERE TRUE" ,"" ,"" ,"" ,"" )</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>This formula sets Customer 7 Address2 column to its Last Year's Sales:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLNoReturn ("Xtreme Sample Database","","","Update ""Customer"" SET ""Address2"" = ""Last Year's Sales"" WHERE ""Customer ID"" = 7" ,"" ,"" ,"" ,"" )</span></b></p> </div> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>This formula demonstrates using information from the current section in the report:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>whileprintingrecords;</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLNoReturn ("Vision Offline","SYSDBA","sesame","Update ENTRY SET PRINTED =1 WHERE ENTRY_ID <span style='background:yellow'>=" + cstr({ENTRY.ENTRY_ID},0,'')</span> ,"" ,"" ,"" ,"" )</span></b></p> </div> <p class="MsoNormal"> </p> <b><u><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></u></b> <p class="MsoNormal"><a name="_Toc335979601"></a><a name= "_Ref139934237"><b><u><span style= 'text-decoration:none'> </span></u></b></a></p> <p class="MsoNormal"><b><u>Embedding File(s) Content in the SQL</u></b><b><u>Statement</u></b></p> <p class="MsoNormal">If you need to trigger a large SQL script, you can embed within any of the sql segments references to files using the following token structure: <b><span style= 'font-family:"Courier New";background:yellow'>[[Insert_File:</span></b><b><span style='font-family:"Courier New";background:lime'>File_Path_and_Name</span></b><b><span style='font-family:"Courier New";background:yellow'>]]</span></b><b><span style='font-family:"Courier New"'><br /> </span></b>For example, <b><span style= 'font-family:"Courier New"'><span style= 'background:yellow'>[[Insert_File:</span><span style= 'background:lime'>c:\temp\Script1.txt</span><span style= 'background:yellow'>]]</span></span></b><br /> <br /></p> <p class="MsoNormal" style='margin-bottom:6.0pt'>Such tokens are replaced with the content of the specified files (if such files exists). You can use <b>as many file tokens as you wish</b>. If an inserted file has embedded file tokens, they would be replaced as well (the process is <b>recursive</b>).</p> <b><span style= 'font-size:14.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <h3><a name="_Toc147821151">Avoiding Duplicate Processing (old approach)</a></h3> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>Since Crystal may evaluate the same formula multiple times, as it renders the page content (particularly when Keep Together properties cause shifting of page content from one page to another), the SQL statements may fire more than once. This can be a problem in cases where an Update statement is incrementing a value. <br /> <br /> To guard against duplicate processing, you can leverage CUT Light's ability to read and write ini file values. Here is an example:<br /> <br /></p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>If GetIniValue("c:\cutlight.ini","PickTicket.rpt",<br /> {TKT_HDR.TKT_NO})="Failed INI Lookup"</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>Or</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>DateDiff ("s",<br /> CDateTime(GetIniValue("c:\cutlight.ini","PickTicket.rpt",<br /> {TKT_HDR.TKT_NO})), CurrentDateTime)>10</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>then</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>(</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>ExecuteSQLNoReturn ("ODBC1","","","Update DB1.dbo.TKT_HDR SET DB1.dbo.TKT_HDR.TIMES_PRTD = DB1.dbo.PS_TKT_HDR.TIMES_PRTD + 1 WHERE DB1.dbo.TKT_HDR.TKT_NO = '"+{TKT_HDR.TKT_NO}+"'" ,"" ,"" ,"" ,"" );<br /> <br /></span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>SetIniValue("c:\cutlight.ini","PickTicket.rpt",{TKT_HDR.TKT_NO},<br /> ToText(CurrentDateTime))</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-size: 11.0pt;font-family:"Courier New"'>)</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> This formula starts by checking that a value for that particular record (ticket number) hasn't yet been written to the ini file or, if it has, it hasn't happened within the last 10 seconds. If that condition is satisfied, the formula then proceeds to execute the Update statenment and record the execution time for that particular ticket in the ini file. </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b>Note: you may</b> refer to a saved encrypted password by its name<b>. See information about this in the</b> ExecuteSQLCanConnect()<b>section.<br clear= "all" style='page-break-before:always' /></b></p> <h2><a name="_Toc147821152"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SQLNoReturn()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style= 'background:aqua'>ConnectionType</span>, <span style= 'background:yellow'>ConnectionString</span>, <span style= 'background: lime'>sql</span>)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function is a newer version similar to the older <span style= 'color:#0070C0'>ufl</span>ExecuteSQLNoReturn.<br /> Differences include:</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>1.<span style= 'font:7.0pt "Times New Roman"'> </span> The code uses pure .NET implementation, removing the dependency on ADODB</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>2.<span style= 'font:7.0pt "Times New Roman"'> </span> SQL statement is passed in as a single string. No need to worry about the 254 character limitation.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>3.<span style= 'font:7.0pt "Times New Roman"'> </span> Currently, the only ConnectionType supported is ODBC</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>4.<span style= 'font:7.0pt "Times New Roman"'> </span> If the result has more than one row or column, the function simply returns the value in the first row and first column (converted to string).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u><br /> The number of affected rows (as string) or an error message (starting with ***).<br /> <br /> For Connection String examples, see: <span class= "MsoHyperlink"><a href= "https://www.connectionstrings.com/">https://www.connectionstrings.com/</a></span><br /> <br /> This SQL Server example updates an employee last name by adding '*' to it.<br /> So 'Fuller" becomes 'Fuller*'. It returns the value '1' because only 1 row was affected.<br /> <br /> uFLSQLNoReturn<span style='background:aqua'>("ODBC"</span>, <span style='background:yellow'>"Driver={SQL Server Native Client 11.0}; Server=REMOTE151; Initial Catalog=Northwind;Trusted_Connection=yes;"</span>,</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:lime'>"Update [dbo].[Employees] SET [dbo].[Employees].[LastName] = 'Fuller' WHERE [dbo].[Employees].[EmployeeID]=2"</span>);</p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821153"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExecuteSQLReturnValue()</a></h2> <p class="MsoNormal" style='margin-left:.25in'> <u><br /></u><span style='color:red'>Note: uflSQLReturnValue() provides a newer function with similar functionality.<br /> <br /></span></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (ODBC DSN or OLEDB Connection String,<br /> User ID, Password, sql1, sql2, sql3, sql4, sql5)<br /> <br /> This function executes a SQL statement against any <b>ODBC DSN</b> (even one that is not used by the Crystal report) or any <b>OLEDB Connection String</b>. If the SQL statement is longer than 254 characters, break it into segments across up to 5 sql "segments". <br /> <b><span style='background:yellow'>sql1() –to- sql5()</span></b> arguments can further divide very long sql statements into arrays with up to 254-charcter elements. You can see example of how content can be chopped into such an array in the <span class= "MsoHyperlink"><a href="start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> The SQL statement must be of a type that returns a single value rather than a result set. </p> <p class="MsoNormal" style='margin-left:.25in'>A typical use is to look up or get information from a data source that is not included in the report.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u><br /> A string containing the result, or an error message if failed. <b>You</b> <b>must guard against Null return values</b> by first checking for count or by using an aggregate (Min, Avg, Max…) </p> <p class="MsoNormal" style='margin-left:.25in'><br /> If the sql statement is not properly constructed (e.g., missing single or double quotes) you may get a "Memory Full" message from Crystal. In such a case, examine and adjust the sql statement.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>If you email me a request for a sample report, I will email you an rpt file that demonstrates this functionality. Below is a formula from that report as an example you can follow:<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>The formula returns the number of employees in the EMPLOYEE table (even if that table or even the ODBC data source is not included in the report:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLReturnValue ("Xtreme Sample Database","","","Select Count(*) from Employee","","","","")</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Here's another example:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLReturnValue ("Xtreme Sample Database 11","","", "SELECT sum(A.""Order Amount"") from Orders A WHERE A.""Customer ID"" = " + Cstr({Orders.Customer ID},0,""),"","" ,"","")</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>Here's an example that combines both types of SQL Functions:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>WhilePrintingRecords;</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>IF <span style= 'background:yellow'>ExecuteSQLReturnValue</span> ("Vision Offline","SYSDBA","myPass","Select PRINTED from ENTRY WHERE ENTRY_ID ="+cstr({ENTRY.ENTRY_ID},0,'') ,"" ,"" ,"" ,"" ) ="0"</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'> </span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>THEN</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New";background:yellow'>ExecuteSQLNoReturn</span></b> <b><span style='font-family:"Courier New"'>("Vision Offline","SYSDBA","myPass","Update ENTRY SET PRINTED = 1 WHERE ENTRY_ID ="+cstr({ENTRY.ENTRY_ID},0,'') ,"" ,"" ,"" ,"" )</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <h3><a name="_Toc147821154">Example with a Connection String</a></h3> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>Here's an example where instead of ODBC DSN, a connection string is specified:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLReturnValue (<span style='color:red'>"Provider=sqloledb;Data Source=IP ADDRESS,1433;Network Library=DBMSSOCN;Initial Catalog=DB_NAME;"</span>,"USER","PASSWORD","Select Count(*) from Location","","","",""))</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <span style= 'font-size:14.0pt;font-family:"Times New Roman",serif;color:#0070C0'><br clear="all" style='page-break-before:always' /></span> <h2><span style= 'color:#0070C0;font-weight:normal'> </span></h2> <h2><a name="_Toc147821155"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SQLReturnValue()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<span style= 'background:aqua'>ConnectionType</span>, <span style= 'background:yellow'>ConnectionString</span>, <span style= 'background: lime'>sql</span>)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function is a newer version similar to the older <span style= 'color:#0070C0'>ufl</span>ExecuteSQLReturnValue.<br /> Differences include:</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>5.<span style= 'font:7.0pt "Times New Roman"'> </span> The code uses pure .NET implementation, removing the dependency on ADODB</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>6.<span style= 'font:7.0pt "Times New Roman"'> </span> SQL statement is passed in as a single string. No need to worry about the 254 character limitation.</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>7.<span style= 'font:7.0pt "Times New Roman"'> </span> Currently, the only ConnectionType supported is ODBC</p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>8.<span style= 'font:7.0pt "Times New Roman"'> </span> If the result has more than one row or column, the function simply returns the value in the first row and first column (converted to string).</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u><br /> The resulting value (as string) or an error message (starting with ***).<br /> If the result of the SQL is zero rows, the error message is '***Zero Rows'<br /> <br /> For Connection String examples, see: <span class= "MsoHyperlink"><a href= "https://www.connectionstrings.com/">https://www.connectionstrings.com/</a></span><br /> <br /> This <b>MS Access Example</b> returns the first employee's last name found:<br /> <span style= 'font-size:11.0pt;color:#1F497D'>SQLReturnValue</span><span style= 'font-size:11.0pt'>(<span style= 'background:aqua'>"ODBC"</span>, <span style= 'background:yellow'>"Driver={Microsoft Access Driver (*.mdb, *.accdb)}; Dbq=C:\Temp \Xtreme\xtreme.mdb;"</span>, <span style= 'background:lime'>"Select Employee.""Last Name"" from Employee"</span>);<br /> <br /></span> This SQL Server example returns 'Fuller':<br /> uFLSQLReturnValue<span style='background:aqua'>("ODBC"</span>, <span style='background:yellow'>"Driver={SQL Server Native Client 11.0}; Server=REMOTE151; Initial Catalog=Northwind;Trusted_Connection=yes;"</span>,</p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'background:lime'>"Select [dbo].[Employees].[LastName] from [dbo].[Employees] WHERE [dbo].[Employees].[EmployeeID]=2"</span>);</p> <p class="MsoNormal"><br /> <br /></p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif;color:#4F81BD'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#4F81BD'> </span></b></p> <h2><a name="_Toc147821156"><span style= 'color:#4F81BD'>ufl</span>ExecuteSQLReturnFile()</a></h2> <p class="MsoNormal"><b><span style= 'color:#0070C0'> </span></b></p> <p class="MsoNormal" style='margin-left:.5in'><u>Arguments</u>: (ODBC DSN or OLEDB Connection String, </p> <p class="MsoNormal" style='margin-left:.5in'> User ID, Password, </p> <p class="MsoNormal" style='margin-left:.5in'> <span style='background:yellow'>FilePathAndName</span>, <span style='background:aqua'>ConversionType</span>, <br /> sql1, sql2, sql3, sql4, sql5)</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>This function is similar to ExecuteSQLReturnValue() except for 2 aspects:</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoListParagraph" style= 'margin-left:.75in;text-indent:-.25in'>1.<span style= 'font:7.0pt "Times New Roman"'> </span> Instead of returning a value from the database to the report, the function saves the value To a file specified by the <span style= 'background:yellow'>FilePathAndName</span> argument.</p> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in'>2. The content is converted according to the <span style= 'background:aqua'>ConversionType</span> argument. <br /> Supported options are:</p> <p class="MsoNormal" style='margin-left:.5in;text-indent:.5in'> <b>None</b> or "" (no conversion)</p> <p class="MsoNormal" style='margin-left:.5in;text-indent:.5in'> <b>RTF2Text</b> (convert RTF content to plain text)</p> <p class="MsoNormal" style='margin-left:1.0in'><b>2BMP, 2PNG</b>, <b>2GIF</b>, or <b>2JPEG</b> convert any image type to<br /> bitmap, png, GIF, or jpeg<br /> <b>2BMP_White</b> converts image with <b>transparent</b> background<br /> to BMP with <b>white</b> background<br /> <br /> </p> <p class="MsoNormal" style='margin-left:.5in'>Returns: </p> <p class="MsoNormal" style='margin-left:.5in'>"OK" or a failure message.</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>Note: you can bring the converted/saved content into the report using the <b>FileGetText</b>(), or <b>FileGetTextUTF8</b>() functions. In the case of image files, they can be brought into the report via dynamic reference to image path.</p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821157"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExecuteSQLReturnDelimited()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (ODBC DSN or OLEDB Connection String,<br /> User ID, Password, Delimiter, sql1, sql2, sql3, sql4, sql5)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function executes a SQL statement against any <b>ODBC DSN</b> (even one that is not used by the Crystal report) or any <b>OLEDB Connection String</b>. If the SQL statement is longer than 254 characters, break it into segments across up to 5 sql "segments". </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'background:yellow'>sql1() –to- sql5()</span></b> arguments can further divide very long sql statements into arrays with up to 254-charcter elements. You can see example of how content can be chopped into such an array in the <span class= "MsoHyperlink"><a href="start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> The SQL statement can be of a type that returns multiple records. The function takes all the values in the first column of the result set and concatenates them into a single delimited string. </p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u><br /> A string containing the result, or an error message if failed. </p> <p class="MsoNormal" style='margin-left:.25in'><br /> If the sql statement is not properly constructed (e.g., missing brackets, single or double quotes) you may get a "Memory Full" message from Crystal. In such a case, examine and adjust the sql statement.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>If you email me a request for a sample report, I will email you an rpt file that demonstrates this functionality. Below is a formula from that report as an example you can follow:<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>The formula returns the last names of all employees delimited with a semi-colon (";") from the EMPLOYEE table in the Xtreme Sample Database (even if that table or even the ODBC data source is not included in the report:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='font-family: "Courier New"'>ExecuteSQLReturnDelimited ("Xtreme Sample Database","","","<span style= 'background:yellow'>;</span>", "Select [Last Name] from Employee" ,"" ,"" ,"" ,"" )</span></b></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>The result is:</p> <div style= 'border:solid windowtext 1.0pt;padding:1.0pt 4.0pt 1.0pt 4.0pt; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> Davolio;Fuller;Leverling;Peacock;Buchanan;Suyama;King;Callahan;Dodsworth;Hellstern;<br /> Smith;Patterson;Brid;Martin</p> </div> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.25in'>Note: you may refer to a saved encrypted password by its name. See information about this in the ExecuteSQLCanConnect() section.</p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <h2 style='margin-left:.25in'><a name= "_uflExecuteSQLReturnDelimitedSegment"></a><a name= "_Toc147821158"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>ExecuteSQLReturnDelimited<span style='color:red'>Segment</span>()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (ODBC DSN or OLEDB Connection String,<br /> User ID, Password, Delimiter, sql1, sql2, sql3, sql4, sql5, SegmentN)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>This function executes a SQL statement against any <b>ODBC DSN</b> (even one that is not used by the Crystal report) or any <b>OLEDB Connection String</b>. If the SQL statement is longer than 254 characters, break it into segments across up to 5 sql "segments". <br /> <br /> <b><span style='background:yellow'>sql1() –to- sql5()</span></b> arguments can further divide very long sql statements into arrays with up to 254-charcter elements. You can see example of how content can be chopped into such an array in the <span class= "MsoHyperlink"><a href="start.htm#_uflHTML2Image()">section discussing the HTML2Image() function</a></span>. <b>If the content is less the 254 characters, you can simply use it as that argument without converting it to an array</b>.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>The SQL statement can be of a type that returns multiple records. The function takes all the values in the first column of the result set and concatenates them into a single delimited string. </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'>This function is just like ExecuteSQLReturnDelimited() (see detail in prior page), except that it <b>allows you to retrieve strings that are longer than 254 characters by breaking the operation into segments</b>.</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><br /> <u>Returns:</u><br /> Breaking the resulting string into segments of 254 characters each, the function returns the segment number specified by the Segment_N argument. In Crystal, you can load the entire result into a string variable using the following code:<br /> <br /></p> </div> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>WhilePrintingRecords;</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>StringVar</span> sResult;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>StringVar</span> sSegment;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#0070C0'>NumberVar</span> i;</p> <p class="MsoNormal" style='border:none;padding:0in'>i := 1;</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#00B050'>// Keep appending segments of 254 characters to the sResult string until reaching the end</span></p> <p class="MsoNormal" style='border:none;padding:0in'>sSegment := <span style='color:#0070C0'>ExecuteSQLReturnDelimitedSegment</span> ("Xtreme Sample Database","","", <span style= 'color:#0070C0'>Chr</span>(10) + <span style= 'color:#0070C0'>chr</span>(13), "Select [Customer Name] from Customer" ,"" ,"" ,"" ,"", i );</p> <p class="MsoNormal" style='border:none;padding:0in'>while sSegment <>"" Do</p> <p class="MsoNormal" style='border:none;padding:0in'>(</p> <p class="MsoNormal" style='border:none;padding:0in'>sResult := sResult + sSegment;</p> <p class="MsoNormal" style='border:none;padding:0in'>i := i + 1;</p> <p class="MsoNormal" style='border:none;padding:0in'>sSegment := <span style='color:#0070C0'>ExecuteSQLReturnDelimitedSegment</span> ("Xtreme Sample Database","","", <span style= 'color:#0070C0'>Chr</span>(10) + <span style= 'color:#0070C0'>chr</span>(13), "Select [Customer Name] from Customer" ,"" ,"" ,"" ,"", i )</p> <p class="MsoNormal" style='border:none;padding:0in'>);</p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'color:#00B050'>// Return the resulting string</span></p> <p class="MsoNormal" style='border:none;padding:0in'>sResult;</p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> Note: if you email me a request for a <b>sample report</b>, I will email you an rpt file that demonstrates this functionality.<br /> <br /> Note: you may <b>refer to a saved encrypted password by its name</b>. See information about this in the <b>ExecuteSQLCanConnect()</b> section.<br /> <br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821159"></a><a name="_Totals"></a><a name= "_Totals_of_Totals"></a>Totals of Totals</h1> <p class="MsoNormal">These functions overcome Crystal’s inability to aggregate totals. For example, a report may display the Sum of Order Values by month within each year. CUT Light allows you to return aggregate calculations (such as Max, Min, and Rank) on top of these regular monthly sums:<br /> <br /> <img border="0" width="645" height="349" id="Picture 27" src= "CUT_Light_NET_User_Manual_files/image034.png" alt="image" name= "Picture 27" /><br /> <br /> First, establish a unique key for an in-memory table storing the totals. For example:<br /> <b><span style= 'font-family:"Calibri",sans-serif'>BeforeReadingRecords; Global Stringvar Key1 := <span style= 'color:#3333FF'>uFLCreateGUID</span>();<br /> <br /></span></b></p> <p class="MsoNormal">Then, Accumulate the totals using an in-memory table tied to that key. For example:<br /> <span style= 'font-family:"Calibri",sans-serif'>WhileReadingRecords; Global Stringvar Key1;</span></p> <p class="MsoListParagraph" style='margin-left:.25in'> <b><span style= 'font-family: "Calibri",sans-serif;color:#3333FF'>uFLTotalStore</span></b><span style='font-family:"Calibri",sans-serif'>(Key1, "04", "12", "", "", "", 4, "");<br /> <b><span style='color:#3333FF'>uFLTotalStore</span></b>(Key1, "04", "12", "", "", "", 6, "");<br /> <b><span style='color:#3333FF'>uFLTotalStore</span></b>(Key1, "05", "01", "", "", "", 2, "");<br /> <b><span style='color:#3333FF'>uFLTotalStore</span></b>(Key1, "05", "02", "", "", "", 3, "");<br /></span><span style= 'color:#00B050'>// resulting table: <b>G1 | G2 | G3 | G4 | G5 | Sum | N | Avg | Max | Min<br /> </b></span> <span style='font-family:"Calibri",sans-serif'>"04" "12" 10 2 5 6 4<br /> "05" "01" 2 1 2 2 2<br /> "05" "02" 3 1 3 3 3</span></p> <p class="MsoListParagraph" style='margin-left:.25in'><span style= 'font-family: "Calibri",sans-serif'> </span></p> <p class="MsoNormal">You can then Lookup a single stored total like this:<br /> <span style='font-family:"Calibri",sans-serif'>Global Stringvar Key1; <br /> Cdbl(<b><span style='color:#3333FF'>uFLTotalLookup</span></b>(Key1, "04", "12",, "", "", "", "Sum", "")); </span> <span style='color:#00B050'>// resulting value: <b>10</b></span><span style= 'font-family:"Calibri",sans-serif'><br /> <br /> <br /></span></p> <span style= 'font-size:12.0pt;font-family:"Calibri",sans-serif'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"><span style= 'font-family:"Calibri",sans-serif'> </span></p> <p class="MsoNormal"><span style= 'font-family:"Calibri",sans-serif'>To get a total of totals you can target all stored totals that match a particular pattern.<br /> The example below returns the <b><span style= 'background:lime'>maximum</span></b> of all <b><span style= 'background:aqua'>sums</span></b> stored for any row whose first key column is <span style='background:yellow'>"05"</span> (the ‘*’ in the other four key columns match to anything).<br /> WhilePrintingRecords; Global Stringvar Key1;<br /> cDbl(<b><span style= 'color:#3333FF'>uFLTotalofTotals</span></b>(Key1, "05", "*", "*", "*", "*", "<span style='background:lime'>Max</span>", "<span style= 'background:aqua'>Sum</span>", ""));</span><b><span style= 'font-size:11.0pt'> </span></b> <span style='color:#00B050'>// resulting value: <b>3</b></span></p> <p class="MsoNormal"> </p> <p class="MsoNormal">You can also get the <b>Percentile</b> values for a set of totals using <b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uflTotalPercentile</span></b>() and the Top/Bottom <b>Rank</b> of a given total using <b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uflTotalRank</span></b>().<br /> <br /> The following sections describe these functions in more detail.</p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821160"><span style= 'color:#0070C0'>ufl</span>TotalStore()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u><br /> <b><span style='background:lime'>TotalsKey</span> :</b> string uniquely identifying the in-memory totals table to create/use<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total.<br /> Can be left blank (<b>"")</b><br /> <b><br /> <span style='background:yellow'>Value</span></b> : the number (as Double data type) to accumulate into the total.<br /> <br /> <b><span style='background:fuchsia'>Options</span></b> : blank string (<b>""</b>). Or, if set to <b>"[Distinct]"</b> calls with repeat keys are ignored.<br /> <br /> <u>Returns:</u> a string with details about the created/updated total<br /> or an error message starting with <span style= 'font-size:9.5pt; font-family:Consolas;color:#A31515'>"*** "<br /></span><br /> For example, Formula in Report Header to establish a key for a totals table: <br /> <span style='font-family:"Calibri",sans-serif'> BeforeReadingRecords; Global Stringvar <span style= 'background:lime'>Key1</span> := <span style= 'color:#3333FF'>uFLCreateGUID</span>();<br /> <span style='color:#00B050'>// returns: ‘4841bd19-07d1-4902-95f7-e311d636b62e’<br /></span></span><b><span style='font-size:11.0pt'><br /> </span></b><span style='font-size:11.0pt'>Formula in Detail section to accumulate totals for each year / month combination:<br /> <b> </b></span> <span style= 'font-family:"Calibri",sans-serif'>WhileReadingRecords; <br /> Global Stringvar <span style= 'background:lime'>Key1</span>;</span><b><span style= 'font-size:11.0pt'><br /> </span></b> <b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uFLTotalStore</span></b><span style='font-family:"Calibri",sans-serif'>(<span style='background:lime'>Key1</span>,</span> <span style='background:aqua'>{@Year}</span>, <span style= 'background: aqua'>{@Month}</span><span style= 'font-family:"Calibri",sans-serif'>,</span> <b><span style= 'background:aqua'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>,</span> <b><span style= 'background:aqua'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>,</span> <b><span style= 'background: aqua'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>,</span> <b><span style= 'background:yellow'>4</span></b><span style= 'font-family:"Calibri",sans-serif'>,</span> <b><span style= 'background:fuchsia'>""</span></b><span style= 'font-family:"Calibri",sans-serif'>);<br /> <span style='color:#00B050'>// returns: ‘<b>Inserted: [Sum4|N=1|Avg=4|Min=4|Max=4]</b>’</span></span></p> <p class="MsoNormal"> </p> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821161"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalLookup()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> string uniquely identifying the in-memory totals table to lookup<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total to lookup.<br /> Can be left blank (<b>"")</b></p> <p class="MsoNormal"><u><br /></u><span style= 'background:yellow'>Type</span> : string specifying the total type. Acceptable types: <b>Sum</b>, <b>N</b>, <b>Avg</b>, <b>Max</b>, <b>Min</b><br /> <br /></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>). For future use.<u><br /></u><br /> <u>Returns:</u> a string showing the total or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal">Cdbl(<b><span style= 'font-family:"Calibri",sans-serif; color:#3333FF'>uFLTotalLookup</span></b>(<span style='background:lime'>Key1</span>, <span style='background:aqua'>{@Year}</span>, <span style= 'background:aqua'>{@Month}</span>, <span style= 'background:aqua'>""</span>, <span style= 'background: aqua'>""</span>, <span style= 'background:aqua'>""</span>, <span style= 'background:yellow'>"Sum"</span>, <span style= 'background:fuchsia'>""</span>));<br /> <span style='font-family:"Calibri",sans-serif;color:#00B050'>// returns: '<b>4'<br /></b></span><br /> <br /></p> <h2><a name="_Toc147821162"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalsReset()</a></h2> <p class="MsoNormal"> </p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> key of totals table to reset and remove.<br /> <br /></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>). For future use.<u><br /></u><br /> <u>Returns:</u> a string showing success or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal"><b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uFLTotalsReset</span></b> (<span style='background:lime'>Key1</span>, <span style= 'background:fuchsia'>""</span>);<br /> <span style='font-family:"Calibri",sans-serif;color:#00B050'>// returns: <b>"TotalsKey [4841bd19-07d1-4902-95f7-e311d636b62e] was Reset."<br /> <br /></b></span></p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821163"></a><a name= "_uflTotalofTotals()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalofTotals()</h2> <p class="MsoNormal"><u><span style= 'text-decoration:none'> </span></u></p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> key of totals table to scan for matching rows & total the specified summary.<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total.<br /> Use <b>"*"</b> as a wild card to match all values</p> <p class="MsoNormal"><u><br /></u><span style= 'background:yellow'>Type</span> : string specifying the aggregation operation: <b><i>Sum</i></b>, <b><i>Avg</i></b>, <b><i>Count</i></b>, <b><i>Max</i></b>, <b><i>Min</i></b>, <b><i>StDev</i></b>, or <b><i>Var</i><br /> <br /> <span style='background:#FFC000'>ofType</span> :</b> the column in the totals table to target for aggregation: <b> Sum</b><i>,</i> <b>N</b><i>,</i> <b>Avg</b><i>,</i><b>Max</b><i>,</i> or <b>Min</b><br /> <br /></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>) or, to do a <b><span style='background:yellow'>Conditional Total of Totals</span></b>, specify a condition like this:<br /> "[Condition:<b><span style='background:yellow'>N > 30</span></b>]" (that would total only total table rows that obey the condition)<u><br /></u><br /> <u>Returns:</u> a string showing the total of the total, or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal">Cdbl(<b><span style= 'font-family:"Calibri",sans-serif; color:#3333FF'>uFLTotalofTotals</span></b> (<span style='background:lime'>Key1</span>, <span style= 'background:aqua'>{@Year}</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:yellow'>"Max"</span>, <span style= 'background: #FFC000'>"Sum"</span>, <span style= 'background:fuchsia'>""</span>));<br /> <span style='font-family:"Calibri",sans-serif;color:#00B050'>// returns: '3'<b><br /> <br /></b></span></p> <p class="MsoNormal">Notes:</p> <p class="MsoNormal">When specifying <span style= 'background:aqua'>the 5 key columns</span> <b>You are not restricted to the grouping structure or the grouping hierarchy used in the report</b>. For example, in a report grouped by<br /> a) {@Year}, and b) {@Month} you can ignore the year and find, for each month, the average sum across several years using something like:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal">Cdbl(<b><span style= 'font-family:"Calibri",sans-serif; color:#3333FF'>uFLTotalofTotals</span></b> (<span style='background:lime'>Key1</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: aqua'>{@Month}</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:yellow'>"Avg"</span>, <span style= 'background: #FFC000'>"Sum"</span>, <span style= 'background:fuchsia'>""</span>));<br /> <br /> The Condition can be a composite condition involving any of the columns in the table of totals.<br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821164"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalPercentile()</a></h2> <p class="MsoNormal"><u><br /></u>Returns the Percentile Value for a set of stored totals.<br /> <br /></p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> key of totals table to scan for matching rows & total the specified summary.<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total.<br /> Use <b>"*"</b> as a wild card to match all values</p> <p class="MsoNormal"><b><br /> <span style='background:#FFC000'>ofType</span> :</b> the column in the totals table to target for comparison: <b> Sum</b><i>,</i> <b>N</b><i>,</i> <b>Avg</b><i>,</i><b>Max</b><i>,</i> or <b>Min<br /> <br /> <span style='background:yellow'>Percentile</span></b> : for example, <span style='background:yellow'>75</span> would return the 75<sup>th</sup> percentile value<br /> <br /></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>). For future use.<u><br /></u><br /> <u>Returns:</u> a string showing the targeted percentile value, or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas; color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal"><b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uFLTotalRank</span></b>(<span style='background:lime'>Key1</span>, <span style='background:aqua'>{@Year}</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: #FFC000'>"Sum"</span>, <b><span style= 'background:yellow'>75</span></b>, <span style= 'background:fuchsia'>""</span>)<br /> <br /></p> <p class="MsoNormal"><img border="0" width="626" height="377" id= "Picture 26" src="CUT_Light_NET_User_Manual_files/image035.png" alt="image" name="Picture 26" /><br /> <br /> <br /> <br /></p> <h2><a name="_Toc147821165"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalRank()</a></h2> <p class="MsoNormal"><u><br /></u>Returns the Top or Bottom rank of a given total compared to a specified peer group of totals.<br /> <br /></p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> key of totals table to scan for matching rows & total the specified summary.<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total.<br /> Use <b>"*"</b> as a wild card to match all values</p> <p class="MsoNormal"><u><br /></u><span style= 'background:yellow'>Type</span> : string specifying the Rank type: <b><i>Rank_Top</i></b> or <b><i>Rank_Bottom</i><br /> <br /> <span style='background:#FFC000'>ofType</span> :</b> the column in the totals table to target for comparison: <b> Sum</b><i>,</i> <b>N</b><i>,</i> <b>Avg</b><i>,</i><b>Max</b><i>,</i> or <b>Min<br /> <br /> <span style='background:#F2DBDB'>LookupTotal</span></b> : the total value for which you want to return the rank.<br /> You can use a regular total or uflTotalLookup() to provide that value.<br /> <br /></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>). For future use.<u><br /></u><br /> <u>Returns:</u> a string showing the rank of the LookupTotal, or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas; color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal"><b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uFLTotalRank</span></b>(<span style='background:lime'>Key1</span>, <span style='background:aqua'>{@Year}</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: yellow'>"Rank_Top"</span>, <span style= 'background:#FFC000'>"Sum"</span>,<br /> <b><span style='background:#F2DBDB'>CDbl(Sum ({Orders.Order Amount}, {@YY_MM}))</span></b>, <span style= 'background:fuchsia'>""</span>)<br /> <br /></p> <p class="MsoNormal"><img border="0" width="397" height="218" id= "Picture 13" src="CUT_Light_NET_User_Manual_files/image036.jpg" alt="image" name="Picture 13" /><br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821166"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>TotalNth()</a></h2> <p class="MsoNormal"><u><br /></u>Returns details from the Nth largest or smallest stored totals row in a set of stored totals.<br /> <br /></p> <p class="MsoNormal"><u>Arguments:</u></p> <p class="MsoNormal"><b><span style= 'background:lime'>TotalsKey</span> :</b> key of totals table to scan for matching rows & total the specified summary.<br /> <br /> <b><span style='background:aqua'>G1,G2,G3,G4,G5</span></b> : strings for up to 5 Group Levels or Keys for identifying a total.<br /> Use <b>"*"</b> as a wild card to match all values</p> <p class="MsoNormal"> </p> <p class="MsoNormal"><b><span style= 'background:yellow'>N</span></b> (integer) : for example, to retrieve details from 2<sup>nd</sup> highest Sum, you would set the N to <b>2</b>.</p> <p class="MsoNormal"><u><br /></u><span style= 'background:yellow'>Type</span> : string specifying <b><i>Largest</i></b> or <b><i>Smallest</i><br /> <br /> <span style='background:#FFC000'>ofType</span> :</b> the target column for Nth comparisons: <b> Sum</b><i>,</i> <b>N</b><i>,</i> <b>Avg</b><i>,</i> <b>Max</b><i>,</i>or <b>Min<br /> <br /> <span style='background:#F2DBDB'>ReturnInfo</span></b> : a string with token references to the desired detail from the Nth row.<br /> The function replaces the token references with the values from the target row.<br /> Tokens can be: <i>{G1}, {G2}, {G3},{G4},{G5}</i>, <i>{Sum}, {N}, {Avg}, {Max}, {Min}<br /> For example,</i> <b><span style= 'background:#F2DBDB'>"{G1}|{G2}|{Sum}|Avg|"</span><br /> <br /></b></p> <p class="MsoNormal"><b><span style= 'background:fuchsia'>Options</span></b> : blank string (<b>""</b>). For future use.<u><br /></u><br /> <u>Returns:</u> The requested ReturnInfo or an error message starting with <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515'>"*** "</span><br /> <br /> Example:<br /> Global Stringvar <span style='background:lime'>Key1</span>;</p> <p class="MsoNormal"><b><span style= 'font-family:"Calibri",sans-serif;color:#3333FF'>uFLTotalNth</span></b>(<span style='background:lime'>Key1</span>, <span style='background:aqua'>{@Year}</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background:aqua'>"*"</span>, <span style= 'background: yellow'>"2"</span>, <span style= 'background:yellow'>"Largest "</span>, <span style= 'background:#FFC000'>"Sum"</span>, <b><span style= 'background:#F2DBDB'>"{G2}|{Sum}|"</span></b>, <span style= 'background:fuchsia'>""</span>)<br /> <br /></p> <p class="MsoNormal"><img border="0" width="324" height="260" id= "Picture 28" src="CUT_Light_NET_User_Manual_files/image037.png" alt="image" name="Picture 28" /><br /> <br /> <br /> <br clear="all" style='page-break-before:always' /></p> <h1><a name="_Toc147821167">Geo</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821168"><span style= 'color:#0070C0'>ufl</span>Distance()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (lat1, lon1, lat2, lon2, unit_of_measure)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> lat1, lon1 are the latitude and longitude of point 1 (in decimal degrees)<br /> lat2, lon2 are the latitude and longitude of point 2 (in decimal degrees)<br /> unit_of_measure is how the result should be provided:</p> <p class="MsoNormal" style='margin-left:1.0in'>'m' for miles, 'k' for kilometers, 'n' for nautical miles<br /> </p> <p class="MsoNormal" style='margin-left:.25in'>This function calculates the distance between two points (given the latitude/longitude of those points). Note that south latitudes are negative, east longitudes are positive.</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> Distance in the requested units of measure.<br /> <br /> Example: <b>Distance (52.2047, 0.1406 , 53.2047 , 0.1406, "m")</b> returns <b>69.09</b><br /> <br /></p> <h2><a name="_Toc147821169"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>DistanceByZip5()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Zip1, Zip2, unit_of_measure)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> Zip1 and Zip2 are the <b><span style= 'background:yellow'>Canadian</span></b> or <b><span style= 'background:yellow'>5-digit</span></b> US zip code of the two points (e.g., "M1B0A9" and "16509") unit_of_measure is how the result should be provided:</p> <p class="MsoNormal" style='margin-left:.75in;text-indent:.25in'> 'm' for miles, 'k' for kilometers, 'n' for nautical miles</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> Distance in the requested units of measure.<br /> <br /> Example: <b>DistanceByZip5 ("16509", "M1B 0A9", 'm')</b> returns <b>4.76</b> miles<br /> <br /> <b>Note:</b> this function requires that the CUT_Light.ini file is installed to the default location of:<br /> c:\Program Files\CUT Light\ Or c:\Program Files (x86)\CUT Light\</p> <p class="MsoNormal" style='margin-left:.25in'>Since it uses a local ini file, it doesn't depend on a web connection and quota restrictions imposed by DistanceByZip().<br /> <br /></p> <h2><a name="_Toc147821170"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>DistanceByZipUK()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Zip1, Zip2, unit_of_measure)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> Zip1 and Zip2 are the UK Outer Codes of the two points (e.g., "AB16" and "AB30") unit_of_measure is how the result should be provided:</p> <p class="MsoNormal" style='margin-left:.75in;text-indent:.25in'> 'm' for miles, 'k' for kilometers, 'n' for nautical miles</p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> Distance in the requested units of measure.<br /> <br /> Example: <b>DistanceByZipUK("AB16", "AB30, "k")</b> returns <b>48.92 Kilometers<br /></b> <br /> <b>Note:</b> this function requires that the CUT_Light.ini file is installed to the default location of:<br /> c:\Program Files\CUT Light\ Or c:\Program Files (x86)\CUT Light\</p> <p class="MsoNormal" style='margin-left:.25in'>Since it uses a local ini file, it doesn't depend on a web connection and quota restrictions imposed by DistanceByZip().<br /> <br /></p> <h2><a name="_Toc147821171"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>DistanceByZip()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Zip1, Zip2, unit_of_measure)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> Zip1 and Zip2 are the zip code of the two points (e.g., "16563" or "16563-1400") unit_of_measure is how the result should be provided:</p> <p class="MsoNormal" style='margin-left:.75in;text-indent:.25in'> 'm' for miles, 'k' for kilometers, 'n' for nautical miles</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> Distance in the requested units of measure.<br /> <br /> Example: <b>Distance ("16509", "16563-11400, "m")</b><br /> returns <b>5.76</b> (distance in miles between the two points)<br /> <br /> <b>Note:</b> this function receives data from a web site, so it requires the computer to have access to the internet. If the function stops performing, you probably exceeded the daily hit quota for the web site. You should switch to the <b>DistanceByZip5()</b> function which uses a local data file but is restricted to Canadian or 5-digit US zip codes.</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821172"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetLatLongFromZip()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Zip): zip code (e.g., "16563" or "16563-1400") <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> Latitude/Longitude string.<br /> <br /> Example: <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>GetLatLongFromZip("16563-1400")</span><br /> returns <b>42.124621/-79.982133</b><br /> <br /> <b>Note:</b> this function receives data from a web site, so it requires the computer to have access to the internet. If the function stops performing, you probably exceeded the daily hit quota for the web site. You should switch to the <b>GetLatLongFromZip5()</b> function, which uses a local data file but is restricted to Canadian or 5-digit US zip codes.<br /> <br /></p> <h2><a name="_Toc147821173"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetLatLongFromZip5()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Zip): <b><span style= 'background:yellow'>Canadian</span></b> or <b><span style= 'background:yellow'>5-digit US</span></b> codes ("16563" or "M1B0A9" or "M1B 0A9") <br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Returns:</u> Latitude/Longitude string.<br /> <br /> Example: <span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:black'>GetLatLongFromZip5("M1B 0A9") </span> <br /> returns: <b>43.807304/-79.179753</b><br /> <br /> <b>Note:</b> this function requires that the CUT_Light.ini file is installed to the default location of: c:\Program Files\CUT Light\ Or c:\Program Files (x86)\CUT Light\</p> <p class="MsoNormal" style='margin-left:.25in'>Since it uses a local ini file, it doesn't depend on a web connection and quota restrictions imposed by GetLatLongFromZip().<br /> <br /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"> </p> <h2><a name="_Toc147821174"></a><a name= "_uflGoogleAddress2LatLong()"></a><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GoogleAddress2LatLong()</h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Address, ApiKey)<br /> <br /> <u>Returns:</u> Latitude/Longitude string. Error message (starting with ***) if the process failed<br /> <br /> Example: <b><span style= 'font-size:11.0pt;font-family:"Arial",sans-serif; color:#1F497D'>uFLGoogleGeoAddress2LatLong</span></b><span style='font-size: 11.0pt;font-family:"Arial",sans-serif;color:black'>("5275 Rome Ct, Erie, PA 16509, USA",</span>""<span style= 'font-size:11.0pt; font-family:"Arial",sans-serif;color:black'>)</span> <br /> returns: <b>42.0961719||-80.0294165</b></p> <p class="MsoNormal" style='margin-left:.25in'><br /> Download <span class="MsoHyperlink"><a href= "http://www.milletsoftware.com/Download/CUT_Light_Google_Geo.rpt">sample report</a></span>. Or see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/images/CUT%20Light/CUT_Light_Google_Geo%20Sample%20Report.png"> image</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>You need to follow <span class="MsoHyperlink"><a href= "https://developers.google.com/maps/documentation/geocoding/get-api-key"> Google's Instructions</a></span> to create a cloud project, enable billing, and get your <b>Maps API Key</b>. You then need to either specify the ApiKey via the argument or, more typically, leave the ApiKey argument blank ("") and set the API key via an entry in <b>CUT_Light_Options.ini.</b><br /> For the 32-bit version of CUT Light, create that file here:<br /> C:\Program Files (x86)\Millet Software\CUT_Light_NET_32\CUT_Light_Options.ini<br /> The entry should look like this (use your own API key of course):<br /> -----------<br /> [Options]<br /> <b>GoogleAPI_Geo=AIzaSyDNR6</b>…<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'> </span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'> </span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'><br /> <br /> <br /></span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:10.0pt; font-family:"Arial",sans-serif'> </span></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><a name= "_uflGoogleDrivingTimeDistance()"></a><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821175"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GoogleDrivingTimeDistance()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Origin, Destination, Units, ApiKey)<br /> Origin/Destination are specified as address or Lat|Long pair ("42.0961719||-80.0294165","")<br /> Units: "Metric" to return distance in <b>meters</b>. "Imperial" to return distance in <b>feet</b>.<br /> <br /> <u>Returns:</u> a string with 4 elements delimited by '||':<br /> 1. Driving time (seconds) assuming we depart now (<span style= 'background:yellow'>takes into account traffic conditions</span>)<br /> 2. Driving time as nicely formatted text</p> <p class="MsoNormal" style='margin-left:.25in'>3. Distance in feet if Units argument was set to "Imperial", meters if "Metric".<br /> 4. Distance as nicely formatted text</p> <p class="MsoNormal" style='margin-left:.25in'>Returns error message (starting with ***) if the process failed<br /> <br /> Example: <b><span style= 'font-size:11.0pt;font-family:"Arial",sans-serif; color:#1F497D'>uFLGoogleDrivingTimeDistance</span></b><span style='font-size: 11.0pt;font-family:"Arial",sans-serif;color:black'>("5275 Rome Ct, Erie, PA 16509, USA",<br /> "While House, Washington, DC", "Imperial",</span>""<span style= 'font-size:11.0pt;font-family:"Arial",sans-serif;color:black'>)</span> <br /> returns: 20405||5 hours 40 mins||594538||369 mi<br /> <br /> Download <span class="MsoHyperlink"><a href= "http://www.milletsoftware.com/Download/CUT_Light_Google_Geo.rpt">sample report</a></span>. Or see <span class="MsoHyperlink"><a href= "https://www.milletsoftware.com/images/CUT%20Light/CUT_Light_Google_Geo%20Sample%20Report.png"> image</a></span>.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>You need to follow <span class="MsoHyperlink"><a href= "https://developers.google.com/maps/documentation/distance-matrix/get-api-key"> Google's Instructions</a></span> to create a cloud project, enable billing, and get your <b>Distance Matrix API Key</b>. Specify the ApiKey via the argument or set the API key via an entry in <b>CUT_Light_Options.ini</b> like this (use your own API key of course):<br /> -----------<br /> [Options]<br /> <b>GoogleAPI_Distance=AIzaSyBcu</b>…<br /> <br clear="all" style='page-break-before:always' /></p> <h1><a name="_Toc147821176">Excel</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821177"><span style= 'color:#0070C0'>ufl</span>GetXLSValue()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Workbook, Worksheet, Cell)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The text of the excel cell value<br /> Returns "Workbook Not Found" if the file can't be found. <br /> Returns "Worksheet Not Found" if the worksheet can't be found</p> <p class="MsoNormal" style='margin-left:1.0in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Example: GetXLSValue <b>("c:\temp\test.xlsx", "Sales", "B2")</b><br /> <br /> <b>Notes:</b><br /> 1. If you leave the sheet name blank ("") or as "1" the first sheet in the workbook is used.<br /> <br /></p> <h2><a name="_Toc147821178"></a><a name= "_Toc427065918"><span style='color: #0070C0'>ufl</span>SetXLSValue()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Workbook, Worksheet, Cell, NewValue)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> OK or error message.<br /> Returns "Workbook Not Found" if the file can't be found. <br /> Returns "Worksheet Not Found" if the worksheet can't be found</p> <p class="MsoNormal" style='margin-left:1.0in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Example: SetXLSValue <b>("c:\temp\test.xlsx", "Sales", "B2", "MyNewValue")</b><br /> <br /> <b>Notes:</b><br /> 1. If you leave the sheet name blank ("") or as "1" the first sheet in the workbook is used.<br /> 2. NewValue is specified inside double quotes, but treated as if typed into the cell, so "100.2" would become a number, while "<span style='color:red;background:yellow'>'</span>100.2" would become text in the spreadsheet due to the single quote.<br /> <br /></p> <h2><a name="_Toc147821179"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetXLSOutput()</a></h2> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to plug Crystal values as input to an Excel model and get some output back. One typical use scenario is VLOOKUP tables, allowing users to maintain lookup logic in Excel without needing to modify the Crystal report.</p> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Workbook, Worksheet, InputCell, InputCellValue, OutputCell)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The text of the excel OutputCell after plugging the InputCellValue into InputCell<br /> Returns "Workbook Not Found" if the file can't be found. <br /> Returns "Worksheet Not Found" if the worksheet can't be found</p> <p class="MsoNormal" style='margin-left:1.0in'> </p> <p class="MsoNormal" style='margin-left:.25in'>Example: GetXLSOutput <b>("c:\temp\test.xlsx", "", "B2", {@LookUpValue}, "C4")</b><br /> <br /> <b>Notes:</b><br /> 1. If you leave the sheet name blank ("") or as "1" the first sheet in the workbook is used.<br /> <br /></p> <h2><a name="_Toc147821180"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>XLSLookUp()</a></h2> <p class="MsoNormal" style='margin-left:.25in'>This function allows you to look up a value in one column and return the corresponding value (from the same row) in another column.<br /> The advantages of using this newer function compared to uflGetXLSOutput are:</p> <p class="MsoListParagraph" style='text-indent:-.25in'> a)<span style= 'font:7.0pt "Times New Roman"'> </span> Doesn't require Excel to be installed on the same machine</p> <p class="MsoListParagraph" style='text-indent:-.25in'> b)<span style= 'font:7.0pt "Times New Roman"'> </span> Much faster</p> <p class="MsoListParagraph" style='text-indent:-.25in'> c)<span style= 'font:7.0pt "Times New Roman"'> </span> Doesn't require a VLOOKUP() or similar logic within the spreadsheet<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Workbook, Worksheet, Lookup Value, Lookup Column, ReturnFrom Column)<br /> note: all arguments are of String type, even if the value in excel is numeric</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The <u>text</u> of the value found in the corresponding column.<br /> Or "LookUp Value Not Found" if the lookup value is not found within the Lookup Column.<br /> Example: GetXLSLookup<b>("c:\temp\test.xlsx", "Emails", "7882", "C", "Q")<br /> <br /></b></p> <p class="MsoNormal"><b> </b> Notes: the 'Lookup column' doesn't need to be to the left of the 'ReturnFrom Column'.</p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821181"></a><a name= "_uflXlsGetValue()"></a><span style= 'color:#0070C0'>ufl</span>XlsGetValue()</h2> <p class="MsoNormal" style='margin-left:.25in'>The advantages of using this newer function compared to uflGetXLSValue() are:</p> <p class="MsoListParagraph" style='text-indent:-.25in'> a)<span style= 'font:7.0pt "Times New Roman"'> </span> Doesn't require Excel to be installed on the same machine</p> <p class="MsoListParagraph" style='text-indent:-.25in'> b)<span style= 'font:7.0pt "Times New Roman"'> </span> Using the SegmentN argument allows you to retrieve values longer than 254 characters</p> <p class="MsoListParagraph" style='text-indent:-.25in'> c)<span style= 'font:7.0pt "Times New Roman"'> </span> The array arguments allow you to get values from multiple sheets & cells<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Workbook, SheetName(), Cell(), SegmentN)<br /> note: The SheetName() and Cell() arrays allow you to get values from multiple sheets and cells. The values are delimited by '||' .<br /> If you are targeting a single sheet/cell combination, pass them in as simple string arguments.</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The cell values, delimited by '||' or an error message.<br /> <br /> <br /></p> <p class="MsoNormal">Example: <b><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:blue'>uFLXLSGetValue</span></b><b><span style='font-size:10.0pt; font-family:"Arial",sans-serif;color:black'>("C:\Temp\MyData.xlsx", ["Sheet1","Sheet1"], ["A1","A2"], 1);</span></b> <br /> this returns '422||TestA22' which are the delimited values found in Sheet1, cell A1 & A2.<br /> <br /> In this case, we know the content would not exceed 254 characters, so we pass in a SegmentN value of 1. If we need to handle longer returned values, we can <span class="MsoHyperlink"><a href= "start.htm#_uflGetINIValueSegment()">loop following the logic discussed for the uflGetINIValueSegment() function</a></span>.</p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif;color:#0070C0'><br clear="all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt;color:#0070C0'> </span></b></p> <h2><a name="_Toc147821182"></a><a name= "_uflXlsSetValue()"></a><span style= 'color:#0070C0'>ufl</span>XlsSetValue()</h2> <p class="MsoNormal" style='margin-left:.25in'>The advantages of using this newer function compared to uflSetXLSValue() are:</p> <p class="MsoListParagraph" style='text-indent:-.25in'> a)<span style= 'font:7.0pt "Times New Roman"'> </span> Doesn't require Excel to be installed on the same machine</p> <p class="MsoListParagraph" style='text-indent:-.25in'> b)<span style= 'font:7.0pt "Times New Roman"'> </span> Can handle protected sheets</p> <p class="MsoListParagraph" style='text-indent:-.25in'> c)<span style= 'font:7.0pt "Times New Roman"'> </span> The array arguments allow you to set values in multiple sheets & cells in a single pass<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (Workbook, SheetName(), Cell(), NewValue())<br /> note: The SheetName(),Cell(), and NewValue() arrays allow you to set values to multiple sheets and cells.<br /> If you are targeting a single sheet/cell combination, pass them in as simple string arguments.</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> "OK" or error message.<br /> <br /> <br /></p> <p class="MsoNormal">Example: <b><span style= 'font-size:10.0pt;font-family:"Arial",sans-serif; color:blue'>uFLXLSSetValue</span></b><b><span style='font-size:10.0pt; font-family:"Arial",sans-serif;color:black'>("C:\Temp\MyData.xlsx", ["Sheet1","Sheet1"], ["A1","A2"], ["422","TestA22"]);</span></b> <br /> <br /> Here is a sample report image showing both setting and getting multiple Excel cell values:</p> <p class="MsoNormal"> </p> <p class="MsoNormal"><img border="0" width="624" height="170" id= "Picture 19" src="CUT_Light_NET_User_Manual_files/image038.jpg" alt="image" name="Picture 19" /></p> <p class="MsoNormal"> </p> <p class="MsoNormal"><b><br /> <br /></b><br /> <br /> <br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821183">Font</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821184"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetTextWidth()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Text, FontName, FontSize, Bold, Italic, Units)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The width of the text in specified Units ("Twips" or "Pixels")<br /> -1 if an error occurs<br /> <br /> Note: 1440 twips = 1 inch<br /> <br /></p> <p class="MsoNormal" style='margin-left:1.0in'> </p> <p class="MsoNormal" style='margin-left:1.0in;text-indent:-.75in'> Examples: GetTextWidth({Employee.Last Name}, "Arial", 10, False, False, "Pixels")<br /> GetTextWidth({Employee.Last Name}, "Arial", 10, False, False, "Twips")</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821185"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetFontSizeToFitText()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Text, FontName, Available Width, Bold, Italic, Units)</p> <p class="MsoNormal" style='margin-left:.5in'>The Units argument reflects the units in which Available Width was specified:<br /> "Inches", "Centimeters", "Twips", or "Pixels".<br /> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The largest font size that would fit the specified text within the available width.<br /> -1 if an error occurs<br /> <br /></p> <p class="MsoNormal" style='margin-left:15.0pt'>Example: <b>GetFontSizeToFitText</b>("This is Some Text", "Arial", 2, False, False, "Inches")<br /> returns a value of 18 (so font size of 18 is the largest that would fit that text in 2 Inches)<br /> <br /> Note: typically used to dynamically control the font size of a field/formula in Crystal.<br /> <br /></p> <h2><a name="_Toc147821186"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetTextHeight()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (Text, MaxWidth, FontName, FontSize, Bold, Italic)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The height of the wrapped text in inches, when fitted into the MaxWidth (in inches)<br /> -1 if an error occurs<br /> <br /> Examples: GetTextHeight ({@SomeText}, 3.5, "Arial", 10, False, False)</p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <h2><a name="_Toc147821187"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>GetTextNumberOfLines()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /></u>Same as GetTextHeight(), but returns <b>number of wrapped lines</b> rather than text height.</p> <p class="MsoNormal"><br /> <br /> </p> <h1><a name="_Toc147821188">Encryption</a></h1> <h2><a name="node0" id="node0"></a><span style= 'color:#0070C0'><br /> <a name="_Toc147821189">ufl</a></span>BlowFishEncrypt()</h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (StringToEncrypt, <b><span style= 'color:red'>Key</span></b>)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The encrypted text (as HEX) using the BlowFish algorithm.<br /> <br /> For example: <b>BlowFishEncrypt ("MilletSoftware", "Sesame" )</b></p> <p class="MsoNormal" style='margin-left:.25in'>Returns:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:9.0pt'>268BA82DCA546F2C4E107E9C8AF16546318A8E275BDE0F8D1C5BBD663C8DF10E</span><br /> <br /></b></p> <p class="MsoNormal" style='margin-left:.25in'>Note: StringtoEncrypt can't exceed 254 characters. If you try to pass a string larger than that, the function returns: ""String to Encrypt Must Be Less Than 255 Characters"<br /> <br /> Note however that the returned encrypted string may be longer than 254 characters<br /> <br /></p> <h2><a name="_Toc147821190"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BlowFishDecrypt()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (StringToDecrypt, <b><span style= 'color:red'>Key</span></b>)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The decrypted text using the BlowFish algorithm.<br /> <br /> For example:<br /> <b>BlowFishDecrypt ("</b><b><span style= 'font-size:7.0pt'>268BA82DCA546F2C4E107E9C8AF16546318A8E275BDE0F8D1C5BBD663C8DF10E</span>", "Sesame" )</b></p> <p class="MsoNormal" style='margin-left:.25in'>Returns:</p> <p class="MsoNormal" style='margin-left:.25in'> <b>MilletSoftware</b></p> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <p class="MsoNormal" style='margin-left:.25in'>Note: StringtoDecrypt can't exceed 254 characters. If you try to pass a string larger than that, the function returns: ""String to Decrypt Must Be Less Than 255 Characters"<br /> If the string you need to decrypt is longer, use <b>BlowFishDecrypt<span style='color:red'>Segment</span>()</b> (see next page).<br /> <br /></p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><b> </b></p> <h2><a name="_Toc147821191"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>BlowFishDecrypt<span style='color:red'>Segment</span>()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (<b><span style='color:red'>Key,</span></b> Segment1, Segment2, Segment3, Segment4, Segment5)</p> <p class="MsoNormal" style='margin-left:.25in;text-indent:.25in'> Note: Key is the first argument in this function (unlike the prior function).<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u> The result (as HEX) of decrypting the combined text of all segments using the BlowFish algorithm.<br /> <br /> For example: <b>BlowFishEncrypt<span style= 'color:red'>Segment</span> ("Sesame", "MilletSoftware", "", "", "","" )</b></p> <p class="MsoNormal" style='margin-left:.25in'>Returns:</p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:9.0pt'>268BA82DCA546F2C4E107E9C8AF16546318A8E275BDE0F8D1C5BBD663C8DF10E</span><br /> <br /></b></p> <p class="MsoNormal" style='margin-left:.25in'>This function is like <b>BlowFishDecrypt</b>() but it <b>allows you to break the text you need to decrypt into up to 5 segments that are each no longer than 254 characters</b>.</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'>Here is a Crystal formula sample that automatically breaks a string to such segments<br /> <br /></p> </div> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>StringVar Plain_String := "Long Plain Text or a reference to a Crystal field/formula";</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>StringVar Encrypted_String := <b>BlowFishEncrypt</b>(Plain_String, "Sesame");<br /> StringVar Decrypted_String;</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> </span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>IF Len(Encrypted_String) <= 254 Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Decrypted_String := <b>BlowFishDecryptSegments</b>("Sesame",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Encrypted_String, "", "", "", "")</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>Else If Len(Encrypted_String) <= 254 * 2 Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Decrypted_String := <b>BlowFishDecryptSegments</b>("Sesame",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Left(Encrypted_String, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, 254 + 1), "", "", "")</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>Else If Len(Encrypted_String) <= 254 * 3 Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Decrypted_String := <b>BlowFishDecryptSegments</b>("Sesame",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Left(Encrypted_String, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, 254 + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 2) + 1), "", "")</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>Else If Len(Encrypted_String) <= 254 * 4 Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Decrypted_String := <b>BlowFishDecryptSegments</b>("Sesame",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Left(Encrypted_String, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, 254 + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 2) + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 3) + 1), "")</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>Else If Len(Encrypted_String) <= 254 * 5 Then</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Decrypted_String := <b>BlowFishDecryptSegments</b>("Sesame",</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Left(Encrypted_String, 254), Mid(Encrypted_String, 254 + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 2) + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 3) + 1, 254),</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'> Mid(Encrypted_String, (254 * 4) + 1))</span></p> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt; color:black'>else Decrypted_String := "Encrypted String is Too Long";</span></p> </div> <p class="MsoNormal" style='margin-left:.25in'><b> </b></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc519529313"></a><a name= "_Toc509669447"></a><a name="_Toc506904411"></a><a name= "_Toc502988851"></a><a name="_Toc502915280"></a><a name= "_Toc502588263"></a><a name="_Toc502587321"></a><a name= "_Toc502510281"></a><a name="_Toc502508675"></a><a name= "_Toc502422928"></a><a name="_Toc502422010"></a><a name= "_Toc502335390"></a><a name="_Toc502334935"></a><a name= "_Toc502315959"></a><a name="_Toc502315741"></a><a name= "_Toc502315653"></a><a name="_Toc502315469"></a><a name= "_Toc501975066"></a><a name="_Toc501974997"></a><a name= "_Toc501974151"></a><a name="_Toc501973431"></a><a name= "_Toc501973340"></a><a name="_Toc501973205"></a><a name= "_Toc501970045"></a><a name="_Toc147821192">Email</a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821193"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>EmailSetOptionsIniFile()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> full path and name of the ini file storing processing options.</p> <p class="MsoNormal" style='margin-left:.25in'> For example: <br /> <b>SetOptionsIniFile</b>("C:\ProgramData\MilletSoftware\VC_11\DataLink_Viewer.ini")</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515; background:white'> "OK"</span> if successful, failure message otherwise.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>You may point to an existing DataLink Viewer.ini file used by Visual CUT or you may first call this function when the ini file doesn't exist yet. If the ini file doesn't exist, the function automatically creates it and all the entries shown below. you can then:<br /> a) use Notepad to update entries, and</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'>b) call <b><span style= 'color:#0070C0'>ufl</span>EmailSaveEncryptedPassword</b>() to encrypt and save the email authentication password (if your SMTP server requires password authentication).</p> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>[Options]</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Default_SMTP_Server=<span style= 'color:red'>???</span></span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SMTP_Port=<span style= 'color:red'>???</span></span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_User_ID=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt; color:#00B050'>// the following entry is set only by calling</span> <b><span style= 'font-size:9.5pt;color:#00B050;background:white'>uflEmailSavePasswordEncrypted</span></b><b><span style='font-size:9.5pt;color:#00B050'>()</span></b></p> <p class="MsoNormal" style='margin-left:.25in'><b><span style= 'font-size:11.0pt; color:#0070C0'>Email_Encrypted_Password_CUT_Light</span></b><span style='font-size:11.0pt'>=</span> <span style='font-size:11.0pt'>E2484C7AB94FD7C525F177D…</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_StartTLS=False</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'> </span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Connect_Timeout=40</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Connect_Retries=4</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Message_Timeout=60</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Failure_Notices_To=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Bounce_Address=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Send_Encrypted=False</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Send_Signed=False</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_Outgoing_Folder=<br /> Email_SMTP_Domain=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SMTP_Disconnect_After_Send=True</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SocksHostname=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SocksPort=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SocksUsername=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SocksPassword=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Email_SocksVersion=</span></p> <p class="MsoNormal" style='margin-left:.25in'><span style= 'font-size:11.0pt'>Check_Email_Addresses=TRUE</span></p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><span style= 'font-size:11.0pt'>Email_POP3_Server=</span></p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal"> </p> <b><span style= 'font-size:12.0pt;font-family:"Times New Roman",serif; color:#0070C0'><br clear="all" style='page-break-before:always' /></span></b> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821194"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>SetEmailSaveEncryptedPassword()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> the unencrypted password.</p> <p class="MsoNormal" style='margin-left:.25in'> For example: <br /> <b>SetEmailSaveEncryptedPassword</b>("MyPassword")</p> <p class="MsoNormal" style='margin-left:.25in'><br /> <u>Returns:</u> <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515; background:white'> "OK"</span> if successful, failure message otherwise.<br /> <br /></p> <p class="MsoNormal">When successful, the encrypted password is saved to the <b>Email_Encrypted_Password_CUT_Light</b> entry in the [Options] section of the ini file established by a prior call to <b>EmailSetOptionsIniFile</b>().</p> <p class="MsoNormal"> </p> <p class="MsoNormal">While you must call <b>EmailSetOptionsIniFile</b>() everytime you wish to send email, you need to call <b>SetEmailSaveEncryptedPassword</b>()only when the password changes.<br /> <br /></p> <p class="MsoNormal"><span style= 'font-size:14.0pt;color:#0070C0'> </span></p> <h2><a name="_Toc147821195"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>EmailSend()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u>Arguments:</u> (FromEmail, ToEmail<span style='background:yellow'>Array</span>, CcEmail<span style='background:yellow'>Array</span>, BccEmail<span style='background:yellow'>Array</span>, ReplyToEmail,<br /> Subject, Message<span style='background:yellow'>Array</span>, Attachment<span style='background:yellow'>Array</span>, Priority, LogFile)<br /> <br /> <u>Returns:</u> <span style= 'font-size:9.5pt;font-family:Consolas;color:#A31515; background:white'> "OK"</span> if successful, failure message otherwise.</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><br /> The <span style='background:yellow'>array</span> arguments allow you to specify multiple email addresses and email attachments.<br /> <br /> LogFile must be the path and file name of an <u>existing</u> text file.<br /> The MessageArray allows you to divide a very long text or HTML message into 254-charcter segments. Here is an example:<br /> <br /></p> </div> <p class="MsoNormal" style='margin-left:.25in'>Local StringVar Message := {@emailMessage};</p> <p class="MsoNormal" style='margin-left:.25in'>local stringvar array MessageArray;</p> <p class="MsoNormal" style='margin-left:.25in'>IF Len(Message) = 0 Then</p> <p class="MsoNormal" style='margin-left:.25in'>(</p> <p class="MsoNormal" style='margin-left:.25in'> redim Messagearray [1];</p> <p class="MsoNormal" style='margin-left:.25in'> MessageArray[1] = "";</p> <p class="MsoNormal" style='margin-left:.25in'>)</p> <p class="MsoNormal" style='margin-left:.25in'>Else</p> <p class="MsoNormal" style='margin-left:.25in'>(</p> <p class="MsoNormal" style='margin-left:.25in'> Local numbervar segments := RoundUp(Len(Message)/254);</p> <p class="MsoNormal" style='margin-left:.25in'> redim Messagearray [segments];</p> <p class="MsoNormal" style='margin-left:.25in'> Local numbervar index ;</p> <p class="MsoNormal" style='margin-left:.25in'> for index := 0 to segments - 1 step 1 do</p> <p class="MsoNormal" style='margin-left:.25in'> (</p> <p class="MsoNormal" style='margin-left:.25in'> MessageArray[index + 1] := mid(Message, 1 + (index * 254) , 254)</p> <p class="MsoNormal" style='margin-left:.25in'> );</p> <p class="MsoNormal" style='margin-left:.25in'>);</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'><br /> </p> <h3><a name="_Toc406134978"></a><a name="_Toc147821196">Full Example</a></h3> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal"> </p> <p class="MsoNormal" style='margin-left:.5in'>Local StringVar Message := {@MyEmailMessage};</p> <p class="MsoNormal" style='margin-left:.5in'>// Convert the message to an array with 254-character text segments</p> <p class="MsoNormal" style='margin-left:.5in'>local stringvar array MessageArray;</p> <p class="MsoNormal" style='margin-left:.5in'>IF Len(Message) = 0 Then</p> <p class="MsoNormal" style='margin-left:.5in'>(redim Messagearray [1];</p> <p class="MsoNormal" style='margin-left:.5in'> MessageArray[1] = "";)</p> <p class="MsoNormal" style='margin-left:.5in'>Else</p> <p class="MsoNormal" style='margin-left:.5in'>( Local numbervar segments := RoundUp(Len(Message)/254);</p> <p class="MsoNormal" style='margin-left:.5in'> redim Messagearray [segments];</p> <p class="MsoNormal" style='margin-left:.5in'> Local numbervar index ;</p> <p class="MsoNormal" style='margin-left:.5in'> for index := 0 to segments - 1 step 1 do</p> <p class="MsoNormal" style='margin-left:.5in'> (MessageArray[index + 1] := mid(Message, 1 + (index * 254) , 254));</p> <p class="MsoNormal" style='margin-left:.5in'>);</p> <p class="MsoNormal" style='margin-left:.5in'>// ------------------------------</p> <p class="MsoNormal" style='margin-left:.5in'>// Point to the ini file where the email options are stored</p> <p class="MsoNormal" style='margin-left:.5in'> uFLEmailSetOptionsIniFile("C:\ProgramData\MilletSoftware\VC_11\DataLink_Viewer.ini");</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>// This is needed (only once) if SMTP server requires a password</p> <p class="MsoNormal" style='margin-left:.5in'> uFLEmailSaveEncryptedPassword("Your Secret Password");</p> <p class="MsoNormal" style='margin-left:.5in'> </p> <p class="MsoNormal" style='margin-left:.5in'>uFLEmailSend("""From Name"" <ido@MilletSoftware.com>",</p> <p class="MsoNormal" style='margin-left:.5in'> """To Name"" <joe@Acme.com>", "", "", "", // to, cc, bcc, ReplyTo</p> <p class="MsoNormal" style='margin-left:.5in'> "My Email Subject", MessageArray, {@Attachments},</p> <p class="MsoNormal" style='margin-left:.5in'> "Normal", // Priority: "Lowest"/"Low"/"Normal"/"High"/"Highest"</p> <p class="MsoNormal" style='margin-left:.5in'> ""); // log file (path & name of an <u>existing</u> text file) if you wish to log email activity</p> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h3><a name="_Toc147821197">Specifying Multiple (Simple/Composite) Email Addresses</a></h3> <p class="MsoNormal">You specify multiple email address destinations in the <b>To</b>, <b>CC</b>, or <b>BCC</b> emailing options, by simply including multiple entries in the array arguments and/or by separating multiple addresses with a <b>semi-colon (</b><b><span style= 'font-size:14.0pt;background:yellow'>;</span>)</b> without any spaces. <br /> You can also specify <u>composite</u> (display name as well as address) email destinations. <br /> For example: <b>"Ido Millet" <ido@MilletSoftware.com></b><b><span style= 'font-size:14.0pt;background:yellow'>;</span>"Jane Doe" <Jane@aol.com></b><br /> <br /> <br /></p> <h3><a name="_Toc147821198"></a><a name= "_Toc406134979"></a><a name="_Ref88136547"></a><a name= "_Ref88136530">Specifying Email Distribution Lists in Text Files</a></h3> <p class="MsoNormal">To facilitate emailing to a long list of recipients, you can specify in the<br /> <b><span style='background:yellow'>To</span></b>, <b><span style= 'background: yellow'>CC</span></b>, and <b><span style= 'background:yellow'>BCC</span></b> emailing options a <b>file name containing a distribution list</b>. <br /> For example, using Notepad you can create a file such as:<br /> <br /> <img border="0" width="345" height="132" id="Picture 14" src= "CUT_Light_NET_User_Manual_files/image039.png" alt= "Title: Email Distribution List - Description: Email Distribution List in a text file." name="Picture 14" /><br /> <br /> You then specify that Visual CUT should use that file as a distribution list by entering<br /> <b><span style='background:yellow'>File:</span><span style= 'background:aqua'>c:\temp\test_email_list.txt</span> <br /> </b> in the <b>To</b>, <b>CC</b>, or <b>BCC</b> emailing options.<br /> <br /> Notes: you use the word "<b>File:</b>" followed by the path & name of the text file containing the email addresses. <b>Each address should be on a separate line</b> and it can be specified as an <b>email address only or as a composite</b> (display name and address) as shown in the example above.<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><a name="_Toc406134983"></a><a name= "_Toc406134980"><b><span style= 'font-size:14.0pt'> </span></b></a></p> <h3><a name="_Toc147821199">Specifying Email Distribution Lists in SQL Queries</a></h3> <p class="MsoNormal">In cases where you wish to dynamically retrieve the list of email addresses using an SQL query against an ODBC data source, you can specify in the <b><span style= 'background:yellow'>To</span></b>, <b><span style= 'background:yellow'>CC</span></b>, and/or <b><span style= 'background: yellow'>BCC</span></b> emailing options an expression such as:<br /> <br /></p> <p class="MsoNormal"><b><u>MS Access</u></b> <u>Example:</u><br /> <span style= 'font-family:"Courier New";background:aqua'>ODBC:</span><span style='font-family:"Courier New"'>Customers<span style='background:yellow'>::</span>User_ID<span style='background:yellow'>::</span>Password<span style='background:yellow'>::</span>SELECT [email] FROM [Contacts] WHERE [Customer_ID] = '{Customer_ID}'</span></p> <p class="MsoNormal"> </p> <p class="MsoNormal"><b><u>SQL Server</u></b> <u>Example:</u></p> <p class="MsoNormal">ODBC:CONTACTS::sa::xxxxx::SELECT DISTINCT AHD.ctct.c_email_addr FROM</p> <p class="MsoNormal">AHD.ctct where AHD.ctct.c_email_addr IS NOT NULL</p> <p class="MsoNormal"> </p> <p class="MsoNormal">The expression starts with <b><span style= 'font-family:"Courier New"; background:aqua'>ODBC:</span></b> followed by 4 elements separated by <span style= 'font-family:"Courier New";background:yellow'>::</span></p> <p class="MsoNormal">1. <b><span style= 'font-family:"Courier New"'>ODBC DSN</span></b> (Note: could be different from the DSN used for the Crystal report)</p> <p class="MsoNormal">2. <b><span style= 'font-family:"Courier New"'>User ID</span></b> (use a single space if not needed)</p> <p class="MsoNormal">3. <b><span style= 'font-family:"Courier New"'>Password</span></b> (use a single space if not needed)</p> <p class="MsoNormal">4. <b><span style= 'font-family:"Courier New"'>SQL Statement</span></b><br /> <br /> <b><u>Notes:</u></b></p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> If the SQL statement returns multiple rows, Visual CUT takes care of concatenating the email addresses from all the rows to a single string with semi-colon as the delimiter.</p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> The SQL statement syntax depends on your database. For example, as shown in the samples above, MS Access uses [ ] around field/table names but SQL Server doesn't.</p> <p class="MsoNormal" style='margin-left:.5in;text-indent:-.25in'> <span style='font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> You can embed dynamic fields/formula values anywhere inside the expression.<br /> In the MS Access example, the list of contacts for the Customer in the current bursting cycle would be retrieved. This offers powerful email distribution management options...<br /> <br /> <br /></p> <h3><a name="_Toc147821200"></a><a name="_Toc406134976">Attaching Multiple Files</a></h3> <p class="MsoNormal">To attach multiple files to a single email message, simply include multiple entries in the AttachmentArray argument or specify multiple files and separate them with a <b>semi-colon (</b><b><span style= 'font-size: 14.0pt;background:yellow'>;</span>) Without any spaces.</b> <br /> <br /> If all files are under the same folder, it's enough to specify the full path only for the 1<sup>st</sup> file. <br /> For example: <b><span style= 'font-family:"Arial",sans-serif'>c:\temp\Sales.pdf;Returns.pdf</span></b><br /> <br /> You can also specify file names using <b>wild cards</b>. <br /> For example, in a bursting scenario, to send all pdf files in the current month folder under the current customer:</p> <p class="MsoNormal"> <b>C:\VC_Exports\{customer.customer_id}\{@Month}\*.pdf</b></p> <p class="MsoNormal">and to send all files that start with the current Customer ID:</p> <p class="MsoNormal"> <b>C:\VC_Exports\{customer.customer_id}*.*</b></p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h3><a name="_Toc147821201">Specifying a Different Character Set</a></h3> <p class="MsoNormal">In order to override the default character set (iso-8859-1) you should add an entry to the [Options] section of DataLink_Viewer.ini. For example, in order to support Chinese characters, you should add the following entry:<br /> <b><span style= 'font-family:"Courier New"'>Email_Char_Set=big5</span></b></p> <p class="MsoNormal"> </p> <h3><a name="_Toc147821202"></a><a name="_Toc406134987">Queuing Emails & The smtpQ Service</a></h3> <p class="MsoNormal">If you are also using Visual CUT, by specifying an outgoing folder (<span style= 'font-size:11.0pt'>Email_Outgoing_Folder</span>) in the ini file, you can direct outgoing email messages (as eml files) to an outgoing folder. For more detail, see the Visual CUT user manual.</p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821203"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>IsValidEmail()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (email address)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u><br /> True if the email address looks valid. False otherwise.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Note: the logic only ensures correct structure and no invalid characters. It doesn't check the domain and doesn't test whether the email address actually exists.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821204"><span style= 'color:#0070C0;font-weight:normal'>ufl</span>IsValidEmails()</a></h2> <p class="MsoNormal" style='margin-left:.25in'><u><br /> Arguments:</u> (email addresses separated by a separator, The separator)<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'> <u>Returns:</u><br /> True if all email addresses looks valid. False otherwise.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in'>Note: the logic only ensures correct structure and no invalid characters. It doesn't check the domain and doesn't test whether the email address actually exists.<br /> <br /> Example: Isvalidemails("<b>ido@MilletSoftware.com<span style= 'background: yellow'>;</span>ixm7@psu.edu</b>", "<b><span style= 'background:yellow'>;</span></b>")</p> <p class="MsoNormal" style='margin-left:.25in'>Returns True<br /> <br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821205"></a><a name= "_Legacy_Functions"></a>Legacy Functions</h1> <p class="MsoNormal"> </p> <p class="MsoNormal">These functions provide substitutes for old UFLs such as <b><i>uflssm.dll</i></b>, <b><i>ufldate.dll</i></b>, and <b><i>uflbtime.dll</i></b>. This allows reports using these functions to run in Crystal 2020 and the 64-bit Crystal runtime.<br /> <br /> The function names are the same as in their legacy UFLs except that in CUT Light they are prefixed with '<b>fl</b>'. You can use Visual CUT to automate the process of replacing the original name with the same name prefixed with fl. See <a href= "https://youtu.be/ZXemfgcVlLA">video demo</a>.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821206"><span style= 'color:#0070C0;font-weight:normal'>fl</span>HoursFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> the <b>hours</b> portion after converting the argument to time.<br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:yellow'>Hours</span>FromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585);</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:yellow'>14</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821207"><span style= 'color:#0070C0;font-weight:normal'>fl</span>MinutesFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> the <b>minutes</b> portion after converting the argument to time.<br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:aqua'>Minutes</span>FromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:aqua'>3</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821208"><span style= 'color:#0070C0;font-weight:normal'>fl</span>SecondsFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> the <b>seconds</b> portion after converting the argument to time.<br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:lime'>Seconds</span>FromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:lime'>5</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821209"><span style= 'color:#0070C0;font-weight:normal'>fl</span>SHHMMFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> string showing the time formatted as <b><span style='background: yellow'>HH</span>:<span style= 'background:aqua'>MM</span></b>.<br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:yellow'>HH</span><span style= 'background:aqua'>MM</span>SecondsFromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:yellow'>02</span>:<span style= 'background:aqua'>03</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821210"><span style= 'color:#0070C0;font-weight:normal'>fl</span>HHMMPMFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> string showing the time formatted as <b><span style='background: yellow'>HH</span>:<span style= 'background:aqua'>MM</span></b> AM/PM<br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:yellow'>HH</span><span style= 'background:aqua'>MM</span>PMSecondsFromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:yellow'>02</span>:<span style= 'background:aqua'>0</span>3 PM</span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821211"><span style= 'color:#0070C0;font-weight:normal'>fl</span>HHMMSSFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> string showing the time formatted as <b><span style='background: yellow'>HH</span>:<span style= 'background:aqua'>MM</span>:<span style= 'background:lime'>SS</span></b><br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:yellow'>HH</span><span style= 'background:aqua'>MM</span><span style= 'background:lime'>SS</span>SecondsFromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:yellow'>02</span>:<span style= 'background:aqua'>0</span>3:<span style= 'background:lime'>05</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'>note: legacy function from <span style='background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821212"><span style= 'color:#0070C0;font-weight:normal'>fl</span>HHMMSSPMFromSecsSinceMidnight()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> SecsSinceMidnight as integer (number of seconds since midnight)<br /> <u>Returns:</u> string showing the time formatted as <b><span style='background: yellow'>HH</span>:<span style= 'background:aqua'>MM</span>:<span style='background:lime'>SS</span> AM/PM</b><br /> Example: <span style= 'font-family:"Courier New";color:blue'>fl<span style= 'background:yellow'>HH</span><span style= 'background:aqua'>MM</span><span style= 'background:lime'>SS</span>SecondsFromSecsSinceMidnight</span><span style='font-family:"Courier New";color:black'>(50585)</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family: "Courier New";color:black'><span style= 'background:yellow'>02</span>:<span style= 'background:aqua'>03</span>:<span style='background:lime'>05</span> PM<br /> note: legacy function from <span style= 'background:lightgrey'>uflssm.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821213"><span style= 'color:#0070C0;font-weight:normal'>fl</span>DayOfYear()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> myDate as Date<br /> <u>Returns:</u> a number representing the <b>day of year</b> (1-366)<br /> Example: <span style= 'font-family:"Courier New";color:blue'>flDayOfYear</span><span style='font-family:"Courier New"'>(<span style='color:blue'>Date</span>(2022,9,14))</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family:"Courier New";color:black'>257<br /> note: legacy function from <span style= 'background:lightgrey'>ufldate.dll</span><br /> <br /></span></p> <h2><a name="_Toc147821214"><span style= 'color:#0070C0;font-weight:normal'>fl</span>WeekOfYear()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> myDate as Date<br /> <u>Returns:</u> the <b>week number</b> as integer<br /> Example: <span style= 'font-family:"Courier New";color:blue'>flWeekOfYear</span><span style='font-family:"Courier New"'>(<span style='color:blue'>Date</span>(2022,9,14))</span> <span style='font-family:Wingdings;color:black'>è</span> <span style='font-family:"Courier New";color:black'>38<br /> note: legacy function from <span style= 'background:lightgrey'>ufldate.dll</span></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'> </span></p> <h2><a name="_Toc147821215"><span style= 'color:#0070C0;font-weight:normal'>fl</span>TIME()</a></h2> <p class="MsoNormal"><u><br /> Arguments:</u> Fraction of a day (24 hours) as a Number<br /> <u>Returns:</u> string showing the time formatted as <b><span style='background: yellow'>HH</span>:<span style= 'background:aqua'>mm</span>:<span style= 'background:lime'>ss</span></b><br /> Example: <span style= 'font-family:"Courier New";color:blue'>flBTIME</span><span style= 'font-family:"Courier New"'>(0.66)</span> <span style= 'font-family:Wingdings; color:black'>è</span> <span style= 'font-family:"Courier New";color:black'><span style= 'background:yellow'>15</span>:<span style= 'background:aqua'>50</span>:<span style= 'background:lime'>24</span><br /> note: legacy Btrieve function from <span style= 'background:lightgrey'>uflbtime.dll</span><br /> <br /></span></p> <p class="MsoNormal"><span style= 'font-family:"Courier New";color:black'><br /> <br /> <br /></span></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:16.0pt;color:maroon'> </span></b></p> <h1><a name="_Toc147821216">Update History</a><a name= "_Toc519529314"></a></h1> <p class="MsoNormal"> </p> <h2><a name="_Toc147821217">Version 6.4.9133 (October 10, 2023):</a></h2> <p class="Bullet2"><span style= 'font-family:Symbol;color:blue'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added a <b>[Center]</b> option to <a href= "start.htm#_uflImageResize()_1">uflImageResize()</a> allowing you to center a proportionally resized image within the specified width & height. This stops Crystal from distorting the image when '<b><i>Can Grow</i></b>' is False.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821218">Version 6.4.9131 (August 6, 2023):</a></h2> <p class="Bullet2"><span style= 'font-family:Symbol;color:blue'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Updated <a href="start.htm#_uflhttpToImage()">uflhttpToImage()</a> to avoid 'Invalid URL' results due to JavaScript errors</p> <p class="Bullet2"><span style= 'font-family:Symbol;color:blue'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added instructions for <a href= "start.htm#_Fixing_'Old_Browser'">Fixing 'Old Browser' error</a> when using <a href= "start.htm#_uflhttpToImage()">uflhttpToImage()</a><br /> <br /></p> <h2><a name="_Toc147821219">Version 6.4.9127 (July 12, 2023):</a></h2> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> Fixed text display for some Application Identifiers (AI codes) in <a href="start.htm#_uflBBarcodeGS1()">uflBBarcodeGS1()</a></p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821220">Version 6.4.9127 (June 23, 2023):</a></h2> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> Added support for doing Conditional Totals of Totals in <a href= "start.htm#_uflTotalofTotals()">uflTotalofTotals()</a></p> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> <span class="MsoHyperlink"><span style= 'color:windowtext; text-decoration:none'>Added</span></span> <a href="start.htm#_uflBBarcodeGS1()">uflBBarcodeGS1()</a> <span class="MsoHyperlink"><span style= 'color:windowtext;text-decoration:none'>to <b>generate GS1-128 barcodes</b>.</span></span></p> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> <span class="MsoHyperlink"><span style= 'color:windowtext; text-decoration:none'>Included sample report for barcodes with no dependency on a database.</span></span></p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflSparkLine()">Sparkline charts</a> <span class="MsoHyperlink"><span style= 'color:windowtext;text-decoration:none'>now better support negative values.</span></span><br /> <br /></p> <h2><a name="_Toc147821221">Version 6.4.9123 (April 8, 2023):</a></h2> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> Fixed a bug and improved performance for <a href= "start.htm#_uflReplaceAccentedChars()">uflReplaceAccentedChars()</a></p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed a bug in sizing of overlay logos on QR Codes.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Updated Excel component.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Optimized performance for several functions.</p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821222">Version 6.4.9117 (November 30, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflImageReorient()">uflImageReorient()</a> function to allow rotating and flipping images.<br /> <br /></p> <h2><a name="_Toc147821223">Version 6.4.9117 (November 30, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added 10 functions from old UFLs such as <b><i>uflssm.dll</i></b>, <b><i>ufldate.dll</i></b>, and <b><i>uflbtime.dll</i></b>. This allows reports using these functions to run in 32-bit as well as 64-bit (e.g. Crystal 2020) applications. See <a href= "start.htm#_Legacy_Functions">Legacy Functions</a></p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Updated an internal component.<br /> <br /></p> <h2><a name="_Toc147821224">Version 6.4.9114 (September 9, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed a bug in <a href= "start.htm#_uflNumberToDate()">uflNumberToDate()</a>.</p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821225">Version 6.4.9112 (July 2, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflJsonGet()">uflJsonGet()</a> function to retrieve JSON content using a specified path.</p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821226">Version 6.4.9106 (May 12, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflPing()">uflPing()</a> function to check access to remote machine.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflSleep()">uflSleep()</a> function to inject a delay (e.g. retry a connection).</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflGoogleTranslate()">Language translation</a> (via Google Translate) now supports 109 languages.<br /> <br /></p> <h2><a name="_Toc147821227">Version 6.4.9105 (April 18, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflDecode2ImageFile()">Decode2ImageFile()</a> to convert Base64 or Hexadecimal content to an image file for dynamic loading into a report (via the 'Graphic Location' expression of a dummy image).</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed a recently introduced bug in uflImageCrop().</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflBulletChart()">uflBulletChart()</a> now supports a <b><i>[ReverseColors]</i></b> option to treat lower numbers as good.<br /> <br /></p> <h2><a name="_Toc147821228">Version 6.4.9103 (March 29, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Improved Trim logic for functions that might return errors longer than 254 characters.<br /> <br /></p> <h2><a name="_Toc147821229">Version 6.4.9102 (February 19, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflFormatValue()">uflFormatValue()</a> to convert Inches or Millimeters to imperial format.<br /> For example, a value of <b>71.6</b> Inches becomes <b>5' 11 5/8"</b><br /> <br /></p> <h2><a name="_Toc147821230">Version 6.4.9101 (February 8, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed a bug in <a href= "start.htm#_uflhttpExists()">uflhttpFileExists</a><span class= "MsoHyperlink">()</span>.</p> <h2><br /> <a name="_Toc147821231">Version 6.4.9098 (January 11, 2022):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added a From/To tokens alternative to <a href= "start.htm#_uflhttpFileParse()">uflhttpFileParse()</a> <span class= "MsoHyperlink"><span style= 'text-decoration:none'>.</span></span></p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821232">Version 6.4.9098 (December 3, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflZatcaEncode()">uflZatcaEncode()</a> to support QR Codes for electronic ZATCA invoices.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added ‘Hex’ encoding options (for string as well as integers) to <a href="start.htm#_uflEncode_()">uflEncode()</a>.<br /> <br /></p> <h2><a name="_Toc147821233">Version 6.4.9095 (October 3, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added 7 functions to support <a href= "start.htm#_Totals_of_Totals">Totals of Totals</a>.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflBBarcodeQR()">uflBBarcodeQR()</a> now support adding a logo.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflBBarcodeQR()">uflBBarcodeQR()</a> now support auto-cropping to avoid padding.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflImageCrop()_1">uflImageCrop()</a> now supports auto-cropping (e.g. <a href= "start.htm#_Removing_Padding">remove padding from QR Barcodes</a>).<br /> <br /></p> <h2><a name="_Toc147821234">Version 6.4.9092 (August 6, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflRegExpIsMatch()">uFLRegExpisMatch()</a>, <a href="start.htm#_uflRegExpMatch()">uFLRegExpMatch()</a> and <a href="start.htm#_uflRegExpReplace()">uflRegExpReplace()</a> now accept as input either a single string or an array of strings. This avoids a string length limitation.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with a newer component.<br /> <br /></p> <h2><a name="_Toc147821235">Version 6.4.9090 (May 17, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflNumberToDate()">uflNumberToDate()</a> function.</p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821236">Version 6.4.9087 (April 23, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflImageResize()">uflImageResize()</a> now supports “[Reorient_EXIF]” option to reorient the image based on embedded EXIF code. </p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflImageResize()">uflImageResize()</a> now handles 0, 0 arguments for width & height to indicate no size change.<br /> <br /></p> <h2><a name="_Toc147821237">Version 6.4.9085 (March 23, 2021):</a></h2> <p class="Bullet2"><span class="MsoHyperlink"><span style= 'font-family:Symbol; color:windowtext;text-decoration:none'>·<span style='font:7.0pt "Times New Roman"'> </span></span></span> Added <a href= "start.htm#_uflImageColorRemap()">uflImageColorRemap()</a> function to change colors in images and barcodes.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflImageResize()">uflImageResize()</a> now supports “[AvoidAntiAliasing]” option.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflEncode_()">uflEncode()</a> now supports “Base64” encoding.</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflDecode_()">uflDecode()</a> to decode Base64 or Hexadecimal content.<br /> <br /></p> <h2><a name="_Toc147821238">Version 6.4.9079 (January 7, 2021):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflhttpFileParse()">uflhttpFileParse()</a> function to extract information from web pages.<br /> <br /></p> <h2><a name="_Toc147821239">Version 6.4.9078 (August 16, 2020):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflFileAddText()">uflFileAddText2()</a> function to provide control over encoding and emitting BOM.<br /> <br /></p> <h2><a name="_Toc147821240">Version 6.4.9077 (July 2, 2020):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> <a href="start.htm#_uflFileAddText()">uflFileAddText()</a> and <a href="start.htm#_uflFileAddTextKey()">uflFileAddTextKey</a> functions can now accept a string array as the text input. This avoids multiple calls when writing very long lines.<br /> <br /></p> <h2><a name="_Toc147821241">Version 6.4.9076 (July 1, 2020):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> uflExecuteSQLNoReturn(), uflSQLNoReturn(), uflSQLReturnValue(), uflExecuteSQLReturnFile(), uflExecuteSQLReturnDelimited(), and uflExecuteSQLReturnDelimitedSegment() functions can now accept a string array for each of their sql1, sql2, sql3, sql4, sql5 arguments. This accommodates extremely long sql statements.<br /> <br /></p> <h2><a name="_Toc147821242">Version 6.4.9074 (May15, 2020):</a></h2> <p class="Bullet2"><span style= 'font-size:14.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with a newer component.<br /> <br /></p> <h2><a name="_Toc147821243">Version 6.4.9072 (April 6, 2020):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflFileAge2()">uflFileAge2()</a> to allow more options for type of age (CreationTime, LastAccessTime, or LastWriteTime).</p> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with several newer components.<br /> <br /></p> <h2><a name="_Toc147821244">Version 6.4.9069 (12/20/2019):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflFile2Image()">uflFile2Image()</a> to allow insertion of PDF files as resized images into reports.<br /> <br /></p> <h2><a name="_Toc147821245">Version 6.4.9068 (11/23/2019):</a></h2> <p class="Bullet2"><span style= 'font-size:14.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflEncode_()">uflEncode()</a> to provide barcode128 encoding functionality<br /> <br /></p> <h2><a name="_Toc147821246">Version 6.4.9067 (5/16/2019):</a></h2> <p class="Bullet2"><span style= 'font-size:14.0pt;font-family:Symbol'>·<span style= 'font:7.0pt "Times New Roman"'> </span></span> To allow dynamic setting of the Google API key, added a new required argument to the <a href= "start.htm#_uflGoogleDrivingTimeDistance()"><b>GoogleDrivingTimeDistance()</b></a> and <a href= "start.htm#_uflGoogleAddress2LatLong()"><b>uFLGoogleGeoAddress2LatLong()</b></a> functions. If you upgrade to this version, and you wish to keep using the ini file entry to set the API key, simply add a blank argument like this:<br /> <b><span style= 'font-size:11.0pt;font-family:"Arial",sans-serif'>uFLGoogleGeoAddress2LatLong</span></b><span style='font-size:11.0pt;font-family:"Arial",sans-serif;color:black'>("5275 Rome Ct, Erie, PA 16509, USA", <span style= 'background:yellow'>""</span>)<br /></span><b><span style= 'font-size:11.0pt;font-family:"Arial",sans-serif'>uFLGoogleDrivingTimeDistance</span></b><span style='font-size:11.0pt;font-family:"Arial",sans-serif;color:black'>(Origin, Destination, "imperial", <span style= 'background:yellow'>"'</span>);</span><br /> <br /></p> <h2><a name="_Toc147821247">Version 6.4.9066 (3/18/2019):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflXlsGetValue()">uflXLSGetValue()</a> and <a href="start.htm#_uflXlsSetValue()">uflXLSSetValue()</a> as enhanced versions of the older uflGetXlsValue and uflSetXLSValue(). These functions allow getting and setting multiple cell values in a single pass. They also allow getting values longer than 254 characters.<br /> <br /></p> <h2><a name="_Toc147821248">Version 6.4.9064 (1/24/2019):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflGetINIValueSegment()">uflGetINIValueSegment()</a> to allow retrieving results longer than 254 characters. It also allows specifying the text to return if the ini entry is not found.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed uflGetINIValue() so it returns "" when entry is found but it has a blank value.<br /> <br /></p> <h2><a name="_Toc147821249">Version 6.4.9061 (1/18/2019):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> The <b>Number2Words()</b> function now has an option to convert a number to Arabic words while expressing the decimal portion as N/100. See <a href= "https://www.screencast.com/t/vlzdavyyi3dU">sample image</a>.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821250">Version 6.4.9059 (9/23/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflINISectionDelete()">uflINISectionDelete()</a> function to delete ini file section.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflBulletChart()"><b>uflBulletChart()</b></a>, <a href= "start.htm#_uflGaugeRadial()"><b>uflGaugeRadial()</b></a>, and <a href="start.htm#_uflSparkLine()"><b>uflSparkline()</b></a> functions to generate Radial Gauge, bullet charts. And Sparklines. See <a href="https://www.screencast.com/t/LQdpunWV0" target= "_blank">image</a>.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href="start.htm#_uflImageCrop_()">uflImageCrop()</a> function. Allows cropping and tight placement of images. See <a href="https://www.screencast.com/t/4MWItrMvs1E4">image</a>.</p> <p class="Bullet2" style='text-indent:0in'> </p> <h2><a name="_Toc147821251">Version 6.4.9043 (7/3/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <a href= "start.htm#_uflKeySetNewItem()">ufl<b>KeySetNewItem</b>()</a> and <a href="start.htm#_uflKeySetClear()">ufl<b>KeySetClear</b>()</a> functions to provide better performance and more control compared to the <a href="start.htm#_uflNewKey()">uflNewKey()</a> function<br /> <br /></p> <h2><a name="_Toc147821252">Version 6.4.9042 (6/25/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added uflGoogleSentiment<b>()</b> function for natural language sentiment analysis.<br /> See <a href="https://www.screencast.com/t/RpMBO8WUBz" target= "_blank">image sample</a>.<br /> <br /></p> <h2><a name="_Toc147821253">Version 6.4.9041 (6/2/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>Number2Words()</b> function to convert a number to Arabic words for a specified currency. See <a href= "https://www.screencast.com/t/RpMBO8WUBz" target="_blank">image sample</a>.<br /> <br /></p> <h2><a name="_Toc147821254">Version 6.4.9040 (5/16/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>SQLReturnValue()</b> and <b>SQLNoReturn()</b> functions with no need for ADODB COM and with support for specifying a long sql statement via a single string argument.</p> <h2><br /> <a name="_Toc147821255">Version 6.4.9038 (4/3/2018):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>CultureInfoName()</b> function to return the computer's locale name (e.g. 'en-US').</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>ImageResize</b>() now saves to image types based on file extension.</p> <p class="Bullet2" style='margin-left:0in;text-indent:0in'> </p> <h2><a name="_Toc147821256">Version 6.4.9037 (2/24/2018):</a></h2> <p class="Bullet2" style='margin-left:0in;text-indent:0in'>Internal changes for optimized performance.<br /> <br /></p> <h2><a name="_Toc147821257">Version 6.4.9036 (10/21/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed handling of Lat/Long pairs as inputs to <b>GoogleDrivingTimeDistance()</b> function.<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h2><a name="_Toc147821258">Version 6.4.9035 (10/21/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> <span style='background:white'>added ufl<b>BB</b>arcode...() versions to all 16 barcode functions. Two key benefits:</span></p> <p class="Itemize2"><span style= 'font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>Simpler to use:</b> because they return the path to the image file. So a single function call in the 'Graphic Location' property of a picture is all you need.</p> <p class="Itemize2"><span style= 'font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>Better Error Handling:</b> CUT Light automatically fits the text (font size & wrapping) of the error message in the image and returns the path to it. So instead of a barcode image, you see an image of the error message. This makes troubleshooting simpler. It also <b>avoids displaying the wrong image</b> (original image used when designing the report).</p> <p class="Bullet2" style='text-indent:0in'>See example of the simplified calls, including one case with an error returned <a href="https://www.screencast.com/t/r9ezr6JAIDa">here</a>.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821259">Version 6.4.9034 (10/18/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>Barcode39</b>(), <b>Barcode93</b>(), <b>Barcode128</b>(),<b>BarcodeCodeBar</b>(), <b>BarcodeITF</b>(), <b>BarcodeMSI</b>(), <b>BarcodePlessey</b>(), <b>BarcodeUpcA</b>(), <b>BarcodeUpcE</b>(), <b>BarcodeUpcEanExtension</b>(), <b>BarcodeEAN8</b>(), <b>BarcodeEAN13</b>() function to generate barcodes of these types on the fly without dependency on font files. See <a href= "https://www.screencast.com/t/ixLKcrXab">example</a>.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b><i>BatchFileRun()</i></b> function allowing <b>triggering BAT or CMD files, with an option to hide the batch file window</b>.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>CmdRun()</b> as well as <b>BatchFileRun()</b> now require a 1-time user permission to trigger such functions. The permission is stored as an entry in the <b><i>CUT_Light_Options.ini</i></b> file.<br /> <br /></p> <h2><a name="_Toc147821260">Version 6.4.9031 (9/15/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with newer component</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed sporadic Google API handshake issue.<br /> <br /></p> <h2><a name="_Toc147821261">Version 6.4.9029 (7/27/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>XLSLookUp()</b> function for fast lookups without needing excel to be installed.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>GoogleAddress2LatLong()</b> function to get the Latitude and Longitude of an address.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>GoogleDrivingTimeDistance()</b> function to get driving time (taking into account current traffic conditions) and distance between two locations specified as addresses or Latitude|Longitude.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed 2 Input Box functions.<br /> <br /></p> <h2><a name="_Toc147821262">Version 6.4.9025 (6/21/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added support for removing the quiet zone around QR Barcode by setting the AddedMargin argument to -1.<br /> <br /></p> <span style= 'font-size:12.0pt;font-family:"Times New Roman",serif'><br clear= "all" style='page-break-before:always' /></span> <p class="MsoNormal"><b><span style= 'font-size:14.0pt'> </span></b></p> <h2><a name="_Toc147821263">Version 6.4.9024 (5/30/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Changed <b>httpToimage()</b> function to<br /> a) also support png and bmp images,<br /> b) support an optional argument of <i>ImageWidth</i> (useful when the web page is responsive and you wish to target a certain width), and<br /> c) support an optional <i>Wait4Load</i> argument specifying waiting time in milliseconds, allowing the web page to fully load before being captured as image.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Optimized <b>httpToimage()</b> and <b>html2image()</b> to reduce memory consumption.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>httpExists()</b> function (treats redirect as failure)</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>FileUnzip()</b> function.<br /> <br /></p> <h2><a name="_Toc147821264">Version 6.4.9019 (4/8/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>IpDot2Long()</b> and <b>IpLong2Dot()</b> functions to convert IP addresses between dot and number representations.<br /> <br /></p> <h2><a name="_Toc147821265">Version 6.4.9018 (2/17/2017):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Implemented code changes to support new deployment to non-standard application location.<br /> <br /></p> <h2><a name="_Toc147821266">Version 6.4.9017 (10/26/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>GoogleTranslate</b>() function, allowing you to translate any amount of text using the paid ($20 for 1 million characters) Google Translate service. This service supports <a href= "https://cloud.google.com/translate/v2/translate-reference#supported_languages"> more than 100 languages</a>.<br /> <br /></p> <h2><a name="_Toc147821267">Version 6.4.9014 (10/17/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added 4 new functions to render 2D barcodes: <b>BarcodeQR</b>(), <b>BarcodePDF417</b>(), <b>BarcodeDataMatrix</b>(), and <b>BarcodeAztec</b>(). You can use these functions to generate barcode images on the fly and load the image into a picture object on the Crystal report using a dynamic Graphic Location expression (see <a href= "http://screencast.com/t/4XXXixwqkN">example</a>).<br /> <br /></p> <h2><a name="_Toc147821268">Version 6.4.9012 (10/11/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Modified setup properties so you can now install both the 32-bit version as well as the 64-bit version on the same computer. This allows you to develop a report using Crystal Designer (32-bit) and test on the same machine using the 64-bit version of DataLink Viewer.<br /> <br /></p> <h2><a name="_Toc147821269">Version 6.4.9011 (9/11/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>HTML2Image</b>() function to overcome limitations with how Crystal interprets HTML. Instead, it converts the HTML to an image so you can then load the image into a picture object using a dynamic Graphic Location expression (see <a href= "http://screencast.com/t/wC5cSbiS5cKu">example</a>).</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>ConvertRTF2Text</b>() function to convert Rich Text to Plain Text (see <a href= "http://screencast.com/t/dmL1w16KHb">example</a>).</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Functions that accept sql1,sql2,sql3,sql4,sql5 arguments no longer insert spaces while combining them into a single SQL statement. This avoids problems when a space should be avoiding. If you need a space, simply include it at the start or end of a segment.<br /> <br /></p> <h2><a name="_Toc147821270">Version 6.4.9009 (8/28/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>httpToImage</b>() function to allow capturing web page as image and bringing it into the report via the Graphic Location expression.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>FileCompare</b>() function to check if the content of 2 files is the same.<br /> <br /></p> <h2><a name="_Toc147821271">Version 6.4.9008 (8/3/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with newer Chilkat component.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821272">Version 6.4.9007 (4/26/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>SecondsToTimeString</b>() function to convert seconds to a formatted time string.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>TimeStringtoSeconds</b>() function to convert a time string to seconds.<br /> <br /></p> <h2><a name="_Toc147821273">Version 6.4.9006 (4/13/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>LookupResetEntries</b>() function to reset all entries previously set via <b>LookupAddEntry</b>() calls. This is useful in cases where a user runs multiple reports without closing the reporting software (Crystal, DataLink Viewer, …) between reports.</p> <p class="MsoNormal"> </p> <h2><a name="_Toc147821274">Version 6.4.9005 (3/19/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>LookupAddEntry()</b> and <b>LookupGetEntry()</b> functions. This allows storing and retrieving Kay-Value pairs in memory (for example, across report/subreport boundaries) without the complexity and 1K rows limitations of array variables.<br /> <br /></p> <h2><a name="_Toc147821275">Version 6.4.9004 (2/24/2016):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>ImageResize()</b>function. This allows creating a resized version of a given image file. The resized version can then be loaded into the report using the Picture location expression.<br /> <br /></p> <h2><a name="_Toc147821276">Version 6.4.9001 (10/12/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>GetTextHeight()</b> and <b>GetTextNumberOfLine()</b> function. These functions provide information about the height and number of lines of wrapped text given the allowed width and the font type, font size, and style.<br /> <br /></p> <h2><a name="_Toc147821277">Version 6.4.8002 (9/26/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>httpCallServiceGetTokens()</b> function to call a web service and return one or more tokens. For example, this can be used to send an SMS message.<br /> <br /></p> <h2><a name="_Toc147821278">Version 6.4.6005 (9/19/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added a 64-bit version of the UFL.<br /> <br /></p> <h2><a name="_Toc147821279">Version 6.4.6001 (8/13/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>SetXLSValue()</b> function to set the value of a spreadsheet cell.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>FileDelete()</b>, <b>FileRename()</b>, and <b>FileCopy()</b> functions.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>CmdRun()</b> function to pass a command line to Cmd.exe<br /> <br /></p> <h2><a name="_Toc147821280">Version 6.4.4001 (8/5/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Fixed a problem causing DistanceByZip(), DistanceByZip5(), and DistanceByUK() to not be available in Crystal formula editor.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Optimized DistanceByZip(), DistanceByZip5(), and DistanceByUK() to be much faster.</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added information for missing USA zip codes.<br /> <br /></p> <h2><a name="_Toc147821281">Version 6.4.2001 (6/4/2015):</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Packaged with a newer Chilkat dll to match the version used by Visual CUT</p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>httpFileDownloadRename()</b> function to return the original file name downloaded from the server and to elect to keep or restore that name to the downloaded file.<br /> <br /></p> <h2><a name="_Toc147821282">Version 6.3.1006 (4/1/2015)</a></h2> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added 3 Regular Expression functions:</p> <p class="Itemize2" style='margin-left:.55in'><span style= 'font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>RegExpReplace</b>() for text replace functionality</p> <p class="Itemize2" style='margin-left:.55in'><span style= 'font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>RegExpMatch</b>() for finding and extracting text that matches a pattern</p> <p class="Itemize2" style='margin-left:.55in'><span style= 'font-family:Wingdings'>§<span style= 'font:7.0pt "Times New Roman"'> </span></span> <b>RegExpIsMatch</b>() for validating that a string matches a pattern<br /> <br /></p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>ConvertRTFFileToText</b>() for converting RTF file to plain text file.<br /> <br /></p> <p class="Bullet2"><span style='font-family:Symbol'>¨<span style= 'font:7.0pt "Times New Roman"'> </span></span> Added <b>ExecuteSQLReturnFile</b>() for retrieving the content of a database column in a specific record, optionally converting the content:<br /> RTF to Plain Text or<br /> Any image type to bmp, png, jpeg, or gif (including an option to convert transparent background to Bitmap with white background), and saving the result to a file.<br /> <br /></p> <p class="Itemize2" style='text-indent:0in'> </p> <h2><a name="_Toc147821283">Version 6.3.1 (1/2/2015): Released .NET version.</a></h2> <p class="MsoNormal"><a name="_Toc59021494"> </a></p> <b><span style= 'font-size:16.0pt;font-family:"Times New Roman",serif; color:maroon'><br clear="all" style='page-break-before:always' /></span></b> <h1><a name="_Toc147821284">Known Issues and Limitation</a></h1> <p class="MsoNormal"> </p> <p class="MsoListParagraph" style= 'margin-left:.25in;text-indent:-.25in'>1.<span style= 'font:7.0pt "Times New Roman"'> </span> Function arguments passed to a UFL should not exceed 254 characters. That is why some of the functions provided by CUT Light allow you to specify array arguments or use several arguments that are internally combined. In other cases, you simply need to chop the string into segments and loop. For example, here is how you can write a large string to a text:</p> <div style= 'border:none;border-bottom:solid windowtext 1.5pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <div style= 'border:none;border-bottom:solid windowtext 1.0pt;padding:0in 0in 1.0pt 0in; margin-left:.25in;margin-right:0in'> <p class="MsoNormal" style='border:none;padding:0in'><b>StringVar MyText := {@LargeText};</b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>StringVar TargetFile := "c:\temp\test.txt";</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#00B050'>// chop and write the text in 254 character segments</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'><b>While Len(MyText) > 254 Do</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> (<br /> <span style='color:#0070C0'>FileAddText</span> (TargetFile, Left(MyText, 254), False, False);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> MyText := Mid(MyText, 255);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b> );</b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#00B050'>// write the remaining small segment</span></b></p> <p class="MsoNormal" style='border:none;padding:0in'> <b><span style='color:#0070C0'>FileAddText</span> (TargetFile, MyText, False, False);</b></p> <p class="MsoNormal" style='border:none;padding:0in'> </p> </div> <p class="MsoNormal" style='margin-left:.25in'> </p> <p class="MsoNormal" style='margin-left:.25in;text-indent:-.25in'> 2.<span style= 'font:7.0pt "Times New Roman"'> </span> In cases where a function accepts array arguments (for example, EmailSend(), you can convert a long string to multiple array elements (each at a maximum of 254 characters. The user manual section about EmailSend() provides an example.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;text-indent:-.25in'> 3.<span style= 'font:7.0pt "Times New Roman"'> </span> A simple preview of a Crystal report may trigger evaluation/formatting of only the 1<sup>st</sup> page.<br /> If you want the Master report to be fully processed upon initial preview (without manually scrolling to the last page), you may need to insert a Special Field such as "Page N of M" to force immediate processing for the whole report.<br /> <br /></p> <p class="MsoNormal" style='margin-left:.25in;text-indent:-.25in'> 4.<span style= 'font:7.0pt "Times New Roman"'> </span> Crystal XI suffers from an issue (ADAPT00755322) leading to a termination of Crystal when running a report that uses dynamic parameters on a machine that also has a UFL installed. If you are using Crystal XI and reports with dynamic parameters, you should not install UFLs until Business Objects resolves this issue.</p> </div>
Contents
Topics
Search
Introduction
Install / Uninstall
Windows & Miscelleneous
uflBatchFileRun()
uflBitWiseAnd()
uflClipboardSetText()
uflCmdRun()
uflCreateGUID()
uflCultureInfoName()
uflEXERun()
uflFormatValue()
uflGetDiskSerialNumber()
uflGetEnvironmentVar()
uflGetMachineIPAddress()
uflGetMachineName()
uflNormDist()
uflGetRegisteredCompanyName()
uflGetUser()
uflNewKey()
Avoiding Duplicate Processing (New Approach)
uflKeySetNewItem()
uflKeySetClear()
uflLookupAddEntry()
uflLookupGetEntry()
uflLookupResetEntries()
uflVisualCutRun()
uflSleep()
Images
uflGetImageProperties()
uflImageResize()
uflImageReorient()
uflImageCrop()
uflImageColorRemap()
Fixing black background in png files
uflFile2Image()
Barcodes
uflBBarcodeQR()
Adding Colors
Adding a Logo
Removing Padding
Using utf-8 as character set
uflZatcaEncode()
uflBBarcodeGS1()
uflBBarcodePDF417()
uflBBarcodeDataMatrix ()
uflBBarcodeAztec()
uflBBarcode39()
uflBBarcode93()
uflBBarcode128()
uflBBarcodeITF()
uflBBarcodeCodeBar()
uflBBarcodeMSI()
uflBBarcodePlessey()
uflBBarcodeUpcA()
uflBBarcodeUpcE()
uflBBarcodeUpcEanExtension()
uflBBarcodeEAN8()
uflBBarcodeEAN13()
Charts
uflBulletChart()
uflGaugeRadial()
uflSparkLine()
String/Text/JSON
uflPopulateTemplate()
uflExpandStringwithEnvironmentVar()
uflReplaceAccentedChars()
uflEncode()
uflDecode()
uflDecode2ImageFile()
uflHex2Ascii()
uflHex2Number()
uflConvertRTF2Text()
uflConvertRTFFileToText()
uflJsonGet()
Regular Expressions
uflRegExpIsMatch()
uflRegExpMatch()
uflRegExpReplace()
File
uflFileAge()
uflFileAge2()
uflFileCompare()
uflFileCopy()
uflFileDelete ()
uflFileExists()
uflFileRename()
uflFileJustName()
uflFileJustPath()
uflFileListFromWildCards()
uflFileUnzip()
uflGetTempFolder()
Text File
uflFileAddText()
uflFileAddText2()
uflFileAddTextKey()
uflLookupText()
uflFileGetText()
uflFileGetTextUTF8()
ini/registry
uflGetINIValue()
uflGetINIValueSegment()
uflSetINIValue()
uflINISectionDelete()
uflGetRegistryString()
GMT/Local and Time-Related
uflGMTtoLocalMinutes()
uflGMTtoLocal()
Evaluating Report Processing Elapsed Time
uflGMTtoZone()
uflSecondsToTimeString()
uflTimeStringToSeconds()
uflNumberToDate()
Message/Input Boxes
uflMessageBoxOK()
uflMessageBoxYesNo()
uflInputBox()
uflInputBox2Command()
Web / HTML / Google / Translate
uflHTMLfile2RTFfile()
uflHTMLstring2RTFFile()
uflHTMLString2Txtfile()
uflhttpFileExists()
uflhttpExists()
uflhttpFileDownload()
uflhttpFileDownloadRename()
uflhttpFileParse()
uflhttpToImage()
Web URL Example
File URL Example
Simple File Path Example
Fixing 'Old Browser' error
uflhttpCallServiceGetTokens()
uflGoogleSentiment()
uflGoogleTranslate()
uflNumber2Arabic()
uflIpDot2Long()
uflIpLong2Dot()
uflPing()
SQL
uflExecuteSQLCanConnect()
uflExecuteSQLNoReturn()
Avoiding Duplicate Processing (old approach)
uflSQLNoReturn()
uflExecuteSQLReturnValue()
Example with a Connection String
uflSQLReturnValue()
uflExecuteSQLReturnFile()
uflExecuteSQLReturnDelimited()
uflExecuteSQLReturnDelimitedSegment()
Totals of Totals
uflTotalStore()
uflTotalLookup()
uflTotalsReset()
uflTotalofTotals()
uflTotalPercentile()
uflTotalRank()
uflTotalNth()
Geo
uflDistance()
uflDistanceByZip5()
uflDistanceByZipUK()
uflDistanceByZip()
uflGetLatLongFromZip()
uflGetLatLongFromZip5()
uflGoogleAddress2LatLong()
uflGoogleDrivingTimeDistance()
Excel
uflGetXLSValue()
uflSetXLSValue()
uflGetXLSOutput()
uflXLSLookUp()
uflXlsGetValue()
uflXlsSetValue()
Font
uflGetTextWidth()
uflGetFontSizeToFitText()
uflGetTextHeight()
uflGetTextNumberOfLines()
Encryption
uflBlowFishEncrypt()
uflBlowFishDecrypt()
uflBlowFishDecryptSegment()
Email
uflEmailSetOptionsIniFile()
uflSetEmailSaveEncryptedPassword()
uflEmailSend()
Full Example
Specifying Multiple (Simple/Composite) Email Addresses
Specifying Email Distribution Lists in Text Files
Specifying Email Distribution Lists in SQL Queries
Attaching Multiple Files
Specifying a Different Character Set
Queuing Emails & The smtpQ Service
uflIsValidEmail()
uflIsValidEmails()
Legacy Functions
flHoursFromSecsSinceMidnight()
flMinutesFromSecsSinceMidnight()
flSecondsFromSecsSinceMidnight()
flSHHMMFromSecsSinceMidnight()
flHHMMPMFromSecsSinceMidnight()
flHHMMSSFromSecsSinceMidnight()
flHHMMSSPMFromSecsSinceMidnight()
flDayOfYear()
flWeekOfYear()
flTIME()
Update History
Version 6.4.9133 (October 10, 2023):
Version 6.4.9131 (August 6, 2023):
Version 6.4.9127 (July 12, 2023):
Version 6.4.9127 (June 23, 2023):
Version 6.4.9123 (April 8, 2023):
Version 6.4.9117 (November 30, 2022):
Version 6.4.9117 (November 30, 2022):
Version 6.4.9114 (September 9, 2022):
Version 6.4.9112 (July 2, 2022):
Version 6.4.9106 (May 12, 2022):
Version 6.4.9105 (April 18, 2022):
Version 6.4.9103 (March 29, 2022):
Version 6.4.9102 (February 19, 2022):
Version 6.4.9101 (February 8, 2022):
Version 6.4.9098 (January 11, 2022):
Version 6.4.9098 (December 3, 2021):
Version 6.4.9095 (October 3, 2021):
Version 6.4.9092 (August 6, 2021):
Version 6.4.9090 (May 17, 2021):
Version 6.4.9087 (April 23, 2021):
Version 6.4.9085 (March 23, 2021):
Version 6.4.9079 (January 7, 2021):
Version 6.4.9078 (August 16, 2020):
Version 6.4.9077 (July 2, 2020):
Version 6.4.9076 (July 1, 2020):
Version 6.4.9074 (May15, 2020):
Version 6.4.9072 (April 6, 2020):
Version 6.4.9069 (12/20/2019):
Version 6.4.9068 (11/23/2019):
Version 6.4.9067 (5/16/2019):
Version 6.4.9066 (3/18/2019):
Version 6.4.9064 (1/24/2019):
Version 6.4.9061 (1/18/2019):
Version 6.4.9059 (9/23/2018):
Version 6.4.9043 (7/3/2018):
Version 6.4.9042 (6/25/2018):
Version 6.4.9041 (6/2/2018):
Version 6.4.9040 (5/16/2018):
Version 6.4.9038 (4/3/2018):
Version 6.4.9037 (2/24/2018):
Version 6.4.9036 (10/21/2017):
Version 6.4.9035 (10/21/2017):
Version 6.4.9034 (10/18/2017):
Version 6.4.9031 (9/15/2017):
Version 6.4.9029 (7/27/2017):
Version 6.4.9025 (6/21/2017):
Version 6.4.9024 (5/30/2017):
Version 6.4.9019 (4/8/2017):
Version 6.4.9018 (2/17/2017):
Version 6.4.9017 (10/26/2016):
Version 6.4.9014 (10/17/2016):
Version 6.4.9012 (10/11/2016):
Version 6.4.9011 (9/11/2016):
Version 6.4.9009 (8/28/2016):
Version 6.4.9008 (8/3/2016):
Version 6.4.9007 (4/26/2016):
Version 6.4.9006 (4/13/2016):
Version 6.4.9005 (3/19/2016):
Version 6.4.9004 (2/24/2016):
Version 6.4.9001 (10/12/2015):
Version 6.4.8002 (9/26/2015):
Version 6.4.6005 (9/19/2015):
Version 6.4.6001 (8/13/2015):
Version 6.4.4001 (8/5/2015):
Version 6.4.2001 (6/4/2015):
Version 6.3.1006 (4/1/2015)
Version 6.3.1 (1/2/2015): Released .NET version.
Known Issues and Limitation
Adding a Logo
Adding Colors
Attaching Multiple Files
Avoiding Duplicate Processing (New Approach)
Avoiding Duplicate Processing (old approach)
Barcodes
Charts
Email
Encryption
Evaluating Report Processing Elapsed Time
Example with a Connection String
Excel
File
File URL Example
Fixing 'Old Browser' error
Fixing black background in png files
flDayOfYear()
flHHMMPMFromSecsSinceMidnight()
flHHMMSSFromSecsSinceMidnight()
flHHMMSSPMFromSecsSinceMidnight()
flHoursFromSecsSinceMidnight()
flMinutesFromSecsSinceMidnight()
flSecondsFromSecsSinceMidnight()
flSHHMMFromSecsSinceMidnight()
flTIME()
flWeekOfYear()
Font
Full Example
Geo
GMT/Local and Time-Related
Images
ini/registry
Install / Uninstall
Introduction
Known Issues and Limitation
Legacy Functions
Message/Input Boxes
Queuing Emails & The smtpQ Service
Regular Expressions
Removing Padding
Simple File Path Example
Specifying a Different Character Set
Specifying Email Distribution Lists in Text Files
Specifying Email Distribution Lists in SQL Queries
Specifying Multiple (Simple/Composite) Email Addresses
SQL
String/Text/JSON
Text File
Totals of Totals
uflBatchFileRun()
uflBBarcode128()
uflBBarcode39()
uflBBarcode93()
uflBBarcodeAztec()
uflBBarcodeCodeBar()
uflBBarcodeDataMatrix ()
uflBBarcodeEAN13()
uflBBarcodeEAN8()
uflBBarcodeGS1()
uflBBarcodeITF()
uflBBarcodeMSI()
uflBBarcodePDF417()
uflBBarcodePlessey()
uflBBarcodeQR()
uflBBarcodeUpcA()
uflBBarcodeUpcE()
uflBBarcodeUpcEanExtension()
uflBitWiseAnd()
uflBlowFishDecrypt()
uflBlowFishDecryptSegment()
uflBlowFishEncrypt()
uflBulletChart()
uflClipboardSetText()
uflCmdRun()
uflConvertRTF2Text()
uflConvertRTFFileToText()
uflCreateGUID()
uflCultureInfoName()
uflDecode()
uflDecode2ImageFile()
uflDistance()
uflDistanceByZip()
uflDistanceByZip5()
uflDistanceByZipUK()
uflEmailSend()
uflEmailSetOptionsIniFile()
uflEncode()
uflExecuteSQLCanConnect()
uflExecuteSQLNoReturn()
uflExecuteSQLReturnDelimited()
uflExecuteSQLReturnDelimitedSegment()
uflExecuteSQLReturnFile()
uflExecuteSQLReturnValue()
uflEXERun()
uflExpandStringwithEnvironmentVar()
uflFile2Image()
uflFileAddText()
uflFileAddText2()
uflFileAddTextKey()
uflFileAge()
uflFileAge2()
uflFileCompare()
uflFileCopy()
uflFileDelete ()
uflFileExists()
uflFileGetText()
uflFileGetTextUTF8()
uflFileJustName()
uflFileJustPath()
uflFileListFromWildCards()
uflFileRename()
uflFileUnzip()
uflFormatValue()
uflGaugeRadial()
uflGetDiskSerialNumber()
uflGetEnvironmentVar()
uflGetFontSizeToFitText()
uflGetImageProperties()
uflGetINIValue()
uflGetINIValueSegment()
uflGetLatLongFromZip()
uflGetLatLongFromZip5()
uflGetMachineIPAddress()
uflGetMachineName()
uflGetRegisteredCompanyName()
uflGetRegistryString()
uflGetTempFolder()
uflGetTextHeight()
uflGetTextNumberOfLines()
uflGetTextWidth()
uflGetUser()
uflGetXLSOutput()
uflGetXLSValue()
uflGMTtoLocal()
uflGMTtoLocalMinutes()
uflGMTtoZone()
uflGoogleAddress2LatLong()
uflGoogleDrivingTimeDistance()
uflGoogleSentiment()
uflGoogleTranslate()
uflHex2Ascii()
uflHex2Number()
uflHTMLfile2RTFfile()
uflHTMLstring2RTFFile()
uflHTMLString2Txtfile()
uflhttpCallServiceGetTokens()
uflhttpExists()
uflhttpFileDownload()
uflhttpFileDownloadRename()
uflhttpFileExists()
uflhttpFileParse()
uflhttpToImage()
uflImageColorRemap()
uflImageCrop()
uflImageReorient()
uflImageResize()
uflINISectionDelete()
uflInputBox()
uflInputBox2Command()
uflIpDot2Long()
uflIpLong2Dot()
uflIsValidEmail()
uflIsValidEmails()
uflJsonGet()
uflKeySetClear()
uflKeySetNewItem()
uflLookupAddEntry()
uflLookupGetEntry()
uflLookupResetEntries()
uflLookupText()
uflMessageBoxOK()
uflMessageBoxYesNo()
uflNewKey()
uflNormDist()
uflNumber2Arabic()
uflNumberToDate()
uflPing()
uflPopulateTemplate()
uflRegExpIsMatch()
uflRegExpMatch()
uflRegExpReplace()
uflReplaceAccentedChars()
uflSecondsToTimeString()
uflSetEmailSaveEncryptedPassword()
uflSetINIValue()
uflSetXLSValue()
uflSleep()
uflSparkLine()
uflSQLNoReturn()
uflSQLReturnValue()
uflTimeStringToSeconds()
uflTotalLookup()
uflTotalNth()
uflTotalofTotals()
uflTotalPercentile()
uflTotalRank()
uflTotalsReset()
uflTotalStore()
uflVisualCutRun()
uflXlsGetValue()
uflXLSLookUp()
uflXlsSetValue()
uflZatcaEncode()
Update History
Using utf-8 as character set
Version 6.3.1006 (4/1/2015)
Version 6.3.1 (1/2/2015): Released .NET version.
Version 6.4.2001 (6/4/2015):
Version 6.4.4001 (8/5/2015):
Version 6.4.6001 (8/13/2015):
Version 6.4.6005 (9/19/2015):
Version 6.4.8002 (9/26/2015):
Version 6.4.9001 (10/12/2015):
Version 6.4.9004 (2/24/2016):
Version 6.4.9005 (3/19/2016):
Version 6.4.9006 (4/13/2016):
Version 6.4.9007 (4/26/2016):
Version 6.4.9008 (8/3/2016):
Version 6.4.9009 (8/28/2016):
Version 6.4.9011 (9/11/2016):
Version 6.4.9012 (10/11/2016):
Version 6.4.9014 (10/17/2016):
Version 6.4.9017 (10/26/2016):
Version 6.4.9018 (2/17/2017):
Version 6.4.9019 (4/8/2017):
Version 6.4.9024 (5/30/2017):
Version 6.4.9025 (6/21/2017):
Version 6.4.9029 (7/27/2017):
Version 6.4.9031 (9/15/2017):
Version 6.4.9034 (10/18/2017):
Version 6.4.9035 (10/21/2017):
Version 6.4.9036 (10/21/2017):
Version 6.4.9037 (2/24/2018):
Version 6.4.9038 (4/3/2018):
Version 6.4.9040 (5/16/2018):
Version 6.4.9041 (6/2/2018):
Version 6.4.9042 (6/25/2018):
Version 6.4.9043 (7/3/2018):
Version 6.4.9059 (9/23/2018):
Version 6.4.9061 (1/18/2019):
Version 6.4.9064 (1/24/2019):
Version 6.4.9066 (3/18/2019):
Version 6.4.9067 (5/16/2019):
Version 6.4.9068 (11/23/2019):
Version 6.4.9069 (12/20/2019):
Version 6.4.9072 (April 6, 2020):
Version 6.4.9074 (May15, 2020):
Version 6.4.9076 (July 1, 2020):
Version 6.4.9077 (July 2, 2020):
Version 6.4.9078 (August 16, 2020):
Version 6.4.9079 (January 7, 2021):
Version 6.4.9085 (March 23, 2021):
Version 6.4.9087 (April 23, 2021):
Version 6.4.9090 (May 17, 2021):
Version 6.4.9092 (August 6, 2021):
Version 6.4.9095 (October 3, 2021):
Version 6.4.9098 (December 3, 2021):
Version 6.4.9098 (January 11, 2022):
Version 6.4.9101 (February 8, 2022):
Version 6.4.9102 (February 19, 2022):
Version 6.4.9103 (March 29, 2022):
Version 6.4.9105 (April 18, 2022):
Version 6.4.9106 (May 12, 2022):
Version 6.4.9112 (July 2, 2022):
Version 6.4.9114 (September 9, 2022):
Version 6.4.9117 (November 30, 2022):
Version 6.4.9117 (November 30, 2022):
Version 6.4.9123 (April 8, 2023):
Version 6.4.9127 (July 12, 2023):
Version 6.4.9127 (June 23, 2023):
Version 6.4.9131 (August 6, 2023):
Version 6.4.9133 (October 10, 2023):
Web / HTML / Google / Translate
Web URL Example
Windows & Miscelleneous
CUT Light (Crystal Reports User Function Library) by
Millet Software
CUT Light (Crystal Reports User Function Library) by
Millet Software