Transloadit

O que é uma Assembly Variable?

Uma Assembly Variable da Transloadit é um marcador de posição como ${file.original_basename} que é resolvido durante o processamento. Os Robots usam esses valores para adaptar seu comportamento com base no arquivo atual, nos campos enviados ou no contexto da Assembly, como ${assembly.id} e ${unique_prefix}.

Como as Assembly Variables funcionam

Variáveis são expressões avaliadas com base no contexto de execução quando um Robot precisa de valores desconhecidos no momento da criação do Template. Seus espaços de nomes expõem atributos de arquivos, campos enviados e valores no nível da Assembly, como identificadores e prefixos exclusivos, permitindo que um mesmo grafo adapte nomes e opções para cada entrada. Elas diferem de parâmetros literais porque a expansão ocorre durante a execução e pode variar entre arquivos. O valor resolvido passa a compor caminhos ou configurações do Robot, por isso seu tipo, os caracteres permitidos e o comportamento quando ele está ausente são importantes.

Informações essenciais

  1. Variáveis com escopo de arquivo podem resultar em valores diferentes para cada item de uma mesma Assembly, o que permite nomear arquivos de acordo com sua origem, mas também pode criar colisões quando os nomes-base se repetem.
  2. Os campos fornecem às Instructions dados específicos de cada solicitação sem alterar o Template: eles podem chegar como campos de formulário enviados com o upload ou ser definidos programaticamente no parâmetro fields, com os valores enviados pelo formulário tendo precedência em caso de conflito. Eles continuam sendo entradas não confiáveis e exigem validação antes de qualquer uso sensível.
  3. Um valor ausente ou malformado pode se propagar para um parâmetro de Robot ou um caminho de saída; as integrações devem testar o comportamento de fallback em vez de presumir que todos os arquivos disponibilizam todos os campos.

Quando as Assembly Variables são importantes

Use variáveis quando os nomes de saída ou as opções de Robot precisarem depender de dados de cada arquivo ou solicitação sem Instructions separadas. Faça a sanitização dos valores usados em caminhos ou nomes, pois entradas inesperadas podem criar saídas inválidas ou conflitantes.

Transforme conhecimento sobre mídia em um pipeline funcional

Conecte uploads, processamento, IA, armazenamento e entrega por meio de uma única API declarativa, com o stack de codificação, o ajuste de escala e as constantes mudanças de formatos gerenciados para você.

Experimente a Transloadit gratuitamente