Tabellen- und Feldzuordnung
Eine Jira Tabellenzuordnung legt fest, dass eine Business Central-Tabelle mit einem bestimmten Jira Entitätstyp synchronisiert wird. Aktuell werden folgende Kombinationen unterstützt:
| BC Quelltabelle | Jira Entitätstyp | Jira REST-Ressource |
|---|---|---|
| Debitor | Organisation | /rest/servicedeskapi/organization |
| Kontakt (nur Art Person) | Kunde | /rest/servicedeskapi/customer |
Pro Kombination aus BC-Tabelle und Jira Entitätstyp ist nur eine aktivierte Tabellenzuordnung zulässig.
Entitätskonfiguration
Die Seite Jira Entitätskonfigurationen legt je Jira Entitätstyp den REST-Endpunkt und die Verarbeitungsregeln fest, die von jeder Tabellenzuordnung für diese Entität verwendet werden:
| Feld | Bedeutung |
|---|---|
| Jira API Endpunkt | Relative REST-Ressource zum Erstellen oder Aktualisieren der Entität |
| Jira API Endpunkt (löschen) | Relative REST-Ressource zum Löschen der Entität; unterstützt die Platzhalter {entityId}/{organizationId} |
| Standard Verarbeitungspriorität | Standardpriorität für Nachrichten dieses Entitätstyps, sofern die Zuordnung sie nicht überschreibt (niedrigere Zahl = wird zuerst verarbeitet) |
| Löschen verhindern | Verhindert, dass Löschvorgänge für diesen Entitätstyp eingereiht werden |
| Standard Feld Änderung verhindern | Verhindert Änderungen an Standardfeldern, sobald der Datensatz bereits synchronisiert wurde |
| Erstellen falls Aktualisieren fehlschlägt | Reiht eine neue Erstellen-Nachricht ein, wenn eine Aktualisierung fehlschlägt, weil das Ziel in Jira nicht mehr existiert |
Standard-Entitätskonfigurationen für Organisation und Kunde werden automatisch beim ersten Ausführen des Einrichtungsassistenten oder der Aktion Standards initialisieren erstellt. Die Aktion Konfiguration testen auf der Entitätskonfigurationskarte zeigt den aufgelösten Endpunkt zusammen mit allen aktivierten Tabellenzuordnungen an, die ihn verwenden.
Tabellenzuordnung
Auf der Karte Jira Tabellenzuordnung legen die Bereiche Business Central Quelle und Jira Ziel die BC-Tabelle und den Jira Entitätstyp fest; diese können nicht mehr geändert werden, sobald die Zuordnung Aktiviert ist. Der Bereich Verbindung wählt den zu verwendenden OAuth2 Einrichtung Code, mit optionaler Überschreibung der Basis URL. Der Bereich Status zeigt die Mapping Beschreibung und die Anzahl der Aktive Felder an.
Eine Zuordnung kann nur aktiviert werden, wenn:
- eine OAuth2 Einrichtung ausgewählt ist, die sowohl eine Client ID als auch ein Client Secret besitzt,
- die OAuth2 Einrichtung über eine Cloud ID verfügt (d. h. die Autorisierung wurde abgeschlossen), und
- eine Basis URL verfügbar ist, entweder auf der Zuordnung oder auf der OAuth2 Einrichtung.
Das Deaktivieren einer Zuordnung ist blockiert, solange noch ausstehende, in Verarbeitung befindliche oder zur Wiederholung vorgesehene Nachrichten dafür existieren.
Auf der Karte der Tabellenzuordnung verfügbare Aktionen:
- Standard Mappings erstellen - erstellt eine empfohlene Menge an Feldzuordnungen für den gewählten Entitätstyp (siehe Feldzuordnung).
- Datensätze für Synchronisation wählen - aktiviert die Synchronisation für bestehende Datensätze in großer Zahl (siehe unten).
- Aktivierungsregeln - konfiguriert die automatische Aktivierung der Synchronisation (siehe Automatische Aktivierung).
- Entitätskonfiguration öffnen - öffnet die Entitätskonfigurationskarte für den zugeordneten Entitätstyp.
- Verfügbare Spaces abrufen - lädt Jira Service Management Spaces für die Space-Zuordnung.
- Mapping testen - erstellt eine Beispiel-Payload aus dem ersten Datensatz der Quelltabelle, ohne sie an Jira zu senden.
- Gegen Jira validieren - prüft, ob die in den Feldzuordnungen verwendeten benutzerdefinierten Felder tatsächlich in Jira existieren.
Feldzuordnung
Feldzuordnungen, angezeigt im Teilbereich Feldzuordnungen der Tabellenzuordnungskarte, legen fest, welches Business Central-Feld an welches Jira-Feld gesendet wird:
| Feld | Bedeutung |
|---|---|
| Feldkategorie | Standard Feld (eingebautes Jira-Feld, z. B. Name) oder Benutzerdefiniertes Feld (organisationsspezifisches Jira-Feld) |
| BC Quellfeld | Das zu synchronisierende Business Central-Feld |
| Jira Feld ID | Die Ziel-Feld-ID oder der Name in Jira |
| Jira Feldtyp | Text, E-Mail, URL, Datum, Zahl, Boolesch, Telefon, Auswahl oder Mehrfachauswahl |
| Standard Wert sofern Feld leer ist | Wert, der an Jira gesendet wird, wenn das BC-Feld leer ist |
| Mapping Aktiviert | Ob die Feldzuordnung aktiv ist |
| Feldzweck / Beschreibung | Freitextnotiz zur Beschreibung des Zwecks des Feldes (standardmäßig ausgeblendet) |
Zuordnungen mit Benutzerdefiniertes Feld werden über die Detailfelder-API von Organisation/Kunde an Jira gesendet statt über den Standard-Erstell-/Aktualisierungsaufruf, wofür zusätzliche OAuth2 Scopes benötigt werden - siehe Zusätzliche Scopes - nur bei Verwendung von Detailfeldern erforderlich.
Innerhalb einer Tabellenzuordnung ist pro BC-Feld nur eine Feldzuordnung zulässig. Bei benutzerdefinierten Feldern muss die Jira Feld ID mindestens zwei Zeichen lang sein, darf ? : ; . = " nicht enthalten und darf nicht eines der reservierten Wörter Name, Key, Created, Updated oder Label sein. Die Aktion Feldwert testen zeigt den aufgelösten Wert für den ersten Datensatz der Quelltabelle an.
Mit Standard Mappings erstellen auf der Tabellenzuordnungskarte wird eine empfohlene Menge an Feldzuordnungen für den gewählten Entitätstyp angelegt; bestehende Zuordnungen werden nach Bestätigung gelöscht.
Kombinierter Name
Durch Aktivieren von Kombinierter Name aktivieren auf der Tabellenzuordnung erhält Jira einen aus mehreren Business Central-Feldern zusammengesetzten Namen, unter Verwendung einer Vorlage für Kombinierter Name mit Feldnamen in geschweiften Klammern, zum Beispiel:
{No.} - {Name}
Der resultierende Wert wird im Feld Jira kombinierter Name auf der Debitoren- oder Kontaktkarte gespeichert. Er wird automatisch neu berechnet, sobald sich ein in der Vorlage verwendetes Feld am Datensatz ändert, sowie - wenn der kombinierte Name erstmalig auf der Zuordnung aktiviert wird - für alle bereits für die Synchronisation aktivierten Datensätze, begleitet von einem Fortschrittsdialog.
Massenaktivierung der Synchronisation für bestehende Datensätze
Mit Datensätze für Synchronisation wählen auf der Tabellenzuordnung kann die Synchronisation für viele bestehende Datensätze gleichzeitig aktiviert werden, statt einzeln:
- Datensätze für Synchronisation wählen auf der Tabellenzuordnungskarte oder -liste auswählen.
- Über den Standard-Filterdialog die einzubeziehenden Datensätze eingrenzen.
- Die Auswahl bestätigen.
Alle passenden Datensätze, für die die Synchronisation noch nicht aktiviert ist, werden aktualisiert, und eine Bestätigungsmeldung zeigt an, wie viele Datensätze verarbeitet wurden. Datensätze werden nur eingereiht, wenn die Tabellenzuordnung und ihre Feldzuordnungen bereits vollständig konfiguriert sind, wie oben beschrieben. Bei Kontakten werden nur Datensätze mit Art Person berücksichtigt, passend zu den unterstützten Kombinationen.
Zuordnung von Datensätzen zu Jira Service Management Spaces
Ein Space bezeichnet einen Jira Service Management Service Desk. Organisationen und Kunden können bei der Synchronisation automatisch mit einem oder mehreren Spaces verknüpft werden:
- Auf der Tabellenzuordnungskarte Verfügbare Spaces abrufen auswählen, um Spaces aus Jira Service Management zu laden (erfordert eine autorisierte OAuth2 Einrichtung).
- Die zu verwendenden Spaces auswählen und bestätigen; sie werden dem Teilbereich Zugewiesene Jira Spaces auf der Tabellenzuordnungskarte hinzugefügt.
Standardmäßig wird jeder synchronisierte Datensatz mit allen zugewiesenen Spaces verknüpft. Um einen Space auf passende Datensätze zu beschränken:
- Im Teilbereich Zugewiesene Jira Spaces für den Space Filter aktivieren einschalten.
- Filter bearbeiten auswählen, um den Filter-Generator zu öffnen und die Kriterien festzulegen.
- Mit Passende Datensätze anzeigen prüfen, welche Datensätze aktuell zutreffen, oder mit Filter leeren die Einschränkung wieder entfernen (dann werden alle Datensätze zugewiesen).
Der Filter-Generator ist mit häufig verwendeten Feldern vorbelegt, es können jedoch auch weitere Felder der Quelltabelle hinzugefügt werden:
| Quelltabelle | Vorbelegte Filterfelder |
|---|---|
| Debitor | Nr., Land/Regionscode, Debitorenbuchungsgruppe, Debitor Preisgruppe |
| Kontakt | Nr., Land/Regionscode, Art, Firma Nr. |
Wenn ein Debitor oder Kontakt synchronisiert und in Jira erstellt wird, verknüpft der Connector die entstehende Organisation bzw. den Kunden automatisch mit jedem zugewiesenen Space, dessen Filter zutrifft (bzw. mit allen zugewiesenen Spaces, sofern für diesen Space kein Filter gesetzt ist).