Compartilhar via

Como a: Personalizar a Web Part de Conteúdo da consulta usando propriedades personalizadas

  • Artigo

Você pode usar a Web Part de Conteúdo de consulta para criar personalizado modos de exibição de dados que é consultado em muitas origens e presentes que dados em um local. Após adicionar o Content Query Web Part para um página da Web, você pode consultando o comportamento, lista personalizado e de conteúdo tipos por configuração personalizado propriedades. do personalizar o Web Part Há 60 propriedades e métodos disponível para o ContentByQueryWebPart classe T:Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart, muitos dos quais você pode personalizar. Este tópico apresenta algumas das propriedades e inclui exemplos de uso e sintaxe no formato Collaborative Application Markup Language (CAML) que você pode adicionar a um arquivo .WebPart.

Algumas propriedades de conteúdo consulta da Web Part Microsoft Office do SharePoint Server 2007 ossossversion12 são herdadas de Windows SharePoint Services 3.0 e outros são exclusivo para O Office SharePoint Server 2007. Este tópico concentra-se na propriedades introduzidas em O Office SharePoint Server 2007. A seguir estão as duas categorias básicas de propriedades de conteúdo de consulta da Web Part O Office SharePoint Server 2007 ossossshort:

  • Propriedades que definidas ou substituir um aspecto do subjacente Web Part o comportamento. Em alguns casos, essas propriedades também afetam a interface usuário (interface do usuário).

  • Propriedades que modificam o Web Part UI sem configuração ou de substituição subjacente comportamento.

Propriedades que modificar interface do usuário e o comportamento

Propriedades na primeira GRUPO, such as substituições, são geralmente mais avançado porque você pode usá-los para modificar o comportamento da Web Part. Se um usuário tentar modificar o interface do usuário ou definir outra propriedade que pode afetar o comportamento que afeta esta propriedade, essa propriedade "WINS" no interface do usuário; Ele substitui outras configurações e determina como a Web Part de Conteúdo da consulta se comporta. Essas propriedades são úteis quando você desejar fazer o seguinte:

  • Adicione campos persistentes e campo Opções.

  • Substituir o usar como padrão cruzado-consulta lista comportamento para que muda para campo e campo opções no persistir interface do usuário e não pode ser substituído ou interrompido por outras alterações.

  • Renomear longo, nomes compostos coluna em mais comum variável transformação XSLT nomes e evitar a criação personalizado transformações XSLT para cada esquema.

A seguinte tabela descreve algumas das propriedades que modificam interface do usuário e comportamento.

Propriedade Descrição

CommonViewFields

Solicita campos adicionais, que é necessário porque a Web Part de Conteúdo da consulta não retorna todos os campos para todos os itens automaticamente. Você deve campos solicitação para processar em um transformação XSLT.

Esta propriedade é aditivo, o que significa que você pode adicionar mais de um CommonViewField para um conteúdo consulta da Web Part e estender suas propriedades de base, como FieldDescription e FieldTitle.

QueryOverride

Ignora os limites para consulta comportamento impostas pela Content Query Web Part UI. Possibilita especificar a parte consulta de um cruzado-consulta lista em CAML.

Quando o QueryOverride QueryOverride propriedade estiver definida, o interface do usuário para filtragem, classificação, e agrupamento aparece esmaecido no painel de ferramenta. De exemplo, Por padrão o Content Query Web Part permite três filtros e você pode desejar para adicionar mais e garantir que o personalizado campos e o comportamento persistir no interface do usuário.

WebsOverride

Determina se o cruzado-consulta lista deve incluir subsites. O Office SharePoint Server 2007 Por padrão, recurses subsites, que significa que o site pai e seus sites filho são exibidos.

Quando o WebsOverride WebsOverride propriedade for definida, a Web Part de Conteúdo da consulta não incluir e exibe os resultados de somente o site especificado.

ListsOverride

Substitui o comportamento lista em O Office SharePoint Server 2007 e oferece suporte a vários tipos de listas, como bibliotecas de página, o tipo base General List e tipos lista específica. Você pode usar este personalizado propriedade para definir qualquer tipo lista, mesmo aqueles não enumerados no interface do usuário porque o modelo não está definido na raiz ou é um tipo base.

Tipos de lista são definidos no tópico de referência b2b26fee-eb45-48ac-99f1-65f725da293f lista elemento no Windows SharePoint Services 3.0 SDK.

ViewFieldsOverride

Proporciona a Web Part de Conteúdo da consulta a capacidade solicitação um conjunto de campos a partir de consulta que você especificar, instead of fazendo a solicitação automática em O Office SharePoint Server 2007 para os campos de base.

DataColumnRenames

Permite a Web Part de Conteúdo da consulta para renomear colunas antes dos dados são passados para o transformação XSLT para processamento.

Propriedades que modificar interface do usuário sem substituindo o comportamento

Como alternativa, você pode precisar Acendedor-peso opções para personalizar campos, campo opções, agrupamento e opções de classificação e filtro opções na interface do usuário. Essas personalizações não afetam o subjacente comportamento e pode ser substituída por propriedades na primeira GRUPO que Não substituir comportamento. Personalizações, como elas são úteis se você desejar fazer o seguinte:

  • Oferecer mais opções por uma Web Part que são definidos inicialmente quando uma instância do Web Part é adicionada à página de conteúdo da consulta

  • Afetam somente uma Web Part que provavelmente não será assunto para um substituir

  • Tornar mais opções disponível para o usuário final.

A seguinte tabela descreve algumas das propriedades neste GRUPO.

Propriedade Descrição

AdditionalFilterFields

AdditionalGroupAndSortFields

Inclui um ou mais campos adicionais ( AdditionalFilterFields AdditionalFilterFields propriedade) ou agrupamento e classificação opções ( AdditionalGroupAndSortFields AdditionalGroupAndSortFields propriedade) que não normalmente aparecem no interface do usuário em ato de soltar o filtro lista suspensa. Isso pode ser útil se um campo não está configurado como uma coluna site mas está presente em algumas listas e deve estar disponível no interface do usuário. Quando essa propriedade for definida, o interface do usuário oferece essa coluna para filtragem.

FilterField1

FilterType1

FilterValue1

FilterOperator1

Filter1ChainingOperator

Inclui a funcionalidade para valores filtro além que suporta o interface do usuário. Utilizar essas propriedades para prefill alguns valores interface do usuário, como quando a Web Part é adicionada primeiro para a página. De exemplo, você pode desejar para especificar valores usar como padrão e para filtro no relativo intervalo de data para data a de hoje.

As abordagens para personalizar uma Web Part de Conteúdo da consulta

Há mais de uma maneira para definir ou modificar personalizado propriedades em uma Web Part de Conteúdo da consulta e o método você escolher depende seus objetivos e onde você está no site e site design processo. De exemplo, se você estiver personalizando um layout de página existente, você poderá usar Microsoft Office do SharePoint Designer 2007 e personalizar o Content Query Web Part enquanto você personalizar o Page Layout. Se você estiver criando um novo, conteúdo personalizado consulta da Web Part para um layout de página existente, você poderá usar O Office SharePoint Designer 2007 para adicionar ou modificar personalizado propriedades.

Para modificar o personalizado propriedades uma Parte da Web de consulta de conteúdo existente, você pode exportar o arquivo .WebPart, faça um copiar-e renomear o original, modifique o personalizado propriedades na copiar do arquivo .WebPart e, em seguida, importação-lo em uma zona Web Part na sua página. Renomeando o original arquivo .WebPart garante que um copiar do original arquivo .WebPart existe para atualizar futura cenários.

Para exportar um arquivo .WebPart, defina sua personalizado Propriedades e, em seguida, importação-

  1. Faça logon no seu site.

  2. O menu Site Actions, clique em Editar Página .

  3. Localizar a Web Part de Conteúdo da consulta na página e, em seguida, do Web Part editar menu, clique exportar .

  4. Salve o arquivo .WebPart.

  5. Renomeie o arquivo .WebPart e, em seguida, use um editor de texto ou O Office SharePoint Designer 2007 para aberto o arquivo renomeado.

    Dica

    Renomeando o original arquivo .WebPart garante que um copiar do original arquivo .WebPart existe para atualizar futura cenários.

  6. Adicionar ou modificar as propriedades e valores propriedade e em seguida, salvar suas alterações.

  7. No menu Página, apontar para Add Web Parts e clique em seguida, procurar .

  8. Selecione a Web Part para importação do Web Part List e em seguida, clique OK .

  9. Arraste a Web Part para uma zona Web Part na página.

Exemplo

Descrição

Esta seção descreve personalizado propriedades e inclui exemplos de formatação e codificar para personalizado propriedade instruções e consultas CAML em uma Web Part de Conteúdo da consulta. Primeiro, apresentamos formatação, informações do campo de base e dicas para usar o CommonViewFields CommonViewFields propriedade. Next, we present a complete CAML query and then walk through the QueryOverride, ListsOverride, WebsOverride, and ViewFieldsOverride properties it sets. You can add each of the property values presented in the CAML query to its respective <property value> statement in the .webpart file. Finalmente, é apresentar a propriedade DataColumnRenames DataColumnRenames e o filtro, agrupamento e classificação opções propriedades.

Propriedade CommonViewFields

Você pode usar dois formatos ao personalizar o CommonViewFields CommonViewFields propriedade. Você pode especificar campos por seu nome interno, ou uma combinação de nome interno e campo Nome, da seguinte maneira:

  • Nome interno de campo

  • Nome interno de campo , tipo de campo

A notação usada para caracteres especiais distingue o nome interno do nome usado no interface do usuário. De exemplo, um espaço entre palavras é representado por _x0020_ no nome interno. Você pode ver o nome interno exibindo o parâmetro seqüência de caracteres da consulta em uma página Site Column, ou por exibindo a codificar Web Part depois de criar o campo. Você pode exibição a codificar Web Part por configuração a Web Part para filtro em um campo, exportando a Web Part e, em seguida, exibindo as propriedades de filtro.

Dica

Para uma lista de adicionais field types que o CommonViewField CommonViewField propriedade tipos campo solicitação, consulte o SPFieldType T:Microsoft.SharePoint.SPFieldType enumeração no Windows SharePoint Services 3.0 SDK.O Office SharePoint Server 2007 includes four additional fields—HTML, Image, Link, and SummaryLink—that you can request.As constantes que este tópico lista identificar os tipos de dados que pode incluir um CommonViewFields CommonViewFields propriedade.

Você também pode combinar as definições CommonViewFields CommonViewFields em instruções compostas, que é útil para definir more than um campo em uma declaração propriedade. Use um ponto-e-vírgula para separar os campos quando combinar definições em uma declaração. Por exemplo:

Nome interno de campo ; Nome interno de campo , tipo de campo

CommonViewFields é uma propriedade Additive, o que significa que você pode adicionar um comum campo exibição No parte superior dos campos de base que sempre solicita a Content Query Web Part. O de base campos solicitação colunas usar como padrão por GUID e no interface do usuário aparecem como nomes de Site Column. A seguinte tabela lista os nomes campo básico e tipos.

Nome Tipo

Title

Texto

FileRef

Pesquisa

ID

Contador

Modified

DateTime

Author

"Usuário"

Editor

Usuário

Created

DateTime

PublishingRollupImage

Imagem

Level

"Number"

Note

"Observação"

No seguinte exemplo, a CommonViewFields propriedade define o GUID, quais O Office SharePoint Server 2007 usa internamente para referência o nome interno do campo, o tipo de campo, o nome interno do CommonViewField e seu tipo base, CommonViewFields seguido de GUID da tipo base.

<property name="CommonViewFields" type="string">_Level,Number;PublishingRollupImage;</property>

QueryOverride, ListsOverride, WebsOverride e ViewFieldsOverride propriedades

Each override property—QueryOverride, ListsOverride, WebsOverride, and ViewFieldsOverride—overrides a default Content Query Web Part behavior. Para substituir um comportamento, construção uma consulta CAML que define as condições desejar para definir.

Dica

Para saber mais sobre a sintaxe CAML e comandos, consulte o Os esquemas principal linguagem de marcação de aplicativos de colaboração no Windows SharePoint Services 3.0 SDK.

No seguinte exemplo, nós demonstrar personalizado configuração Propriedades para a Web Part de consulta de conteúdo usando uma consulta CAML. A consulta CAML faz o seguinte:

  1. Recupera um campo Created criado.

  2. Define a consulta para recuperar itens atualizadas nos últimos sete dias e classifica-los em ordem decrescente.

  3. Especifica o tipo lista a consulta do.

  4. Recupera dados recursivamente do site especificado e seus filhos.

  5. Recupera os valores para um campo específico para exibir para cada item.

A consulta inteira é mostrada, e ele está descrito em detalhes no seguinte seções.

 1 <ViewFields>
 2   <FieldRef name="Title" Nullable="True" Type="Text"/>
 3   <FieldRef name="Comments" Nullable="True" Type="Note"/>
 4 </ViewFields>
 5 <Lists ServerTemplate="850"></Lists>
 6 <Webs Recursive="True" />
 7 <RowLimit>15</RowLimit>
 8 <![CDATA[
 9    <Where>
10     <Gt>
11       <FieldRef name="Created" Nullable="True" Type="DateTime"/>
12       <Value Type="DateTime"><Today OffsetDays="-7"/></Value>
13     </Gt>
14   </Where>
15   <OrderBy>
16       <FieldRef name="Created" Nullable="True" Type="DateTime"
17       Ascending="FALSE"/>
18   </OrderBy>]]>

Propriedade QueryOverride

8-19 Linhas definem o QueryOverride QueryOverride propriedade.

 8 <![CDATA[
 9    <Where>
10     <Gt>
11       <FieldRef name="Created" Nullable="True" Type="DateTime"/>
12       <Value Type="DateTime"><Today OffsetDays="-7"/></Value>
13     </Gt>
14   </Where>
15 <OrderBy>
16    <FieldRef name="Created" Nullable="True" Type="DateTime"
17    Ascending="FALSE"/>
18 </OrderBy>
19 </Query>]]>

Na acima exemplo:

  • Lines 8-10 define the query and open the <where> clause.

  • A linha 11 refere-se a um campo tipo base com o nome "Criado" e é de tipo de campo DateTime.

  • Linha 12 define o valor para este campo seja DateTime e define um deslocamento de-7, significando que 7 é subtraída a partir da data que a consulta filtros no.

  • Lines 13 and 14 close the <where> clause.

  • Line 15 opens the <OrderBy> clause, which determines the sort order for the fields specified within.

  • As linhas 16 e 17 definir a ordem classificar para o campo "Criado". A Web Part exibe esse dados em ordem decrescente.

Propriedade ListsOverride

Você também pode usar uma consulta CAML para recuperar itens de Windows SharePoint Services 3.0 e O Office SharePoint Server 2007 listas. A seguinte tabela mostra três exemplos declaração CAML que recuperar itens de lista distintos tipos.

Tipo lista Propriedade declaração

Bibliotecas de página

 
<![CDATA[
   <Lists ServerTemplate="850">
   </Lists>
]]>

Tipo base General List

 
<![CDATA[
         <Lists BaseType="0">
         </Lists>
]]>

Um tipo específico de lista

 
<![CDATA[
   <Lists>
     <List ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}"/>
   </Lists>
]]>

De exemplo, 5 linha define o ListsOverride ListsOverride propriedade.

5 <Lists ServerTemplate="850"></Lists>

Este maiúsculas e minúsculas, a consulta usa ServerTemplate="850" para substituir a atual lista em uso. Você pode localizar uma enumeração de disponível lista tipos de Lists P:Microsoft.SharePoint.SPSiteDataQuery.Lists propriedade no Windows SharePoint Services 3.0 SDK.

Propriedade WebsOverride

Você pode usar CAML para definir a propriedade WebsOverride WebsOverride para recuperar itens recursivamente, conforme o seguinte exemplo de código.

<![CDATA[
   <Webs Recursive="True"/>
]]>

Ou recuperar itens de somente os sites especificados.

<![CDATA[
   <Webs/>
]]>

Na linha 6 de exemplo, definimos a propriedade como recuperar itens recursivamente.

6 <Webs Recursive="True"/>

Propriedade ViewFieldsOverride

Para exibir valores para qualquer item no Web Part, definido a propriedade ViewFieldsOverride ViewFieldsOverride como recuperar dados de um tipo especificado de um campo especificado, como mostrado no seguinte exemplo de código.

<![CDATA[
   <FieldRef name="Comments" Nullable="True" Type="Note"/>
   <FieldRef name="Created" Nullable="False" Type="User"/>
]]>

Configuração Nullable="True" retorna itens que não têm essa coluna.

No amostra de código, 1\endash 4 linhas defina o ViewFieldsOverride ViewFieldsOverride propriedade:

1 <ViewFields>
2   <FieldRef name="Title" Nullable="True" Type="Text"/>
3   <FieldRef name="Comments" Nullable="True" Type="Note"/>
4 </ViewFields>

  • Line 1 opens the <ViewFields> clause, which sets the ViewFieldsOverride property.

  • Linhas referir 2 e 3 para o campo Title título (um campo de texto) e o campo Comments comentários (um campo detalhes).

  • Line 4 closes the <ViewFields> section.

Propriedade DataColumnRename

Use o DataColumnRename DataColumnRename propriedade às colunas renomear programaticamente. Esta propriedade pode ajudá-lo a minimizar XSLT e personalização esquema, ou para executar em massa ou personalizado coluna renomeando operações. De exemplo, você pode renomear um composto nome da coluna such as KBArticleTitle para um comum nome de variável transformação XSLT such as Title e remover a necessidade de criar um personalizado transformação XSLT para cada personalizado esquema.

Separe valores renomear coluna usando ponto-e-vírgula e use o formato originalName newName.

<![CDATA[<property name="DataColumnRenames" type="string">KBArticleTitle,Title</property>]]

Dica

Se você renomear uma coluna com um nome que já existe, a operação renomear falhará.

Campos adicionais, Filtro, Agrupamento e Classificação opções

Definir propriedades neste GRUPO para adicionar campos, grupos, agrupamento e classificação opções, filtros e opções filtro. Você pode especificar campos pelo seu nome interno, GUID, uma combinação de nome interno e exibir nome ou GUID e exibir o nome.

Definir as propriedades AdditionalGroupAndSortFields AdditionalFilterFields AdditionalGroupAndSortFields e usando um do seguinte formatos:

  • internalName

  • internalName, DisplayName

  • GUID

  • GUID, DisplayName

Você pode também combinar AdditionalFilterFields e AdditionalGroupAndSortFields AdditionalGroupAndSortFields definições em instruções compostas, que é útil para definir more than um campo em uma declaração propriedade. Use ponto-e-vírgula para separar os campos quando combinar definições em uma declaração, conforme mostrado:

internalName;GUID; internalName,DisplayName;GUID,DisplayName

Configurando o AdditionalFilterFields AdditionalFilterFields propriedade permite que você adicionar um Created criado para o interface do usuário, conforme o seguinte exemplo de código.

<![CDATA[<property name="AdditionalFilterFields" type="string">Created</property>]]

Configurando o AdditionalGroupAndSortFields AdditionalGroupAndSortFields propriedade permite que você adicionar um opção criado para o agrupamento e classificação listas de interface do usuário,

<!CDATA[<property name="AdditionalGroupAndSortFields" type="string">Created</property>]]

Filtrar propriedades

Você pode usar personalizado propriedades para estender filtro valores além que suporta o interface do usuário. Definir ou modificar qualquer um dos campo filtro, filtro tipo, valor filtro ou filtro encadeamento propriedades operador adiciona ou altera o comportamento filtro no interface do usuário.

Dica

Propriedades de Filtro Não substituir o interface do usuário; Eles prefill o interface do usuário com valores usar como padrão.

Campo de filtro, tipo filtro e propriedades valor filtro são sempre do tipo string:

  • <property name="FilterField1" type="string" />

  • <property name="FilterType1" type="string" />

  • <property name="FilterValue1" type="string" />

  • <property name="FilterOperator1" type="Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart+FilterFieldQueryOperator, Microsoft.SharePoint.Publishing, Version=12.0.0, Culture=neutral" PublicKeyToken=71e9bce111e9429c"/>

O seguinte exemplo codificar filtro Exibe um filtro criado no formato DateTime DateTime e Exibe itens que foram criados após 25 de outubro de 2006:

  • <property name="FilterField1" type="string">Created</property>

  • <property name="FilterType1" type="string">DateTime</property>

  • <property name="FilterValue1" type="string">Today-7</property>

  • <property name="FilterOperator1" type="Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart+FilterFieldQueryOperator, Microsoft.SharePoint.Publishing, Version=12.0.0, Culture=neutral" PublicKeyToken=71e9bce111e9429c"/>

Use the following format to set the type parameter in filter operator and filter chaining operator property statements: PropertyName, namespace, Version, Culture, PublicKeyToken.

  • <property name="FilterOperator1" type="Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart+FilterFieldQueryOperator, Microsoft.SharePoint.Publishing, Version=12.0.0, Culture=neutral" PublicKeyToken=71e9bce111e9429c"/>

  • <property name="Filter1ChainingOperator" type="Microsoft.SharePoint.Publishing.WebControls.ContentByQueryWebPart+FilterField, Microsoft.SharePoint.Publishing, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c">Eq</property>

O válido valores para o operador filtro e filtro encadeamento operador propriedades diferem, da seguinte maneira:

  • A filtro operador propriedades apresentação o E e ou botões no interface do usuário.

  • O filtro encadeamento operador propriedades preencher o segundo campo no mostrar itens quando Lista no seção Additional Filters do interface do usuário.

A seguinte tabela fornece válido valores para propriedades operador de filtro.

Valor Valor de exibição

And

E

Or

Ou

A seguinte tabela fornece válido valores para o filtro encadeamento propriedades operador.

Valor Valor de exibição

Eq

é igual a

Neq

não é igual a

Gt

é maior que

Geq

é maior ou igual a

Lt

é menor que

Leq

é menor ou igual a

BeginsWith

Começa com

Contains

Contém

Consulte também

Referência

SPSiteDataQuery
ContentQueryWebPart

Outros recursos

Como a: Personalizar XSL para a Web Part de Conteúdo da consulta
Como a: exibir campos personalizados em um conteúdo consulta da Web Part
Como a: Personalizar o RSS para a Web Part de Conteúdo da consulta