Pour importer et exporter des données et exécuter des fonctions d'automatisation et d'administration générales dans BlackLine® dans le cadre d'une chaîne, ajoutez une étape qui utilise une commande de connexion BlackLine OAuth2.
Note : Lorsque vous utilisez une commande pour importer des données dans BlackLine, une structure de données différente est requise en fonction du type d'importation. Wdata s'en charge pour vous, mais le format des données doit se mettre en forme avec les modèles d'importation de BlackLine.
Pour activer ces commandes, un administrateur informatique commence par connecter une connexion BlackLine OAuth2.
Paramètres du compte
Pour importer des données de paramètres de compte dans un fichier de valeurs séparées par des virgules (CSV) dans BlackLine, ajoutez une commande Paramètres de compte .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des paramètres du compte. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Comptes
Pour importer des données de compte dans un fichier CSV vers BlackLine, ajoutez une commande Accounts .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des comptes. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Soldes bancaires
Pour importer des données de solde bancaire dans un fichier CSV vers Blackline, ajoutez une commande Bank Balances .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/bank-balances/put
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des soldes bancaires. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Taux de change
Pour importer des données sur les taux de change dans un fichier CSV vers Blackline, ajoutez une commande Currency Rates .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/cross-currency-rates/put
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des taux de change. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Télécharger le rapport
Pour télécharger un rapport depuis BlackLine, ajoutez une commande Download Report .
Note : Pour vous assurer qu'un rapport est disponible au téléchargement, nous vous recommandons de créer un calendrier dans BlackLine afin d'exécuter automatiquement le rapport à intervalles réguliers, par exemple tous les 30 à 45 jours.
Appel API équivalent :
Propriétés
Propriété |
Détail |
ID du rapport |
Saisissez l'ID du rapport à télécharger. |
Mettre en forme |
Sélectionnez la forme du rapport. |
Sorties
Sortie |
Type de sortie |
Rapport |
Fichier |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Entités
Pour importer des données d'entités dans un fichier CSV vers Blackline, ajoutez une commande Entities .
Appel API équivalent : https://developer.blackline.com/docs/master-data/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des entités. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Types d'entités
Pour importer des données sur les types d'entités dans un fichier CSV vers BlackLine, ajoutez une commande Entity Types .
Appel API équivalent : https://developer.blackline.com/docs/master-data/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des types d'entités. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Obtenir les erreurs d'importation
Pour obtenir une liste des erreurs survenues lors d'une importation, ajoutez une commande Get import errors .
Appel API équivalent : N/A
Propriétés
Propriété |
Détail |
ID d'importation |
L'identifiant unique du processus d'importation. |
Sorties
Sortie |
Type de sortie |
Erreurs |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Éléments
Pour importer des données d'articles dans un fichier CSV vers Blackline, ajoutez une commande Items .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/items/put
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des éléments. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Importer des données
Pour importer les données fournies, ajoutez une commande Importation de données .
Appel API équivalent: N/A
Propriétés
Propriété |
Détail |
ID d'importation |
L'ID (nom du profil d'importation) de l'importation. |
Mettre en forme |
Le format des données importées.
Options :
|
Données |
Les données à importer. |
Séparateur |
Le délimiteur des données à importer. Cela ne s'applique que si l'on utilise le format de données CSV.
Options :
|
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Lister les rapports
Pour dresser la liste des rapports disponibles au téléchargement dans BlackLine, ajoutez une commande List Reports .
Note : Pour vous assurer que les rapports sont disponibles au téléchargement, nous vous recommandons de créer un calendrier dans BlackLine afin d'exécuter automatiquement les rapports à intervalles réguliers, par exemple tous les 30 à 45 jours.
Appel API équivalent :
Propriétés
Aucun
Sorties
Sortie |
Type de sortie |
Rapport |
Fichier |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Soldes multidevises
Pour importer des données de soldes multidevises dans un fichier CSV vers BlackLine, ajoutez une commande Soldes multidevises .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/multi-currency-balances/put
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des soldes multidevises. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Sous-livres
Pour importer des données de comptabilité auxiliaire dans un fichier CSV vers Blackline, ajoutez une commande Subledgers .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-accounts-api/1/routes/dataingestion/accounts/subledgers/put
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation de Subledgers. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Autocertification de la tâche terminée
Pour importer dans BlackLine des données sur les tâches d'autocertification terminées dans un fichier CSV, ajoutez une commande Task Auto-Certify Completed .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation de la tâche Auto-Certify Completed. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Dépendances des tâches
Pour importer dans BlackLine des données sur les dépendances des tâches dans un fichier CSV, ajoutez une commande Task Dependencies .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des dépendances des tâches. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Tâches
Pour importer des données de tâches dans un fichier CSV vers Blackline, ajoutez une commande Tasks .
Appel API équivalent : https://developer.blackline.com/docs/data-ingestion-tasks-api/1/overview
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des tâches. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Attribution des comptes utilisateurs
Pour importer des données d'attributions de comptes d'utilisateurs dans un fichier CSV vers BlackLine, ajoutez une commande Attributions de comptes d'utilisateurs .
Appels API équivalents :
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des attributions de comptes d'utilisateurs. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Entités utilisatrices
Pour importer des données d'entités d'utilisateurs dans un fichier CSV vers Blackline, ajoutez une commande User Entities .
Appel API équivalent : https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/entities/get
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Saisissez le fichier CSV qui contient les données pour l'importation des entités utilisateur. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Rôles des utilisateurs
Pour importer des données sur les rôles des utilisateurs dans un fichier CSV vers Blackline, ajoutez une commande User Roles .
Appel API équivalent : https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des rôles utilisateurs. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |
Utilisateurs
Pour importer les données des utilisateurs dans un fichier CSV vers Blackline, ajoutez une commande Users .
Appel API équivalent : https://developer.blackline.com/docs/users/1/routes/v1/users/%7Bid%7D/roles-products/get
Propriétés
Propriété |
Détail |
Séparateur |
Entrez le délimiteur utilisé dans le fichier CSV. |
Source de données CSV |
Entrez le fichier CSV qui contient les données pour l'importation des utilisateurs. |
Mappages des colonnes |
L'importation nécessite un ordre spécifique des colonnes, tel que prescrit dans le modèle d'importation BlackLine. Si le fichier CSV a les mêmes noms d'en-tête que le modèle d'importation, ne rien indiquer. Sinon, mappez les colonnes du CSV aux colonnes du modèle d'importation, par exemple ID -> Identifiant unique de l'entité . |
Sorties
Sortie |
Type de sortie |
Importer |
JSON |
Codes de sortie
Code |
Type |
Détail |
0 |
Avec succès |
Avec succès |
1 |
Erreur |
Une erreur s'est produite lors de l'importation. |