• Web Application Functions
• Web Application Security Functions
• Web Application Server Functions
• Web Application Component Functions
• a5_check_throttle_file Function
• a5_get_webfile Function
• a5_getapplicationdatafolder Function
• a5_getinstallationapplicationdatafolder Function
• a5_loadapplicationdata Function
• a5_run_async_xbasic Function
• a5_webprojectfile Function
• a5_webprojectget Function
• a5_webprojectpath Function
• a5_webprojectslist Function
• a5_websharedresourcepath Function
• a5_wf_style_builder Function
• a5_wf_style_names Function
• a5_wfse Function
• A5_xb_runGenericComponent Function
• A5_xb_runGridComponent Function
• a5AjaxChunkedResponseWrite Function
• a5w_analyzeWebAccessLogs Function
• a5w_getExtendedUserInfo Function
• a5w_saveToExtendedUserInfo Function
• a5wcb_createframelayoutarray Function
• a5wcb_extendedUserInfoTableFields Function
• a5wcb_friendlyname_decode Function
• a5wcb_friendlyname_encode Function
• a5wcb_getextauthproviders Function
• a5wcb_getprojectfmname Function
• a5wcb_linkfilterbuildercs Function
• a5wcb_prompthighordertext Function
• a5wcb_promptstatictext Function
• a5wcb_removejavascriptcomments Function
• a5wcb_removejavascriptevents Function
• a5wcb_replace_comp_style Function
• a5wcb_tabtemplateajax Function
• a5wcb_ux_register_userdefined_control Function
• compile_Xbasic_function_library Function
• currentgridfilter Function
• currentgridorder Function
• currentlistfilter Function
• currentlistorder Function
• loadClass Function
• require Function

A5_xb_runGenericComponent Function

Syntax

Arguments

inputPropsPointer

Defines the Component to run and various properties of the Component. This object can have the following properties:

inputProps.componentNameCharacter

Name of the UX, PageLayout or Custom component to run.

inputProps.aliasCharacter

Alias for the component

inputProps.divCharacter

(Optional when function is called from an A5 code block). The ID of the div where the component should be rendered. If the a5_xb_runGenericComponent() function is in an <%a5..%> code block and you omit this property, the component is shown inline.

inputProps.panelRootIdCharacter

(Optional) If the target component is a UX component that uses Panels, you can specify the ID of a element into which the Panels are inserted. If this property is not specified, the Panels are inserted in the BODY tag. If you want the Panels to be inside an element (such as another Panel Card, or a Window), you should set this property to the ID of the container (e.g. Window or Panel Card).

inputProps.settingsPointer

Additional settings for the Component specific to the type of Component being run.

inputProps.settings.__parentComponentAliasCharacter

(Optional) The alias of the parent component. If the parent is a Grid, you can typically set to '{grid.componentName}'. If the parent is a UX, set to '{dialog.componentName}'. If this property is not set the {dialog.object}.getParentObject() method (called from this UX) will fail.

inputProps.settings.__argumentValuesCharacter

If the component has any arguments, set the value of the arguments. The property is a CR-LF delimited string. The syntax for each line in the string is:

Example

argumentName=argumentValue

For example:

inputProps.__argumentValues = <<%str%
arg1=John
arg2=Smith
%str%

inputProps.settings.__overrideSettingsCharacter

(Optional) A CR-LF delimited string that allows you to override settings in the component. This string can be used to override many properties in the component. It is typically used to set the style of the component to match the style of the parent component.

inputProps.settings.__populateDialogLogical

UX Component Only

(Optional) If the UX component that you are loading has been bound to database tables, then you can populate the controls in the UX with data. Set this property to .T. if you want to populate the controls. If this property is .T., then you must set the inputProps.settings.__PKValue property.

inputProps.settings.__PKValueCharacter

UX Component Only

The primary key value of the record you want to retrieve to populate the UX component with. If the primary key is multi-column, specify the key as a single value with each segment delimited with 3 pipes. For example:

Example

john|||smith

Description

Generates the HTML and Javascript for a UX, PageLayout or Custom component.

Examples

In the following example the a5_xb_runGenericComponent() function is run in a <%a5..%> code block.

The example runs two UX components. The first UX component ('Mysql_customer_embedded') has been bound to a table and the UX is populated with data from that table, showing the data from the record with a primary key value of '10'.

The second UX component ('UX_arguments') has two arguments, 'arg1' and 'arg2'. The values for these arguments is defined by setting the settings.__argumentValues property.

<p>This is a free-form HTML container with an a5 code block.</p>

<%a5
    dim p as p
    p.componentName = "Mysql_customer_embedded"
    p.alias = "MYDLG"
    p.settings.__populateDialog = .t.
    p.settings.__PKValue = 10
    dim xb as c
    xb = a5_XB_RunGenericComponent(p)
    ?xb
%>

<p>This is another UX component....</p>

<%a5
    dim p2 as p
    p2.componentName = "UX_arguments"
    p2.alias = "MYDLG2"
    p2.settings.__parentComponentAlias = "{dialog.componentname}"
    p2.settings.__argumentValues = <<%str%
        arg1=John
        arg2=Smith
    %str%
    p2.settings.__overrideSettings = "style_name = " + s_quote("{dialog.style}")
    dim xb2 as c
    xb2 = a5_XB_RunGenericComponent(p2)
    ?xb2

%>