Guia Documento

Voltar
BI > BI Desenvolvedor > Dashboard > Guia Documento

Apresenta configurações específicas para o Documento.

Tipo

• Página Html: Define se o Documento será uma página Html.
• Rtf: Define se o Documento será de texto.

Origem

• Arquivo/Url: Define se o Documento será um arquivo que deverá ser aberto ou um Url de algum site.
• Dimensão: Define se o Documento será aberto através de um Dimensão.

Apresentação

• Barra Ferramentas: Define se será apresentado a barra de ferramentas com os botões de voltar, avançar e recarregar. Propriedade válida quando for Tipo Página Html.
• Caminho: Define o caminho o qual deverá conter o arquivo.

Peculiaridades para utilização na Web

A utilização do Item de Documento na Web para apresentar o conteúdo de algum site (origem configurada para Url) possui uma restrição que depende da origem/domínio do site desejado. Por questões de segurança, as aplicações Web possuem um conceito chamado Same-Origin Policy (política de mesma origem, em uma tradução livre) que define que uma página só pode executar scripts e manipular o conteúdo de outra quando estas provém da mesma origem/domínio. A definição de mesmo domínio é checada através de uma combinação das informações de protocolo (http, https, etc.), nome do servidor e número da porta.

Como a aplicação obtém a página desejada e a apresenta dentro do Dashboard, isto permitiria que a aplicação manipulasse a página em questão, o que infringe a política descrita acima. Desta forma, sites que estão configurados para não permitirem este tipo de ação não serão apresentados quando o Dashboard for aberto na Web. Para notificar o usuário, se for detectado que não é possível abrir o site informado, é exibida uma mensagem notificando o problema encontrado.

Para solucionar o problema descrito acima, podemos utilizar um recurso chamado Cross-Origin Resource Sharing (CORS). Este mecanismo permite que sites de diferentes domínios compartilhem recursos, tornando possível que a aplicação obtenha o site informado e o apresente dentro do Dashboard. O CORS permite que informemos domínios com os quais permitidos o compartilhamento de recursos. Sendo assim, é preciso que se tenha acesso às configurações do site que desejamos apresentar.

Configurações

Apresenta configurações auxiliares para o Documento.
Dimensões

Contém uma ou mais Dimensões que poderão ser utilizadas como parâmetros quando a Origem for de Arquivo/Url e quando a Origem for de Dimensão conterá apenas uma.

Parâmetros

Disponível apenas quando Origem for de Arquivo Url.

As Tags dos parâmetros cadastrados deverão conter no Caminho, caso isto não ocorra o usuário será informado e estes parâmetros não utilizados serão removidos. Os parâmetros servem como um complemento de um caminho, onde terão valores dinâmicos incluídos em um caminho fixo.

Obs.: Verificar se as Tags informadas não comprometerão no caminho informado, estas tags deverão ser valores únicos no caminho por isso é sugerido que seja colocado identificadores especiais como @,#,%.

Exemplo:

Caminho: 'http://www.@Cliente.com.br/@Modulo''

Parâmetros:

Tag	Dimensão	Valor referente a Dimensão
@Cliente	Cliente	'Cigam'
@Modulo	Modulo	'erp-cigam'

Resultado: http://www.cigam.com.br/erp-cigam' '''

Parâmetro Cadastro

• Tag: Define um identificador único que deverá conter no caminho da Url ou do Arquivo, no local desta tag será colocado o valor da respectiva Dimensão escolhida.
• Dimensão: Dimensão que conterá os valores que irão complementar o caminho da Url ou do Arquivo.