Elemento de interface do usuário Microsoft.Common.FileUpload

Artigo
06/01/2023

Um controle que permite a um usuário especificar um ou mais arquivos a carregar.

Exemplo de interface do usuário

Captura de tela do elemento de interface do usuário do Microsoft.Common.FileUpload no portal do Azure.

Esquema

{
  "name": "element1",
  "type": "Microsoft.Common.FileUpload",
  "label": "Some file upload",
  "toolTip": "",
  "constraints": {
    "required": true,
    "accept": ".doc,.docx,.xml,application/msword"
  },
  "options": {
    "multiple": false,
    "uploadMode": "file",
    "openMode": "text",
    "encoding": "UTF-8"
  },
  "visible": true
}

Saída de exemplo

Se options.multiple for false e options.uploadMode for file, a saída terá o conteúdo do arquivo como uma cadeia de caracteres JSON:

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua."

Se options.multiple for true e options.uploadMode for file, a saída terá o conteúdo dos arquivos como uma matriz JSON:

[
  "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
  "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
  "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.",
  "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
]

Se options.multiple for false e options.uploadMode for url, a saída terá o conteúdo dos arquivos como uma cadeia de caracteres JSON:

"https://myaccount.blob.core.windows.net/pictures/profile.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"

Se options.multiple for true e options.uploadMode for url, a saída terá o conteúdo dos arquivos como uma cadeia de caracteres JSON:

[
  "https://myaccount.blob.core.windows.net/pictures/profile1.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://myaccount.blob.core.windows.net/pictures/profile2.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d",
  "https://myaccount.blob.core.windows.net/pictures/profile3.jpg?sv=2013-08-15&st=2013-08-16&se=2013-08-17&sr=c&sp=r&rscd=file;%20attachment&rsct=binary &sig=YWJjZGVmZw%3d%3d&sig=a39%2BYozJhGp6miujGymjRpN8tsrQfLo9Z3i8IRyIpnQ%3d"
]

Ao testar um CreateUiDefinition, alguns navegadores (como o Google Chrome) truncam URLs geradas pelo elemento Microsoft.Common.FileUpload no console do navegador. Talvez seja necessário clicar com o botão direito do mouse em links individuais para copiar as URLs completas.

Comentários

constraints.acceptEspecifica os tipos de arquivos que são mostrados no diálogo do arquivo do navegador. Consulte a especificação do HTML5 para obter os valores permitidos. O valor padrão é null.
Se options.multiple é definido como true, o usuário pode selecionar mais de um arquivo no diálogo do arquivo do navegador. O valor padrão é false.
Esse elemento dá suporte ao carregamento de arquivos em dois modos com base no valor de options.uploadMode. Se file for especificado, a saída terá o conteúdo do arquivo como um blob. Se url for especificado, o arquivo será carregado em um local temporário e a saída terá a URL do blob. Blobs temporários serão limpos após 24 horas. O valor padrão é file.
Um arquivo carregado é protegido. A URL de saída inclui um token SAS para acessar o arquivo durante a implantação.
O valor de options.openMode determina como o arquivo é lido. Se o arquivo deve ser texto sem formatação, especifique text; caso contrário, especifique binary. O valor padrão é text.
Se options.uploadMode é definido como file e options.openMode é definido como binary, a saída é codificada em base64.
options.encodingEspecifica a codificação a ser usada para ler o arquivo. O valor padrão é UTF-8e é usado apenas quando options.openMode é definido como text.

Próximas etapas

Para obter uma introdução à criação de definições de interface do usuário, consulte Introdução ao CreateUiDefinition.
Para obter uma descrição das propriedades comuns em elementos de interface do usuário, consulte Elementos de CreateUiDefinition.

Compartilhar via