X3 Utilities
Web sites
Function
Press the F7 key and the name of GESAYS (function):Web sites
Description
This a setup function of the XTEND site.
These are a few examples of elements that can be parameterized:
- Give access to the site (to publish),
- Put it in maintenance or not,
- Define the list of languages,
- Activate tracking and debugging tools, among others
- ...
Select the work site
Function
Press the F7 key and the name of AYTCHGFCYW (function):Current site selection
Description
It is mandatory to select the work or current site in order to start XTEND setup.
All setup functions refer to the work site.
The function displays the list of existing XTEND sites.
The current selection is saved in X3 user preferences
Website visualization
Function
Press the F7 key and the name of VISUAYS (function):Website visualization
Description
The current site must be already selected.
The site can also be visualized via the function GESAYG : Web pages. On the AHOME page, choose the upper menu: Tools / View web page.
The AHOME page executes in an X3 window. If the user clicks on the icon on top, the page opens in the default web browser.
Use
Function
Press the F7 key and the name of CONSAYU (function):Usage
Description
Displays the list of XTEND setup records selected by type
For each record, it displays the list of setup records that refer to this record.
For instance:
A field can be referenced by an entity that can itself be referenced by a block that can be referenced by a page.
Each level (maximum of 3) uses 3 columns to display the code, the type (Niv.#-Type) and the description of the record.
Use
This is a useful function to:
- Spot the differences between XTEND parameters
- Perform grouped copies of parameters to another site
- Perform grouped deletions.
Website confirmation
Function
Press the F7 key and the name of AYTFCYGEN: Web site confirmation
Description
Confirms selected elements of an XTEND site: update of the XML dictionary and display of a report.
Verification
If an interface is associated with the record, the consistency between the data and the parameters of the Web services is checked.
Recommendations
During the development phase, it is recommended to regularly validate all the site elements.
The element validation errors are displayed in red in the report.
The validation generates a new XML dictionary of XTEND parameters.
The new dictionary is only automatically taken into account on reload/F5 of the HTML page in the browser if the option of the setup record of the site 'Technique\Check updates\Web dictionary' is checked.
If the option is not activated, the reloading of the dictionary needs to be forced using the following url:
'http://hostname:port/xtend/svc/SolutionX3/DossierX3/SiteXtend/admin/reposit/reload'
Website copy
Function
Press the F7 key and the name of AYTFCYCOP (function):Website duplication
Description
Used to copy (by replacement) all the parameters and/or HTML design of an XTEND site (Origin) to a destination site in the (default) current folder or any other folder.
For instance:
Copy of a site in the development environment to the production environment.
Restrictions
This function does not copy the Web services used by the site.
Refer to the 'Copy of Web services' function.
Web service copy
Function
Press the F7 key and the name of AYTWSRGES (function):Copying Web service
Description
This function is used to select one or several interfaces off an XTEND site belonging to the current X3 folder, and to copy/publish the associated Web services to another folder.
In order to activate the copy, at least one interface from the list needs to be selected.
Copy of a sub-program:
- Copy of a 4GL processing Web service
- Creation of the 'sub-program' record
- Publishing the Web service
Copy of an X3 object Web service
- Publishing the Web service
Field creation help
Function
This function can be accessed via the tools menu of the setup records
Description
This function is used to create the field tokens from:
- the field list of an X3 Table
- the field list of an X3 View
- the setups of the Web service associated with an interface
Screen
Column | Description |
Parameter | Code of the table field or Web service parameter |
Title | Field description |
Field Token | XTEND code for the setup (same code by default) |
Present | Selected if this field is already present in the dictionary |
Type | Field type (XTEND) |
Menu | Menu identifier for the type Local Menu |
Dimension | Maximum number of setup or field values |
Generation | For fields of dimension superior to 1, indicates if it is necessary to generate an index (FIELDNAME + INDEX). |
Index | Field index for name calculation |
Validate the fields after generation so that the XTEND server takes them into account.
The validation generates a new XML dictionary of XTEND parameters.
The new dictionary is only automatically taken into account on reload/F5 of the HTML page in the browser if the option of the setup record of the site 'Technique\Check updates\Web dictionary' is selected.
If it is not selected, it is necessary to force the reloading of the dictionary using the following url:
'http://hostname:port/xtend/svc/SolutionX3/DossierX3/SiteXtend/admin/reposit/reload'
Entity creation help
Function
'Tools/Replenishment help' of the 'Entity' record
Description
This function creates entities from an interface parameters.
1. Open the Entity function
2. Create a new Entity
3. Select the interface type
- For the 'Access table' type, select the interface that will be assigned to the entity
4. Activate the menu 'Tools/Entry help'.
After the selection of the interface, the list of parameters grouped by publication group is displayed.
Screen
Column | Description |
Interface setups | Web service setup code |
Group | Publication group (sub-program) or block code (object) |
Title | Field title for X3 Objects |
Field Token | XTEND field token code. |
Title | XTEND field title |
An EXTEND entity is usually associated with a publication group (Group column) that represents a screen block for an X3 object).
The creation operation consists in selecting the fields by double clicking on the first column and selection a field token in the "Field token" column.
Recommendations
It is advised to create all XTEND field previously via the utility function "Field creation".
If the field does not exist, the "Field token" cannot be accessed by tunnel to create it.
Website deletion
Function
Press the F7 key and the name of AYTFCYDEL (function):Web site deletion
Action
Used to delete the HTML designs and/or the setup of an XTEND site.
Restrictions
Web services are not deleted because they can be used by other sites.
They must be deleted manually via the function GESAWE:Web service
Design/archive management
Function
Press the F7 key and the name of AYTFCYTAR (function):Design/archive management
Description
This function is used to create/restore/delete an archive (.tar file) containing the HTML design of an XTEND site.
This is a very useful function to copy/restore the HTML design of an XTEND site to another location or another X3 folder.
Advanced setup
Function
Press the F7 key and the name of GESAYU (function):Advanced setup
Description
This function displays the parameters that cannot be reached via the setup records.
This function is used for the application of XTEND server's patches
Generation of lists of values
Function
Press the F7 key and the name of PRHBATCH (function):Generation of lists of values
Description
This function generated value lists of currencies and countries based on tables TABCUR et TABLAN.
It is used as an example for the generation of lists of value via batch.