Bevor Sie beginnen
Dieses Merkblatt erklärt, wie Sie die Liste der Kostenstellen einer Lucca-Instanz abrufen können. Dieser Artikel richtet sich an erfahrene Administratoren:innen.
Der Abruf von Daten geschieht in drei Schritten:
- Erstellen der API-Abfrage
- Generieren der Abfrage
- Auswerten der Antwort
Erstellen der API-Abfrage und Daten wiederherstellen
Die aktuelle Verwaltungsschnittstelle der analytischen Ausrichtungen ermöglichen nicht die Datenextraktion der Kostenstellen. Dies ist nur über eine API-Abfrage möglich.
Um diese Abfrage zu erstellen, können Sie sich auf die entsprechende Dokumentation verlassen.
Grundlage der Anfrage
Die Abfrage beginnt systematisch mit der URL Ihrer Datenbank. Daher benötigen Sie den Namen Ihrer Instanz, zum Beispiel {NomInstance}, gefolgt von /api/v3/axisSections, was erwähnt, dass Sie die Kostenstellen der analytischen Ausrichtungen abrufen möchten.
Dies ergibt schließlich: https://{NomInstance}.ilucca.net/api/v3/axisSections.
Auswahl der anzuzeigenden Felder
Wählen Sie dann die Felder aus, die Sie anzeigen möchten, und fügen Sie sie nach ...axisSections?fields= hinzu, indem Sie sie alle durch ein Komma trennen.
Wenn Sie beispielsweise den Benutzernamen, den Namen, den Code und ob er aktiv ist oder nicht, benötigen, erhalten Sie Folgendes: https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active
Welche Felder sind wiederherstellbar?
Dies ist je nach Bedarf unterschiedlich. Nachstehend finden Sie eine Liste der am meisten verwendeten Felder:
| Feldname | Beschreibung |
| ID | Entspricht der eindeutigen Bezeichnung der Kostenstelle. Dieses Feld ist erforderlich, um den Code einer Kostenstelle bei einem Import bearbeiten zu können. |
| Name | Name der Kostenstelle |
| Code | Code der Kostenstelle. Ein Pflichtfeld beim Import von Daten. |
| AxisId | Bezeichnung der analytischen Ausrichtung der Kostenstelle. Ein Pflichtfeld beim Import von Daten. |
| Active | Gibt an, ob die Kostenstelle archiviert wurde (active = false) oder nicht. |
| Owner | Verantwortliche:r der Kostenstelle. |
| ParentAxisSections | Kostenstellen der Ausrichtung, mit der die Kostenstelle verknüpft ist. |
| Departments | Bei Zugriffsbeschränkung: Abteilungen mit Zugriff auf die Kostenstelle. |
| LegalEntities | Bei Zugangsbeschränkung: Betriebe mit Zugriff auf die Kostenstelle. |
| Users | Bei Zugriffsbeschränkung: Benutzer:innen mit Zugriff auf die Kostenstelle. |
Sie können auch nach diesem Bild suchen:
(Optional) Filterung nach Achse
Anschließend können Sie beispielsweise nach der gewünschten Achse filtern.
Dazu müssen Sie die Achsenbezeichnung abrufen. Wenn Sie sich entscheiden, die Kostenstellen der analytischen Ausrichtung „Test“ hier anzuzeigen, müssen Sie die Bezeichnung 8 verwenden:
Es muss dann nach ...?fields=...&axisId=
zur URL hinzugefügt werden. Für den Fall dieser analytischen Ausrichtung mit der Bezeichnung 8 ergibt dies: https://{NomInstance}.ilucca.net/api/v3/axisSections?fields=id,name,code,active&axisId=8
Abfrage generieren
Sobald die Abfrage abgeschlossen ist, ist es am einfachsten, idie so erstellte URL in Ihrem Browser aufzurufen.
Verwenden Sie einen Browser, über den Sie kürzlich eine Verbindung zu Lucca hergestellt haben.
Das Abfrageergebnis verwenden
Die Antwort auf diese Abfrage geschieht im JSON-Format. Sie können diese mit einem Tool ganz einfach in das Excel-Format umwandeln (z. B.: http://www.convertcsv.com/json-to-csv.htm).
Normalerweise reicht es aus, die Antwort im JSON-Format in das Tool zu kopieren, um eine Excel-Datei zu erhalten.
Der zu kopierende Teil der Antwort ist in diesem Bild hervorgehoben:
Für das Beispiel der Seite https://www.convertcsv.com/json-to-csv.htm reicht es dann aus, es hier zu kopieren:
Im Ergebnisteil steht Ihnen die Excel- oder CSV-Version zur Verfügung.
Sie können diese Datei ebenfalls in diesem Format auswerten, falls Sie Ihre Änderungen erneut importieren möchten. Geben Sie in diesem Fall die Kennung in die Felder ein und geben Sie sie lieber in die erste Spalte ein. Andernfalls geben Sie den Code der Kostenstelle ein und geben Sie die Datei dann im CSV-Format mit einem „;“-Trennzeichen ein. Im Beispiel dieser Site befindet es sich im Tab „Optionen“.