Operazioni preliminari

In questa esercitazione viene descritto come installare Oracle Visual Builder Add-in for Excel, creare una cartella di lavoro di Microsoft Excel che recupera i dati da un servizio REST e pubblicare la cartella di lavoro in modo che gli utenti business possano eseguire task di immissione dati. Il completamento di questa esercitazione richiede circa 10 minuti.

Presupposto

Oracle Visual Builder Add-in for Excel consente di scaricare i dati da un servizio REST in una tabella di una cartella di lavoro di Excel, in cui gli utenti possono modificare, creare o eliminare i dati prima di inviare tali modifiche al servizio. Una volta installato l'add-in, si immetterà l'endpoint del servizio per scaricare i dati dal servizio nella cartella di lavoro di Excel. Verrà inoltre visualizzata una nuova scheda della barra multifunzione di Oracle Visual Builder con i comandi che consentono di gestire i dati scaricati.

Di cosa hai bisogno?

• Un sistema operativo Windows 10 o 11 con un'installazione di Microsoft Excel 365 o altra versione supportata

  Fare riferimento alla sezione Piattaforme supportate in Sviluppo di fogli di calcolo integrati mediante Oracle Visual Builder Add-in for Excel.

• Accesso all'istanza di Oracle Visual Builder

  Nota: è possibile completare l'esercitazione utilizzando un servizio REST di propria scelta. Assicurarsi di disporre dei metadati del servizio OpenAPI per il servizio di destinazione (alcuni servizi Oracle forniscono una descrizione del genere aggiungendo /describe all'URL). Se segui questo percorso, alcuni passaggi di questo tutorial potrebbero essere diversi per il tuo servizio.

  Ad esempio, è possibile saltare i passi da 1 a 6 del passo 1, ma sarà comunque necessario completare i passi secondari 7 e 8 per installare l'add-in. Prima di iniziare, scaricare il programma di installazione dalla pagina Download.

Installare Oracle Visual Builder Add-in for Excel

1. Fare clic con il pulsante destro del mouse su questo file e scaricarlo sul computer.

   Il file Personnel_Manager.zip contiene un'applicazione visiva con un business object Dipendenti e dati di esempio.

2. Nel browser Web, accedere a Oracle Visual Builder.
3. Nella pagina Applicazioni Visual fare clic su Importa, quindi selezionare Applicazione dal file e sfogliare per selezionare il file Personnel_Manager.zip . Fare clic su Importa.
4. Nella pagina Applicazioni Visual, fare clic su Gestione personale nella colonna Nome.
5. Fare clic su Business object , quindi su Menu e selezionare Gestione dati.

   

6. Nella pagina Gestione dati, fare clic su Modifica dati in Excel per scaricare il programma di installazione.

   Suggerimento: verificare la presenza di una versione più recente nella pagina Download.

7. Uscire da Excel prima di eseguire il programma di installazione.
8. Fare doppio clic sul file del programma di installazione scaricato per iniziare l'installazione, fare clic su Avanti e quindi su Chiudi dopo l'installazione del componente aggiuntivo. Vedere Install Oracle Visual Builder Add-in for Excel in Developing Integrated Spreadsheets Using Oracle Visual Builder Add-in for Excel.

   L'installazione riuscita abilita l'add-in in Excel e quando si avvia Excel viene visualizzata una nuova scheda Oracle Visual Builder.

   

Configurare una cartella di lavoro Excel per scaricare i dati da un servizio REST

In questo passo verrà creata una tabella in una cartella di lavoro di Excel in cui vengono scaricati i dati dei dipendenti dal servizio REST associato all'applicazione visiva appena importata.

1. Nella scheda Business object di Oracle Visual Builder, fare clic su Dipendenti, quindi su Endpoint.
2. Espandere API delle risorse, quindi fare clic sull'icona Appunti per copiare l'intero URL per l'API delle risorse di metadati:

   

3. Creare una cartella di lavoro di Excel denominata employees-source.xlsx in una directory del computer e aprirla.
4. Fare clic sulla cella in cui si desidera individuare la tabella dati.
5. Nella scheda Oracle Visual Builder della cartella di lavoro di Excel, fare clic su Designer per avviare la procedura guidata Impostazione nuovo layout.
6. Nella prima schermata della procedura guidata, immettere l'URL copiato in precedenza nel campo Indirizzo Web e fare clic su Avanti.

   

   Lasciare l'impostazione di autenticazione impostata su "Predefinito".

   Nota: se si utilizza un servizio REST diverso, immettere l'URL del servizio e aggiungere /describe all'URL.

7. Nella finestra di dialogo Accedi, immettere il nome utente e la password utilizzati per accedere a Oracle Visual Builder, quindi fare clic su Accedi.

   L'add-in si connette all'istanza di Oracle Visual Builder e recupera i metadati del servizio. I risultati dell'operazione vengono visualizzati nella procedura guidata.

8. Fai clic su Avanti per continuare.
9. Nella schermata successiva, selezionare Dipendenti, quindi fare clic su Avanti.

   

   Nella schermata successiva viene richiesto di scegliere il tipo di layout che si desidera creare: Tabella o Form-over-Table.

   

10. Selezionare Layout tabella, quindi fare clic su Avanti.

    Nella schermata successiva viene richiesto di scegliere business object aggiuntivi per uno o più layout dipendenti.

    

11. Lasciare vuota questa schermata e fare clic su Avanti per continuare.
12. Nella schermata finale, confermare i dettagli del nuovo layout e fare clic su Fine.

    Nella cartella di lavoro di Excel viene visualizzata una nuova tabella. Vengono visualizzate le intestazioni di colonna, con una riga di dati segnaposto sotto le intestazioni. Verrà inoltre visualizzato Designer layout sulla destra.

    

    Nota: se la cella di origine del layout si trova nelle prime 10 righe, la riga di intestazione viene congelata in modo da visualizzare sempre le intestazioni di colonna quando si scorre verso l'alto o verso il basso nel foglio di lavoro.

13. Fare clic su Scarica dati per scaricare i dati a cui fa riferimento il business object Dipendente.

    

Personalizzare la tabella nella cartella di lavoro di Excel prima della pubblicazione

È possibile personalizzare la tabella creata dall'add-in nella cartella di lavoro di Excel prima di pubblicarla e distribuirla agli utenti per l'immissione dei dati. Ad esempio, è possibile modificare l'ordine delle colonne in modo che la colonna E-mail venga visualizzata prima del nome del dipendente. È inoltre possibile aggiungere una query di ricerca per filtrare i dati scaricati dal servizio. Ad esempio, è possibile aggiungere il campo Stipendio dal business object Dipendenti come campo di ricerca per consentire agli utenti di immettere i criteri di ricerca che consentono di scaricare solo i record dei dipendenti che soddisfano tali criteri.

1. Nella scheda Oracle Visual Builder, fare clic su Designer, se necessario. Fare quindi clic sulla scheda Colonne in Designer layout.
2. Riordinare le colonne trascinando e rilasciando l'icona visualizzata a sinistra della voce E-mail, come mostrato qui:

   Suggerimento: fare clic con il pulsante destro del mouse su una colonna per visualizzare altre opzioni per il riordinamento.

   

   Nota: le colonne Modifica, Stato e Chiave vengono generate automaticamente. Impossibile personalizzare o rimuovere queste colonne.

3. Fare clic sulla scheda Scarica per aggiungere una query di ricerca.
4. Fare clic sull'icona Modifica accanto a Cerca.

   

5. Selezionare Stipendio nell'editor dei campi dei business object disponibili e fare clic su OK.
6. Nell'editor di ricerca selezionare maggiore di nell'elenco dei comparatori e lasciare vuoto il valore.
7. Deselezionare Editor abilitato al download per assicurarsi che i controlli dell'editor di ricerca nel prompt di ricerca siano disabilitati al download.
8. Fare clic su OK per salvare le impostazioni di ricerca e chiudere l'editor di ricerca.
9. Fare clic su Scarica dati.
10. Nella finestra di dialogo Cerca, immettere 10000 e fare clic su OK.

    L'add-in scarica solo i record dei dipendenti il cui stipendio supera 10.000.

    

Pubblicare e distribuire la cartella di lavoro di Excel agli utenti

Dopo aver creato la cartella di lavoro di Excel e averla configurata per scaricare i dati dal servizio REST, è possibile pubblicarla. Questo passo facoltativo è utile se si desidera creare una copia della cartella di lavoro che è possibile distribuire ad altri utenti per l'immissione dei dati. Consente inoltre di rimuovere gli strumenti di progettazione (Designer, Elimina layout e Pubblica) e attivare la protezione del foglio di lavoro. Detto questo, è possibile distribuire la cartella di lavoro di Excel di origine senza pubblicarla.

1. Nella scheda Oracle Visual Builder, fare clic su Pubblica.

   

2. Nella finestra Pubblica cartella di lavoro, accettare la posizione e il nome del file della cartella di lavoro. Quando il nome della cartella di lavoro originale termina con -source (come nel nostro esempio, employees-source.xlsx), l'add-in offre lo stesso nome senza -source.

   

3. Deselezionare la casella di controllo Rimuovi host servizio da ogni catalogo, ma lasciare invariate le altre opzioni di pubblicazione.
4. Fare clic su Pubblica. Vedere Pubblicare una cartella di lavoro di Excel integrata in Sviluppo di fogli di calcolo integrati mediante Oracle Visual Builder Add-in for Excel.

   Nel riquadro Stato viene visualizzata una conferma.

   

5. Salvare e chiudere la cartella di lavoro di Excel di origine utilizzata per pubblicare la cartella di lavoro di Excel.

   Ora è possibile distribuire la cartella di lavoro pubblicata ad altri utenti per l'immissione dei dati. Ogni utente deve disporre di un nome utente e di una password che consentano di accedere al servizio REST immesso durante la creazione della cartella di lavoro di Excel.

   Il passo successivo di questa esercitazione mostra come gli utenti completano i task di immissione dati utilizzando la cartella di lavoro di Excel appena pubblicata.

Crea, legge, aggiorna ed elimina i dati in una cartella di lavoro di Excel pubblicata

Gli utenti business che ricevono una copia della cartella di lavoro di Excel pubblicata devono installare l'add-in per scaricare i dati dal servizio REST. Il programma di installazione può essere scaricato direttamente dalla pagina Download. Una volta installato, l'add-in può creare, leggere, aggiornare ed eliminare i dati scaricati nella cartella di lavoro prima di caricare le modifiche al servizio.

1. Aprire la cartella di lavoro di Excel pubblicata dalla directory in cui è stata salvata.

   

   La sezione Progettazione non viene visualizzata nella scheda Oracle Visual Builder perché gli strumenti di progettazione sono stati disabilitati, impedendo agli utenti di una cartella di lavoro pubblicata di accedere ai comandi Designer, Elimina layout e Pubblica a cui è possibile accedere come sviluppatore della cartella di lavoro. La tabella visualizza le intestazioni di colonna, ma nessun dato, poiché si è scelto di cancellare tutti i layout quando è stata pubblicata la cartella di lavoro di Excel.

2. Fare clic su Scarica dati per scaricare i dati che la cartella di lavoro è configurata per recuperare.
3. Immettere un nome utente e una password nella finestra di dialogo Collega e fare clic su OK.
4. Poiché si imposta una query di ricerca per limitare i download dei dati in base allo stipendio del dipendente, verrà richiesto di immettere un valore per la query. Lasciare vuoto il valore e fare clic su OK.

   L'add-in scarica tutti i dati dei dipendenti.

   

5. Apportare le seguenti modifiche:
   • Nella riga 1, modificare Sophia in Sophie.
   • Fare clic sulla cella G2 e selezionare Manager dalla lista di valori per modificare la qualifica di Dave Brown.
   • Selezionare la riga per John Sieve (riga 4) ad esempio facendo clic sul suo indirizzo e-mail. Nella scheda Oracle Visual Builder, fare clic su Modifiche righe tabella, quindi su Contrassegna per eliminazione.
   • Selezionare l'intera riga 5, fare clic con il pulsante destro del mouse e scegliere Inserisci dal menu di scelta rapida. Immettere questi dati per la riga appena inserita: E-mail = jmcgahern@example.com, Nome = John, Cognome = McGahern, Data assunzione = 2018-01-30, Titolo mansione = Accountant, Stipendio = 19,000 e Reparto = Accounting.

     Nota: un altro modo per aggiungere nuove righe nella tabella è selezionare la riga immediatamente sotto l'ultima riga scaricata nella tabella, quindi fare clic su Modifiche righe tabella e Inserisci righe. L'add-in crea una nuova riga all'interno della tabella, che sarà quindi possibile modificare.

   • Selezionare la riga di Ken Ster alla fine della tabella (riga 102) ad esempio selezionando il proprio indirizzo e-mail. Nella scheda Oracle Visual Builder, fare clic su Modifiche righe tabella, quindi su Contrassegna per eliminazione.

     Una volta apportate queste modifiche, la tabella è simile a quella mostrata nell'immagine seguente. In altre parole, nella colonna Modificato di ogni riga in cui è stata apportata una modifica viene visualizzato un messaggio Update, Delete o Create.

     

6. Nella scheda Oracle Visual Builder, fare clic su Carica modifiche.

   Quando viene visualizzato un messaggio che informa che la tabella contiene eliminazioni in sospeso, fare clic su Sì per confermare. Al termine del caricamento, la tabella aggiorna la colonna Stato per descrivere la modifica per ogni riga modificata caricata.

   La nuova riga creata determina la creazione di un nuovo record per John McGahern nella raccolta.

   Le righe contrassegnate per l'eliminazione, i record per John Sieve e Ken Ster, non vengono più visualizzati in quanto il servizio REST le ha eliminate dalla raccolta.

   

   Nota: tutti i dati vengono convalidati prima di essere caricati nel servizio REST. Se si verificano errori, è sempre possibile correggere gli errori e caricare di nuovo le modifiche. Se si verificano errori parziali, ad esempio se l'aggiornamento e l'eliminazione delle righe hanno avuto esito positivo ma la creazione delle righe non è riuscita, sarà necessario correggere solo i dati per la riga di creazione non riuscita.

   Per verificare che le modifiche apportate alla cartella di lavoro di Excel siano state caricate correttamente, andare alla scheda Dati della pagina Business object nell'applicazione visiva.

   

Si desiderano saperne di più?

• Introduzione a Oracle Visual Builder Add-in for Excel in Sviluppo di fogli di calcolo integrati mediante Oracle Visual Builder Add-in for Excel
• Configurare le opzioni di ricerca per il download in Sviluppo di fogli di calcolo integrati mediante Oracle Visual Builder Add-in for Excel
• Gestione dei dati mediante Oracle Visual Builder Add-in for Excel. Questa guida consente agli utenti business di avere successo utilizzando le cartelle di lavoro integrate.