Inhaltstypen

Inhaltstypen definieren eine Reihe von Feldern, die alle Arten von Daten enthalten können (z. B. Gebäudenamen, Adressen, Daten, Zahlen, Bilder usw.).

Man kann sie sich wie Tabellen in einer Excel-Tabelle vorstellen, wobei der Inhaltstyp die Tabelle und ihre Spalten definiert und die Elemente als Tabellenzeilen gespeichert werden. Inhaltstypen werden in einem JSON-Dokument definiert, das in das iCL Portal und den iCL Designer geladen werden kann, um sie zu nutzen.

Tipp

Für ein tieferes Verständnis von Inhaltstypen und -elementen lesen Sie bitte die Knowledge Base Artikel hier

Hinweis: Sie können unsere Demo-Arbeitsmappe 💾 für diesen Abschnitt herunterladen und mitverfolgen. Die Definition des Inhaltstyps finden Sie hier 💾

Inhaltstypen in die Arbeitsmappe importieren

Um einen Inhaltstypen zur weiteren Verwendung in die Arbeitsmappe zu importieren, können Sie mit der rechten Maustaste auf den Ordner 'Inhaltstypen' im Arbeitsmappen-Explorer klicken und die .json-Datei aus dem entsprechenden Ordner mit 'Importieren' auswählen.

Verwendung von Inhaltstypen in Checklisten

Ein Inhaltstyp wird über Felder in die Checkliste aufgenommen. Wählen Sie dazu ein Feld aus und ändern Sie den Typ "Kontrolle" in "Inhaltselement". Dann können Sie einen der importierten Inhaltstypen in dem Feld darunter auswählen.

Inhaltstypen - Optionen

Die folgenden Optionen stehen für den Inhaltstyp zur Verfügung:

Option	Beschreibung
Filter	Wenn das Feld nicht schreibgeschützt ist, ermöglicht es dem Benutzer, eine Liste von Elementen zu öffnen, aus denen er wählen kann. Der Filter kann verwendet werden, um die Anzahl der verfügbaren Einträge zu reduzieren. Sie könnten z. B. die Liste der verfügbaren Gebäude auf solche mit einer bestimmten Postleitzahl beschränken.
Automatische Erstellung	Ermöglicht die Speicherung von Daten, die während einer Inspektion in den Inhaltstyp eingegeben werden, als neuen Datensatz im iCL Portal.
Automatische Aktualisierung	Ermöglicht es Ihnen, bestehende Daten des Inhaltstyps zu ändern und diese Änderungen im iCL Portal zu aktualisieren.
Automatisches Ausfüllen	Ein Inhaltstyp wird normalerweise automatisch in das Feld Inhaltstyp eingetragen, wenn er zu Beginn der Inspektion ausgewählt wird. Mit Autofill können Sie dieses Standardverfahren deaktivieren, um den Inhaltstyp zu einem späteren Zeitpunkt manuell auszuwählen.
nur in erster Checkliste	Wenn diese Option aktiviert ist, wirken sich die Autofill-Einstellungen nur auf die erste Checkliste innerhalb einer Inspektion aus. Wenn der Benutzer weitere Checklisten anlegt, wird Autofill für diese deaktiviert.
Auditierung aktivieren	Wie bei jedem anderen Feld speichert diese Option einen Zeitstempel und den derzeit aktiven Benutzer, wenn dieses Feld geändert wird. Dies ist eine allgemeine Option und bezieht sich nicht direkt auf Inhaltstypen.

Inhaltstypen - Zuordnungen

Inhaltstypen enthalten eine beliebige Anzahl von Feldern, die mit Daten gefüllt werden können. Wenn ein Inhaltstyp in eine Arbeitsmappe importiert wird, können seine Felder den Feldern der Checkliste zugeordnet werden. Auf diese Weise werden nach Abschluss der Inspektion die Felder des Inhaltstyps mit den Daten der entsprechenden Checklistenfelder aktualisiert. Beachten Sie, dass jedes Feld, das obligatorisch ist, am Ende mit einem Sternchen (*) gekennzeichnet ist.

Die nächsten beiden Abschnitte befassen sich mit der Bindung von Inhaltselementen an und von Checklisten.

Inhaltstypen - Blockly-Skripte

Mappings sind einfach Blockly-Skripte, die es Ihnen ermöglichen, den Wert eines beliebigen Checklistenfeldes an ein bestimmtes Feld eines Inhaltsartikels zu binden. Wenn diese Daten auch in der Arbeitsmappe angezeigt werden sollen, müssen Felder für die Anzeige erstellt und mit den Mapping-Feldern des Inhaltstyps verknüpft werden.

Im folgenden Beispiel haben wir die Felder der Inhaltselemente mit einigen Feldern der Checkliste verknüpft. Beachten Sie, dass wir verschiedene Arten von Feldern zugeordnet haben: Building name ist ein reines Textfeld, während Bild ein Bild ist, Zip_code ist numerisch und Bau ist ein Feld vom Typ Datum! Beachten Sie auch, dass die Zuordnung für zip_code etwas anders aussieht: Da es einem Optionsfeld (Dropdown) in der Checkliste zugeordnet ist, können Sie wählen, ob Sie den Wert oder den Titel dieses Feldes abrufen möchten.

Wenn Sie nun den Wert eines Feldes eines Inhaltselements in der Checkliste anzeigen möchten, müssen Sie es an die geskriptete Antwort eines Checklistenfeldes binden. In der Regel werden Sie dieselben Checklistenfelder wiederverwenden, die Sie bereits mit dem Inhaltselement über dessen Zuordnungen verbunden haben. Als Beispiel zeigen wir Ihnen, wie wir das Feld Bauname in die Checkliste laden

Ziehen Sie dazu einfach das Inhaltsfeld Gebäude per Drag & Drop in den Editor von Skripted Answer.

The fallback content to display on prerendering

Wie Sie sehen, müssen Sie den Namen des Feldes des Inhaltselements, das Sie abrufen möchten, manuell angeben. In diesem Fall stehen fünf Felder zur Auswahl: (Bitte ignorieren Sie IsDeleted - darauf gehen wir später ein)

Wann werden Mappings ausgewertet?

Es ist wichtig zu verstehen, dass die Zuordnungen von Inhaltselementen nicht live sind. Was verstehen wir unter "live"? Im Wesentlichen bedeutet dies, dass jedes Mal, wenn ein Inhaltsfeld geändert wird - zum Beispiel: Der Benutzer wählt ein Gebäude für das Feld Gebäude - dann werden alle geskripteten Antworten, die davon abhängen, ausgewertet. Das Textfeld Gebäudename wird also sofort den Namen des ausgewählten Gebäudes anzeigen.

Wenn der Benutzer dann aber das Textfeld Gebäudename in der Checkliste ändert, wird der Name des Gebäudes nicht sofort aktualisiert. Das kann verwirrend sein. Schließlich haben wir in unserem Mapping festgelegt, dass das Gebäudefeld Gebäudename an dieses Textfeld in der Checkliste gebunden ist.

Stattdessen werden erst dann, wenn die Inspektion abgeschlossen ist, alle Zuordnungen in den Checklisten ausgewertet und dazu verwendet, das Gebäude zu aktualisieren (wenn "automatische Aktualisierungen" aktiviert sind) oder ein neues zu erstellen, wenn es noch nicht existiert (und "automatische Erstellung" aktiviert ist).

Dies ist eine wichtige Funktion, da Sie so genau verfolgen können, welche Elemente während einer Inspektion aktualisiert/erstellt wurden. Außerdem kann eine Inspektion jederzeit abgebrochen werden, ohne dass zwischenzeitliche und falsche Änderungen an Inhaltselementen vorgenommen werden.

Das spezielle Feld 'IsDeleted'

Wenn Sie sich erinnern, wurde das Mapping-Feld "IsDeleted" oben kurz erwähnt, aber nicht erklärt. Dies ist ein eingebautes Feld, das jeder Inhaltstyp hat. Es gibt Ihnen im Wesentlichen die Möglichkeit, ein Element permanent aus dem System zu löschen. Ein Beispiel: Sie stellen vielleicht fest, dass ein Gebäude abgerissen wurde. Dann können Sie ihm ein boolesches Feld (z. B. ein Ja-Nein-Kontrolllistenfeld) zuordnen, so dass Ihre Benutzer die Löschung dieses Objekts veranlassen können.

Beachten Sie, dass Sie für den Fall, dass Sie den Eintrag vor weiteren Inspektionen verbergen möchten, lieber ein benutzerdefiniertes Feld (z. B. "isarchived") einführen und diese Einträge aus Ihrer Checkliste herausfiltern sollten. Auf diese Weise können Sie diese Elemente mit ihren Inspektionen immer noch im System sehen, während Sie sie vor Ihren Inspektoren verbergen.

Inhaltstypen - Wiederholung von Inhaltselementen mit Checklisten / Kapiteln / Überschriften

Es ist möglich, Checklisten, Kapitel und Überschriften mit Inhaltselementdaten zu wiederholen. Wenn Sie einen Standard-Inhaltstyp für Inspektionen und einen damit verbundenen Mängel-Inhaltstyp haben, können Sie eine Liste von Mängeln erstellen, die mit einem bestimmten Eintrag des Standard-Inhaltstyps für Inspektionen zusammenhängen. Zum Beispiel die Auflistung von Mängeln zu einem bestimmten Gebäude.

Wenn Sie eine Liste von Objekten mit allen darin enthaltenen Mängeln auflisten möchten, ist die Hierarchieebene das Kapitel für das Objekt und die Überschrift für seine Mängel.

Im Eigenschaftsfenster eines Kapitels oder einer Überschrift erhalten Sie in Bezug auf den Inhaltstyp Einstellungen, wenn Sie die Eigenschaft 'ist wiederholbar' auswählen.

Im Eigenschaftsfenster Checkliste können Sie die Eigenschaft Wiederholen für direkt auswählen. Diese Option ist erforderlich, um wiederholbare Inhaltselemente zu erstellen.

In diesem Abschnitt können Sie der Checkliste, dem Kapitel oder der Überschrift Verweise auf Inhaltselemente hinzufügen. Dies erfordert einen Standard-Inhaltstyp sowie einen Defekt-Inhaltstyp, der eine Beziehung zum Standard-Inhaltstyp gesetzt hat. Beide Inhaltstypen müssen ebenfalls als Frageknoten vom Typ 'Inhaltselement' in den Wiederholungsbaum eingefügt werden.

Repeat for - Geprüfte Elemente

Wenn die Eigenschaft 'Wiederholen für' auf Inspected Items gesetzt ist, muss hier das Standard-Content-Item eingefügt werden, in dem Objektdaten oder inspizierbare Daten gespeichert sind.

Eigenschaft	Beschreibung
Wiederholung für	Inspected Item: erfordert einen normalen Inhaltstyp (BuiltInTypeId: 0)
von Typ	Diese Eigenschaft akzeptiert alle Inhaltstypen, die inspiziert werden können. Sie können hier z.B. nicht auf einen defekten Inhaltstyp verweisen.
Kontextfeld	Setzt das Feld, in dem das Inhaltselement für jede wiederholte Instanz gespeichert werden soll. Dieser Wert wird automatisch gesetzt.

Wiederholen für - Verwandte Elemente

Wenn die Eigenschaft 'Wiederholen für' auf Verwandte Elemente gesetzt ist, ist es erforderlich, einen Inhaltstyp mit Beziehungen zu einem übergeordneten Inhaltstyp hinzuzufügen.

Eigenschaft	Beschreibung
Wiederholung für	Related Item: erfordert einen Inhaltstyp mit einem Feld des eingebauten Typs ParentContentItemid und eine Beziehung zu einem inspizierbaren Inhaltstyp.
des Typs	Diese Eigenschaft akzeptiert den Inhaltstyp selbst, sofern er bereits als Frageknoten in einer der absteigenden Überschriften gesetzt ist.
Kontextfeld	Setzt das Feld, in dem das Inhaltselement für jede wiederholte Instanz gespeichert werden soll. Dieser Wert wird automatisch gesetzt.
Abfrage	Definiert Filter und Reihenfolge für die verwandten Elemente. Ein Filter ist erforderlich, der das übergeordnete Inhaltselement definiert, für das die verwandten Elemente wiederholt werden sollen.

Blockly Query

Mit der Related Items Einstellung kommt auch eine Blockly Query mit.

Sie können die Daten Ihrer defekten Inhaltselemente über verschiedene Blöcke filtern und sortieren.