Impostazione della visibilità delle viste

Per consentire o impedire agli utenti di visualizzare o modificare una vista, impostare la proprietà di visibilità.

Informazioni su questa attività

Per default, le viste sono visibili e modificabili. Tuttavia, è possibile modificare le seguenti opzioni nella pagina Visibilità della vista.
  • Same as parent (valore predefinito)
  • Required
  • Editable
  • Read only
  • None
  • Hidden

Quando si imposta la visibilità su Same as parent, si imposta la vista per ereditarne la visibilità dal coach o dalla vista che la contiene. Ad esempio, la vista è all'interno di una vista con visibilità Read only . Se la visibilità della vista è impostata su Same as parent, la vista eredita il valore Read only . Per informazioni su queste opzioni e sulla visibilità in generale, consultare Visualizza proprietà di visibilità.

Il contenuto della pagina Visibilità varia a seconda che la vista si trovi all'interno di un coach o di una vista.
In una pagina In una vista
Per una vista che si trova nel layout di una pagina, è possibile impostare la visibilità della vista in base a un valore, una regola o uno script.
Pagina di visibilità con tre opzioni di origine: valore, regola e script. Valore selezionato e la pagina mostra l'interfaccia utente per impostare la visibilità in base a un valore.

Generalmente, l'impostazione della visibilità in base al valore è l'opzione più semplice ma meno flessibile mentre l'impostazione della visibilità in base allo script è l'opzione più complessa ma più flessibile.

È anche possibile modificare la visibilità in base alla dimensione dello schermo se si sceglie di impostare la visibilità in base al valore. Ad esempio, è possibile che si desideri avere una vista visibile in uno schermo grande ma nasconderla per uno schermo medio o piccolo. Per eseguire questa operazione, impostare la visibilità su Editable quando si modifica il layout dello schermo grande. Si passa quindi al layout a schermo medio e si modifica la visibilità in Hidden o None. Se non si specifica un valore per il layout a schermo piccolo, esso eredita il valore di visibilità dal layout a schermo medio. Per informazioni, consultare Impostazioni reattive per le viste.
Limitazione: non è possibile avere regole o script differenti per ciascuna impostazione della dimensione dello schermo.
 Per una vista che si trova nel layout di una vista, è possibile impostare la visibilità della vista solo in base ad un valore.
Pagina Visibilità che mostra l'interfaccia utente per impostare la visibilità in base a un valore

Nella procedura si applica solo la prima opzione.

Procedura

Nelle proprietà Visibilità di una vista, impostare la relativa visibilità in uno dei seguenti modi:
Per valore
Selezionare Valore , quindi selezionare un valore dall'elenco o fare clic su Assegna una variabile, quindi selezionare la variabile che determina la visibilità della vista. Facoltativamente, è possibile impostare un valore diverso per le diverse impostazioni della dimensione dello schermo selezionando prima l'impostazione della dimensione dello schermo, quindi selezionando il valore di visibilità per l'impostazione della dimensione dello schermo.
Nota: in base a come si imposta la proprietà di visibilità, la vista può essere visualizzata come disabilitata (per Hidden) o non visualizzata nell'area (per None). Quando si imposta la proprietà di visibilità su None, la vista non è più visibile sul canvas, ma è elencata nella finestra a comparsa Elementi invisibili Elementi invisibili . Per visualizzare nuovamente la vista, selezionarla nell'elenco a comparsa e impostare nuovamente la visibilità su Mostra. Per ulteriori informazioni, consultare Visualizza proprietà di visibilità.
Per regola
Selezionare Regola e quindi creare una serie di regole di visibilità. Una serie di regole di visibilità ha una o più regole e un valore predefinito per quando non si applica alcuna regola. Le regole hanno una relazione OR. Posiziona le regole nell'ordine della loro applicabilità perché la vista utilizza il valore di visibilità della prima regola che si applica.
  1. Determinare se la prima regola nella serie di regole si basa su un valore di variabile o su un membro del team e selezionare di conseguenza Variabile o Team .
  2. Impostare il valore predefinito per la serie di regole selezionando un valore nel campo Altro .
  3. Creare la prima regola nella serie di regole.
    Per una variabile, il formato della regola è visibilità variabile condizione valore. Per creare una regola di visibilità basata sul valore di una variabile, completare la seguente procedura:
    • Per visibilità, impostare il valore per la visibilità nel campo Imposta su .
    • Per variabile, fare clic su Seleziona e quindi selezionare la variabile definita nel servizio umano che determina quando si applica il valore di visibilità.
    • Per condizione, selezionare il tipo di confronto utilizzato sul valore della variabile.
    • Per valore, immettere il valore della variabile che attiva l'applicazione del valore di visibilità.
    Per un team, il formato della regola è visibilità appartenenza team. Per creare una regola di visibilità basata sull'appartenenza al team, completare la seguente procedura:
    • Per visibilità, impostare il valore per la visibilità nel campo Imposta su .
    • Per appartenenza, seleziona il tipo di appartenenza dell'utente nel team.
    • Per team, seleziona il team a cui appartiene l'utente.

    Per aggiungere più valori di variabile o appartenenze al gruppo a una regola, fare clic su Aggiungi. I clic successivi aggiungono un valore di variabile o l'appartenenza al team per ogni clic. Se ci sono più variabili o appartenenze al team in una regola, ognuna di esse ha una relazione AND con l'altra. In altre parole, devono essere tutte vere per poter applicare la regola.

  4. Creare più regole in base alle esigenze.
  5. Fare clic su Salva o su Termina modifica.
Per sceneggiatura
Selezionare Script e creare uno script di visibilità:
  1. Fare clic su Seleziona.
  2. Selezionare una o più variabili locali che attivano lo script da eseguire.
  3. Immettere il codice JavaScript nel campo.
    I parametri seguenti sono disponibili per il codice:
    Parametro Descrizione
    context Il parametro context contiene dati da context.bpm.system, context.bpm.team.membere context.bpm.team.manager. Gli oggetti system, membere manager sono identici agli oggetti che hanno lo stesso nome nell'oggetto view.context .
    Nota: se lo script controlla l'appartenenza al team e più team hanno lo stesso nome nell' automazione del flusso di lavoro e nei relativi toolkit dipendenti, l'appartenenza in tali team deve essere la stessa. Se l'appartenenza al team non è la stessa, utilizzare le regole invece di uno script per impostare la visibilità.
    event Il parametro event contiene dati dall'evento initialize o change . Il framework richiama lo script di visibilità utilizzando l'evento initialize (type: "initialize") durante l'inizializzazione della pagina. Il framework richiama lo script di visibilità con l'evento di modifica (type: "change") quando una delle variabili controllate cambia. L'evento change è simile a quello gestito dal gestore eventi change() , ma ha le seguenti proprietà aggiuntive:
    • type: "change" or "initialize"
    • path: fully qualified path to the variable that changed. Ad esempio, immettere "local.employee.phoneNumber[2].areaCode"
    local Il parametro local contiene tutte le variabili del servizio umano disponibili per la pagina. Ad esempio, è possibile ottenere un valore di variabile utilizzando una chiamata come local.get("employee").get("phoneNumber").get(0).get("type")

    Nel vostro JavaScript, ogni valore di ritorno deve essere una stringa con uno dei seguenti valori: REQUIRED EDITABLE READONLY NONE DEFAULT HIDDEN.

    Quando un utente modifica il valore in una di queste variabili controllate, l'evento di modifica risultante provoca l'esecuzione dello script. Ad esempio, è possibile che l'interfaccia utente visualizzi una vista quando l'utente seleziona tea dal marchio MyDrink . Gli utenti del team vendite possono modificare la vista. Il servizio ha variabili Drink e Brand . Selezionare queste variabili e quindi aggiungere il seguente codice nel campo:
    if(local.get("brand") == "MyDrink" && local.get("drink") == "Tea") {
	if(context.bpm.team.member.indexOf("SalesTeam") != -1) {
		return "EDITABLE";
	} else {
		return "READONLY";
	}
} else {
	return "NONE";
}
  4. Fare clic su Salva o su Termina modifica.