Virtual Structure Component

Fnd_VS_CreateNameLists

Fnd_VS_CreateNameLists

Legacy manual page 255

Parameters

ParameterTypeDescription
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.