Configurando a Visibilidade das Visualizações

Para permitir ou evitar que os usuários vejam ou editem uma visualização, configure sua propriedade de visibilidade.

Sobre esta tarefa

Por padrão, as visualizações são visíveis e editáveis. No entanto, é possível mudar as opções a seguir na página Visibilidade da visualização.
  • Same as parent (valor padrão)
  • Required
  • Editable
  • Read only
  • None
  • Hidden

Ao configurar a visibilidade como Same as parent, você configura a visualização para herdar sua visibilidade do coach ou da visualização que a contém. Por exemplo, sua visualização está em uma visualização que tem visibilidade Read only . Se a visibilidade de sua visualização estiver configurada como Same as parent, sua visualização herdará o valor Read only. Para obter informações sobre essas opções e visibilidade em geral, consulte Visualizar propriedades de visibilidade.

Os conteúdos da página Visibilidade diferem dependendo se a visualização está dentro de um coach ou de uma visualização.
Em uma página Em uma visualização
Para uma visualização que esteja no layout de uma página, é possível configurar a visibilidade da visualização de acordo com um valor, regra ou script.
Página de visibilidade com três opções de origem: valor, regra e script. O valor é selecionado e a página mostra a interface com o usuário para configurar a visibilidade de acordo com um valor.

Geralmente, configurar a visibilidade por valor é a opção mais simples, mas menos flexível, enquanto configurar a visibilidade por script é a opção mais complexa, mas mais flexível.

Também é possível alterar a visibilidade de acordo com o tamanho da tela se você optar por configurar a visibilidade por valor. Por exemplo, você pode desejar ter uma visualização visível em uma tela grande, mas ocultá-la para uma tela média ou pequena. Para fazer isso, você deve configurar a visibilidade para Editable quando você estiver editando o layout de tela grande Em seguida, você alterna para o layout da tela média e muda a visibilidade para Hidden ou None Se você não especificar um valor para o layout de tela pequena, ele herda o valor de visibilidade do layout de tela médio. Para obter informações, consulte Configurações Responsivas para Visualizações
Restrição: Não é possível ter regras ou scripts diferentes para cada configuração de tamanho de tela
 Para uma visualização que está no layout de uma visualização, é possível configurar a visibilidade da visualização de acordo somente com um valor.
Página de visibilidade que mostra a interface com o usuário para configurar a visibilidade de acordo com um valor

No procedimento, somente a primeira opção se aplica.

Procedimento

Nas propriedades de Visibilidade de uma visualização, configure sua visibilidade de uma das seguintes maneiras:
Por valor
Selecione Valor e, em seguida, selecione um valor na lista ou clique em Designar uma variávele, em seguida, selecione a variável que determina a visibilidade da visualização. Opcionalmente, é possível definir um valor diferente para as configurações diferentes de tamanho de tela selecionando a configuração de tamanho de tela pela primeira vez e, em seguida, selecionando o valor de visibilidade para essa configuração de tamanho de tela.
Nota: Com base em como você configura sua propriedade de visibilidade, a visualização pode ser exibida como desativada (para Hidden) ou não exibida na tela (para None). Quando você configura a propriedade de visibilidade como None, a visualização não fica mais visível na tela, mas é listada na janela pop-up Itens Invisíveis Itens Invisíveis Para exibir a visualização novamente, selecione-a na lista pop-up e configure a visibilidade de volta para Mostrar. Para obter mais informações, consulte Visualizar propriedades de visibilidade..
Por regra
Selecione Regra e crie um conjunto de regras de visibilidade. Um conjunto de regras de visibilidade possui uma ou mais regras e um valor padrão para quando nenhuma regra se aplica. As regras possuem um relacionamento OR. Coloque as regras na ordem de sua aplicabilidade porque a visualização usa o valor de visibilidade da primeira regra que se aplica.
  1. Determine se a primeira regra no conjunto de regras é baseada em um valor de variável ou em uma associação da equipe e selecione Variável ou Equipe de acordo.
  2. Configure o valor padrão para o conjunto de regras selecionando um valor no campo Do Contrário.
  3. Crie a primeira regra no conjunto de regras.
    Para uma variável, o formato da regra é visibilidade variável condição valor. Para criar uma regra de visibilidade baseada em um valor de variável, conclua as etapas a seguir:
    • Para visibilidade, configure o valor para a visibilidade no campo Configurar para .
    • Para variável, clique em Selecionar e, em seguida, selecione a variável definida no serviço manual que determina quando o valor de visibilidade é aplicável.
    • Para condição, selecione o tipo de comparação usada no valor da variável.
    • Para valor, insira o valor da variável que aciona o aplicativo do valor de visibilidade.
    Para uma equipe, o formato da regra é visibilidade associação equipe Para criar uma regra de visibilidade baseada em uma associação de membro, conclua as etapas a seguir:
    • Para visibilidade, configure o valor para a visibilidade no campo Configurar para .
    • Para membership, selecione o tipo de associação do usuário na equipe.
    • Para team, selecione a equipe à qual o usuário pertence.

    Para incluir mais valores de variáveis ou associações à equipe em uma regra, clique em Incluir.. Cliques subsequentes incluem um valor de variável ou associação de equipe para cada clique. Se houver várias variáveis ou associações de equipe em uma regra, cada um deles tem um relacionamento AND com a outra. Ou seja, todas elas devem ser true para a regra se aplicar.

  4. Crie mais regras conforme necessário.
  5. Clique em Salvar ou Finalizar edição.
Por script
Selecione Script e, em seguida, crie um script de visibilidade:
  1. Clique em Selecionar
  2. Selecione uma ou mais variáveis locais que acionem a script a ser executado.
  3. Digite código JavaScript no campo.
    Os parâmetros a seguir estão disponíveis para seu código:
    Parâmetro Descrição
    context O parâmetro context contém dados do context.bpm.system, context.bpm.team.member, e context.bpm.team.manager. O system, member, e os objetos manager são idênticos aos objetos que possuem o mesmo nome no objeto view.context .
    Lembre-se: Se seu script verificar a associação da equipe e várias equipes tiverem o mesmo nome na automação de fluxo de trabalho e seus kits de ferramentas dependentes, a associação nessas equipes deverá ser a mesma. Se a associação da equipe não for a mesma, use as regras em vez de um script para configurar a visibilidade.
    event O parâmetro event contém dados do evento initialize ou change. A estrutura chama o script de visibilidade usando o evento initialize (type: "initialize") durante a inicialização da página. A estrutura chama o script de visibilidade com o evento change (type: "change") quando uma das variáveis assistidas é alterada. O evento change é semelhante ao que é manipulado pelo manipulador de eventos change() , exceto que ele possui as propriedades extras a seguir:
    • type: "change" or "initialize"
    • path: fully qualified path to the variable that changed. Por exemplo, digite "local.employee.phoneNumber[2].areaCode"
    local O parâmetro local contém todas as variáveis de serviço manual que estão disponíveis para a página. Por exemplo, você pode obter um valor de variável utilizando uma chamada como local.get("employee").get("phoneNumber").get(0).get("type")

    Em seu JavaScript, cada valor de retorno deve ser uma Sequência com um dos seguintes valores: REQUIRED EDITABLE READONLY NONE DEFAULT HIDDEN.

    Quando um usuário altera o valor em uma dessas variáveis inspecionadas, o evento de mudança resultante faz com que o script seja executado. Por exemplo, você pode desejar que a interface com o usuário exiba uma visualização quando o usuário seleciona chá da marca MyDrink. Os usuários da equipe de vendas podem editar a visualização. O serviço possui as variáveis Drink e Brand. Selecione essas variáveis e, em seguida, inclua o seguinte código no 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. Clique em Salvar ou Finalizar edição.