Modo de Edição em Contexto

O modo de edição em contexto visa facilitar a administração de conteúdos do portal, de forma que os conteúdos e interfaces tenham ícones que permitam a edição de seu conteúdo de forma mais prática e intuitiva.

Utilização

Para que possa ser feita a edição em contexto, o usuário precisa estar no modo de edição em contexto, que faz parte do perfil de Publicador.

Caso ainda não esteja, o usuário necessita entrar no mesmo. Para isso, veja Perfil de Publicador.

Existem dois tipos de edição em contexto: de instância de interface e de conteúdo. Na primeira, serão exibidas opções de edição relacionadas à instância de interface (e seus conteúdos). Na segunda, serão exibidas opções de edição relacionadas ao conteúdo em si.

Quando no modo de edição em contexto, os conteúdos e interfaces que possuam a marcação para edição em contexto serão destacados com um ícone quadrado em seu canto superior esquerdo, como pode ser visto a seguir:

in-context_edit_mode_000

Ao clicar com o botão esquerdo no íconeda instância de interface, um menu adequado é exibido, como a seguir:

in-context_edit_mode_001

Assim como ao clicar com o botão esquerdo na marcação do conteúdo, um menu adequado é exibido, como a seguir:

in-context_edit_mode_002

Ao clicar sobre uma instância de interface, o publicador poderá Adicionar ou Administrar conteúdos. Ao clicar sobre um conteúdo, o publicador poderá Adicionar, Editar ou Administrar conteúdos. A opção "Administrar conteúdos" redireciona o publicador para a interface de administração mais apropriada para a instância de interface, desde que a mesma esteja instanciada e seja encontrada. A opção "Adicionar" abre um popup com a instancia de interface caso ela seja "runtime only" (ver servicedefinition.xsd) ou redireciona para a instância de interface de adicionar mais adequada, caso contrário. A opção "Editar" se assemelha à opção "Adicionar".

Comportamento Padrão

Por padrão, ícones de instância de interface são adicionadas automaticamente aos elementos que contém uma instância de interface e ícones de conteúdo são adicionadas a elementos que possuam um atributo href (link) nos moldes padrões de links para interface de detalhes (recebendo parâmetro lumItemId contendo o identificador do conteúdo lincado). Ao identificar que um item (instância de interface ou conteúdo) possui um ícone, a ferramenta verifica quais itens de menu o usuário teria acesso (de acordo com suas permissões) e automaticamente remove aqueles itens aos quais o usuário não teria permissão de executar.

Observações

A edição em contexto não é habilitada em interfaces administrativas.
A opção "Editar" chama a interface de edição passando como parâmetro o identificador do item (itemId) em um parâmetro com o nome do campo marcado como primary key no source do item. Caso a interface de edição utilize filtros para filtrar o conteúdo a ser editado diferente do campo primary key do source, essa opção não funcionará corretamente.
Para o correto funcionamento da funcionalidade, a interface administrativa do source do conteúdo a ser editado não deve ser runtime e deve estar instanciada em alguma página.
Caso as interfaces de adicionar ou editar sejam exibidas de forma runtime, o usuário deve ter permissão de visualização na página na qual a interface de administração está instanciada.

Desabilitando

A funcionalidade de edição em contexto pode ser desabilitada em três níveis diferentes: na interface (ver servicedefinition.xsd), na instância de serviço (ver Edição das Propriedades de Instâncias de Serviços) e na instância de interface (ver Customização de Instância de Interface e/ou Serviço). Basta a edição em contexto estar desabilitada em um dos três níveis para que ela não esteja habilitada.

Customizando reconhecimento de fragmentos para modo de edição em contexto

Quando uma instância de interface é renderizada em modo de edição de contexto, o portal automaticamente inclui alguns atributos no HTML que são utilizados para identificar as edições em contexto disponíveis. Os atributos incluídos são:

lumis:interface-instance: identifica a instância de interface que renderizou um fragmento da página. O valor deste atributo é o identificador da instância de interface. É incluído automaticamente no elemento da página que fica ao redor da renderização da instância de interface.
lumis:content: identifica um conteúdo a qual um fragmento da página se refere. O valor deste atributo é o identificador do conteúdo (contentId). É incluído automaticamente em links (elementos <a>) que referenciam um conteúdo através do parâmetro lumItemId.

Estes atributos não são automaticamente incluídos para uma instância de interface se a edição em contexto para a instância de interface esteja desabilitada, seja por ter sido desabilitada na interface, instância de serviço ou instância de interface.

A marcação lumis:interface-instance não é automaticamente incluída se a interface renderizou algum atributo lumis:interface-instance . Isto permite que a interface customize o local que ficará a marcação de lumis:interface-instance caso necessário. Também pode-se utilizar lumis:interface-instance="" como forma de desabilitar sua inclusão automática.

A marcação lumis:content não é automaticamente incluída se a interface renderizou algum atributo lumis:content . Isto permite que a interface defina manualmente as partes de sua renderização que correspondem a algum conteúdo. Também pode-se utilizar lumis:content="" como forma de desabilitar sua inclusão automática.