Guia Documento

Voltar
BI > BI Desenvolvedor > Dashboard > Guia Documento

Docbi

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.

Dimdispersão

Parâmetros

Disponível apenas quando Origem for de Arquivo Url.

Configbotao

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' '''

Docbi2

Parâmetro Cadastro

Docbi3

• 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.