"output_data": [{
      "id":"solution.csv"
}]

Actifs de données

Vous pouvez utiliser les références des biens de données pour localiser tout bien de données présent dans votre espace et bénéficier des capacités d'intégration des connecteurs de données.

Vous pouvez spécifier l'emplacement de la sortie en utilisant un " href, si le bien existe déjà dans l'espace, et le bien est mis à jour. Exemple :

      "location": {
           "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }

Vous pouvez également créer un bien en spécifiant le nom du bien et une description. Cet exemple crée le bien " solution.csv.

      "location": {
            "name": "solution.csv",
            "description": "solution description"
      }

Cet exemple définit des références de données de sortie pour mettre à jour un bien de données dans un espace.

output_data_references": [{
      "type": "data_asset",
      "id" : "solution.csv",
      "connection": {},
      "location": {
            "href": "/v2/assets/<ASSET_ID>?space_id=<SPACE_ID>"
      }
}]

Vous pouvez également enregistrer vos données de sortie sous la forme d'une ressource portant un nom différent en utilisant le champ " name. Cet exemple crée un bien de sortie nommé " my_solution.csv dans l'espace courant.

"output_data_references": [{
      "type" : "data_asset",
      "id" : "solution.csv",
      "connection": {},
      "location": {
            "name": "my_solution.csv"
      }
}]

Cet exemple vous montre comment enregistrer un fichier Microsoft Excel dans un espace.

"output_data_references": [{
      "type": "data_asset",
      "id": "kpis.csv",
      "connection": {},
      "location": {
            "id": "<SPACE_ID>"
            "name": "kpis.xlsx"
      }
}]

Vous pouvez également utiliser une expression régulière comme identifiant. Pour plus d'informations, voir Regexp.

Actifs de connexion

Vous pouvez utiliser des actifs de connexion pour référencer n'importe quelles données et vous référer ensuite à la connexion sans avoir à spécifier les informations d'identification à chaque fois. Le référencement d'une connexion sécurisée sans avoir à utiliser des informations d'identification en ligne dans le contenu renforce également la sécurité. Vous pouvez utiliser le id pour identifier les connexions. Exemple :

"output_data_references": [{
      "type": "connection_asset",
      "id": "solution.csv",
      "connection": {
              "id" : "<CONNECTION_ID>",
      }
      "location": {  
              <data-connector interaction properties depending on connection type>
      }
}]

Le <CONNECTION_ID> est l'identifiant unique d'une connexion. Vous pouvez trouver cet identifiant lorsque vous avez créé une connexion et que vous modifiez ensuite la connexion dans votre projet. L'identifiant est visible dans l'URL de la fenêtre Editer la connexion.

Pour plus d'informations sur les définitions de tâches, voir Définitions des tâches de déploiement.

Vous pouvez spécifier les propriétés d'interaction requises pour la connexion dans le champ " location

Cet exemple se connecte à un seau COS/S3. Les propriétés d'interaction sont indiquées dans le champ " location

      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }

Cet exemple se connecte à une ressource Db2. Les propriétés d'interaction sont indiquées dans le champ " location

      "location": {
            "table_name" : "<TABLE_NAME>",
            "schema_name" : "<SCHEMA_NAME>"
      }

Cet exemple se connecte à un seau COS/S3. La référence de la connexion est indiquée dans le champ " id.

"output_data_references": [{
      "type": "connection_asset",
      "id": "diet_food.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<FILENAME>",
            "bucket" : "<BUCKET_NAME>"
      }
}]

Cet exemple vous montre comment enregistrer un fichier Microsoft Excel dans un godet COS/S3.

"output_data_references": [{
      "type": "kpis.csv",
      "id": "kpis.csv",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "file_name" : "<kpis.xlsx>",
            "bucket" : "<BUCKET_NAME>"
      }
}]

Cet exemple vous montre comment vous connecter à un poste Db2. La référence de la connexion est indiquée dans le champ " id.

"output_data_references": [{
      "type" : "connection_asset",
      "id" : "solution.csv",
      "connection" : {
            "id" : "<CONNECTION_ID>"
      },
      "location" : {
            "table_name" : "<TABLE_NAME>",
            "schema_name" : "<SCHEMA_NAME>"
      }
}]

Pour plus d'informations sur les propriétés d'interaction que vous pouvez utiliser dans le champ location, voir Connexions de plate-forme dans le menu principal. Sur la page Connexions, sélectionnez Ressources de connexion > Propriétés de connexion. Sélectionnez ensuite l'onglet Propriétés d'interaction > En tant que cible pour le connecteur concerné. Vous devrez peut-être créer un Platform assets catalog.

Pour plus d'informations sur les différentes connexions disponibles pour l' Decision Optimization, voir Sources de données prises en charge dans l'Decision Optimization

Données référencées par URL

Vous pouvez utiliser des données référencées par URL pour stocker des données à une URL particulière.

Cet exemple utilise la commande PUT pour placer le fichier de sortie solution.csv sur le serveur.

"output_data_references": {
      "type": "url",
      "id": "solution.csv",
      "connection": {
            "verb": "PUT",
            "url": "https://myserver.com/diet_food.csv",
            "headers": {
                  "Content-Type": "application/x-www-form-urlencoded"
            }
      },
      "location": {}
}

"id":".*\\.csv"

"id":".*"

"output_data_references": [{
      "type" : "connection_asset",
      "id" : ".*",
      "connection": {
            "id" : "<CONNECTION_ID>"
      },
      "location": {
            "bucket" : "<BUCKET_NAME>",
            "file_name": "${oaas_job_id}/${oaas_attachment_name}"
      }
}]