Transfert de fichier

Propre à OrkyvoToutes les offres1 entrée · 1 sortie

Envoie ou récupère un fichier via SFTP ou l'agent, dans les répertoires autorisés du serveur.

Éléments reçusTransfert de fichierÉléments produits

Fonctionnement

Envoi : écriture dans un fichier temporaire du même répertoire, puis remplacement atomique ; empreinte SHA-256 vérifiée après écriture. Récupération : le fichier est conservé comme artefact chiffré (référencé, expiration 7 jours) plutôt que dans les données du workflow. 25 Mo au plus.

Paramètres

Paramètre	Type	Détail
Serveur ou groupeobligatoire	serveur ou groupe	Serveurs de l'environnement de l'exécution uniquement. Un groupe est résolu au démarrage de l'étape.
Sens	choix	Valeurs : Envoyer vers le serveur, Récupérer depuis le serveur.
Chemin distantobligatoire	texte	Absolu, dans un répertoire autorisé du serveur ; toute remontée (..) ou lien vers l'extérieur est refusé.
Contenu envoyéselon les autres paramètres	choix	Valeurs : Texte, Fichier joint à l'élément, Artefact d'une étape précédente.
Texteselon les autres paramètres	texte long	—
Propriété binaire de l'élémentselon les autres paramètres	texte	—
Identifiant de l'artefactselon les autres paramètres	texte	—
Droits du fichier (octal)selon les autres paramètres	texte	—
Remplacer un fichier existantselon les autres paramètres	oui / non	—
Créer les répertoires manquants (dans l'emplacement autorisé)selon les autres paramètres	oui / non	—
En cas d'échec sur un serveur	choix	Valeurs : Échouer le bloc (après tous les serveurs), Continuer : le statut figure dans le résultat.
Serveurs traités en parallèle (groupe)	nombre	50 au plus.

Données reçues et renvoyées

EntréeListe d'éléments ; le premier élément fournit le contenu (texte, fichier joint ou artefact) et les expressions.
SortieUn élément par serveur : { serverId, serverName, status, path, size, sha256, verified, artifactId (récupération), error, taskId }.

Erreurs

Chemin hors des répertoires autorisés, remontée de répertoire, fichier trop volumineux, fichier existant sans remplacement, empreinte différente après écriture.

Exemple

Paramètres d'un bloc prêt à l'emploi. Dans l'éditeur, l'onglet Aide du bloc applique cet exemple en un clic.

Paramètres de l'exemple (JSON)Ouvrir l'éditeur

{
  "direction": "upload",
  "remotePath": "/tmp/orkyvo/app/version.txt",
  "source": "content",
  "content": "{{ $json.version }}",
  "mode": "0644"
}