Aby importować i eksportować dane oraz wykonywać funkcje ogólnej automatyzacji i administracji w BlackLine® jako część łańcucha, dodaj krok korzystający z polecenia połączenia BlackLine OAuth2.
Uwaga: Gdy używasz polecenia do importowania danych do BlackLine, wymagana jest inna struktura danych w zależności od typu importu. Wdata zajmie się tym za Ciebie, ale format danych powinien być zgodny z szablonami importu BlackLine.
Aby włączyć te polecenia, administrator IT najpierw konfiguruje połączenie BlackLine OAuth2.
Ustawienia konta
Aby zaimportować dane ustawień konta w pliku CSV (comma-separated values) do BlackLine, dodaj polecenie Ustawienia konta .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu ustawień konta. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Konta
Aby zaimportować dane konta w pliku CSV do BlackLine, dodaj polecenie Accounts .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu kont. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Salda bankowe
Aby zaimportować dane salda bankowego w pliku CSV do BlackLine, dodaj polecenie Bank Balances .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/bank-balances/put
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu sald bankowych. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Kursy walut
Aby zaimportować dane kursów walut w pliku CSV do BlackLine, dodaj polecenie Currency Rates .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/cross-currency-rates/put
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu kursów walut. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Pobierz raport
Aby pobrać raport z BlackLine, dodaj polecenie Download Report .
Uwaga: Aby upewnić się, że raport jest dostępny do pobrania, zalecamy utworzenie harmonogramu w BlackLine, aby automatycznie uruchamiać raport w regularnych odstępach czasu, np. co 30-45 dni.
Równoważne wywołanie API
Właściwości
Właściwość |
Szczegóły |
Identyfikator raportu |
Wprowadź identyfikator raportu do pobrania. |
Format |
Wybierz format raportu. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Raport |
Plik |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Podmioty
Aby zaimportować dane podmiotów w pliku CSV do BlackLine, dodaj polecenie Entities .
Równoważne wywołanie API: https://developer.blackline.com/docs/master-data/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu podmiotów. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Typy podmiotów
Aby zaimportować dane typów podmiotów w pliku CSV do BlackLine, dodaj polecenie Entity Types .
Równoważne wywołanie API: https://developer.blackline.com/docs/master-data/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu typów podmiotów. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Pobierz błędy importu
Aby pobrać listę błędów, które wystąpiły podczas importu, dodaj polecenie Get import errors .
Równoważne wywołanie API: NIE DOTYCZY
Właściwości
Właściwość |
Szczegóły |
Identyfikator importu |
Unikalny identyfikator procesu importu. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Błędy |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Pozycje
Aby zaimportować dane pozycji w pliku CSV do BlackLine, dodaj polecenie Items .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/items/put
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu pozycji. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Importuj dane
Aby zaimportować dostarczone dane, dodaj polecenie Importuj dane .
Równoważne wywołanie API: NIE DOTYCZY
Właściwości
Właściwość |
Szczegóły |
Identyfikator importu |
ID (nazwa profilu importu) importu. |
Format |
Format importowanych danych.
Opcje:
|
Dane |
Dane do zaimportowania. |
Ogranicznik |
Ogranicznik danych do zaimportowania. Ma to zastosowanie tylko w przypadku korzystania z formatu danych CSV.
Opcje:
|
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Lista raportów
Aby wyświetlić listę raportów dostępnych do pobrania w BlackLine, dodaj polecenie List Reports .
Uwaga: Aby zapewnić dostępność raportów do pobrania, zalecamy utworzenie harmonogramu w BlackLine w celu automatycznego uruchamiania raportów w regularnych odstępach czasu, np. co 30-45 dni.
Równoważne wywołanie API:
Właściwości
Brak
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Raport |
Plik |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Salda w wielu walutach
Aby zaimportować dane sald wielowalutowych w pliku CSV do BlackLine, dodaj polecenie Multi-Currency Balances .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu sald wielowalutowych. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Księgi pomocnicze
Aby zaimportować dane subledgers w pliku CSV do BlackLine, dodaj polecenie Subledgers .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu Subledgers. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Automatyczna certyfikacja zadania zakończona
Aby zaimportować dane o ukończonych zadaniach autocertyfikacji w pliku CSV do BlackLine, dodaj polecenie Task Auto-Certify Completed .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu Auto-Certify Completed dla zadania. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Zależności od zadań
Aby zaimportować dane o zależnościach zadań w pliku CSV do BlackLine, dodaj polecenie Task Dependencies .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu zależności zadań. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Zadania
Aby zaimportować dane zadań w pliku CSV do BlackLine, dodaj polecenie Tasks .
Równoważne wywołanie API: https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu zadań. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Przypisania konta użytkownika
Aby zaimportować dane przypisań kont użytkowników w pliku CSV do BlackLine, dodaj polecenie User Account Assignments .
Równoważne wywołania API
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu przypisań kont użytkowników. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Jednostki użytkownika
Aby zaimportować dane jednostek użytkowników w pliku CSV do BlackLine, dodaj polecenie User Entities .
Równoważne wywołanie API: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu User Entities. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Role użytkowników
Aby zaimportować dane ról użytkowników w pliku CSV do BlackLine, dodaj polecenie User Roles .
Równoważne wywołanie API: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu ról użytkowników. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |
Użytkownicy
Aby zaimportować dane użytkowników w pliku CSV do BlackLine, dodaj polecenie Users .
Równoważne wywołanie API: https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Właściwości
Właściwość |
Szczegóły |
Ogranicznik |
Wprowadź separator używany w pliku CSV. |
Źródło danych CSV |
Wprowadź plik CSV zawierający dane do importu użytkowników. |
Mapowania kolumn |
Import wymaga określonej kolejności kolumn, zgodnie z szablonem importu BlackLine. Jeśli plik CSV ma takie same nazwy nagłówków jak szablon importu, pozostaw puste pole. W przeciwnym razie zmapuj kolumny w CSV na kolumny w szablonie importu, np. ID -> Entity Unique Identifier . |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Importuj |
JSON |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
1 |
Błąd |
Wystąpił błąd podczas importu |