Qu’est-ce qu’une Assembly Variable ?

Une Assembly Variable Transloadit est un espace réservé tel que ${file.original_basename}, qui est résolu pendant le traitement. Les Robots utilisent ces valeurs pour adapter leur comportement en fonction du fichier en cours, des champs soumis ou du contexte au niveau de l’Assembly, comme ${assembly.id} et ${unique_prefix}.

Fonctionnement des Assembly Variables

Les variables sont des expressions évaluées dans le contexte d’exécution lorsqu’un Robot a besoin de valeurs inconnues au moment de la création du Template. Leurs espaces de noms exposent les attributs des fichiers, les champs soumis et les valeurs au niveau de l’Assembly, comme les identifiants et les préfixes uniques, ce qui permet à un même graphe d’adapter les noms et les options à chaque entrée. Elles diffèrent des paramètres littéraux, car leur substitution a lieu pendant l’exécution et peut varier selon les fichiers. La valeur résolue est intégrée à des chemins ou à des réglages du Robot ; son type, les caractères autorisés et le comportement en cas d’absence sont donc importants.

Points clés

  1. Les variables propres aux fichiers peuvent prendre des valeurs différentes pour chaque élément d’une même Assembly, ce qui permet de nommer les fichiers selon leur source, mais peut aussi créer des collisions lorsque les noms de base se répètent.
  2. Les champs fournissent aux Instructions des données propres à chaque requête sans modifier le Template : ils peuvent être transmis comme champs de formulaire avec le téléversement ou définis par programmation dans le paramètre fields, les valeurs transmises par formulaire étant prioritaires en cas de conflit. Ils restent des entrées non fiables et doivent être validés avant toute utilisation sensible.
  3. Une valeur manquante ou mal formée peut se propager dans un paramètre de Robot ou un chemin de sortie ; les intégrations devraient tester le comportement de repli plutôt que supposer que chaque fichier expose tous les champs.

Quand les Assembly Variables sont importantes

Utilisez des variables lorsque les noms de sortie ou les options des Robots doivent dépendre de données propres à chaque fichier ou requête sans Instructions distinctes. Assainissez les valeurs utilisées dans les chemins ou les noms, car des entrées inattendues peuvent créer des sorties invalides ou conflictuelles.

Transformer vos connaissances sur les médias en une chaîne de traitement opérationnelle

Reliez les téléversements, le traitement, l’IA, le stockage et la diffusion via une seule API déclarative — la pile d’encodage, la montée en charge et l’évolution constante des formats sont prises en charge pour vous.

Essayer Transloadit gratuitement