Um Daten zu importieren und zu exportieren und Funktionen zur allgemeinen Automatisierung und Verwaltung innerhalb von BlackLine® als Teil einer Kette durchzuführen, fügen Sie einen Schritt hinzu, der einen BlackLine OAuth2-Verbindungsbefehl verwendet.
Hinweis: Wenn Sie einen Befehl zum Importieren von Daten in BlackLine verwenden, ist je nach Importtyp eine andere Datenstruktur erforderlich. Wdata übernimmt dies für Sie, aber das Format der Daten sollte den BlackLine-Importvorlagen entsprechen.
Um diese Befehle zu aktivieren, konfiguriert ein IT-Administrator zunächst eine BlackLine OAuth2-Verbindung.
Kontoeinstellungen
Um Kontoeinstellungsdaten in einer Datei mit kommagetrennten Werten (CSV) in BlackLine zu importieren, fügen Sie den Befehl Kontoeinstellungen hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Kontoeinstellungen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Konten
Um Kontodaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Konten hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Kontenimport enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Bankguthaben
Um Banksaldodaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Banksalden hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/bank-balances/put
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Banksalden enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Wechselkurse
Um Währungskursdaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Währungskurse hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/cross-currency-rates/put
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Währungskurse enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Bericht herunterladen
Um einen Bericht von BlackLine herunterzuladen, fügen Sie den Befehl Download Report hinzu.
Hinweis: Um sicherzustellen, dass ein Bericht zum Herunterladen zur Verfügung steht, empfehlen wir Ihnen, in BlackLine einen Zeitplan zu erstellen, um den Bericht automatisch in regelmäßigen Abständen auszuführen, z. B. alle 30-45 Tage.
Äquivalenter API-Aufruf
Eigenschaften
Eigenschaft |
Einzelheiten |
Bericht-ID |
Geben Sie die ID des Berichts ein, den Sie herunterladen möchten. |
Formatieren |
Wählen Sie das Format für den Bericht. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht |
Datei |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Entitäten
Um Daten von Entitäten aus einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Entitäten hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/master-data/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import von Entitäten enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Entitätstypen
Um Entitätsarten-Daten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Entitätsarten hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/master-data/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import von Entitätstypen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Importfehler abrufen
Um eine Liste der Fehler abzurufen, die während eines Imports aufgetreten sind, fügen Sie den Befehl Get import errors hinzu.
Äquivalenter API-Aufruf: N/A
Eigenschaften
Eigenschaft |
Einzelheiten |
Import-ID |
Die eindeutige ID des Importprozesses. |
Ausgaben
Ausgabe |
Art der Ausgabe |
Fehler |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Elemente
Um Artikeldaten aus einer CSV-Datei in BlackLine zu importieren, fügen Sie einen Befehl Items hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/items/put
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Artikelimport enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Daten importieren
Um die bereitgestellten Daten zu importieren, fügen Sie den Befehl Daten importieren hinzu.
Äquivalenter API-Aufruf: N/A
Eigenschaften
Eigenschaft |
Einzelheiten |
Import-ID |
Die ID (Importprofilname) des Imports. |
Formatieren |
Das Format der Importdaten.
Optionen:
|
Daten |
Die zu importierenden Daten. |
Trennzeichen |
Das Begrenzungszeichen der zu importierenden Daten. Dies gilt nur bei Verwendung des CSV-Datenformats.
Optionen:
- Komma
- Tabulatorzeichen
- Rohrleitung
|
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Berichte auflisten
Um die in BlackLine zum Download verfügbaren Berichte aufzulisten, fügen Sie den Befehl List Reports hinzu.
Hinweis: Um sicherzustellen, dass die Berichte zum Herunterladen zur Verfügung stehen, empfehlen wir Ihnen, in BlackLine einen Zeitplan zu erstellen, um die Berichte automatisch in regelmäßigen Abständen auszuführen, z. B. alle 30-45 Tage.
Äquivalenter API-Aufruf:
Eigenschaften
Keine
Ausgaben
Ausgabe |
Art der Ausgabe |
Bericht |
Datei |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Mehrwährungssalden
Um Salden in mehreren Währungen aus einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Multi-Currency Balances hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Salden in mehreren Währungen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Nebenbücher
Um Nebenbuchhaltungsdaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Nebenbuchhaltung hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import von Nebenbüchern enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Aufgabe Auto-Zertifizierung abgeschlossen
Um Daten über abgeschlossene Autozertifizierungsaufgaben in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Task Auto-Certify Completed hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Aufgabe Auto-Zertifizierung abgeschlossen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Abhängigkeiten von Aufgaben
Um Daten über Aufgabenabhängigkeiten aus einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Task Dependencies hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Aufgabenabhängigkeiten enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Aufgaben
Um Aufgabendaten aus einer CSV-Datei in BlackLine zu importieren, fügen Sie einen Befehl Aufgaben hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Aufgabenimport enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Zuweisung von Benutzerkonten
Um Daten zu Benutzerkontozuweisungen in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Benutzerkontozuweisungen hinzu.
Äquivalente API-Aufrufe
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Benutzerkontozuordnungen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Benutzerentitäten
Um die Daten von Benutzerentitäten aus einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Benutzerentitäten hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import von Benutzerentitäten enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Benutzerrollen
Um Benutzerrollendaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl User Roles hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Import der Benutzerrollen enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Exit-Codes
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |
Benutzer
Um Benutzerdaten in einer CSV-Datei in BlackLine zu importieren, fügen Sie den Befehl Users hinzu.
Äquivalenter API-Aufruf: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Eigenschaften
Eigenschaft |
Einzelheiten |
Trennzeichen |
Geben Sie das in der CSV-Datei verwendete Begrenzungszeichen ein. |
CSV-Datenquelle |
Geben Sie die CSV-Datei ein, die die Daten für den Benutzerimport enthält. |
Spaltenzuordnungen |
Der Import erfordert eine bestimmte Spaltenreihenfolge, wie sie in der BlackLine-Importvorlage vorgegeben ist. Wenn die CSV-Datei die gleichen Kopfzeilennamen wie die Importvorlage hat, lassen Sie sie leer. Andernfalls ordnen Sie die Spalten in der CSV den Spalten in der Importvorlage zu, z. B. ID -> Entity Unique Identifier . |
Ausgaben
Ausgabe |
Art der Ausgabe |
Importieren |
JSON |
Codes für die Beendigung
Code |
Typ |
Einzelheiten |
0 |
Erfolg |
Erfolg |
1 |
Fehler |
Es gab einen Fehler beim Import |