Asset Schema
Jira Assets (Insight) organisiert Daten in einem Schema, das aus Objekttypen (zum Beispiel Debitor oder Projekt) besteht, die jeweils eigene Attribute (zum Beispiel Name oder Land) besitzen. Bevor Business Central-Datensätze als Assets synchronisiert werden können, muss diese Struktur in Business Central vorhanden sein - entweder automatisch als empfohlener Standard erstellt oder manuell passend zu einem bestehenden Jira Assets Schema modelliert.
Standard-Schema
Auf der Seite Jira Asset Schemata kann mit Standard DYCE-Schema erstellen der empfohlene Ausgangspunkt in einem Schritt erstellt werden: ein Schema mit dem Namen DYCE Business Central (Code DYCE_CORE, Schema Schlüssel DYCEBC) mit vier Objekttypen - Customer, Customer Employee, Project und Service Asset - samt ihrer Attribute und den passenden Tabellen- und Feldzuordnungen. Dies kann wiederholt ausgeführt werden; bereits passende Konfiguration wird wiederverwendet statt dupliziert.
Das Attribut Job Planning Line ID des Objekttyps Service Asset trägt die Business Central System-ID der zugrunde liegenden Projektplanzeile; DYCE Time Tracking verwendet es, um Zeiterfassungen vorzubelegen - siehe Service Assets anlegen.
Schema, Objekttyp und Attribut
| Seite | Zeigt |
|---|---|
| Jira Asset Schemata | Alle Schemata mit Code, Name, Schema Schlüssel, Sync Status und Jira ID |
| Jira Asset Schema Karte | Code, Name, Schema Schlüssel (2-10 Großbuchstaben oder Ziffern), Beschreibung, OAuth Einrichtung Code, Sync Status, Jira ID sowie die zum Schema gehörenden Objekttypen |
| Jira Asset Objekttyp Karte | Schema Code, Code, Name, Bild ID, Sync Status, Jira ID sowie die zum Objekttyp gehörenden Attribute |
| Jira Asset Attribute (Teilbereich auf der Objekttyp Karte) | Code, Name, Datentyp, Optionen (nur bei Datentyp Auswahl), Ist Pflicht, Ist eindeutig, Objekttypen Code Referenz (nur bei Datentyp Objekt Referenz), Sync Status |
Jeder neue Objekttyp erhält automatisch ein verpflichtendes, nicht löschbares Systemattribut mit dem Namen Name.
Attribut Datentypen
Jedes Attribut besitzt einen der folgenden Datentypen: Text, Ganzzahl, Boolean, Datum, DateTime, URL, E-Mail, Auswahl oder Objekt Referenz. Ein Attribut mit Objekt Referenz verweist auf einen anderen Objekttyp desselben Schemas (dessen Objekttypen Code Referenz) und kann nur von einer Feldzuordnung angesprochen werden, deren Business Central-Quellfeld über eine Tabellenbeziehung verfügt - siehe Feldzuordnung.
Sync Status und Übertragung an Jira
Schema, Objekttyp und Attribut besitzen jeweils einen Sync Status: Draft, solange sie nur in Business Central definiert sind, und Synced, sobald sie an Jira übertragen wurden. Ein Datensatz mit Status Synced kann in Business Central nicht mehr direkt bearbeitet werden; Änderungen erfolgen am entsprechenden Datensatz in Jira, oder es wird ein neues Attribut mit Status Draft hinzugefügt und separat übertragen.
Aktionen:
- Zu Jira senden - verfügbar, solange das Schema den Status Draft hat; erstellt das Schema, seine Objekttypen und deren Attribute in Jira Assets und setzt sie auf Synced.
- Neue Attribute übertragen (Seite Jira Asset Schemata) / Neue Attribute übertragen (Karte Jira Asset Schema) - verfügbar, sobald das Schema Synced ist; überträgt nur seither hinzugefügte Attribute, ohne den bereits in Jira vorhandenen Stand zu verändern.
Das Löschen eines Schemas, Objekttyps oder Attributs, das bereits Synced ist, erfordert eine Bestätigung, da es dadurch nicht aus Jira entfernt wird. Ist es noch von einer Tabellenzuordnung, einer Feldzuordnung oder als Ziel eines Attributs mit Objektreferenz referenziert, ist das Löschen nicht möglich.