"Custom" Action | X4Documentation

The Custom action is created via the <CustomAction/> element within <Actions>. With a Custom action, you can implement simple actions without predefined text and icons, e.g. a component can be called.

In addition to the standard attributes for (7.4.0-en) Actions, the <CustomAction/> element can also have the following attributes:

Attribute	Description
`displayName`	Label of the button. Translatable Possible values: Any string or language key
`externalLink`	Allows you to navigate to an external website by setting an external link. Data binding possible Possible values: String (URL) Note: In Detail components, the external link can also be passed by a Technical Process. To do this, you need to link a Technical Process that contains the external link in its response to the action (`process` attribute): XML `<Ok externalLink="http://www.google.de" />`
`externalLinkTarget`	Specifies whether the link (`externalLink`) opens on the same tab or a new tab. Possible values: `same`: The link opens on the same tab `new`: The link opens on a new tab
`validated`	Allows validation of the input Possible values: `true`- Validation is enabled If the validation fails, the button is disabled. `false`: Validation is not enabled (default) If the validation fails, the button is not disabled.
`url`	Allows you to navigate to an external website by setting an external link. Data binding possible

Example

Example of a "Custom" action

XML

<DetailComponent path="Dashboard" displayName="Dashboard" default="true">
	<Actions>
	<CustomAction componentName="CountryList"
    			  displayName="Save custom"
    			  validated="true"
   				  process="/WebApp/Administration/Country/CreateOrUpdateCountry.wrf"/>
	</Actions>
	<FlowLayout>
		…
	</FlowLayout>
</DetailComponent>

The example above generates the Save customer action: