• 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_runGridComponent Function

Syntax

Arguments

inputPropsPointer

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

inputProps.gridNameCharacter

Name of the Grid component to run

inputProps.aliasCharacter

Alias for the Grid component. This must be a unique value. No spaces. Try to keep alias as short as possible.

inputProps.thisComponentAliasCharacter

(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 {grid.object}.getParentObject() method (called from this Grid) will fail.

inputProps.divCharacter

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

inputProps.userFilterCharacter

(Optional) A filter to apply to the Grid. The filter must use either SQL or DBF syntax, depending on the data source for the Grid. The filter can use literal values of arguments. Arguments are recommended.

A user filter can be removed when the user clicks the Clear Search button in the Search Part. Contrast this with the Base Filter, which cannot be removed by the user. When the user searches in the Grid, the user filters are in addition to the base filter.

A filter using literal values:

STATE = 'MA'

A filter using arguments:

STATE = :whatState

If the filter uses arguments, you can set the argument values in the arguments property.

inputProps.userOrderCharacter

(Optional) An order expression to apply to the Grid. The order must use either SQL or DBF syntax, depending on the data source for the Grid. For example:

SQL Syntax:

LASTNAME, SALARY DESC

DBF Syntax:

LASTNAME +invert(SALARY)

inputProps.baseFilterCharacter

(Optional) Applies a base filter to the Grid. A base filter cannot be removed by the user. See userFilter above for additional comments.

inputProps.argumentsCharacter

(Optional) Needs to be specified if the userFilter or baseFilter properties use arguments.

You can specify the values of as many arguments as you want. The argument values are specified in a CR-LF delimited string. Each line in the string defines the value of a single argument. The syntax for each line is:

ArgumentName|Data Type|Value

For example, the following string defines the value of three arguments:

inputProps.arguments = <<%txt%
name|character|Smith
amountDue|numeric|1000
dateOfBirth|time|1/1/1972
%txt%

inputProps.linkDefinitionCharacter

(Optional) Allows you to specify that the Grid is 'linked'. Linking a Grid is similar to filtering it. However, when a Grid is linked and new records are added, the linking fields in the new record are automatically set to the linking values.

The syntax for specifying the link definition is a CR-LF delimited list of linking fields and their corresponding values. Each line in the string has this format:

LinkingField(type:value)

For example, say you wanted to link on the firstname and lastname fields with corresponding values of 'Cathy' and 'Hite', you would use this definition:

inputProps.linkDefinition = <<%txt%
firstname(c:Cathy)
lastname(c:Hite)
%txt%

inputProps.overrideCharacter

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

Description

Generates the HTML and Javascript for a Grid component.

Examples

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

<b>An embedded Grid will be shown here.</b>

<%a5
    delete p
    dim p as p
    p.gridName = "MyGrid"
    p.alias = "MYGRID1"
    p.thisComponentAlias = "{grid.componentname}"

    dim xb as c
    xb = a5_XB_RunGridComponent(p)
    ?xb
%>

The above example can be modified to ensure that the target Grid component uses the same style as the parent component by setting the p.override property. For example:

p.override = "style_name = \"{grid.style}\""

In the following example the a5_xb_runGridComponent() function is run in an Xbasic function that handles an Ajax callback:

function xbRunGrid as c (e as p)
    delete p

    dim p as p
    p.gridName = "Grid_SalesPeople"
    p.alias = "SALESPEOPLE1"
    p.thisComponentAlias = "{dialog.componentname}"
    p.div = "grid1"

    p.override = <<%txtsettings%
    rows = 2
    %txtsettings%

    p.override = p.override + crlf() + "style_name = \"{grid.style}\""

    dim xb as c
    xb = a5_XB_RunGridComponent(p)
    xbRunGrid = xb

end function