Função Download no Power Apps

Artigo
03/09/2022
2 minutos para o fim da leitura

Transfere um ficheiro da Web para o dispositivo local.

Descrição

A função Download transfere um ficheiro de uma página Web para o dispositivo local.

Nos leitores nativos (Windows, Android e iOS), é solicitada ao utilizador uma localização para guardar o ficheiro.

Quando utilizado na Web, Download depende das definições do browser para determinar o que acontece com o ficheiro. Para imagens, vídeos, PDF e outros tipos de ficheiros que o navegador suporta de forma nativa, é aberto um novo separador de navegador para exibir o ficheiro. Muitos navegadores suportam guardar o conteúdo para o sistema de ficheiros local.

Só em Windows, Download devolve a localização onde o ficheiro foi armazenado localmente como uma cadeia de texto.

A função Download só pode ser utilizada em fórmulas de comportamento.

Sintaxe

Download( Endereço )

Address – Obrigatório. O endereço URL de um recurso Web a transferir.

Exemplos

Transferência Simples

A fórmula seguinte vai transferir o manual do utilizador do Surface Book, um ficheiro PDF:

Download( "https://go.microsoft.com/fwlink/?linkid=827480" )

Quando executado num dispositivo móvel, será solicitado que o utilizador forneça uma localização para guardar o ficheiro.

Quando executado na maioria dos browsers, será aberto um novo separador para apresentar o ficheiro PDF, uma vez que a maioria dos browsers suporta nativamente este tipo de ficheiro.

Passo a Passo

O modelo de esquema de tablet Demonstração de Produtos foi utilizado para o exemplo seguinte. Para criar uma aplicação com este modelo, siga os passos de criar uma aplicação e selecione o modelo Demonstração de Produtos. Também pode utilizar a sua própria aplicação.

Ir para o Power Apps.
Selecione Aplicações no painel de navegação esquerdo.
Selecione a sua aplicação e, em seguida, selecione Editar.
Selecione Inserir a partir do menu e selecione Etiqueta.
Mova a etiqueta para a parte inferior direita do ecrã.
No painel de propriedades no lado direito, selecione Cor como branco e defina a Espessura do limite como 1.
Selecione a propriedade Text do lado direito e introduza texto como Transferir Manual do Utilizador.
Na lista de propriedades na parte superior esquerda, selecione OnSelect.
Introduza a fórmula como Download("https://go.microsoft.com/fwlink/?linkid=827480"). Também pode utilizar qualquer outro URL que pretender.
Guarde e publique a aplicação.
Reproduza a aplicação.
Selecione o botão Transferir Manual do Utilizador para transferir o manual.

Nota

As definições do browser determinam se o ficheiro deve ser transferido ou aberto diretamente num novo separador. Para mais detalhes, vá para Descrição da função Download.

Consulte também

Referência de fórmulas de aplicação de tela