Attention
TYPO3 v9 has reached its end-of-life September 30th, 2021 and is not maintained by the community anymore. Looking for a stable version? Use the version switch on the top left.
You can order Extended Long Term Support (ELTS) here: TYPO3 ELTS.
uri.newRecord¶
Use this ViewHelper to provide 'create new record' links. The ViewHelper will pass the command to FormEngine.
The table argument is mandatory, it decides what record is to be created.
The pid argument will put the new record on this page, if 0 given it will
be placed to the root page.
The uid argument accepts only negative values. If this is given, the new record will be placed (by sorting field) behind the record with the uid. It will end up on the same pid as this given record, so the pid must not be given explicitly by pid argument.
An exception will be thrown, if both uid and pid are given. An exception will be thrown, if the uid argument is not a negative integer.
To edit records, use the <be:uri.editRecord>.
Examples¶
Uri to create a new record of a_table after record 17 on the same pid:
<be:uri.newRecord table="a_table" returnUrl="foo/bar" uid="-17"/>
/typo3/index.php?route=/record/edit&edit[a_table][-17]=new&returnUrl=foo/bar
Uri to create a new record of a_table on root page:
<be:uri.newRecord table="a_table" returnUrl="foo/bar""/>
/typo3/index.php?route=/record/edit&edit[a_table][]=new&returnUrl=foo/bar
Uri to create a new record of a_table on page 17:
<be:uri.newRecord table="a_table" returnUrl="foo/bar" pid="17"/>
/typo3/index.php?route=/record/edit&edit[a_table][-17]=new&returnUrl=foo/bar