Compreender os painéis: componentes dos painéis e FormXML

Os painéis são um dos diferentes tipos de formulários em aplicativos controlados por modelos. Use o SystemForm.Type ou UserForm.Type para determinar se o formulário é um painel. Um formulário do tipo de painel tem o valor da propriedade de 0.

A definição do conteúdo do formulário e da apresentação é armazenada no FormXML. Para obter mais informações, consulte Esquema XML de Formulário.

Para obter cadeias de caracteres FormXML de exemplo para diferentes tipos de dashboards, consulte Painéis de Exemplo.

Componentes do Painel

Um painel pode conter gráficos, grades, IFRAMEs ou recursos da Web. Por padrão, um único painel pode conter até seis desses componentes.

Gráficos

Um painel de propriedade da organização pode conter apenas gráficos de propriedade da organização. No entanto, um painel de propriedade do usuário pode conter gráficos de propriedade do usuário e da organização. Para obter mais informações, consulte Gráficos (Visualizações) para aplicativos controlados por modelos.

Grades

As grades buscam dados de consultas (exibições) em aplicativos baseados em modelos. Um painel pertencente à organização pode conter apenas as grades que obtêm dados de consultas salvas. No entanto, um painel pertencente ao usuário pode conter grades que buscam dados de consultas do usuário e de consultas salvas. Para obter mais informações, consulte a tabela SavedQuery.

IFRAMEs

Ao adicionar um IFRAME a um painel pertencente à organização, você pode especificar se deseja restringir ou permitir scripts entre frames. Para fazer isso, use o <Security> parâmetro no controle IFRAME no FormXML. No entanto, para painéis pertencentes ao usuário, a execução de scripts entre frames em IFRAMEs é restrita, e isso não pode ser alterado. Se você tentar criar um painel pertencente ao usuário que contenha um IFRAME com script entre frames habilitado, uma mensagem de erro será exibida.

Recursos da Web

Você pode incluir apenas recursos da Web habilitados para formulário em um painel. Embora essa restrição se aplique quando você adiciona um recurso da Web usando o designer de painel no aplicativo Web, o SDK não aplica essa restrição quando você adiciona um recurso da Web a um painel. Para obter mais informações, consulte os recursos da Web para aplicativos controlados por modelos.

Componentes do painel e elementos FormXML

Os aplicativos controlados por modelo exibem componentes do painel com base nos valores especificados no FormXML. A imagem a seguir mostra um exemplo de um painel. Cada painel pode incluir várias guias. As guias formam uma pilha vertical que separa a área principal do painel, e você pode expandi-las ou recolhê-las. Uma aba pode conter várias seções. As seções habilitam o agrupamento e o layout dos componentes do painel.

Observação

A página do painel não exibe nomes de guia e seção.

Layout de componentes do painel.

Elementos FormXML com suporte para dashboards

Embora os dashboards sejam um tipo de formulário, os dashboards não dão suporte a todos os elementos e parâmetros FormXML. A tabela a seguir fornece informações sobre os elementos FormXML, elementos filho e parâmetros aos quais os painéis dão suporte.

Para obter um exemplo de FormXML para diferentes tipos de dashboards, consulte Painéis de Exemplo.

Elemento Elementos Filho Parâmetros de elemento
<form> <tabs> nenhum
<tabs> <tab> nenhum
<tab> -<labels>
-<columns>
-id
-name
-expanded
-verticallayout
-showlabel
-locklevel
<labels> <label> nenhum
<label> nenhum -description
-languagecode
<columns> <column> nenhum
<column> <sections> width
<sections> <section> addedby
<section> -<labels>
-<rows>
-id
-name
-showlabel
-showbar
-columns
<rows> <row> addedby
<row> <cell> addedby
<cell> -<labels>
-<control>
-auto
-addedby
-id
-showlabel
-rowspan
-colspan
<control> <parameters> -id
-classid
<parameters> -<Url>
-<PassParameters>
-<Security>
-<Scrolling>
-<Border>
-<ViewIds>
-<ViewId>
-<IsUserView>
-<IsUserChart>
-<TargetEntityType>
-<AutoExpand>
-<RecordsPerPage>
-<EnableQuickFind>
-<EnableJumpBar>
-<EnableChartPicker>
-<EnableViewPicker>
-<ChartGridMode>
-<VisualizationId>
nenhum

Consulte também

Dashboards
Ações nos painéis
Criar um painel