create-file
La fonction create-file vous permet de stocker le flux de contenu dans un fichier dont vous pourrez avoir besoin dans l’avenir. Les fichiers créés avec l’aide de la fonction create-file ne sont pas temporaires. De tels fichiers appartiennent à l’utilisateur et pas à FlowForce.
La fonction create-file est semblable à la fonction as-file en ce sens qu’elle crée un fichier cible spécifié avec le flux de contenu, mais create-file ne crée pas de fichiers temporaires. Utilisez /system/create-file pour stocker les flux de contenu que vous souhaitez garder. Utilisez as-file pour passer le flux de contenu en tant que fichier à un programme quelconque. Ceci pourrait être un fichier temporaire géré par FlowForce.
L’expression source (voir la capture d’écran ci-dessous) peut être tout ce qui retourne un stream. Vous pouvez utiliser tout ce que vous passez à la fonction as-file. Par exemple, vous pouvez utiliser les options suivantes :
•stdout(result), stderr(result), result(result, name, index) obtient des streams de résultats d’étape ;
•as2-mdn-serialize(mdn) produit une version sérialisée d’un MDN ;
•mime-flatten(stream) produit un stream de message/rfc822 d’un autre en le préfixant avec ses en-têtes MIME ;
•mime-multipart(string, stream*) produit une structure multi-partie MIME comme stream ;
•stream-open(filename, contenttype) ouvre un fichier sur un disque ;
•empty-stream() produit un stream zero-length ;
•stream-from-string(text, encoding, content-type) encode une valeur de string dans un stream.
Paramètres
Nom | Type | Description |
|---|---|---|
Fichier cible | string | Paramètre obligatoire. Le nom du fichier qui « stream » du contenu sera enregistré. |
Source stream | stream | Paramètre obligatoire. Le contenu « stream » que vous voulez enregistrer dans un fichier. |
Écraser la cible | booléen | Paramètre optionnel. Définissez ce paramètre comme true si vous voulez écraser les fichiers de destination avec les mêmes noms. La valeur par défaut est false. |
Répertoire de travail | string | Paramètre optionnel. Spécifie le chemin vers le répertoire où le fichier cible sera enregistré. |
Abandon sur erreur | booléen | Paramètre optionnel. Ce paramètre détermine la sortie de la tâche dans laquelle une erreur est apparue. Si le paramètre Abandon sur erreur est true, l’exécution de la tâche sera terminée. Si le paramètre Abandon sur erreur est false, FlowForce Server ignorera les erreurs et poursuivra son exécution de la tâche. La valeur par défaut est true. |
Exemple
La capture d’écran ci-dessous illustre la fonction create-file. Notre objectif est de créer un fichier appelé CreateTest.txt et de l’enregistrer sur le desktop. Nous allons utiliser la fonction stream-from-string, qui encode une valeur de string dans un stream. En conséquence, notre nouveau fichier CreateTest.txt contient le string MyFileContent.
| Note : | pour exécuter une tâche, définissez un déclencheur et/ou exécutez la tâche en tant que service. |
