Open the menu

    Contexto de Negócio

    Um contexto de negócio do portal é um conjunto de propriedades que serão disponibilizadas de forma centralizada. Um contexto é definido por um arquivo chamado contextdefinition.xml . A referência deste arquivo é o XSD contextdefinition.xsd, que deve utilizar a localização http://www.lumis.com.br/context e na distribuição do produto encontra-se em def/lumis/portal/businesscontext/contextdefinition.xsd .

    A estrutura básica do arquivo de definição do contexto é a seguinte:

    Cada propriedade (nó property) deve possuir um dos seguintes nós:

    • fixed: utilizado para expor um valor fixo no contexto.
    • expression: utilizado para expor o valor de uma EL (expression language) no contexto.
    • custom: utilizado para customizar a obtenção do valor para ser exposto no contexto.

    Valores fixos no contexto

    Para expor um valor fixo no contexto, um parâmetro pode ser definido como:

    Onde valor é o valor a ser exposto.

    Valores de EL no contexto

    Para expor valores de EL no contexto, um parâmetro pode ser definido como:

    Onde el é a EL a ser exposta. As variáveis disponíveis são listadas em Recursos disponíveis em EL, marcadas com o escopo LayoutFile. A variável pageWebResource , no entanto, não está disponível.

    Além dessas variáveis, as seguintes variáveis estão disponíveis:

    • groupsHash: retorna um hash dos grupos do usuário corrente.
    • lum_device: retorna o dispositivo que está acessando o portal.

    As funções disponíveis são:

    • isMemberOf(String groupAlias): Retorna se o usuário atual pertence ao grupo dado. Em outras palavras, retorna verdadeiro se existe um grupo G tal que apelido de G é igual ao parâmetro fornecido.
    • groupsHash(): Retorna um hash com os grupos que o usuário pertence.

    Valores customizados no contexto

    Para expor valores customizados no contexto, é necessário definir o elemento <custom> especificando a classe que implementa IBusinessContextValueProvider utilizando o atributo className.

    Se espeficado o atributo className , ele deve conter o nome totalmente qualificado da classe Java que implementa IBusinessContextValueProvider.

    Na definição da propriedade customizada podem ser passados parâmetros para serem utilizados no cálculo do valor a ser exposto, como no seguinte exemplo:

    Nesse caso, lumis.portal.businesscontext.example.HelloWorldContextValueProvider é o nome totalmente qualificado da classe customizada a ser utilizada. Essa classe deve implementar lumis.portal.businesscontext.IBusinessContextValueProvider. Para uma melhor compatibilidade futura, é recomendado estender a classe abstrata lumis.portal.businesscontext.AbstractBusinessContextValueProvider . A interface define os seguintes métodos:

    • public String get(HttpServletRequest request): Método utilizado para calcular o valor da propriedade na requisição.
    • public void initialize(Map<String, String> parameters): Método de inicialização que recebe um mapa de parâmetros opcionais passados no nó parameters dentro do nó custom. No exemplo, esse mapa seria: {name = World}.

    Abaixo uma implementação de exemplo:

    Nessa implementação de exemplo, o valor da propriedade seria "Hello, World", onde World é o parâmetro com o nome name.

    Para maiores informações, veja a API Java e XSD.

    Exemplos de utilização

    Para expor o dispositivo do usuário na propriedade device.os:

    Para expor o tipo de dispositivo do usuário na propriedade device.type:

    Para expor o hash dos grupos do usuário na propriedade groups.hash:

    Para expor se o usuário pertence a algum grupo na propriedade is.member.of.apelido:

    Para obter o contexto atual no contexto de uma interface (ou seja, em um controle, em um process action , em um data provider etc), basta utilizar o método getBusinessContext() do request de interface, por exemplo:

    Em um process action ou controle:

    Em um data provider :