Einführung in Inhaltstypen
Im iCL-System werden die Daten in Inhaltselementen gespeichert, die durch Inhaltstypen definiert werden. Dieser Leitfaden führt Sie durch ein grundlegendes Szenario zum Erstellen und Arbeiten mit einem einfachen Inhaltstyp.
Bevor Sie beginnen, lesen Sie unsere Beiträge über Inhaltstypen. Dieser Leitfaden baut auf dem Wissen auf, das in diesen Beiträgen vermittelt wird.Bevor Sie beginnen, lesen Sie unsere Beiträge über Inhaltstypen. Dieser Leitfaden baut auf dem, in diesen Beiträgen vermittelten, Wissen auf.
Wir werden die Arbeit an der Arbeitsmappe zur Gebäudeinspektion aus den vorherigen Leitfäden fortsetzen,
💾 Sie können es hier herunterladen.
In diesem Leitfaden möchten wir Ihnen zeigen, wie Sie den Überblick über die regelmäßig zu inspizierenden Gebäude behalten können. Stellen Sie sich das folgende Szenario vor: Sie leiten ein Team in einer Gebäudeinspektionsfirma, und Ihre Aufgabe ist es, die regelmäßigen Gebäudeinspektionen zu verwalten, den Überblick über die Gebäude zu behalten, die Ihr Team inspiziert, und den Gebäudeinspektoren Aufgaben zuzuweisen.
Lesen Sie weiter, um zu erfahren, wie Sie all dies mit der iCL-Produktfamilie einfach erledigen können!
Erstellen Sie einen Gebäude-Inhaltstyp
Das Erste, was wir erreichen wollen, ist die Speicherung der Gebäudeinformationen. Das ist ein wichtiger Schritt, um einen Überblick über die zu prüfenden Gebäude zu bekommen.
Der erste Schritt besteht darin, einen Inhaltstyp für die Darstellung von Gebäuden im iCL-System zu erstellen. Dieser Inhaltstyp wird ein Gebäude mit den folgenden Feldern modellieren: ein eindeutiger Name zur Identifizierung des Gebäudes, die Adresse und optional ein Bild des Gebäudes.
Sie fragen sich jetzt wahrscheinlich, warum es ein separates Feld "eindeutiger Name" und ein Feld "Adresse" gibt, wenn die Adresse ohnehin eindeutig ist? Sie können natürlich die Adresse als Namen für das Gebäude verwenden, da sie eindeutig ist. Allerdings sind Adressen oft sehr lang und Sie möchten vielleicht einen kürzeren Namen angeben, damit der Benutzer das Objekt leicht identifizieren kann.
Inhaltstypen werden in JSON-Dateien definiert, den Artikel der Wissensdatenbank zur Definition von Inhaltstypen finden Sie hier.
Der Inhaltstyp building mit den oben beschriebenen Feldern sieht wie folgt aus:
{
"$type": "contentType",
"name": "building",
"displayName": "Building",
"canBeInspected": true,
"titleFieldName": "building_name",
"icon": "",
"fields": [
{
"$type": "contentField",
"name": "building_name",
"displayName": "Building Name",
"isRequired": true
},
{
"$type": "contentField",
"name": "address",
"displayName": "Address",
"isRequired": true
},
{
"$type": "contentField",
"type": "FileEntry",
"name": "picture",
"displayName": "Picture"
}
],
"id": "216bf3e2-a3a1-4941-9e58-dccf79f2038b",
"version": 1
}
Die wichtigsten Dinge, die zu beachten sind:
- Die Eigenschaft "canBeInspected" ist auf "true" gesetzt, weil wir Inspektoren die Möglichkeit geben wollen, Gebäude zu inspizieren.
- Der "titleFieldName" ist der "building_name", also ein Pflichtfeld.
- Die "Adresse" ist aus offensichtlichen Gründen ebenfalls erforderlich.
- Die Eigenschaft "type" wird nur für das Bild definiert, da die beiden anderen Felder Textfelder sind, was der Standardwert ist.
Das war's! Wir haben eine Definition für einen Inhaltstyp, der ein Gebäude modellieren kann. Laden wir sie in das iCL Portal hoch und erstellen wir ein Inhaltselement dieses Typs!
Laden Sie die JSON-Datei in das iCL Portal hoch
Melden Sie sich mit Ihren Anmeldedaten am iCL Portal an und navigieren Sie zu "Einstellungen > Inhaltstypen".
Sie können die Datei durch Klicken auf die Schaltfläche Hochladen oder einfach per Drag&Drop in den Bereich hochladen.
Erstellen sie ein Inhaltselement des Typs building
Wenn der Upload erfolgreich war, sollten Sie den angegebenen Anzeigenamen des gegebenen Typs (in unserem Fall "Gebäude") im Menü "Inhalt" sehen können.
Um ein Gebäude-Inhaltselement im iCL Portal zu erstellen, klicken Sie auf die violette Schaltfläche "Gebäude erstellen". Füllen Sie die (erforderlichen) Felder aus und klicken Sie auf "Erstellen".
Wenn Sie zur Gebäudeliste zurückkehren, sollten Sie nun das soeben erstellte Objekt sehen.
Importieren Sie den Inhaltstyp in die Arbeitsmappe
Der nächste Schritt besteht darin, den Inhaltstyp zu importieren und in die Arbeitsmappe einzubinden.
Öffnen Sie die Arbeitsmappe im iCL Designer und klicken Sie mit der rechten Maustaste auf den Ordner 'Inhaltstypen' im Explorer-Fenster auf der linken Seite. Klicken Sie dann auf Import und wählen Sie die JSON-Datei aus.
Wählen Sie dann die Datei im Explorer-Fenster aus. Daraufhin werden die Eigenschaften der Datei auf der rechten Seite angezeigt. Um den Benutzern die Möglichkeit zu geben, Elemente dieses Inhaltstyps zu inspizieren, wählen Sie im Fenster "Eigenschaften" die Option "Wird inspiziert".
Nun erstellen wir ein Feld für das geprüfte Gebäude - sein Typ wird 'Inhaltselement' sein. Fügen Sie es der Überschrift 'Gebäude' hinzu und machen Sie es zu einem schreibgeschützten Feld.
Wie Sie in der obigen Abbildung sehen können, sind "Automatische Aktualisierungen" und "Automatisches Ausfüllen" aktiviert.
Wenn die Option "Automatisches Ausfüllen" aktiviert ist, werden die geprüften Elemente automatisch in das Feld in iCL Filler geladen.
Mit der Option "Automatische Updates" können Sie die Daten des Inhaltselements mithilfe seiner Mappings aktualisieren.
Automatische Aktualisierungen mit Zuordnungen
Der Inhaltstyp Gebäude hat 3 Felder: Name, Adresse und ein Bild. Erstellen wir Fragen, die diesen Feldern entsprechen (das Adressfeld existiert bereits).
Beachten Sie, dass das Bild kein Pflichtfeld in der Definition des Inhaltstyps ist, daher sollte das Bildfeld auch nicht zwingend sein.
Wir wollen die Daten aus dem Inhaltselement in diese Felder laden. Dazu müssen wir ein Blockly-Skript geskriptete Antwort für jede Frage erstellen, in der wir das entsprechende Feld des Inhaltselements verwenden.
Die "Scripted answer" des Adressfeldes sieht zum Beispiel so aus:
Auf diese Weise haben wir sichergestellt, dass die Daten aus dem Inhaltselement in die Checkliste geladen werden. Es kann jedoch sein, dass Sie den Wert einiger dieser Felder aktualisieren möchten, z. B. das Foto, weil das Gebäude neu gestrichen wurde. Wie wird dieses neue Foto wieder in das Inhaltselement geladen? Durch die "automatischen Aktualisierungen" und Mappings!
Verwenden Sie die Werte der neu erstellten Felder in den Mappings des Artikels.
Sie können die icl-Datei von hier herunterladen.
Starten Sie eine Inspektion mit zu prüfendem Inhaltselement in iCL Filler
Schauen wir uns das alles in iCL Filler an. Starten Sie eine neue Inspektion mit dieser Arbeitsmappe in der App.
Das erste, was Sie bemerken werden, ist, dass nach dem Start der Inspektion eine neue Seite erscheint. Es ist die Liste der Inhaltselemente, aus der Sie auswählen müssen, welches Sie inspizieren möchten. Wählen Sie ein Gebäude aus.
Jetzt können Sie sehen, dass der Gebäudename, die Adresse und das Bild in die angegebenen Felder geladen werden.
Angenommen, Sie bemerken einen Fehler in einem Wert. Im obigen Beispiel gibt es einen Fehler in der Adresse, die Postleitzahl ist falsch. Korrigieren Sie den Fehler, beenden Sie die Inspektion und schließen Sie sie ab.
Beachten Sie, dass die Position erst nach Abschluss der Inspektion aktualisiert wird! Dies hat einen Grund:
Bevor Sie eine Inspektion abschließen, können Sie die Daten in der Checkliste nach Belieben ändern - und zwar so, wie es die Checkliste erlaubt. Sie können sogar eine Inspektion abbrechen und damit die Daten in den Checklisten löschen. Inhaltselemente live zu ändern, wäre keine gute Idee, da Sie versehentlich Daten löschen oder beschädigen könnten.
Aus diesem Grund werden Änderungen an Inhaltselementen erst nach Abschluss der Inspektion übernommen.
Öffnen Sie nach Abschluss der Inspektion das iCL Portal und navigieren Sie zu dem Inhaltselement, das Sie inspiziert und aktualisiert haben. Wenn die Inspektion erfolgreich gesendet wurde, sollte das Element aktualisiert worden sein.
Verwendung einer Aufgabe zur Inspektion eines Gebäudes
Bis jetzt haben wir gesehen, wie Inspektoren Inspektionen in iCL Filler starten und ein zu inspizierendes Objekt für die jeweilige Inspektion auswählen können. Als Teamleiter möchten Sie jedoch vielleicht Inspektionen für Ihr Team planen, bei denen Sie vorgeben können, welches Gebäude inspiziert werden soll. Im iCL-System können Sie dafür tasks verwenden.
Navigieren Sie zu Ihrem Team im iCL Portal und klicken Sie auf 'Inspektion planen'.
Füllen Sie die erforderlichen Felder aus, wählen Sie die Arbeitsmappe und ein zu prüfendes Element. Weisen Sie die Aufgabe dem Benutzer zu, der das Gebäude inspizieren soll, oder geben Sie sie als selbst-zuweisbar an.
Wenn die Aufgabe erstellt und veröffentlicht ist, navigieren Sie zurück zu iCL Filler (mit dem richtigen Benutzer) und synchronisieren Sie.
Navigieren Sie dann zum Menü "Aufgaben" und wählen Sie die Aufgabe aus.
Wenn die Liste der Aufgaben zu lang ist, können Sie sie anhand des Titels der Aufgabe oder ihrer Referenz/Externer ID suchen.
Starten Sie die Aufgabe. Beachten Sie, dass dieses Mal die Seite, auf der Sie ein zu prüfendes Element auswählen können, übersprungen wird, da das geprüfte Element in der Aufgabe angegeben ist.
Zusammenfassung
In diesem Leitfaden haben Sie ein grundlegendes Verständnis von Inhaltstypen und Inhaltselementen erworben. Dieses Wissen wird Ihnen helfen, Daten im iCL-System effektiv zu verwalten und zu organisieren.
Wenn Sie mehr über Inhaltstypen (insbesondere Mängel) erfahren möchten, lesen Sie das nächste Tutorial!