Paramétrer et configurer un SFTP

Avant de commencer

Novice en matière de SDCP ? Voir Concept : présentation d'une SDCP et Configurer une source de données Cloud personnalisée (SDCP).
Autorisations requises :
Développeur intégration
dans
Administration > Ensembles d'autorisations

Navigation

Dans le menu de navigation, accédez à

Intégration

Concevoir des intégrations

.

Paramétrer et configurer un SFTP

Créer une nouvelle connexion SFTP

Créez une
Connexion SFTP
dans le panneau
Identifiants
de Concevoir des intégrations.
Donnez un nom à la connexion et cliquez sur
Créer
.
Saisissez l'expression hôte dans le formulaire de connexion. Les connexions utilisent le port 22 si vous n'en indiquez aucun. Ports pris en charge :
22
1224
2222
5022
5031
5122
10022
20022
Choisissez votre méthode d'authentification.
Pour l'authentification d'une clé privée, aucun mot de passe n'est requis.
Pour une authentification de base, un mot de passe doit être saisi.
Pour l'authentification d'une clé privée, envoyez une clé publique à l'administrateur du serveur client pour installation.
Cliquez sur
Tester la connexion
avant sa première utilisation.

Lorsque vous cliquez sur
Tester la connexion
avant sa première utilisation, le champ
Empreinte digitale
est renseigné, ce qui permet de vérifier le serveur à l'occasion de connexions futures. L'administrateur du serveur client peut vérifier l'
empreinte digitale
et ainsi confirmer que vous êtes connecté au serveur adéquat.
Après avoir cliqué sur
Tester la connexion
avant sa première utilisation, cliquez sur votre connexion SFTP dans le panneau
Identifiants
pour recharger la connexion et afficher le champ Empreinte digitale.
Lorsque vous cliquez sur
Tester la connexion
ou que vous utilisez la connexion SFTP dans un script, l'empreinte digitale du serveur doit correspondre ou la connexion échouera.

Sélectionner votre source de données Cloud personnalisée

Sélectionnez une SDCP existante ou créez une SDCP dans

Sources de données

du panneau Concevoir des intégrations.

Ajouter une connexion SFTP à une source de données Cloud personnalisée (SDCP)

Cliquez sur l'onglet Paramètres du concepteur pour votre SDCP.
Faites glisser le paramètre
Connexion SFTP
de
Paramètres supplémentaires
jusqu'au panneau
Paramètres des composants
.
Configurez la connexion SFTP dans l'onglet Paramètres du concepteur. Le nom du paramètre est le pseudonyme que vous utiliserez dans votre script. Par exemple, "sftpserver".

Ajouter la connexion SFTP à votre script

Créez un client en utilisant ai.sftp.createClient() et indiquez le nom de votre paramètre SFTP. Par exemple :
const client = ai.sftp.createClient('mysftp').
Une fois la connexion établie, un objet client est alors créé.
Testez votre connexion dans le panneau
Actions
pour exécuter votre script. Vous pouvez rechercher les résultats des tests de votre script dans
Journaux
du panneau
Actions
.

Méthodes SFTP pour charger et télécharger des fichiers

createClient(sftpConnection)
client = ai.sftp.createClient('mysftp');

uploadFile(Writer, uploadedFileName)
client.uploadFile(writer,'./archive/datasample.csv.asc'
);

downloadFile(filename)
client.downloadFile('./archive/datasample.csv.asc'
);

Déconnecter le client
client.disconnect();

Libérer les ressources système consommées par l'objet Reader.
reader.cleanUp();

Exemple pour se connecter et télécharger des fichiers à partir d'un serveur SFTP

function testConnection(context) {
    let client;
    try {
        client = ai.sftp.createClient('mysftp');
    }
    catch(e) {
        ai.log.logError('An error occurred connecting to the server: ' + e);
        return false;
    }
    finally {
        if (client) client.disconnect();
    }
    return true;
}
 
 
function importData(context) {
    const rowset = context.getRowset();
    const client = ai.sftp.createClient('mysftp');
    const reader = client.downloadFile('./someData.csv');
    try {
        reader.readLine();
        let line = reader.readLine();
        while (line)
        {
            let cells = line.split(',');
            rowset.addRow(cells);
            line = reader.readLine();
        }
    }
    catch(e) {
        ai.log.logError('An error occurred downloading the file: ' + e);
    }
    finally {
        client.disconnect();
        reader.cleanUp();
    }
}