mergePPTX
A child command of composePPTXContent that brings content of another PPTX presentation into the composed PPTX presentation produced by the parent command. The specified slides, their layouts, and optionally their slide masters and associated themes, are placed into the specified position, while any slides in that position and following are moved further to make way for the arriving slides.
Parent commands
composePPTXContent
Required. Defines the presentation that this command modifies.
Attributes
source | ||
|---|---|---|
Required | Value type | EL-evaluated |
Yes | File | Yes |
Defines the PPTX presentation that provides the slides to import. The resolved File should therefore be a PPTX presentation file. | ||
range | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | String | Yes |
This attribute can be used to specify which slides are moved from the other presentation. The resolved String should list numbers of the slides separated by commas (e.g. "1,3,5,6,7"). Instead of slide number, a slide range may also be specified by having the start and end numbers of the range with a hyphen between them (e.g. "1,3,5-7"). If a slide number in the range is less than 1 or higher than the amount of slides in the other slides in the presentation, a warning is produced and no slide moved. However, even if the range contains invalid numbers, all valid numbers within the range will result in those slides being moved. If If not defined, all slides of the presentation are imported. | ||
adaptive | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | Boolean | Yes |
Defines how slide layouts and slide masters associated with the imported slides are handled. If the resolved value is If the resolved value is If undefined, the value of | ||
insertTo | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | Number, String | Yes |
This attribute can be used to place the imported slides at a specific point at the presentation. The resolved value is expected to be a slide number, either as a Number or as a number-like String. The imported slides are then placed into that point of the base presentation, shifting the slide currently in that position so that it will follow the sequence of imported slides. Note that this slide number is interpreted in the context of the presentation's original structure before any commands have altered it. If, for example, the slide that was originally number 2 has moved to become number 7 due to other commands placing more slides into the presentation, the value of '2' will refer to that slide despite its current number. If undefined, the imported slides are placed at the end of the presentation. | ||
removeFooter | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | Boolean | Yes |
Defines if placeholder shapes of certain type that typically form a footer are removed from the imported slides. If the resolved value is If left undefined, the value of | ||
replaceExisting | ||
|---|---|---|
Required | Value type | EL-evaluated |
No | Boolean | Yes |
Defines if the merging operation will replace content instead of just adding content. If the resolved value of this attribute is If undefined or the resolved value is | ||
Examples
The mergePPTX command allows quite a few options through its attributes, of which all but one are optional. If you just want all the slides of another presentation into the end of the presentation you're composing, only source needs to be defined.
<composePPTXContent var="composedPresentation" value="${presentationTemplate}"><mergePPTX source="${bonusSlides}">If you'd like to define range through a Collection of Numbers or number-like Strings, the toString command can be of use, as it can transform the Collection into a proper range-defining String.
<toString var="slideRange" value="${selectedSlideNums}" itemName="num" expr="${num}"><composePPTXContent var="composedPresentation" value="${presentationTemplate}"><mergePPTX source="${appendixSlides}" range="${slideRange}">