Virtual Structure Component
Fnd_VS_CreateNameLists
Fnd_VS_CreateNameLists
Parameters
| Parameter | Type | Description |
|---|---|---|
| No parameters required |
Description
This routine will create a set of 4D lists that can be used by the virtual structure routines. This routine is called from Foundation’s developer menu. After calling this method, you will see a confirmation dialog: Click the Continue button, and a dialog will ask you to enter a two-character language code for the new lists: Enter the language code of your choice, and then Foundation will generate a 4D list for each table in the database. The lists will be named VS_Table001_XX, VS_Table002_XX, VS_Table003_XX, etc. The “XX” will actually be the code you entered in the dialog. The numeric part of the name represents the table number in the structure. So VS_Table001_XX contains the table and field names for the first table, the list named VS_Table002_XX contains the table and field names for the second table, and so on. By referencing the list names by number rather than by name, you can safely change the name of a 4D table without affecting these lists. Once the lists are created, you can edit any of the table or field names by editing the lists using the 4D List editor. Then, add a call to the Fnd_VS_UseNameLists method in your startup routine. This will cause the modified table and field names to be used by the other routines in this component. The new names will also be passed to 4D’s SET TABLE TITLES and SET FIELD TITLES commands, so the new names will be used in the 4D editors. When you add new tables or fields to the structure, you can call this command again to update these lists. Your existing changes will not be touched, so it is safe to run this command at any time. The routine will only add missing table or field names. You can safely delete any of these lists - if they are not found when the Fnd_VS_UseNameLists method is called, then the actual 4D list names will be used instead.
Extracted source text
Fnd_VS_CreateNameLists
Parameter Type Description
No parameters required.
This routine will create a set of 4D lists that can be used by the virtual structure routines. This routine is
called from Foundation’s developer menu.
After calling this method, you will see a confirmation dialog:
Click the Continue button, and a dialog will ask you to enter a two-character language code for the new
lists:
Enter the language code of your choice, and then Foundation will generate a 4D list for each table in
the database. The lists will be named VS_Table001_XX, VS_Table002_XX, VS_Table003_XX, etc. The
“XX” will actually be the code you entered in the dialog. The numeric part of the name represents the
table number in the structure. So VS_Table001_XX contains the table and field names for the first table,
the list named VS_Table002_XX contains the table and field names for the second table, and so on. By
referencing the list names by number rather than by name, you can safely change the name of a 4D table
without affecting these lists.
Once the lists are created, you can edit any of the table or field names by editing the lists using the 4D
List editor. Then, add a call to the Fnd_VS_UseNameLists method in your startup routine. This will
cause the modified table and field names to be used by the other routines in this component. The new
names will also be passed to 4D’s SET TABLE TITLES and SET FIELD TITLES commands, so the
new names will be used in the 4D editors.
When you add new tables or fields to the structure, you can call this command again to update these
lists. Your existing changes will not be touched, so it is safe to run this command at any time. The
routine will only add missing table or field names.
You can safely delete any of these lists - if they are not found when the Fnd_VS_UseNameLists
method is called, then the actual 4D list names will be used instead.