Usar a Web Part de Formulário HTML para filtrar e exibir dados em outra Web Part

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar a Web Part de Formulário HTML para conectar e transmitir dados a outra Web Part, como a Web Part de Modo de Exibição de Lista.

Neste artigo:

Usando a Web Part de formulário

Adicionar uma Web Part a uma página

Conectar a Web Part de formulário HTML para outra Web Part

Personalizar a Web Part de formulário HTML

Personalizar a Web Part de formulário HTML padrão

Usar uma caixa de texto de várias linhas

Usar botões de opção

Usar uma lista suspensa de opções

Usar caixas de seleção

Configurar as propriedades comuns de uma Web Part

Aparência

Layout

Avançadas

Usando a Web Part de Formulário

Você pode usar a Web Part de Formulário HTML para conectar e transmitir dados a outra Web Part. Por exemplo, é possível usar a Web Part de Formulário HTML padrão para digitar um nome de região, transmitir o valor para a Web Part de Modo de Exibição de Lista de dados de clientes e filtrar os dados por essa região. Também é possível personalizar a Web Part de Formulário HTML para permitir que um usuário, por exemplo, selecione o nome da região em uma lista suspensa. Você pode usar caixas de texto, listas suspensas, caixas de texto de várias linhas, caixas de seleção ou botões de opção na Web Part de Formulário HTML.

A maneira de conectar campos à outra Web Part depende de como ela foi definida para usar conexões de Web Part.

Você pode ter mais de um elemento (caixa de texto, botões de opção e assim por diante) no formulário, mas somente um campo pode ser conectado a uma Web Part de Modo de Exibição de Lista. Ainda assim, diferentes campos podem ser conectados a diferentes Web Parts ao mesmo tempo. Por exemplo, é possível ter uma Web Part de Formulário HTML com uma caixa de texto e um conjunto de botões de opção. A caixa de texto pode ser conectada a uma Web Part de Modo de Exibição de Lista, e os botões de opção, a outra. Quando o usuário clica no botão Ir, ambas as Web Parts Modo de Exibição de Lista são filtradas de acordo com as informações inseridas na Web Part de Formulário HTML.

Você poderá conectar dois ou mais campos na Web Part de Formulário HTML a outra Web Part, se esta puder aceitar vários parâmetros. Nesse caso, será necessário ter um programa de design da Web compatível com o SharePoint, como o SharePoint Designer 2010 para completar as conexões.

Início da página

Adicionar uma Web Part a uma página

Para editar uma página, é necessário ter pelo menos as permissões obtidas por meio da adição ao grupo padrão Membros do <Nome do Site> do SharePoint.

  1. Em uma página, na faixa de opções, clique na guia Página e no comando Editar.

    Comando Editar da guia Editar

    Se o comando Editar estiver desabilitado, talvez você não tenha as permissões para editar a página. Contate o administrador.

  2. Clique na página em que deseja adicionar uma Web Part, clique na guia Inserir e em Web Parts.

    comando de web part

  3. Em Categorias, selecione uma categoria, como Listas e Bibliotecas, selecione a Web Part que você deseja adicionar à página, como Comunicados e clique em Adicionar.

    Seletor de Web Part

  4. Quando você seleciona uma Web Part, as informações sobre ela são exibidas em Sobre a Web Part.

  5. Quando terminar de editar a página, clique na guia Página e em Salvar e Fechar.

Início da página

Conectar a Web Part de Formulário HTML a outra Web Part

Para usar a Web Part de formulário HTML, conecte-o com outra Web Part que é capaz de recebimento valores por meio de uma conexão de Web Part, como a Web Part de exibição de lista. A lista que você deseja filtrar e a coluna na qual você deseja filtrar, devem estar visíveis em uma Web Part na mesma página como a Web Part de formulário HTML. Para obter informações sobre como adicionar uma Web Part de formulário HTML para uma página, consulte Adicionar uma Web Part a uma página.

  1. Navegue até a página contendo a Web Part que você deseja filtrar.

  2. Na faixa de opções, clique na guia Página e no comando Editar.

    Se o comando Editar estiver desabilitado, talvez você não tenha as permissões para editar a página. Contate o administrador.

  3. Aponte para a Web Part de Formulário HTML, clique na seta para baixo, clique em Conexões, aponte para Fornecer Valor de Formulário para e clique no nome da Web Part à qual você deseja se vincular.

  4. Na caixa de diálogo Escolher Conexão, clique na guia Configurar Conexão.

  5. No menu Tipo de Conexão, selecione o campo que corresponde às informações da Web Part de Formulário HTML.

Observação : Os campos não precisam ter os mesmos nomes, nem eles precisam ser os mesmos tipos de dados. Os valores enviados a partir da Web Part de formulário HTML são valores de texto.

  1. Clique em Concluir e em Sair do Modo de Edição, no topo da página.

Por padrão, é possível digitar texto na caixa de texto e clicar em Ir ou pressionar ENTER. A outra Web Part exibirá somente os dados que correspondem ao texto digitado. Para desmarcar a caixa de texto para você poder digitar novo texto, selecione o texto atual e exclua-o.

Início da página

Personalizar a Web Part de Formulário HTML

É possível personalizar a Web Part de Formulário HTML usando o Editor de Código-fonte, disponível no painel de ferramentas da Web Part de Formulário HTML, ou um programa de design da Web compatível com o SharePoint, como o SharePoint Designer 2010. Em vez da caixa de texto padrão, você pode usar botões de opção, caixas de seleção, caixas de texto de várias linhas e caixas de listagem. Também pode adicionar rótulos e atribuir um valor padrão.

Se você personalizar a Web Part de Formulário HTML, lembre-se do seguinte:

  • Apenas um botão Ir (que usa o elemento INPUT) pode ser usado para transmitir dados a outra Web Part.

  • A Web Part de Formulário HTML usa o elemento FORM. Certos elementos HTML não podem ser usados dentro do elemento FORM, incluindo os elementos HTML, BODY e FORM.

  • Todos os nomes de campo de formulário devem ser exclusivos. Cada valor de nome é usado para conexão com um nome de coluna correspondente na Web Part a que você esteja se conectando.

Para personalizar a Web Part de Formulário, use o botão Editor de Código-fonte para exibir a caixa de diálogo Editor de Texto e revisar ou adicionar o código-fonte HTML.

Observação : A Web Part de formulário HTML somente fornece dados para outra Web Part conectável — ele não é possível obter dados de outra Web Part conectável. Por exemplo, você não pode usar a Web Part de formulário HTML como um formulário de detalhes para exibir uma linha de dados.

Início da página

Personalizar a Web Part de Formulário HTML padrão

Para personalizar a Web Part de Formulário padrão, siga este procedimento:

  1. Na página exibir a Web Part de formulário de HTML, na faixa de opções, clique na guia Editar e clique na comando Editar.

  2. Aponte para a Web Part de formulário HTML, clique na seta para baixo e clique em Editar Web Part.

  3. No painel de ferramentas, clique no botão Editor de origem .

  4. A caixa de diálogo Entrada de Texto é aberta com o código HTML padrão.

Para facilitar a leitura e modificação do código, insira retornos de carro no texto para quebrar as linhas, conforme exibido aqui:

<div onkeydown="javascript:if (event.keyCode == 13) _SFSUBMIT_">
<input type="text" name="T1"/>
<input type="button" value="Go" onclick="javascript:_SFSUBMIT_"/>
</div>

É possível alterar o primeiro elemento INPUT de várias maneiras alterando o nome de um campo, adicionando um rótulo a um campo ou adicionando um valor padrão.

Propriedade

rição

Nome do campo

O nome da caixa de texto padrão na Web Part de formulário é T1. Este é o nome que aparece na caixa de diálogo Conexão de configuração . Para dar um nome mais significativo de campo, digite um novo nome no lugar de T1. Não remova as aspas.

Rótulo do campo

Você pode adicionar um texto de rótulo antes ou depois do campo de formulário. Digite o texto sem aspas.

valor padrão

Você pode adicionar um valor padrão ao campo de área de texto. O usuário pode aceitar o valor clicando no botão Ir ou substituí-lo digitando sua própria entrada. Para adicionar um valor padrão, use o atributo de valor.

Por exemplo, se você desejar fornecer um nome mais significativo, adicione um valor padrão e um rótulo; siga este procedimento:

Region: <input type="text" name="Region" value="India"/>

Você pode alterar o segundo elemento INPUT alterando o nome do botão, conforme mostra o exemplo a seguir:

<input type="button" value="SUBMIT" onclick="javascript:_SFSUBMIT_"/>

Você também pode adicionar outros elementos HTML antes e depois do elemento DIV. Por exemplo, uma maneira bem útil e simples de permitir que o usuário atualize rapidamente a página e redefina os elementos FORM é adicionar uma marca de âncora da página atual depois de fechar o elemento DIV. Por exemplo:

<br/>
<a href="http://contoso/SitePages/CustByRegion.aspx">Refresh</a>

Importante : Não altere o outro código HTML na caixa de diálogo Editor de texto. A Web Part de formulário HTML dinamicamente cria uma rotina script em tempo de execução para criar a conexão para a outra Web Part. Não modifique o código de evento onkeydown ou onclick, ou você pode quebrar sem querer a Web Part de formulário HTML.

Início da página

Usar uma caixa de texto de várias linhas

O elemento TEXTAREA define um controle de entrada de texto de várias linhas. O atributo ROWS especifica o número de linhas visíveis no campo de texto. O atributo COLS especifica a largura da área de texto em caracteres. No exemplo a seguir, o usuário vê uma caixa de texto com 5 linhas por 30 caracteres de largura. Quando o usuário digitar nessa caixa, o texto será quebrado ao atingir 30 caracteres.

<textarea name="Region" rows=5 cols=30></textarea>

Dica : Verifique se que há nenhum espaço no código-fonte imediatamente após o colchete de ângulo reto (>).

Início da página

Usar botões de opção

Os botões de opção fornecem opções mutuamente exclusivas a um usuário. O exemplo a seguir exibe esses botões de opção. Use o mesmo nome para cada botão de opção. É comum adicionar rótulos depois de cada botão. Se desejar formatar cada botão de opção em uma linha separada, use o elemento BR.

<input type="radio" name="Region" value="India"/> India<BR/>
<input type="radio" name="Region" value="USA"/> USA<BR/>
<input type="radio" name="Region" value="Spain"/> Spain<BR/>

Início da página

Usar uma lista suspensa de opções

Se houver muitas opções mutuamente exclusivas, considere o uso de uma caixa de listagem suspensa usando o elemento SELECT. Cada opção aparece como uma opção separada na lista, mas o usuário só pode selecionar uma delas. O texto após o colchete angular de fechamento do elemento OPTION é o que aparece na lista suspensa.

<select name="Region">
<option value="India">India</option>
<option value="USA">USA</option>
<option value="Spain"> Spain </option>
</select>

Para fornecer um valor padrão, como Espanha, siga este procedimento:

<option value="Spain" selected="selected"> Spain </option>

Início da página

Usar caixas de seleção

Se houver várias opções mutuamente não exclusivas, considere o uso de caixas de seleção. Cada opção aparece como uma caixa de seleção separada e o usuário pode selecionar parcial ou totalmente as opções. O uso dessa opção requer uma Web Part que aceite vários parâmetros da conexão de Web Part.

<input type="checkbox" name="region1" value="India"/> India<BR/>
<input type="checkbox" name="region2" value="USA"/> USA<BR/>
<input type="checkbox" name="region3" value="Spain"/> Spain<BR/>

Para fornecer um valor padrão, como Espanha, siga este procedimento:

<input type="checkbox" name="region3" value="Spain" checked="checked"/> Spain<BR/> 

Início da página

Configurar as propriedades comuns de uma Web Part

As Web parts compartilham um conjunto comum de propriedades que controlam sua aparência, seu layout e suas características avançadas. É possível alterar as propriedades das Web Parts no painel de ferramentas.

Observação :  As propriedades comuns das Web Parts que você vê no painel de ferramentas podem ser diferentes das propriedades documentadas nesta seção por vários motivos

  • Para ver a seção Avançado do painel de ferramentas, é preciso ter a permissão apropriada.

  • Para uma Web Part específica, o desenvolvedor de Web Parts pode ter optado por não exibir uma ou mais das propriedades comuns, ou pode ter preferido criar e exibir propriedades adicionais que não estão listadas abaixo nas seções Aparência, Layout e Avançado do painel de ferramentas.

  • Algumas permissões e configurações de propriedades podem desabilitar ou ocultar propriedades de Web Part.

Aparência

Propriedade

rição

Título

Especifica o título da Web Part que aparece na barra de título da Web Part.

Altura

Especifica a altura da Web Part.

Largura

Especifica a largura da Web Part.

Estado do Cromado

Especifica se toda a Web Part aparece na página quando essa página é aberta pelo usuário. Por padrão, o estado do cromado é definido como Normal e toda a Web Part é exibida. Apenas a barra de título aparece quando o estado está configurado como Minimizado.

Tipo de Cromado

Especifica se a barra de título e a borda do quadro da Web Part são exibidas.

Layout

Propriedade

rição

Oculta

Especifica se a Web Part fica visível quando o usuário abre a página. Se essa caixa de seleção estiver marcada, a Web Part ficará visível apenas quando você estiver criando a página e terá o sufixo (Oculta) acrescentado ao título.

Você poderá ocultar uma Web Part se quiser usá-la para fornecer dados para outra Web Part por meio de uma conexão de Web Part, mas não quiser exibi-la.

Direção

Especifica a direção do texto no conteúdo da Web Part. Por exemplo, arábico é um idioma da direita para a esquerda; inglês e a maioria dos idiomas europeus são da esquerda para a direita. É possível que essa configuração não esteja disponível para todos os tipos de Web Parts.

Zona

Especifica a zona da página na qual a Web Part está localizada.

Observação : As zonas da página não são relacionadas na caixa de listagem quando você não tem permissão para modificá-las.

Índice de Zona

Especifica a posição da Web Part em uma zona quando essa zona contém mais de uma Web Part.

Para especificar a ordem, digite um inteiro positivo na caixa de texto.

Se as Web Parts na zona estiverem ordenadas de cima para baixo, um valor de 1 significa que a Web Part aparece na parte superior da zona. Se elas estiverem ordenadas da esquerda para a direita, um valor de 1 significa que a Web Part aparece na lateral esquerda da zona.

Por exemplo, quando você adiciona uma Web Part a uma zona vazia ordenada de cima para baixo, o Índice de Zona é 0. Quando uma segunda Web Part é adicionada à parte inferior da zona, seu Índice de Zona é 1. Para mover a segunda Web Part até a parte superior dessa zona, digite 0 e depois digite 1 para a primeira Web Part.

Observação :  Cada Web Part na zona deve ter um valor de Índice de Zona exclusivo. Portanto, alterar o valor de Índice de Zona da Web Part atual também pode alterar esse valor para as outras Web Parts na mesma zona.

Avançada

Propriedade

rição

Permitir Minimização

Especifica se a Web Part pode ser minimizada.

Permitir Fechamento

Especifica se Web Part pode ser removida da página.

Permitir Ocultar

Especifica se a Web Part pode ser ocultada.

Permitir Alteração de Zona

Especifica se a Web Part pode ser movida para outra zona.

Permitir Conexões

Especifica se a Web Part pode participar de conexões com outras Web Parts.

Permitir Edição na Exibição Pessoal

Especifica se as propriedades da Web Part podem ser modificadas em uma exibição pessoal.

Modo de Exportação

Especifica o nível de dados que podem ser exportados para esta Web Part. Dependendo da sua configuração, talvez essa definição não esteja disponível.

URL do Título

Especifica a URL de um arquivo que contém informações adicionais sobre a Web Part. O arquivo é exibido em uma janela separada do navegador quando você clica no título da Web Part.

Descrição

Especifica a Dica de Tela que aparece quando o ponteiro do mouse está sobre o título ou o ícone da Web Part. O valor dessa propriedade é usado quando você procura Web Parts usando o comando Pesquisar no menu Localizar Web Parts do painel de ferramentas.

URL da Ajuda

Especifica a localização de um arquivo que contém informações de Ajuda sobre a Web Part. As informações da Ajuda são exibidas em uma janela separada do navegador quando você clica no comando Ajuda do menu da Web Part.

Modo de Ajuda

Especifica como o navegador exibirá o conteúdo da Ajuda de uma Web Part.

Selecione uma destas opções:

Janela Restrita Abre uma janela de navegador separada, se o navegador tiver esse recurso. O usuário precisa fechar a janela antes de retornar à página da Web.

Sem Janela Restrita Abre uma janela de navegador separada, se o navegador tiver esse recurso. O usuário não precisa fechar a janela antes de retornar à página da Web. Esse é o valor padrão.

Navegar Abre a página da Web na janela atual do navegador.

Observação : Embora as Web Parts personalizadas do Microsoft ASP.NET ofereçam suporte a essa propriedade, os tópicos da Ajuda padrão do SharePoint são abertos apenas em janela separada do navegador.

URL da Imagem do Ícone de Catálogo

Especifica a localização de um arquivo que contém uma imagem a ser usada como ícone da Web Part na Lista de Web Parts. O tamanho da imagem deve ser de 16 por 16 pixels.

URL da Imagem do Ícone de Título

Especifica a localização de um arquivo que contém uma imagem a ser usada na barra de título da Web Part. O tamanho da imagem deve ser 16 por 16 pixels.

Mensagem de Erro de Importação

Especifica uma mensagem que aparecerá se houver algum problema na importação da Web Part.

Início da página

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×