Aperçu

Il peut arriver que vous souhaitiez remplacer les informations d’un champ de base de données sur votre étiquette par de nouvelles données pour un travail d’impression. Cette action s’appelle une substitution de base de données. Lorsque vous effectuez un appel à l’API REST de BarTender Cloud, il peut être difficile de savoir à quoi cela ressemble dans votre programme ou application cliente.

Cet article fournit un exemple d’action d’impression (incluant une substitution de base de données) que vous pouvez envoyer à l’API REST de BarTender Cloud.

S’applique à

BarTender Cloud

Informations

Préparation du document

Avant de passer à l’exemple, préparons le document qui sera utilisé avec l’action d’impression.

1. Créez un nouveau document dans le BarTender Cloud Designer.
2. Cliquez sur l’icône Configuration de la base de données en haut à gauche de l’écran pour ouvrir l’Assistant de configuration de la base de données.

3. Cliquez sur Fichier texte puis sur Suivant.
4. Sélectionnez Données d’exemple intégrées puis cliquez sur Suivant.
5. Collez les données d’exemple ci-dessous puis cliquez sur Suivant.

6. Suivez les étapes restantes de l’Assistant de configuration de la base de données pour terminer la connexion à votre base de données.

Exemple de payload

Voici un exemple de payload incluant une substitution de base de données. Cet exemple est en JSON, mais vous pouvez aussi utiliser YAML. Vous pouvez faire défiler l’exemple complet à l’aide de la barre de défilement à droite.

[
    {
        "SetVariableAction": {
            "VariableName": "EventData",
            "VariableValue": "Id,name,year\r\n1,7325856667720,KS2451-Test1,2020\r\n2,7325856667721,KS2451-Test2,2024\r\n3,1234,test3,22"
        }
    },
    {
        "PrintBTWAction": {
            "DocumentFile": "librarian://main/test.btw",
            "Name": "Print Document",
            "Printer": "PDF",
            "SaveAfterPrint": false,
            "Copies": 1,
            "ReturnPrintData": "true",
            "ReturnPrintSummary": "true",
            "PrintToFileFileName": "myOutput.PDF",
            "PrintToFileFolder": "librarian://main/pdf/",
            "PrintToFileNameVariable": "myPdfOutput",
            "MakeUniqueOutputFile": "true",
            "DatabaseOverrides": [
                {
                  "Name": "Text",
                  "Type": "VariableName",
                  "DataSourceVariableName": "EventData"
                }
            ]
        }
    }

Pour plus d’informations, consultez les ressources ci-dessous.

Ressources supplémentaires

Aide en ligne BarTender Cloud - Référence YAML pour les substitutions de base de données

Présentation de l’API REST BarTender Cloud

Authentification et jetons de l’API REST BarTender Cloud

Types d’applications de l’API REST BarTender Cloud