Release Notes

In FirstSpirit können Elemente mehrfach verwenden, z. B. Bilder, Absätze, Seiten, Datensätze usw. Das bedeutet, diese Inhalte können an mehreren Stellen der Website erscheinen. Man spricht dann auch von „Verwendungen“ oder „Referenzen“.
Werden an einer Stelle Änderungen an einem Element vorgenommen, können sich diese auch auf anderen Seiten auswirken. Schneiden Sie beispielsweise ein Bild in der Medien-Verwaltung oder direkt auf einer Seite zu, erscheint das Bild ggf. auch auf anderen Seiten in dem zugeschnittenen Format.
Um besser zu beurteilen und prüfen zu können, ob, wo und wie sich Änderungen, die Sie an Elementen vornehmen, auswirken, gibt es jetzt zusätzliche Funktionen:

Report „Referenzen“

Der Report „Referenzen“ listet abhängige Elemente auf.
Standardmäßig (wenn der Report über das Icon in der Report-Leiste geöffnet wird) bezieht sich die Liste auf das aktuelle Vorschauelement, also in der Regel auf die aktuelle Vorschauseite.

Bei den Referenzen wird unterschieden zwischen

• Eingehende Referenzen:
  Hier werden alle Elemente angezeigt, die auf das aktuelle Element verweisen.
  Beispiel: Seiten, die einen Link auf die aktuelle Seite enthalten.
• Ausgehende Referenzen:
  Hier werden alle Elemente angezeigt, die vom gewählten Element verwendet werden.
  Beispiel: Medien oder Datensätze, die auf der aktuellen Seite eingebunden sind (z. B. per FS_REFERENCE oder FS_DATASET).

Auf welches Element sich der Report jeweils bezieht, zeigt der Eintrag unterhalb der Report-Überschrift.

Befinden Sie sich in der Vorschau, bezieht sich der Report immer auf die aktuelle Seite.
Wechseln Sie per Vorschau oder Navigationsleiste zu einer anderen Seite, werden immer die Referenzen der jeweils gewählten Seite dargestellt.
Sie können das aktuelle Element durch Anklicken des Icons

fixieren.
So werden bei einem Wechsel zu einem anderen Element weiterhin die Referenzen des fixierten Elements dargestellt und können so step by step geprüft werden.
Der Hintergrund färbt sich dann blau.

Mit einem Klick auf den blau hinterlegten Text gelangen Sie jederzeit wieder zu diesem fixierten Element zurück.

Mit einem Klick auf das Icon

wird die Fixierung gelöst, und die Anzeige der Referenzen folgt dann wieder der Vorschau.

Hinweis: Die Anzeige von Referenzen kann auch Elemente aus anderen Projekten enthalten, oder Elemente für die es keine Anzeigemöglichkeit in der aktuellen ContentCreator-Sitzung gibt. Solche Referenzen werden im Report angezeigt, eine weitere Interaktion ist damit jedoch nicht möglich.

Für Elemente wie Absätze, Medien und Datensätze können die jeweiligen Referenzen über das Icon

angezeigt werden.
Sie finden es an vielen Stellen im ContentCreator:

• EasyEdit-Leiste
  
  
  

• Navigationsleiste
  
  
  

• Medien- und Datenquellen-Verwaltung
  
  
  

• Bearbeitungsdialoge
  
  
  

Zu weiteren Informationen siehe auch https://docs.e-spirit.com/contentcreator/report-bereich/referenzen/index.html.

Report „Verwandte Elemente“
Der Report „Referenzen“ ersetzt den bisherigen Report „Verwandte Elemente“ und übernimmt dessen Funktionen:

• „Wird verwendet von“:
  Seiten, die einen Verweis auf die aktuelle Seite enthalten.
  Jetzt zu finden auf dem Register „Eingehend“.
• „Ausgehende Verweise“:
  Elemente, die vom aktuellen Element verwendet werden.
  Jetzt zu finden auf dem Register „Ausgehend“.
• „Benachbarte Elemente“:
  Dabei handelte es sich um Seiten, die unterhalb desselben Menüeintrags liegen, wie die aktuelle Seite, aber nicht über einen eigenen Menüeintrag verfügen.
  Diese werden nicht mehr im Report angezeigt, sondern werden in der Navigationsansicht dargestellt:

Die Benutzerführung beim Hochladen von Medien über das Eingabeelement „Referenzauswahl“ (FS_REFERENCE) und „Verweissensitive Grafik“ (CMS_INPUT_IMAGEMAP) wurde verbessert (Parameter upload):
Sofern der Upload nicht per Parameter uploadFolder auf einen bestimmten Ordner beschränkt wurde, werden als Upload-Ziele jetzt nur noch die Ordner angeboten, aus denen auch eine Auswahl erlaubt ist, sowie deren Unterordner.

Beispiel

<FS_REFERENCE name="st_picture" hFill="yes" imagePreview="yes" upload="yes" 
           useLanguages="yes">
  <FILTER>
    <ALLOW type="picture"/>
    <HIDE type="file"/>
  </FILTER>
  <LANGINFOS>
    <LANGINFO lang="*" label="Picture" description="Choose the desired picture."/>
    <LANGINFO lang="DE" label="Bild" description="Wählen Sie das gewünschte Bild aus."/>
  </LANGINFOS>
  <PROJECTS>
    <LOCAL name=".">
      <SOURCES>
        <FOLDER name="aboutus" store="mediastore"/>
      </SOURCES>
    </LOCAL>
    <REMOTE name="remote">
      <SOURCES>
        <FOLDER name="homepage" store="mediastore"/>
      </SOURCES>
    </REMOTE>
  </PROJECTS>
</FS_REFERENCE>

Diese Eingabekomponente ermöglicht einen Upload in den Ordner aboutus des lokalen Projekts, in den Ordner homepage des Remote-Projekts sowie Unterordner:

Folgende Modul-Versionen für „FirstSpirit Content Experience Tools“ werden von FirstSpirit 2022.7 unterstützt.

* Diese Module benötigen ab dieser Version FirstSpirit 2020-03 oder höher.

Mit dem aktuellen Release können E-Mails jetzt per API auch an sichtbare und unsichtbare Kopienempfänger versendet werden (cc / „Carbon copy“ und bcc / „Blind carbon copy“ / „Blindkopie“).

Dazu wurde die Klasse MailHeader.Builder (Package de.espirit.firstspirit.access, FirstSpirit Access-API) um die Methoden

ccRecipient
bccRecipient

erweitert.

Beispiel:

import de.espirit.firstspirit.access.MailHeader;
import de.espirit.firstspirit.access.MailService;
  
mailHeaderBuilder = MailHeader.getBuilder();
mailHeaderBuilder.bccRecipient("<mailadress1>;<mailadress2>");
mailHeaderBuilder.ccRecipient("<mailadress1>;<mailadress2>");
mailHeaderBuilder.recipient("<mailadress1>;<mailadress2>");
mailHeaderBuilder.sender("<senderMailadressFromServer>");
mailHeader = mailHeaderBuilder.create();
attachment = null;
service = context.getConnection().getService(MailService.class);
service.sendMail(mailHeader, "<Subject>", "<Mailbody>", attachment);

Es wurde eine Sicherheitslücke geschlossen, die es Usern trotz unzureichender Rechte ermöglichte, Arbeitsablauf-Rechte per FirstSpirit-API anzupassen.

Betroffen ist das Interface StoreElement, Package de.espirit.firstspirit.access.store (FirstSpirit Access-API):

Bei Verwendung der Setter-Methoden sowie einiger modifizierender Getter-Methoden, z. B.

• setWorkflowPermission
• setWorkflowPermissions
• setInheritWorkflowPermission
• getCreateWorkflowPermission

wird jetzt geprüft, ob der ausführende User das Recht hat, Arbeitsablauf-Rechte zu ändern (CAN_CHANGE_PERMISSION, permission 128).

Verfügt der User nicht über das betreffende Recht, wird die Methode nicht ausgeführt, und es wird eine entsprechende Exception protokolliert, z. B.

...
Target exception: de.espirit.firstspirit.access.AccessSecurityException: Access 
   denied to StoreElement 'xyz' with permission 128! 
   (de.espirit.firstspirit.store.access.sitestore.PageRefFolderImpl, id=1600310)
...

Zuvor wurden die Methoden auch ohne ausreichende Rechte ausgeführt.
Bestehende Kundenlösungen, die diese Methoden verwenden, sollten auf Funktionalität geprüft und bei Bedarf dem ausführenden User die erforderlichen Rechte erteilt werden.