EPScript - Revision history

Drn@ecs.soton.ac.uk: Redirected page to EPScript/Introduction

2022-02-21T02:21:01Z

2019-04-24T16:53:24Z

Functions

← Older revision		Revision as of 16:53, 24 April 2019
Line 296:		Line 296:
	returns: STRING		returns: STRING

	=== dumper(3.3.17+ and 3.4.2+) ===		=== dumper (3.3.17+ and 3.4.2+) ===
	Dumps out the type and value of the variable or field specified in a pre XHTML element. This is intended for developers to help in debug issues. The value part of the debug output is generated by Perl's Data::Dumper module.		Dumps out the type and value of the variable or field specified in a pre XHTML element. This is intended for developers to help in debug issues. The value part of the debug output is generated by Perl's Data::Dumper module.
	<source lang="xml">		<source lang="xml">

2019-04-24T16:51:34Z

Added dumper function

← Older revision		Revision as of 16:51, 24 April 2019
Line 295:		Line 295:

	returns: STRING		returns: STRING

			=== dumper(3.3.17+ and 3.4.2+) ===
			Dumps out the type and value of the variable or field specified in a pre XHTML element. This is intended for developers to help in debug issues. The value part of the debug output is generated by Perl's Data::Dumper module.
			<source lang="xml">
			<epc:print expr="$item{creators}.dumper( )" />
			</source>
			parameters: FIELDVALUE.dumper( )

			returns: XHTML

	= Examples =		= Examples =

2019-04-24T16:41:10Z

2019-04-24T16:40:42Z

Added to_dataobj and subproperty functions

← Older revision		Revision as of 16:40, 24 April 2019
Line 277:		Line 277:

	returns: DATAOBJECT		returns: DATAOBJECT

			=== to_dataobj (3.3.17+ and 3.4.2+) ===
			This is like "as_item" but does not require the field to be of "itemref" type. It will take the variable specified and will lookup this against the DataObj type specified using the particular field specified.
			<source lang="xml">
			<epc:print expr="$item{userid}.to_dataobj( 'user', 'userid' ).username" />
			</source>
			parameters: FIELDVALUE.to_dataobj( DATASET, DATAOBJ_FIELD )

			returns: DATAOBJECT


			=== subproperty (3.3.17+ and 3.4.2+) ===
			When you have a compound field and want to print out just a sub-property of this field. This currently only works for non-multiple compound fields. E.g.
			<source lang="xml">
			<epc:print expr="$item{compoundfield}.subproperty( 'field2' )" />
			</source>
			parameters: FIELDVALUE.subproperty( SUBFIELDNAME )

			returns: STRING

	= Examples =		= Examples =

2018-06-11T15:25:03Z

Hash

← Older revision		Revision as of 15:25, 11 June 2018
Line 89:		Line 89:

	This currently only used by the $config parameter to give access to configuration options. Get values out of it the same way you get values from a dataobject, eg. $config{'base_url'}		This currently only used by the $config parameter to give access to configuration options. Get values out of it the same way you get values from a dataobject, eg. $config{'base_url'}

			Note: To use the `$config`, you may need to wrap the whole expression in braces e.g.:
			<source lang="xml">
			<component>
			<field ref="a_set_or_named_set_field" options="{$config{default_value_for_field}}" required="yes" />
			</component>
			</source>

			which would reference (in a cfg/cfg.d/example.pl file):
			<source lang="perl">
			$c->{default_value_for_field} = "amstrad";
			</source>

	== XHTML ==		== XHTML ==

2015-09-24T09:19:02Z

typo corrected

← Older revision		Revision as of 09:19, 24 September 2015
Line 88:		Line 88:
	== Hash ==		== Hash ==

	This currently only used by the $config parameter to give access to configuration options. Get values out of it the same way you get values from a ~~dataobejct~~, eg. $config{'base_url'}		This currently only used by the $config parameter to give access to configuration options. Get values out of it the same way you get values from a dataobject, eg. $config{'base_url'}

	== XHTML ==		== XHTML ==

2014-05-22T10:53:23Z

Added testing a boolean field example

← Older revision		Revision as of 10:53, 22 May 2014
Line 277:		Line 277:
	<source lang="xml">		<source lang="xml">
	<print expr="$config{base_url}" />/<print expr="eprintid" />/		<print expr="$config{base_url}" />/<print expr="eprintid" />/
			</source>
			== Testing a boolean field ==
			Boolean fields can be TRUE, FALSE or NULL. Just doing a test="boolean_field" isn't enough. Use this:
			<source lang="xml">
			<if test="boolean_field = 'TRUE'">
			...
			</if>
	</source>		</source>

2014-05-22T10:48:35Z

Booleans

← Older revision		Revision as of 10:48, 22 May 2014
Line 65:		Line 65:

	True or false values. Returned by = gt and lt and oneof and used in <if> etc.		True or false values. Returned by = gt and lt and oneof and used in <if> etc.

			If you need to test a boolean field, see the example at the end of this page.

	== Data Objects ==		== Data Objects ==

2012-10-04T10:24:58Z