Leitfaden zum Rewrite der SimpleSearch

Überarbeitung der SimpleSearch

Das SimpleSearch-Template zusammen mit den beiden Flex-Modulen Tabellenspalte und Geo-Modul wurden überarbeitet. Alle Änderungen tragen dazu bei, SimpleSearch und Publikationsdatenbank auf den aktuellen technischen Stand zu heben, eine Weiterentwicklung zu ermöglichen, die Nutzung im CMS zu vereinfachen und die Darstellung im Frontend noch barrierefreier zu gestalten.

Die wesentlichen Änderungen erfolgten automatisiert (technische Migration). Da Optionen entfallen und neue dazugekommen sind, kann die Migration redaktionelle Anpassungen verlangen, um die gewünschten Darstellungen im Frontend zu erhalten.

Dieser Leitfaden bietet Ihnen eine schnelle Übersicht über die Änderungen und ggf. notwendige redaktionelle Schritte. Eine ausführliche Dokumentation zur SimpleSearch finden Sie im Support-Wiki.

Erforderliche Schritte und Maßnahmen für Redaktionen

Prüfen Sie, ob Ihre SimpleSearch

  • mehr als 25 aktive Spalten aufweist. Falls ja: Erstellen Sie ein redaktionelles Konzept zur Spaltenreduzierung. SimpleSearches dürfen maximal 25 Spalten aktiv nutzen. Mehr Informationen im Abschnitt zur Begrenzung der Spaltenanzahl
  • Optionen benutzt, die weggefallen sind. Mehr Informationen im Abschnitt Entfallende Optionen
  • auf www.berlin.de angezeigt wird und vollständig ist.

Falls Ihre SimpleSearch nicht mehr oder fehlerhaft dargestellt wird, wenden Sie sich bitte an support@berlin.de

Optionen entfallen

Falls Sie eine der nachfolgenden Optionen nutzen, müssen Sie redaktionell tätig werden.

Zusammenfassung von Spalten und Zeilen entfällt

Prüfen Sie, ob in Ihrer SimpleSearch Spalten oder Zeilen zusammengefasst werden. Falls ja: Erstellen Sie ein redaktionelles Konzept ohne diese Optionen. Ab 10. Juli werden Spalten nicht mehr zusammengefasst, sondern hintereinander dargestellt.

A-Z Listen und Schlagwortlisten entfallen

Entfernen Sie vorhandene Verlinkungen und Verweise auf A-Z- und Schlagwortlisten. Entfernen Sie Spalten und Flex-Module, die rein der Generierung von diesen Listen dienen.

Für Flex-Module, bei welchen die Darstellungsoption “Als Link zur Schlagwortliste…” oder “Als Link zur A-Z-Liste…” ausgewählt ist, wird ab 10. Juli automatisch die Darstellungsoption “Standard – Fremdeingaben” ausgewählt.

Auswahl-Optionen entfallen: Anpassungsbedarf an der CSV

Künftig werden die Inhalte aus den CSVs ohne automatische Änderung angezeigt. Das bedeutet, dass Abkürzungen wie z.B. “BA Mitte” nicht mehr als “Bezirksamt Mitte” ausgegeben werden.

Nutzen Sie bislang die Auswahl-Optionen, fallen folgende Schritte an:

  1. Ändern Sie die Abkürzungen in ihrer CSV in den gewünschten Inhalt (In Excel bietet sich hierfür “Suchen und ersetzen” an)
  2. Laden Sie die CSV neu hoch und wählen Sie beim entsprechenden Flex-Modul im Reiter “Ergebnisliste: Sortierung/Darstellung” die Variante “Standard – Fremdeingaben”

Darstellungsoptionen “gefetteter Text”, “als Ganzzahl ohne Nachkommastellen”, “als Suchbegriff…” entfallen: Anpassungsbedarf an der CSV

Passen Sie die Inhalte in Ihrer CSV so an, dass sie die gewünschte Darstellung mittels textiler Textformatierung erreichen oder indem Sie die Werte direkt so formatieren, wie sie online angezeigt werden sollen.

Das betrifft die aktuellen Optionen:

  • als gefetteter Text: Hier können Sie die Fettung mittels * erreichen. Wählen Sie anschließen die Option “Standard eigener Redakteur”
  • als Suchbegriff für diese Spalte mit einer Such-URL: Hier können Sie die entsprechende Such-URL hinterlegen, mittels textiler Textformatierung. (Beispiel: Suchbegriff)
  • als Suchbegriff für diese Spalte mit einer schönen URL: Diese Option entfällt komplett. Wenden Sie dieselben Schritte wie bei der vorherigen Option an.
  • als Ganzzahl ohne Nachkommastellen: Entfernen Sie die Nachkommastellen der Zahlen und wählen Sie anschließend die Option “als Zahl”.
  • als Währung in Euro: Diese Option wird zu “als Währung”. Um dieselbe Darstellung wie bislang zu erhalten, müssen die Werte in der CSV um folgende Zeichen ergänzt werden:
    • einen Tausendertrenner
    • ,00 am Ende
    • dem Eurozeichen am Ende
      Beispiel: Aus dem Zelleninhalt 1234567 sollte 1.234.567,00€ werden.

Darstellungsoptionen “als Link” sowie unvollständige Adressangaben entfallen: Anpassungsbedarf der Flex-Module

Die Darstellungsoption “als Link” ist nicht barrierefrei. Wählen Sie bei betroffenen Flex-Modulen die Option “als Link mit Linkbezeichner “mehr”“.

Für unvollständige Adressangaben, bei welchen Hausnummer, PLZ oder Ort fehlen, entfällt die Option “als Adresse mit Link zum Stadtplan”. Vervollständigen Sie die Adressangaben und wählen Sie die Option “als Adresse mit Link zum Stadtplan (Straße Hausnummer, PLZ, Ort)”. Können die Angaben nicht ergänzt werden, wählen Sie die Option “Standard – Fremdeingabe”.

Die Option “als Adresse mit Link in die eigene Karte” wird verschoben und direkt im Geo-Modul eingestellt. Um einen Link in die Karte einzufügen, wählen Sie im Flex-Modul die Option “Standard – Fremdeingabe”. Geben Sie anschließend im Geo-Modul die korrekte Spaltenbezeichnung für die Adresse an.

Detailseiten werden automatisch erstellt und enthalten alle aktiven Spalten

Ab 10. Juli wird für jeden Eintrag eine Detailseite generiert, auch wenn diese nicht in der Suchergebnisliste verlinkt wird.

Außerdem werden alle Spalten, deren Flex-Inhalt nicht auf “aus” gestellt ist, auf der Detailseite angezeigt. Es ist nicht möglich, Spalten nur für die Suchergebnisliste oder nur als Suchoption zu nutzen.

Wenn Sie einen Automatikimport nutzen: Prüfen Sie jedes Flex-Modul mit datenschutzrelevanten Inhalten (E-Mail-Adressen, Kontaktdaten usw.) und stellen Sie sicher, dass diese weder in den Suchergebnislisten noch in den Detailseiten angezeigt werden.

Begrenzung der Stichwortsuche auf 16 Spalten

Die Stichwortsuche kann nicht alle 25 sichtbaren Spalten abdecken. Daher wird es neben dem zentralen An-/Aus-Schalter (Reiter “Metadaten” – Unterreiter “Erweitert”) auch eine Option zur Aktivierung der Stichwortsuche pro Tabellenspalten-Flex-Modul geben. Sobald das Modul mindestens auf der Detailseite sichtbar ist, wird diese Option im Reiter “Flex-Inhalt” angeboten.

Die Stichwortsuche ist nur für Spalten mit dem Inhaltstyp “Text” möglich. Sind andere Typen eingestellt, wird die Spalte bei der Stichwortsuche ignoriert.

Wenn Sie mehr als 16 Spalten in der Stichwortsuche einbinden, überlegen Sie sich welche Spalten Sie ggf. nicht in der Stichwortsuche benötigen, da sie bspw. bereits als eigenes Suchfeld angeboten werden.

Tabellenspalten-Flex-Module nur für aktive Inhalte nötig

Ab dem 10. Juli ist es nicht mehr nötig, für jede Spalte in der CSV ein Tabellenspalten-Flex-Modul anzulegen. Sie können nur die benötigten Spalten der CSV mit einem Modul definieren und alle anderen weglassen. Das kann die Übersichtlichkeit in der SimpleSearch steigern.

Begrenzung der Spaltenanzahl

Reduzieren Sie die Anzahl der aktiven Spalten in der CSV Ihrer Simple Search auf 25. Spalten, die weder als Suchoption genutzt werden noch in den Suchergebnissen oder Detailseiten auftauchen, werden nicht mitgerechnet. Diese Spalten gelten nicht als aktiv.

Bedenken Sie, dass “verborgene” Spalten, die beispielsweise nur zur Sortierung der Suchergebnisse dienen oder Synonyme für die Stichwortsuche beinhalten, nicht mehr funktionieren.

Sofern Ihre SimpleSearch mehr als 25 Spalten aktiv nutzt, muss sie neu konzipiert werden. Folgende Fragen unterstützen Sie dabei:

  • Lassen sich Spalten inhaltlich zusammenfassen? Beispiel: Aus drei Spalten “Telefon”, “E-Mail” und “Website” wird eine Spalte “Kontakt”
  • Welche Informationen brauchen Nutzende nicht unbedingt?

Bedenken Sie, dass die CSV-Inhalte Textile-Textformatierungen wie Fettungen zulassen. Excel ermöglicht die gebündelte Bearbeitung von Zellinhalten, sodass Änderungen automatisiert werden können – zum Beispiel über Textketten.

Anzeige auf Berlin.de

Prüfen Sie, ob Ihre SimpleSearch auf www.berlin.de korrekt angezeigt wird.

Es fehlen Inhalte?

Schauen Sie im Edit nach, ob in den entsprechenden Flex-Modulen im Reiter “Flex-Inhalt” die richtige Anzeigeoption ausgewählt ist. Prüfen Sie anschließend im Reiter “Inhaltstyp”, ob der korrekte Datentyp ausgewählt ist.

Es werden Inhalte angezeigt, die nicht erscheinen dürften?

Schauen Sie im Edit nach, ob in den entsprechenden Flex-Modulen im Reiter “Flex-Inhalt” nur die Anzeigeoptionen gewählt sind, die Sie wünschen. Soll ein Inhalt weder im Suchformular noch in der Ergebnisliste, noch auf der Detailseite auftauchen, wählen Sie die Option “Aus”.

Inhalte werden in der falschen Formatierung angezeigt?

Schauen Sie im Edit nach, ob in den entsprechenden Flex-Modulen in den Reiter “Darstellung” die korrekte Option gewählt wurde.

Beauftragung der BerlinOnline-Redaktion

Bei Bedarf kann die BerlinOnline-Redaktion beauftragt werden, bei den redaktionellen Arbeiten zu unterstützen. Weitere Informationen zur Beauftragung erhalten Sie bei Katja Schlangen, stellvertretende Redaktionsleitung BerlinOnline.