Utilizzo ed esempio

L'estensione Web Elenco elementi contiene parametri per le funzionalità principali e altri parametri per personalizzare il contenuto.

Di seguito sono elencati i parametri primari:

  • Chiavi elemento: un riferimento a un intervallo di celle in cui sono contenuti i nomi univoci di elementi e azioni per un'ulteriore elaborazione. Quando viene attivata un'azione, Azioni.Input.Text invia uno dei seguenti valori:
    • Actions.Input.Text="Row": L'elemento verrà selezionato.
    • Actions.Input.Text="Edit": è stato fatto clic sul pulsante Modifica.
    • Actions.Input.Text="Delete": fare clic sul pulsante Elimina.
  • Dati elemento: un riferimento a un intervallo di celle contenente dati di elementi o a una cella contenente il codice XML degli stessi dati. La prima colonna dell'intervallo di dati viene riservata per le proprietà facoltative delle seguenti chiavi:
  • Titolo (stringa)
  • Descrizione 1 (stringa)
  • Descrizione 2 (stringa)
  • Timestamp (stringa)
  • Visibile (booleano): se False, l'elemento viene nascosto. True è l'impostazione predefinita.
  • Attivato (booleano): se questa opzione è impostata su False, l'elemento è disattivato. True è l'impostazione predefinita.
  • Selezionato (booleano): se True, l'elemento viene selezionato. False è l'impostazione predefinita.
  • Modifica (booleano): se impostato su True, vengono visualizzate le icone di modifica ed eliminazione incorporate. False è l'impostazione predefinita.
Questi parametri aggiuntivi consentono la personalizzazione del contenuto. Specificare ="" per utilizzare i valori predefiniti, se disponibili.
Nota

Dove è possibile specificare il testo, ad esempio per il messaggio di errore, utilizzare la funzione TRANSLATEUNIQUESTRING per garantire che il testo venga tradotto se viene modificata la lingua dell'interfaccia utente.

  • Selezione multipla: se True, la selezione multipla viene attivata. False è l'impostazione predefinita.
  • Segnaposto casella di ricerca: per impostazione predefinita, la casella di ricerca è visibile e vuota. Per disattivare la casella di controllo, specificare False.
  • Messaggio di errore: per impostazione predefinita, se non sono presenti elementi di elenco, il messaggio di errore Nessun elemento disponibile.
  • Titolo principale: titolo dell'elenco. Per impostazione predefinita, non viene visualizzato alcun titolo.
  • Colore titolo principale: il colore predefinito del titolo è #368ac0.
  • Colore titolo: il colore predefinito del carattere del titolo è #1a1a1a.
  • Colore selezionato: colore in cui è evidenziata la riga selezionata. Il valore predefinito è #c8e9f4.
  • Testo elementi selezionati: per impostazione predefinita, il testo è Selezionato. Questo parametro è applicabile solo se è abilitata la selezione multipla.
  • Rimuovi azione: definire un'azione su una cella che viene attivata quando si fa clic sul pulsante Rimuovi. Il testo predefinito è Rimuovi. Questo parametro è applicabile solo se è abilitata la selezione multipla.
  • Nascondi bordi laterali: specificare True per nascondere i margini sinistro e destro della riga. Per impostazione predefinita, i margini sono visibili.
  • Colore margine: per impostazione predefinita, il colore dei bordi è #d8d8d8.
  1. Creare un report di Application Studio.
  2. Inserire i dati campione nell'intervallo B8:H12:
    Tasto Titolo Descrizione 1 Descrizione 2 Attivato Selezionato Modifica
    a Elemento A Descrizione A FALSE TRUE
    b Elemento B Descrizione B Info dettagliate B FALSE FALSE FALSE
    c Elemento C Descrizione C TRUE FALSE
    d Elemento D Descrizione D FALSE FALSE
  3. Creare una variabile di report denominata rv_SelectedItem e specificare c come valore e valore predefinito. Nelle proprietà della variabile specificare False come valore dell'opzione È persistente.
  4. Nella cella G9 specificare =ReportVariables.rv_SelectedItem.Text=B9. Copiare la formula nelle celle G10, G11 e G12.
    Dopo l'aggiornamento, le celle mantengono i testi originali.
  5. In ciascuna delle celle chiave (B9, B10, B11 e B12), creare un'azione con le seguenti caratteristiche:
    Azioni: tipo
    Selezionare Imposta parametri come tipo di azione.
    Azioni: modalità
    Selezionare Estensione Web come modalità dell'azione.
    Azioni: Condizione
    Specificare =Actions.Input.Text="ROW".
    Nota

    Questa condizione è valida solo se la modalità di azione è Estensione Web.

    Parametri: nome
    Fare clic su Aggiungi parametro e selezionare la variabile rv_SelectedItem.
    Parametri: proprietà
    Specificare Selected Value(.Text).
    Parametri: valore
    Per l'azione in B9, specificare =B9. Per le altre azioni specificare =B10, =B11 e =B12.
  6. Creare una variabile di report denominata rv_TitleItemA e specificare Elemento A come valore. Nelle proprietà della variabile, specificare Elemento A come valore predefinito e selezionare False come valore dell'opzione È persistente.
  7. Nella cella C9 specificare =ReportVariables.rv_TitleItemA.Text e premere Invio.
    Dopo l'aggiornamento, la cella mantiene il testo originale.
  8. Nella cella B9 creare un'azione con le seguenti caratteristiche:
    Azioni: tipo
    Selezionare Imposta parametri come tipo di azione.
    Azioni: modalità
    Selezionare Estensione Web come modalità dell'azione.
    Azioni: Condizione
    Specificare =Actions.Input.Text="EDIT"
    Nota

    Questa condizione è valida solo se la modalità di azione è Estensione Web.

    Parametri: nome
    Fare clic su Aggiungi parametro e selezionare la variabile rv_TitleItemA.
    Parametri: proprietà
    Selezionare Value(.Text)
    Parametri: valore
    Specificare ="Edited Item A".
  9. Nella cella B13 specificare la seguente formula SETPROPERTY: 
    =SETPROPERTY("",B9:B12,C8,C9:C12,D8,D9:D12,E8,E9:E12,F8,F9:F12,G8,G9:G12,H8,H9:H12)
  10. Fare clic su Estensione Web sulla barra degli strumenti Oggetti e fare doppio clic sull'estensione Web Elenco elementi.
    Il cursore assumerà la forma di un puntatore a croce.
  11. Trascinare il cursore per inserire l’estensione Web e definirne dimensioni e posizione.
  12. Immettere i seguenti parametri.
    Nomi univoci
    Specificare l'intervallo di celle contenente i nomi univoci degli elementi dell'elenco. In questo esempio specificare =B9:B12.
    Dati elemento
    Specificare l'intervallo di celle che definisce la tabella di dati per l'estensione. In questo esempio specificare =B13.
  13. Facoltativamente, specificare i valori per questi parametri oppure ="" per utilizzare i valori predefiniti.
    Titolo principale
    Per impostazione predefinita, nell'elenco non ha alcun titolo. Facoltativamente, specificare un titolo.
    Colore carattere titolo principale
    Se viene specificato un titolo principale, il colore predefinito è blu (#368ac0). Facoltativamente, specificare un valore di colore diverso.
    Segnaposto casella di ricerca
    Per impostazione predefinita, la casella di ricerca è vuota. Facoltativamente, specificare il testo da visualizzare nella casella. Per nascondere la casella di ricerca, specificare FALSE (con distinzione maiuscole/minuscole).
    Messaggio di errore
    Per impostazione predefinita, non viene visualizzato alcun errore se non sono disponibili elementi. Facoltativamente, specificare un messaggio di errore. Utilizzare TRANSLATESTRING per semplificare la traduzione dell'errore se la lingua dell'interfaccia utente viene modificata.
    Colore carattere titolo
    Per impostazione predefinita, il titolo degli elementi dell'elenco è di colore grigio scuro (#1a1a1a). Facoltativamente, specificare un valore di colore diverso.
    Colore selezionato
    Specificare il colore in cui è evidenziato l'elemento di elenco selezionato. Il valore predefinito è azzurro (#c8e9f4). Facoltativamente, specificare un valore di colore diverso.
    Selezione multipla
    Per impostazione predefinita, è possibile selezionare solo singoli elementi. Per attivare le caselle di controllo per la selezione di più elementi, specificare ="TRUE".
    Nascondi bordi laterali
    Per impostazione predefinita, ogni riga ha un bordo sinistro e destro. Specificare "=TRUE" per nascondere questi bordi.
    Colore margine
    Per impostazione predefinita, i bordi superiore e laterale dell'elenco sono di colore grigio chiaro (#d8d8d8). Facoltativamente, specificare un valore di colore diverso.
    Testo elementi selezionati
    Se la selezione multipla è attiva, viene indicato il numero di elementi selezionati, seguito da Selected. Facoltativamente, specificare un testo diverso. Utilizzare TRANSLATESTRINGUNIQUE per semplificare la traduzione del testo se la lingua dell'interfaccia utente viene modificata.
    Pulsante Rimuovi barra delle azioni

    Se la selezione multipla è attiva, è possibile visualizzare un pulsante Rimuovi per deselezionare gli elementi selezionati. Specificare il riferimento di una cella contenente la parola Remove.

    Utilizzare TRANSLATESTRING per semplificare la traduzione del testo se la lingua dell'interfaccia utente viene modificata.