Import de fichiers structurés

Introduction

Lors de la mise en place de votre employé digital, afin d'enrichir sa base de connaissances, vous souhaiterez probablement importer des documents spécifiques dans le back-office. Il y a deux façons de faire : manuellement (Source de données), ou avec un script. La première méthode convient pour l'import de quelques fichiers. Pour une quantité plus importante, il vaut mieux passer par la seconde.

Le tutoriel ci-après et le code associé permettent uniquement d'envoyer des fichiers XML

Récupérer le code

Le code est à récupérer sur le github retorik.ai, à cette adresse Upload_XML_To_RetorikStudio.

Utilisation du code

Une fois que vous avez récupéré le code, n'oubliez pas d'installer les packages via la commande npm install depuis le dossier "src".

Valeurs à modifier :

Ces valeurs sont à remplir selon vos paramètres OpenID associés :

// L'URL du tenant (ex: https://studio.retorik.ai/<nom_du_tenant>/api/content/)
const retorikApiUrl = ""; 
// L'URL d'authentification (ex: https://studio.retorik.ai/<nom_du_tenant>/connect/token)
const retorikAccessTokenUrl = ""; 
// Identifiant OpenID
const retorikUsername = "";
// Client Secret
const retorikPassword = "";

Cette valeur est à modifier selon le nom du type de contenu que vous souhaitez alimenter :

// Type de contenu spécifié
ContentType: "ContenuDemo"

Le contenu XML est à remplir suivant cette structure :

Code

PieceDeContenu: {
    Champ1: {
        TypeDeValeur: Valeur
    },
    Champ2: {
        TypeDeValeur: Valeur
    },
    ...
}

Pour lancer le code, depuis la racine du dossier, exécutez la commande suivante node upload_decisions_to_RS.js

Erreurs courantes et conseils

• Assurez-vous d'avoir correctement remplis tous les champs requis dans le XML avant d'envoyer sur les fichiers back office. En effet, si un champ de votre pièce de contenu n'est pas identiqué comme obligatoire une fois le processus d'envoi lancé, aucune erreur n'apparaîtra.
• Lorsque vous intégrez la pièce de contenu Thing, certains de ses champs sont obligatoires. Voici un exemple de structure de base valide pour l'objet Thing :

Code

const document = {
    Thing: 
    {
        Categories: {   
        Text: "Ceci est un exemple"
        },
        Description: {
        Text: "Ceci est un exemple"
        },
        Name: {
        Text: "Ceci est un exemple"
        }
    }
}