Os formulários são uma parte vital de qualquer aplicação Web do Microsoft SharePoint em que pretende recolher dados de utilizadores. As Vistas de Dados são constituídas com a tecnologia de formulários do ASP.NET para que possa inseri-las como vistas de dados de leitura apenas ou como formulários em que os utilizadores podem escrever na origem de dados utilizando o browser. Com o Microsoft Office SharePoint Designer 2007 pode inserir rapidamente uma Vista de Dados como formulário para que os utilizadores possam efectuar e guardar alterações a qualquer destes tipos de origens de dados: listas e bibliotecas, ligações de bases de dados e ficheiros XML locais.Note que uma Vista de Dados inserida como formulário apenas pode ser utilizada com estes tipos de origens de dados.

Este artigo mostra como inserir uma Vista de Dados como formulário. Além disso, este artigo mostra como criar um ficheiro XML de exemplo para utilizar como origem de dados para que possa acompanhar o exemplo.

 Importante   Este artigo trata da criação de uma Vista de Dados num site do SharePoint localizado num servidor com o Microsoft Windows SharePoint Services 3.0. Esta funcionalidade não está disponível se o site não estiver localizado num servidor com o Windows SharePoint Services 3.0.

---

• Antes de começar

• Porquê inserir uma Vista de Dados como um formulário?

• Criar um ficheiro .xml como origem de dados de exemplo

• Inserir uma Vista de Dados como um formulário

• Editar os dados com o browser

• Passos seguintes sugeridos

---

Antes de começar

O Office SharePoint Designer 2007 tem duas funcionalidades separadas que possibilitam aos utilizadores editar os dados na Vista de Dados com o browser:

• Inserir uma Vista de Dados como um formulário   Quando cria uma Vista de Dados, pode optar por inseri-la como um formulário de um só item ou com vários itens. O formulário está sempre no modo de edição e apresenta um registo ou vários. Os utilizadores podem modificar os dados e inserir registos novos através do browser, mas não podem eliminar registos. Pode optar por um formulário de vários itens se os utilizadores tiverem de editar os dados rapidamente em muitos registos em simultâneo.
• Adicionar ligações a uma Vista de Dados existentes   Pode adicionar ligações a uma Vista de Dados existentes para que utilizadores possam editar, eliminar ou inserir registos na origem de dados. Os utilizadores clicam na ligação de edição de um registo para o colocar em modo de edição. Se adicionar ligações a uma Vista de Dados inserida como formulário, as ligações substituem os botões do formulário. Além disso, se adicionar ligações a uma Vista de Dados inserida como formulário, a Vista de Dados já não irá apresentar campos de formulário por predefinição; irá apenas apresentar dados numa vista. Para obter mais informações, consulte o artigo Editar, eliminar ou inserir registos numa Vista de Dados.

Depois de inserir uma Vista de Dados como formulário, pode filtrar, ordenar e agrupar os dados, aplicar formatação condicional ou criar colunas de fórmula. Quando os utilizadores efectuam alterações aos dados e guardam essas alterações, qualquer filtro, ordem de ordenação, formatação condicional ou coluna de fórmula que seja automaticamente aplicada reflecte os dados actualizados. Pode também adicionar acções de formulário incorporadas aos botões Guardar ou Cancelar apresentados no formulário por predefinição. Poderá encontrar uma hiperligação para mais informações sobre acções de formulários incorporados na secção Consulte Também.

 Parte Superior da Página

Porquê inserir uma Vista de Dados como um formulário?

Uma Vista de Dados é uma vista personalizável de uma origem de dados. Pode inserir uma Vista de Dados numa página ASPX como vista ou como formulário. Uma Vista de Dados inserida como vista permite formatar a apresentação de dados, mas não editar os próprios dados.

Contudo, se inserir a mesma Vista de Dados como um formulário pode editar os dados através do browser e as alterações serão escritas novamente e guardadas na origem de dados original. Com o Office SharePoint Designer 2007 pode rapidamente criar um de três tipos de formulário a partir de uma origem de dados existente:

• Um Formulário de Item Único apresenta um único registo como formulário (com cada campo na respectiva linha e com o nome do campo como cabeçalho para essa linha) para que possa editar os dados para um registo de cada vez. O formulário fornece ligações de navegação em que pode clicar para visualizar o registo anterior ou seguinte.

  

• Um Formulário de Vários Itens apresenta vários registos como formulário (com cada campo na respectiva coluna e com o nome do campo como o cabeçalho para essa coluna) para que possa editar rapidamente os dados para vários registos e guardar as alterações ao mesmo tempo.

  

• Um Formulário de Novos Itens apresenta campos em branco para um único registo (com cada campo na respectiva linha e com o nome do campo como cabeçalho para essa linha) para que possa adicionar dados a uma origem de dados, um registo de cada vez. Poderá querer incluir todos os campos relevantes para o registo, de modo a que todos os dados possam ser guardados em simultâneo.

  

As Vistas de Dados inseridas como formulários podem ser criadas para listas e bibliotecas do SharePoint, ligações de bases de dados e documentos XML locais. Quando insere uma Vista de Dados, o Office SharePoint Designer 2007 recolhe dados de uma origem de dados sob a forma de XML e apresenta esses dados utilizando XSLTs. Tal como qualquer Vista de Dados, pode modificar um formulário utilizando o Office SharePoint Designer 2007.

Após uma Vista de Dados ser inserida numa página, é igualmente possível utilizar as ferramentas WYSIWYG no Office SharePoint Designer 2007 para adicionar ou remover colunas, alterar a formatação do tipo de letra ou aplicar cores. Quando uma Vista de Dados é formatada através da utilização das ferramentas WYSIWYG disponíveis no Office SharePoint Designer 2007, a linguagem Extensible Stylesheet Language (XSL) é inserida directamente no HTML. Quando for possível editar o XSL directamente na vista Código, também será possível utilizar as ferramentas de formatação no Office SharePoint Designer 2007 para aplicar o XSL de forma rápida e fácil sem qualquer conhecimento da linguagem XSL.

 Parte Superior da Página

Criar um ficheiro .xml como origem de dados de exemplo

A Distribuidores Adamastor, uma empresa de distribuição de alimentos requintados, controla o respectivo inventário num ficheiro XML. Quando o inventário está fraco, um membro da equipa contacta o fornecedor desse produto e faz uma encomenda. Sugere que eles insiram a Vista de Dados como formulário para que o membro da equipa que faz a encomenda possa imediatamente actualizar as unidades da encomenda. Assim, a Distribuidores Adamastor terá sempre as informações mais actualizadas possível sobre o inventário actual.

Os procedimentos que se seguem exigem a utilização de um ficheiro .xml como origem de dados. Se não existir um ficheiro .xml num site do SharePoint, será necessário criar em primeiro lugar a lista de produtos da Distribuidores Adamastor. Após a lista ter sido criada, é possível inserir uma Vista de Dados como um formulário para actualizar os dados incluídos na lista.

Criar Produtos.xml

1. No menu Ficheiro, clique em Abrir Site.
2. Na caixa de diálogo Abrir Site, procure e seleccione um site do SharePoint e, em seguida, clique em Abrir.
3. Se for solicitado, na caixa de diálogo Ligar a, escreva o nome de utilizador e a palavra-passe e, em seguida, clique em OK.
4. No menu Ficheiro, clique em Novo.
5. Na caixa de diálogo Novo, no separador Página, clique em Geral no painel mais à esquerda e faça duplo clique em Ficheiro de Texto no painel seguinte à direita.

   Será aberto um novo ficheiro de texto no Web site.

6. Copie as seguintes linhas de código seleccionando-as e, em seguida, premindo CTRL+C.

   <?xml version="1.0" encoding="utf-8"?>
   <ProductsRoot>
       <Products>
           <ProductID>1</ProductID>
           <ProductName>Chai</ProductName>
           <SupplierID>1</SupplierID>
           <CategoryID>1</CategoryID>
           <QuantityPerUnit>10 boxes x 20 bags</QuantityPerUnit>
           <UnitPrice>18</UnitPrice>
           <UnitsInStock>39</UnitsInStock>
           <UnitsOnOrder>0</UnitsOnOrder>
           <ReorderLevel>10</ReorderLevel>
           <Discontinued>0</Discontinued>
       </Products>
       <Products>
           <ProductID>2</ProductID>
           <ProductName>Chang</ProductName>
           <SupplierID>1</SupplierID>
           <CategoryID>1</CategoryID>
           <QuantityPerUnit>24 - 12 oz bottles</QuantityPerUnit>
           <UnitPrice>19</UnitPrice>
           <UnitsInStock>17</UnitsInStock>
           <UnitsOnOrder>40</UnitsOnOrder>
           <ReorderLevel>25</ReorderLevel>
           <Discontinued>0</Discontinued>
       </Products>
       <Products>
           <ProductID>3</ProductID>
           <ProductName>Aniseed Syrup</ProductName>
           <SupplierID>1</SupplierID>
           <CategoryID>2</CategoryID>
           <QuantityPerUnit>12 - 550 ml bottles</QuantityPerUnit>
           <UnitPrice>10</UnitPrice>
           <UnitsInStock>13</UnitsInStock>
           <UnitsOnOrder>70</UnitsOnOrder>
           <ReorderLevel>25</ReorderLevel>
           <Discontinued>0</Discontinued>
       </Products>
       <Products>
           <ProductID>4</ProductID>
           <ProductName>Chef Anton's Cajun Seasoning</ProductName>
           <SupplierID>2</SupplierID>
           <CategoryID>2</CategoryID>
           <QuantityPerUnit>48 - 6 oz jars</QuantityPerUnit>
           <UnitPrice>22</UnitPrice>
           <UnitsInStock>53</UnitsInStock>
           <UnitsOnOrder>0</UnitsOnOrder>
           <ReorderLevel>0</ReorderLevel>
           <Discontinued>0</Discontinued>
       </Products>
       <Products>
           <ProductID>5</ProductID>
           <ProductName>Chef Anton's Gumbo Mix</ProductName>
           <SupplierID>2</SupplierID>
           <CategoryID>2</CategoryID>
           <QuantityPerUnit>36 boxes</QuantityPerUnit>
           <UnitPrice>21.35</UnitPrice>
           <UnitsInStock>0</UnitsInStock>
           <UnitsOnOrder>0</UnitsOnOrder>
           <ReorderLevel>0</ReorderLevel>
           <Discontinued>1</Discontinued>
       </Products>
    </ProductsRoot>
   

7. No Office SharePoint Designer 2007, coloque o cursor na parte superior da página e, em seguida, prima CTRL+V para colar o código que acabou de copiar para a página.
8. No menu Ficheiro, clique em Guardar Como.
9. Na caixa de diálogo Guardar Como, na caixa Nome do ficheiro, escreva produtos.xml.
10. Na lista Guardar com o tipo, clique em XML e, em seguida, clique em Guardar.

 Parte Superior da Página

Inserir uma Vista de Dados como um formulário

Quando uma Vista de Dados é inserida como um formulário através da utilização do painel de tarefas Detalhes da Origem de Dados, é inserida em primeiro lugar uma Vista de Dados na página. Em seguida, é seleccionada uma origem de dados na Biblioteca de Origens de Dados, um painel de tarefas que gere origens de dados disponíveis para um site do SharePoint. Após ser seleccionada uma origem de dados, o painel de tarefas Detalhes da Origem de Dados é aberto. No painel Detalhes da Origem de Dados, são seleccionados os campos que pretende visualizar, sendo em seguida inseridos na Vista de Dados.

Os Formulários de Dados têm como base a tecnologia ASP.NET 2.0. Para criar uma Vista de Dados, é necessário começar com uma página ASP.NET (ficheiro .aspx). Neste exemplo, será criada uma nova página ASP.NET e, em seguida, criada uma Vista de Dados como um formulário através da utilização do painel de tarefas Detalhes da origem de dados.

1. No menu Ficheiro, clique em Novo.
2. Na caixa de diálogo Novo, no separador Página, clique em Geral e, em seguida, faça duplo clique em ASPX.

   É aberta uma nova página com uma tag FORM.

   

3. No menu Vista de Dados, clique em Inserir Vista de Dados.

   Neste momento, é apresentada uma Vista de Dados vazia na página e o painel de tarefas Biblioteca de Origens de Dados é aberto.

   

   Após ter sido inserida a Vista de Dados, é possível adicionar dados.

4. No painel de dados Biblioteca de Origens de Dados, localize a origem de dados pretendida, clique nela e, em seguida, clique em Mostrar Dados.

   No exemplo, em Ficheiros XML, clique em produtos.xml e, em seguida, clique em Mostrar Dados. Se o cabeçalho Ficheiros XML se encontrar fechado, clique no sinal de adição (+) para o expandir.

5. No painel de tarefas Detalhes da Origem de Dados, clique nos campos que pretende inserir na Vista de Dados.

    Sugestão   Para seleccionar vários campos, mantenha premida a tecla CTRL enquanto clica neles.

   No exemplo, na pasta RaizDeProdutos, em Produtos, clique em NomeDoProduto. Mantenha premida a tecla CTRL enquanto clica em Existências, UnidadesEncomendadas e ExistênciaMínima.

   

6. Clique em Inserir Campos Seleccionados como e, em seguida, clique em Formulário de Vários Itens para inserir os dados seleccionados na Vista de Dados como um formulário.

    Nota   O Formulário de Item Único apresenta um registo de cada vez como um formulário. O Formulário de Vários Itens apresenta vários registos, com cada campo na respectiva coluna e o nome do campo como o cabeçalho dessa coluna.

   Os campos seleccionados no painel de tarefas Detalhes da origem de dados surgem agora num formulário.

    Nota   Como este exemplo utiliza um ficheiro .xml, cada campo da Vista de Dados é editável. Contudo, consoante o tipo da origem de dados, é possível que alguns campos possam não ser editáveis. Por exemplo, se a origem de dados for uma lista do SharePoint e optar por incluir no formulário tais campos de sistema como Criado Por ou Modificado Por, esses campos não são editáveis.

   

   Após ter sido inserida uma Vista de Dados como formulário, é possível utilizar ferramentas WYSIWYG, tal como a barra de ferramentas Formatação para modificar tipos de letra, alinhar texto ou aplicar cores. Quando é aplicada uma nova formatação a um ponto de dados numa Vista de Dados, o Office SharePoint Designer 2007 aplica a formatação a todos os dados ao mesmo nível no XML, modificando a folha de estilos XSLT anexa à página. Por exemplo, na ilustração anterior, se seleccionar Chai e, em seguida, clicar em Negrito na barra de ferramentas Formatação , o Office SharePoint Designer 2007 aplica a mesma formatação a todos os conteúdos que surjam no campo NomeDoProduto.

   

7. No menu Ficheiro, clique em Guardar Como. Na caixa de diálogo Guardar Como, na caixa Nome do ficheiro escreva um nome para o ficheiro e, em seguida, clique em Guardar.

 Parte Superior da Página

Editar os dados através do browser

Depois de guardar a página que inclui o formulário, pode pré-visualizá-la no browser e modificar os dados no formulário.

Tipos de campo e entrada de dados

Este exemplo utiliza um ficheiro XML como a origem de dados. Como um ficheiro XML é um ficheiro de texto simples, não é possível especificar os tipos de valores que os campos individuais devem ter. Por exemplo, nada o impede de introduzir e guardar texto num campo que deveria ter números, como UnidadesDaEncomenda.

Contudo, se a origem de dados é uma origem de dados SQL como uma base de dados SQL ou uma lista ou biblioteca do SharePoint, os tipos de campo podem ser especificados na própria origem de dados. Nesse caso, se utilizar o formulário para introduzir texto num campo que requer números e clicar em Guardar, é apresentada uma mensagem de erro no browser explicando que o controlo da origem de dados não executou o comando de actualização. Isto significa que está a introduzir valores no formulário que o campo da origem de dados não pode aceitar. Se receber uma tal mensagem de erro, clique em Voltar no browser e clique em Cancelar no formulário para rejeitar as alterações ou introduza valores nos campos de formulário que a origem de dados possa aceitar.

Por este motivo, quando estrutura o formulário no Office SharePoint Designer 2007 pode ser útil incluir texto nos cabeçalhos das colunas quando um campo requer tipos específicos de entrada.

Utilizar o formulário no browser

1. No Office SharePoint Designer 2007, no menu Ficheiro, clique em Pré-visualizar no Browser e clique no tipo e tamanho do browser que pretende utilizar.

   Atalho do teclado  Clique na página que pretende pré-visualizar na Lista de Pastas e prima F12.

   A página com o formulário é apresentado no browser.

   

2. Pode agora modificar qualquer uma das informações apresentadas num campo de formulário na Vista de Dados. Também pode alterar informações em vários campos em vários registos em simultâneo. Quando concluir a modificação de dados no formulário, clique em Guardar para introduzir as alterações na origem de dados ou clique em Cancelar para rejeitar as alterações.

   Para seguir o exemplo, na coluna NomeDoProduto, no campo que contém a palavra Chai, coloque o cursor no final da palavra Chai, prima a BARRA DE ESPAÇOS uma vez e escreva Concentrado de Chá. Na coluna UnidadesDaEncomenda, no registo Chai, escreva 40. Na coluna UnidadesDaEncomenda, no registo Cajus do Chefe António, escreva 35 e clique em Guardar. O formulário com os registos actualizados é apresentado no browser.

   

 Parte Superior da Página

Passos seguintes sugeridos

As Vistas de Dados constituem vistas de dados poderosas, dinâmicas e totalmente personalizáveis. Agora que aprendeu como inserir uma Vista de Dados, poderá aprender a:

• Filtrar dados numa Vista de Dados  Pode facilmente filtrar os dados numa Vista de Dados para que os dados apresentados sejam exactamente os dados que pretende visualizar. Para obter mais informações, consulte Filtrar dados numa Vista de Dados.
• Ordenar e agrupar dados numa Vista de Dados  É possível ordenar ou agrupar os dados numa Vista de Dados de forma rápida. Por exemplo, pode facilmente ordenar a lista por ordem alfabética. Para mais informações, consulte Ordenar e agrupar dados numa Vista de Dados.
• Aplicar formatação condicional a uma Vista de Dados  É possível aplicar formatação específica a uma Vista de Dados quando os dados na Vista de Dados satisfazem determinadas condições. Para mais informações, consulte Aplicar formatação condicional a uma Vista de Dados.
• Criar uma coluna de fórmula numa Vista de Dados  É possível criar uma coluna calculada que apresente o resultado de um cálculo de dados numa Vista de Dados. Por exemplo, é possível multiplicar o preço unitário pelo número de existências e apresentar o valor total dos itens numa coluna separada. Para mais informações, consulte Criar uma coluna de fórmula numa Vista de Dados.
• Modificar colunas numa Vista de Dados  É possível adicionar, remover ou reorganizar colunas numa Vista de Dados de forma rápida e fácil. Para mais informações, consulte Modificar as colunas numa Vista de Dados.
• Apresentar dados de exemplo numa Vista de Dados  É possível apresentar dados de exemplo numa Vista de Dados de forma fácil. Para mais informações, consulte Apresentar dados de exemplo numa Vista de Dados.

 Parte Superior da Página