Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Interazione con Amazon Simple Storage Service con componenti e automazioni
Puoi richiamare varie operazioni Amazon S3 da un'app App Studio. Ad esempio, potresti creare un semplice pannello di amministrazione per gestire utenti e ordini e visualizzare i tuoi file multimediali da Amazon S3. Sebbene tu possa richiamare qualsiasi operazione Amazon S3 utilizzando l' AWSazione Invoke, ci sono quattro azioni Amazon S3 dedicate che puoi aggiungere alle automazioni della tua app per eseguire operazioni comuni su bucket e oggetti Amazon S3. Le quattro azioni e le relative operazioni sono le seguenti:
Put Object: utilizza l'
Amazon S3 PutObjectoperazione per aggiungere un oggetto a un bucket Amazon S3.Get Object: utilizza l'
Amazon S3 GetObjectoperazione per recuperare un oggetto da un bucket Amazon S3.Elenca oggetti: utilizza l'
Amazon S3 ListObjectsoperazione per elencare gli oggetti in un bucket Amazon S3.Elimina oggetto: utilizza l'
Amazon S3 DeleteObjectoperazione per eliminare un oggetto da un bucket Amazon S3.
Oltre alle azioni, è disponibile un componente di caricamento S3 che puoi aggiungere alle pagine nelle applicazioni. Gli utenti possono utilizzare questo componente per scegliere un file da caricare e il componente chiama Amazon S3 PutObject per caricare il file nel bucket e nella cartella configurati. Questo tutorial utilizzerà questo componente al posto dell'azione di automazione autonoma Put Object. (L'azione autonoma dovrebbe essere utilizzata in scenari più complessi che richiedono logica o azioni aggiuntive da intraprendere prima o dopo il caricamento.)
Prerequisiti
Questa guida presuppone che tu abbia completato i seguenti prerequisiti:
-
Ha creato e configurato un bucket Amazon S3, un ruolo e una policy IAM e un connettore Amazon S3 per integrare correttamente Amazon S3 con App Studio. Per creare un connettore, devi avere il ruolo di amministratore. Per ulteriori informazioni, consulta Connettiti ad Amazon Simple Storage Service (Amazon S3).
Crea un'applicazione vuota
Create un'applicazione vuota da utilizzare in questa guida eseguendo i passaggi seguenti.
Per creare un'applicazione vuota
Nel riquadro di navigazione, scegli Le mie applicazioni.
Scegli + Crea app.
Nella finestra di dialogo Crea app, dai un nome all'applicazione, scegli Inizia da zero e scegli Avanti.
Nella finestra di dialogo Connetti a dati esistenti, scegli Ignora per creare l'applicazione.
Scegliete Modifica app per accedere all'area di disegno della nuova app, dove potete utilizzare componenti, automazioni e dati per configurare l'aspetto e il funzionamento dell'applicazione.
Crea pagine
Crea tre pagine nella tua applicazione per raccogliere o mostrare informazioni.
Per creare pagine
Se necessario, scegli la scheda Pagine nella parte superiore dell'area di disegno.
Nella barra di navigazione a sinistra, c'è una sola pagina creata con la tua app. Scegli + Aggiungi due volte per creare altre due pagine. Il pannello di navigazione dovrebbe mostrare tre pagine totali.
Aggiorna il nome della pagina Page1 effettuando le seguenti operazioni:
Scegliete l'icona con i puntini di sospensione e scegliete Proprietà della pagina.
Nel menu Proprietà a destra, scegli l'icona a forma di matita per modificare il nome.
Entra
FileListe premi Invio.
Ripeti i passaggi precedenti per aggiornare la seconda e la terza pagina come segue:
Rinomina Page2 in.
UploadFileRinomina Page3 in.
FailUpload
Ora, la tua app dovrebbe avere tre pagine denominate e FileList UploadFile FailUpload, che sono mostrate nel pannello Pagine a sinistra.
Successivamente, creerai e configurerai le automazioni che interagiscono con Amazon S3.
Crea e configura automazioni
Crea le automazioni della tua applicazione che interagiscono con Amazon S3. Utilizza le seguenti procedure per creare le seguenti automazioni:
Un'automazione GetFiles che elenca gli oggetti nel tuo bucket Amazon S3, che verranno utilizzati per riempire un componente della tabella.
Un'automazione DeleteFile che elimina un oggetto dal bucket Amazon S3, che verrà utilizzato per aggiungere un pulsante di eliminazione a un componente della tabella.
Un'automazione ViewFile che recupera un oggetto dal bucket Amazon S3 e lo visualizza, che verrà utilizzata per mostrare maggiori dettagli su un singolo oggetto selezionato da un componente della tabella.
Crea un'automazione GetFiles
Crea un'automazione che elenchi i file in un bucket Amazon S3 specificato.
Scegli la scheda Automazioni nella parte superiore dell'area di disegno.
Scegli + Aggiungi automazione.
Nel pannello a destra, scegli Proprietà.
Aggiorna il nome dell'automazione scegliendo l'icona a forma di matita. Inserisci
getFilese premi Invio.Aggiungi un'azione Elenca oggetti eseguendo i passaggi seguenti:
Nel pannello a destra, scegli Azioni.
Scegli Elenca oggetti per aggiungere un'azione. L'azione deve avere un nome
ListObjects1.
Configura l'azione eseguendo i passaggi seguenti:
Scegliete l'azione dall'area di disegno per aprire il menu Proprietà sulla destra.
Per Connector, scegli il connettore Amazon S3 che hai creato tra i prerequisiti.
Per la configurazione, inserisci il testo seguente, sostituendolo
bucket_namecon il bucket che hai creato nei prerequisiti:{ "Bucket": "bucket_name", "Prefix": "" }Nota
È possibile utilizzare il
Prefixcampo per limitare la risposta agli oggetti che iniziano con la stringa specificata.
L'output di questa automazione verrà utilizzato per popolare un componente della tabella con oggetti del tuo bucket Amazon S3. Tuttavia, per impostazione predefinita, le automazioni non creano output. Configura l'automazione per creare un output di automazione eseguendo i seguenti passaggi:
Nella barra di navigazione a sinistra, scegli l'automazione GetFiles.
Nel menu Proprietà a destra, in Output di automazione, scegli + Aggiungi output.
Per Output, inserisci
{{results.ListObjects1.Contents}}. Questa espressione restituisce il contenuto dell'azione e può ora essere utilizzata per popolare un componente della tabella.
Crea un'automazione DeleteFile
Crea un'automazione che elimina un oggetto da un bucket Amazon S3 specificato.
Nel pannello Automazioni a sinistra, scegli + Aggiungi.
Scegli + Aggiungi automazione.
Nel pannello a destra, scegli Proprietà.
Aggiorna il nome dell'automazione scegliendo l'icona a forma di matita. Inserisci
deleteFilee premi Invio.Aggiungi un parametro di automazione, utilizzato per passare i dati a un'automazione, eseguendo i passaggi seguenti:
Nel menu Proprietà a destra, in Parametri di automazione, scegli + Aggiungi.
Scegli l'icona a forma di matita per modificare il parametro di automazione. Aggiorna il nome del parametro
fileNamee premi Invio.
Aggiungete un'azione Elimina oggetto effettuando le seguenti operazioni:
Nel pannello a destra, scegli Azioni.
Scegli Elimina oggetto per aggiungere un'azione. L'azione deve avere un nome
DeleteObject1.
Configura l'azione eseguendo i passaggi seguenti:
Scegliete l'azione dall'area di disegno per aprire il menu Proprietà sulla destra.
Per Connector, scegli il connettore Amazon S3 che hai creato tra i prerequisiti.
Per la configurazione, inserisci il testo seguente, sostituendolo
bucket_namecon il bucket che hai creato nei prerequisiti:{ "Bucket": "bucket_name", "Key": params.fileName }
Crea un'automazione ViewFile
Crea un'automazione che recuperi un singolo oggetto da un bucket Amazon S3 specificato. Successivamente, configurerai questa automazione con un componente di visualizzazione dei file per visualizzare l'oggetto.
Nel pannello Automazioni a sinistra, scegli + Aggiungi.
Scegli + Aggiungi automazione.
Nel pannello a destra, scegli Proprietà.
Aggiorna il nome dell'automazione scegliendo l'icona a forma di matita. Inserisci
viewFilee premi Invio.Aggiungi un parametro di automazione, utilizzato per passare i dati a un'automazione, eseguendo i passaggi seguenti:
Nel menu Proprietà a destra, in Parametri di automazione, scegli + Aggiungi.
Scegli l'icona a forma di matita per modificare il parametro di automazione. Aggiorna il nome del parametro
fileNamee premi Invio.
Aggiungete un'azione Ottieni oggetto effettuando le seguenti operazioni:
Nel pannello a destra, scegli Azioni.
Scegli Ottieni oggetto per aggiungere un'azione. L'azione deve avere un nome
GetObject1.
Configura l'azione eseguendo i passaggi seguenti:
Scegliete l'azione dall'area di disegno per aprire il menu Proprietà sulla destra.
Per Connector, scegli il connettore Amazon S3 che hai creato tra i prerequisiti.
Per la configurazione, inserisci il testo seguente, sostituendolo
bucket_namecon il bucket che hai creato nei prerequisiti:{ "Bucket": "bucket_name", "Key": params.fileName }
Per impostazione predefinita, le automazioni non creano output. Configura l'automazione per creare un output di automazione eseguendo i seguenti passaggi:
Nella barra di navigazione a sinistra, scegli l'automazione ViewFile.
Nel menu Proprietà a destra, in Output di automazione, scegli + Aggiungi output.
Per Output, inserisci
{{results.GetObject1.Body.transformToWebStream()}}. Questa espressione restituisce il contenuto dell'azione.Nota
È possibile leggere la risposta di
S3 GetObjectnei seguenti modi:transformToWebStream: restituisce uno stream, che deve essere consumato per recuperare i dati. Se utilizzato come output di automazione, l'automazione lo gestisce e l'output può essere utilizzato come origine dati di un componente di visualizzazione di immagini o PDF. Può essere utilizzato anche come input per un'altra operazione, ad esempioS3 PutObject.transformToString: restituisce i dati grezzi dell'automazione e deve essere utilizzato in un' JavaScript azione se i file contengono contenuti di testo, ad esempio dati JSON. Deve essere atteso, ad esempio:await results.GetObject1.Body.transformToString();transformToByteArray: restituisce un array di numeri interi senza segno a 8 bit. Questa risposta ha lo scopo di un array di byte, che consente l'archiviazione e la manipolazione di dati binari. Deve essere atteso, ad esempio:await results.GetObject1.Body.transformToByteArray();
Successivamente, aggiungerai componenti alle pagine che hai creato in precedenza e le configurerai con le tue automazioni in modo che gli utenti possano utilizzare la tua app per visualizzare ed eliminare i file.
Aggiungi e configura i componenti della pagina
Ora che hai creato le automazioni che definiscono la logica aziendale e la funzionalità della tua app, creerai i componenti e li connetterai entrambi.
Aggiungi componenti a FileList page
La FileList pagina creata in precedenza verrà utilizzata per visualizzare un elenco di file nel bucket Amazon S3 configurato e ulteriori dettagli su qualsiasi file scelto dall'elenco. Per farlo, dovrai fare quanto segue:
Create un componente della tabella per visualizzare l'elenco dei file. Configurerai le righe della tabella in modo che vengano riempite con l'output dell'automazione GetFiles creata in precedenza.
Create un componente di visualizzazione PDF per visualizzare un singolo PDF. Configurerai il componente per visualizzare un file selezionato dalla tabella, utilizzando l'automazione ViewFile creata in precedenza per recuperare il file dal bucket.
Per aggiungere componenti a FileList page
Scegli la scheda Pagine nella parte superiore dell'area di disegno.
Nel pannello Pagine a sinistra, scegli la FileList pagina.
Nella pagina Componenti a destra, trova il componente Tabella e trascinalo al centro dell'area di disegno.
Scegli il componente della tabella che hai appena aggiunto alla pagina.
Nel menu Proprietà a destra, scegli il menu a discesa Sorgente e seleziona Automazione.
Scegli il menu a discesa Automazione e seleziona l'automazione GetFiles. La tabella utilizzerà l'output dell'automazione GetFiles come contenuto.
-
Aggiungi una colonna da riempire con il nome del file.
Nel menu Proprietà a destra, accanto a Colonne, scegli + Aggiungi.
Scegli l'icona a forma di freccia a destra della colonna Column1 che è stata appena aggiunta.
Per Etichetta colonna, rinomina la colonna in.
FilenameIn Valore, specifica
{{currentRow.Key}}.Scegliete l'icona a forma di freccia nella parte superiore del pannello per tornare al pannello principale delle Proprietà.
-
Aggiungete un'azione nella tabella per eliminare il file in una riga.
Nel menu Proprietà a destra, accanto ad Azioni, scegli + Aggiungi.
In Azioni, rinomina Button in.
DeleteScegli l'icona a forma di freccia a destra dell'azione Elimina che è stata appena rinominata.
In Con un clic, scegli + Aggiungi azione e scegli Invoca automazione.
Scegli l'azione che è stata aggiunta per configurarla.
Per Nome azione immetti
DeleteRecord.In Invoke automation, seleziona
deleteFile.Nella casella di testo del parametro, immettete
{{currentRow.Key}}.In Valore, specifica
{{currentRow.Key}}.
-
Nel pannello a destra, scegliete Componenti per visualizzare il menu dei componenti. Sono disponibili due opzioni per mostrare i file:
Un visualizzatore di immagini per visualizzare i file con
.jpgestensione.png.jpeg, o.Un componente di visualizzazione PDF per visualizzare i file PDF.
In questo tutorial, aggiungerai e configurerai il componente di visualizzazione PDF.
-
Aggiungi il componente visualizzatore PDF.
Nella pagina Componenti a destra, trova il componente del visualizzatore PDF e trascinalo nell'area di disegno, sotto il componente della tabella.
Scegli il componente di visualizzazione PDF che è stato appena aggiunto.
Nel menu Proprietà a destra, scegli il menu a discesa Sorgente e seleziona Automazione.
Scegli il menu a discesa Automazione e seleziona l'automazione ViewFile. La tabella utilizzerà l'output dell'automazione ViewFile come contenuto.
Nella casella di testo del parametro, immettete
{{ui.table1.selectedRow["Filename"]}}.Nel pannello di destra, c'è anche un campo Nome file. Il valore di questo campo viene utilizzato come intestazione per il componente di visualizzazione PDF. Inserisci lo stesso testo del passaggio precedente:
{{ui.table1.selectedRow["Filename"]}}.
Aggiungi componenti a UploadFile page
La UploadFile pagina conterrà un selettore di file che può essere utilizzato per selezionare e caricare un file nel bucket Amazon S3 configurato. Aggiungerai alla pagina il componente di caricamento S3, che gli utenti possono utilizzare per selezionare e caricare un file.
Nel pannello Pagine a sinistra, scegli la pagina. UploadFile
Nella pagina Componenti a destra, trova il componente di caricamento S3 e trascinalo al centro dell'area di disegno.
Scegli il componente di caricamento S3 che hai appena aggiunto alla pagina.
Nel menu Proprietà a destra, configura il componente:
Nel menu a discesa Connector, seleziona il connettore Amazon S3 creato nei prerequisiti.
Per Bucket, inserisci il nome del tuo bucket Amazon S3.
Per Nome file, inserisci.
{{ui.s3Upload1.files[0]?.nameWithExtension}}Per Dimensione massima del file, inserisci
5nella casella di testo e assicurati cheMBsia selezionato nel menu a discesa.Nella sezione Trigger, aggiungi le azioni che vengono eseguite dopo i caricamenti riusciti o non riusciti eseguendo i seguenti passaggi:
Per aggiungere un'azione che viene eseguita dopo il completamento dei caricamenti:
In caso di successo, scegli + Aggiungi azione e seleziona Naviga.
Scegli l'azione che è stata aggiunta per configurarla.
Per Tipo di navigazione, scegli Pagina.
Per Naviga verso, scegli
FileList.Scegliete l'icona a forma di freccia nella parte superiore del pannello per tornare al pannello principale delle Proprietà.
Per aggiungere un'azione che viene eseguita dopo i caricamenti non riusciti:
In caso di errore, scegli + Aggiungi azione e seleziona Naviga.
Scegli l'azione che è stata aggiunta per configurarla.
Per Tipo di navigazione, scegli Pagina.
Per Naviga verso, scegli
FailUpload.Scegliete l'icona a forma di freccia nella parte superiore del pannello per tornare al pannello principale delle Proprietà.
Aggiungete componenti al FailUpload page
La FailUpload pagina è una pagina semplice contenente una casella di testo che informa gli utenti che il caricamento non è riuscito.
Nel pannello Pagine a sinistra, scegli la pagina. FailUpload
Nella pagina Componenti a destra, trova il componente Testo e trascinalo al centro dell'area di disegno.
Scegli il componente di testo che hai appena aggiunto alla pagina.
Nel menu Proprietà a destra, in Valore, inserisci
Failed to upload, try again.
Aggiorna le impostazioni di sicurezza dell'app
Ogni applicazione in App Studio dispone di impostazioni di sicurezza dei contenuti che puoi utilizzare per limitare contenuti multimediali o risorse esterne o su quali domini di Amazon S3 puoi caricare oggetti. L'impostazione predefinita prevede il blocco di tutti i domini. Per caricare oggetti su Amazon S3 dalla tua applicazione, devi aggiornare l'impostazione per consentire i domini in cui desideri caricare gli oggetti.
Per consentire ai domini di caricare oggetti su Amazon S3
Scegli la scheda Impostazioni dell'app.
Scegli la scheda Impostazioni di sicurezza dei contenuti.
Per Connect source, scegli Consenti tutte le connessioni.
Selezionare Salva.
Passaggi successivi: visualizza in anteprima e pubblica l'applicazione per il test
L'applicazione è ora pronta per il test. Per ulteriori informazioni sull'anteprima e sulla pubblicazione delle applicazioni, vedereVisualizzazione in anteprima, pubblicazione e condivisione delle applicazioni.