fileset-add-entries {http://www.daisy.org/ns/pipeline/xproc}

Step fileset-add-entries {http://www.daisy.org/ns/pipeline/xproc}

Add new entries to a fileset.

Defined in: http://www.daisy.org/pipeline/modules/fileset-utils/library.xpl

Input Ports

Port	Description
source.fileset primary
source.in-memory sequence	The input fileset
entries sequence	The documents to add to the fileset Must be empty if the href option is specified.
file-attributes parameter	Additional attributes to add to the new d:file entries, or to existing entries if the fileset already contained files with the same URI as one of the provided entries and if `replace-attributes` is set to `true`. Attributes named `href`, `original-href` or `media-type` are not allowed.

Output Ports

Port	Description
result.fileset primary
result.in-memory sequence	The fileset with the new entries added The result.in-memory port contains all the documents from the source.in-memory port, and if the new entries were provided via de "entries" port, those documents are appended (or prepended, depending on the "first" option). If the input fileset already contained a file with the same URI as one of the new entries, the new entry is not added, unless when the 'replace' option is set, in which case the old entry is removed and the new one is added to the beginning or the end. (Note however that the document sequence is not changed, only the manifest.) If the 'replace-attributes' option is set, attributes of the existing entry may be added or replaced.

Port

Description

result.fileset primary

result.in-memory sequence

The fileset with the new entries added

The result.in-memory port contains all the documents from the source.in-memory port, and if the new entries were provided via de "entries" port, those documents are appended (or prepended, depending on the "first" option).

If the input fileset already contained a file with the same URI as one of the new entries, the new entry is not added, unless when the 'replace' option is set, in which case the old entry is removed and the new one is added to the beginning or the end. (Note however that the document sequence is not changed, only the manifest.) If the 'replace-attributes' option is set, attributes of the existing entry may be added or replaced.

Options

Local Name	Namespace URI	Default	Description
href		()	The URIs of the new entries If the entries are provided via the entry port, the href option must not be specified. In this case the URIs of the entries are the base URIs of the documents.
media-type		''
original-href		''
first		false()
replace		false()
replace-attributes		false()
assert-single-entry		false()