# Fichier (lecture / écriture) - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/file_io

Language: fr

Lire ou écrire un fichier sur le disque local ou un serveur distant (SSH)

## Utilisation et spécificités

path est un chemin sur la cible d’exécution. Sélectionnez disque local ou serveur SSH ; encoding distingue UTF-8 et base64. append et createDirectories règlent le mode d’écriture.

Type technique : `file_io`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : ssh](/docs/credentials/ssh)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `operation` | `enum` | `"read"` | `read`, `write` |
| `path` | `string` | `""` | - |
| `content` | `string` | `""` | - |
| `encoding` | `enum` | `"base64"` | `utf8`, `base64` |
| `mimeType` | `string` | `""` | - |
| `append` | `boolean` | `false` | - |
| `createDirectories` | `boolean` | `true` | - |
| `executionTarget` | `union` | `{"kind":"host"}` | - |
| `executionTarget.kind` | `literal` | `"host"` | `host`, `remote_server`, `kube`, `swarm` |
| `executionTarget.serverId` | `string` | - | -; min 1 |
| `executionTarget.provider` | `enum` | - | `aws`, `gcp`, `scaleway`, `ovh`, `azure`, `digitalocean`, `hetzner` |
| `executionTarget.clusterId` | `string` | - | -; min 1 |
| `executionTarget.namespace` | `string` | - | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `operation`<br>Opération | Lecture renvoie le contenu du fichier (data en base64). Écriture crée ou met à jour un fichier. |
| `encoding`<br>Encodage | UTF-8 pour le texte ; base64 pour les binaires (PDF, images). La sortie Lire fichier inclut toujours data en base64. |
| `content`<br>Contenu | Texte ou base64 selon l'encodage. Vous pouvez mapper nodes.convert1.data depuis Convertir en fichier. |
| `append`<br>Ajouter à la fin | Si activé, ajoute au fichier existant au lieu de l'écraser. |
| `createDirectories`<br>Créer les dossiers | Crée les répertoires parents manquants avant l'écriture. |
| `mimeType`<br>Type MIME | Optionnel - déduit automatiquement depuis l'extension si vide. |

## Exemples

- Chemin hôte : invoices/mars.pdf
- PDF : Lire fichier → Extraire d'un fichier (PDF) avec input nodes.read1.data
- Chemin : exports/result.json

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "operation": "read",
  "path": "",
  "content": "",
  "encoding": "base64",
  "mimeType": "",
  "append": false,
  "createDirectories": true,
  "executionTarget": {
    "kind": "host"
  }
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)