ASNA WingsRPG™ Reference Manual |
Import Display Files Dialog
The following are entries that need to be completed to import Display Files.
Legacy source location | Description |
---|---|
Use login credentials |
Select this option if you do not have a "database name" associated with the IBM i where the Display Files are located. |
Server |
The IP resource name associated with the IBM i where the Display Files are located. |
User |
The IBM i login user name. |
Password |
The IBM i login password. |
Port |
The TCP/IP port used by DataGate 400 service. If you don't know the port number, use "5047". |
Use Database Name |
Select this option if you have a "database name" associated with the IBM i where the Display Files are located. |
Database |
The DataGate "database name" that defines the IBM i connection credentials. |
Library |
The IBM i library where the source member is located. |
File |
The IBM i file name where the source member is located. |
Use Regular expressions checkbox |
Check this option if you want to enter a regular expression pattern instead of the member name to process batch import. |
Member |
The group of members to convert, either typed in manually, selected using the wildcards described below, or, if the "Use Regular expressions" option is checked, the regular expression to be used to process in batch. |
Browse member button (...) |
Press the button labeled "..." to request a dialog box where you can select the member out of the available members in the database, library and file location indicated above. See Browse Member Button (...) |
Import options |
|
File field-reference library list |
The library-list to be used while resolving field-references. If no field-references are used in the DDS description, you can leave this entry blank, otherwise enter a space-separated list of IBM i libraries. |
Language |
Select from the list the .NET programming language used when the Wings website was created. Valid languages are: Visual RPG, C# and Visual Basic. |
Web page name |
The ASPX filename to be used for the imported display file. If you want the same name as the member name, you can leave this entry blank. |
Same as source member checkbox |
Check this option if you want to to keep the member name as the name of the ASPX file to be created. The new file will always have the extension "aspx". |
Namespace |
The .NET to be used when writing code-besides. |
Advanced (...) |
Press the button labeled "Advanced ..." to configure more options. |
Advanced options |
|
Grid Settings: | |
Horizontal Spacing |
Enter the numbers of pixels for the character cell's width.
The absolute horizontal position for any field would be this measurement multiplied by the column position on the DDS record.
|
Vertical Spacing |
Enter the numbers of pixels for the character cell's height. |
Misc: | |
Write Code Behind Errors |
Unsupported DDS Keywords (critcal or not) are always reported on the Visual Studio Output window. This listing is cleared when Visual Studio closes (or when the user requests it be cleared). However, you can control when and how errors are reported in the ASPX code behind. For each level of error severity, you can specify: Ignore – Do not report in code behind. Issue as Comment – The error message will appear only as a comment. Issue as Error – The Error message will appear in the compiler output as an error and the build will fail. Hint – You can review and change the message file used by Wing Design Aid: DDS.MIGRATION.MSGFILE. By default, it is located at "C:\Program Files (x86)\Microsoft Visual Studio\2019\[Visual Studio Version]\ Common7\IDE\Extensions\ASNA\Monarch Wings Design Aid\10.0" The severity and/or text of the message can be modified. Be aware that the file may be automatically replaced whenever a Wings Design Aid upgrade is installed. |
Monarch: | |
Default Template Folder |
When ASNA Wings (or ASNA Monarch Cocoon) is installed, a folder is created with templates to be used as patterns
for the generation of the ASPX or Code-behind files. If you want to modify the templates, it is best to copy
the files you wish to change to a different folder, and configure this folder as the
"User Template Folder" as explained below.
|
Display Size |
This specifies which display size condition to evaluate during the DDS conversion. Supported values are *DS3 and *DS4. For more details see the Display Size topic. |
Labels to Discard |
You may enter a space-delimited list of rows that should be ignored during the import process. |
User Template Folder |
Overrides template files used during the import process. Any template required by the import process will be searched in this folder first, and, if not found, will continue looking in the "Default Template Folder" (see description above). |
The Import DDS dialog supports two distinct wildcards as well as regular expressions, allowing users much greater flexibility in searching for and selecting the desired files. The wildcards and some examples of how they work are described in the tables below, to learn more about regular expressions (a more advanced syntax for text searching) visit Regular-Expressions.info or the regular expressions guide at Zytrax.com.
Character | Meaning | Regular Expression Equivalent |
---|---|---|
* (asterisk symbol) |
Zero or more characters in that position |
(.*) |
? (question mark symbol) |
Any character in that position. (A single character.) |
(.) |
Expression | Description | Matches |
---|---|---|
Mac* |
Names beginning with "Mac" | Mac MacIntosh Mackenzie |
J*n | Names starting with "J" and ending with "n" | Jon Johnson Jason Juan |
*son | Names ending with "son" | Johnson Jason Son Anderson |
*sam* | Names with "sam" anywhere in the string | Sam Samson Grossam |
Mac? | Names exactly four character long, the first three being "Mac" | Mack Macks |
?dam | Names exactly four character long, the last three being "dam" | Adam Odam |
*s?n | Names containing "s" and "n" at the end of the value with any one character between them and any number of characters before the "s". | Anderson Andersen Jackson san sun |
For more information describing the Import process see Importing Display File Process.