Définir et configurer un SFTP

Avant de commencer

Nouveau à CCDS? Voir Concept : présentation de CCDS et définir une source de données infonuagique personnalisée (CCDS)
Autorisations obligatoires :
Développeur d’intégration
dans
Administration > Ensemble d’autorisations

Navigation

À partir du menu de navigation, accédez à

Intégrations de conception

d’intégration

Définir et configurer un SFTP

Créer une nouvelle connexion SFTP

Créez une
connexion SFTP
à partir du volet
Identifiant
dans Concevoir intégrations.
Entrez un nom pour la connexion et cliquez sur
Créer
.
Entrez l’expression hôte dans le formulaire de connexion. Les connexions utilisent le port 22 si vous ne les précisez pas. Workday prend en charge les port :
22
1224
2222
5022
5031
5122
10022
20022
Choisissez votre mode d'authentification.
Pour l’authentification par clé privée, aucun mot de passe n’est requis.
Pour l'authentification de base, entrez un mot de passe.
Pour l'authentification par clé privée, envoyez la clé publique à l'administrateur du serveur client pour l'installation.
Sélectionnez
Tester la connexion
pour la première fois.

Quand vous sélectionnez
Tester une connexion
pour la première fois, le champ
Empreinte digitale
se remplit. Cela active la vérification du serveur pour les connexions futures. L'administrateur du serveur client peut vérifier l'
empreinte digitale
confirmant que vous êtes connecté au bon serveur.
Après avoir exécuté
Tester la connexion
pour la première fois, cliquez sur votre connexion SFTP dans le volet
Identifiants
pour recharger la connexion et afficher le champ d’empreinte digitale.
Quand vous sélectionnez
Tester la connexion
ou que vous utilisez la connexion SFTP dans un script, l’empreinte digitale du serveur doit correspondre ou la connexion échoue.

Sélectionnez votre source de données infonuagique personnalisée

Sélectionnez un CCDS ou créez un CCDS à partir

de sources de données

dans Concevoir intégrations.

Ajouter une connexion SFTP à la source de données Cloud personnalisée

Sélectionnez l’onglet Paramètres de concepteur pour votre CCDS.
Glissez et déposez le paramètre
Connexion SFTP
dans
Paramètres supplémentaires
dans le panneau
Composantes des paramètres
.
Configurez la connexion SFTP dans l’onglet Paramètres de Designer. Le nom du paramètre est l’anse que vous utiliserez dans votre script. Par exemple, ’sftpserver’.

Ajouter la connexion SFTP à votre script

Créez un client à l’aide de 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 créé.
Testez votre connexion dans le volet
Actions
pour exécuter votre script. Vous pouvez trouver des résultats de test de votre script dans
Journaux
dans le volet
Actions
.

Méthodes SFTP pour le téléversement et le téléchargement de fichiers

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

téléverserFile(Writer, téléverséFileName)
client.uploadFile(writer,'./archive/datasample.csv.asc'
);

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

Déconnecter le client
client.disconnect();

Libérez les ressources système utilisées par l’objet lecteur de fichier.
reader.cleanUp();

Exemple pour connecter et télécharger des fichiers depuis 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();
    }
}