Como a: Adicionar Ações para a interface do usuário

Artigo
11/27/2008

Usar recursos facilita a adicionar ações aos menus do interface do usuário em Windows SharePoint Services. Este exemplo mostra como adicionar ações para vários menus através de um recurso e como ativá-lo dentro de implantação.

Local e agrupar identificação

Para definir um ação personalizada para um menu específico, você deve identificar o menu pela configuração de localidade para o apropriado espaço para nome dos serviços SharePoint Windows, e usando a identificação que serviços SharePoint Windows usa para identificar a localidade específica.

De exemplo, para adicionar um ação personalizada para a página Site Settings, defina o atributo Location local do elemento cc5ed5c2-c362-4a61-af77-ff9e8f7e1cae CustomAction para especificar .e Microsoft.SharePoint.SiteSettings Microsoft.SharePoint.SiteSettings uma área específica dentro de página por meio de atributo GroupId GroupId.

Ações diferentes podem exigir usando atributos diferentes CustomAction CustomAction para identificar o menu no qual a local um personalizado item de menu. Mas você também precisa especificar outros parâmetros para a ação, de exemplo, para especificar uma versão, usuário permissões exigido para executar a ação, ou posicionamento in relation to ações existentes no menu. O personalizado ações do seguinte exemplo apresentação uma variedade de atributos.

Consulte Locais de ação personalizada e identificações de padrão para uma lista de personalizado de usar como padrão ação identificações e locais que são usados em uma instalação de Windows SharePoint Services.

Tokens URL

Oferece suporte a serviços SharePoint Windows o seguinte tokens com o qual deseja iniciar uma URL relativa:

~site - site ( SPWeb) relativo link.

~sitecollection - site coleção ( SPSite) relativo link.

Além disso, você pode usar o seguinte tokens dentro uma URL:

{ItemId} - Integer ID que representa o item em uma lista.

{ItemUrl} - URL do item que está sendo tratados. Somente trabalho para documentos em bibliotecas. [Não funcional no Beta 2]

{ListId} -GUID que representa a lista.

{SiteUrl} - URL do site ( SPWeb).

{RecurrenceId} - índice de recorrência. Esse token não com suporte para uso em menus de contexto de lista itens.

Procedimentos

Para adicionar ações para o interface do usuário em uma coleção site

Criar uma pasta UserInterfaceCustomActions de Diretório de instalação no seguinte localidade: C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\FEATURES.

Criar um arquivo Feature.xml na nova pasta UserInterfaceCustomActions para fornecer o manifesto para o recurso, such as o seguinte.

                          <?xml version="1.0" encoding="utf-8" ?>
<Feature Id="GUID" 
    Title="UI Custom Actions"
    Description="This example shows how you can customize various areas inside Windows SharePoint Services."
    Version="1.0.0.0"
    Scope="Site"
    xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="UICustomActions.xml" />
  </ElementManifests>
</Feature>

Para substituir o espaço reservado GUID no anterior Id atributo de identificação, gerar um GUID pela execução Guidgen.exe localizado no Diretório Local_Drive:\Program Files\Microsoft Visual Studio 8\Common7\Tools 8\Common7\Tools Local_Drive:\Program Files\Microsoft Visual Studio.

Criar um arquivo UICustomActions.xml para definir elementos para os vários ações incluídas dentro de recurso. For the sake of exemplo, o URL para cada ação aponta para um arquivo .aspx e passa um valor que identifica a origem da solicitação, as follows:

                          <?xml version="1.0" encoding="utf-8" ?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
<!-- Document Library Toolbar New Menu Dropdown -->
  <CustomAction Id="UserInterfaceCustomActions.DocLibNewToolbar"
    RegistrationType="List"
    RegistrationId="101"
    GroupId="NewMenu"
    Rights="ManagePermissions"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="1000"
    Title="MY DOCLIB NEW MENU TOOLBAR BUTTON">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?NewMenu"/>
  </CustomAction>
<!-- Document Library Toolbar Upload Menu Dropdown -->
  <CustomAction Id="UserInterfaceCustomActions.DocLibUploadToolbar"
    RegistrationType="List"
    RegistrationId="101"
    GroupId="UploadMenu"
    Rights="ManagePermissions"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="1000"
    Title="MY DOCLIB UPLOAD MENU TOOLBAR BUTTON">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?UploadMenu"/>
  </CustomAction>
<!-- Document Library Toolbar Actions Menu Dropdown -->
  <CustomAction Id="UserInterfaceCustomActions.DocLibActionsToolbar"
    RegistrationType="List"
    RegistrationId="101"
    GroupId="ActionsMenu"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="1000"
    Title="MY DOCLIB ACTIONS MENU TOOLBAR BUTTON">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?ActionsMenu"/>
</CustomAction>
<!-- Document Library Toolbar Settings Menu Dropdown -->
  <CustomAction Id="UserInterfaceCustomActions.DocLibSettingsToolbar"
    RegistrationType="List"
    RegistrationId="101"
    GroupId="SettingsMenu"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="1000"
    Title="MY DOCLIB SETTINGS MENU TOOLBAR BUTTON">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?SettingsMenu"/>
  </CustomAction>
<!-- Site Actions Dropdown -->
  <CustomAction Id="UserInterfaceCustomActions.SiteActionsToolbar"
    GroupId="SiteActions"
    Location="Microsoft.SharePoint.StandardMenu"
    Sequence="1000"
    Title="MY SITE ACTIONS BUTTON">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?SiteActions"/>
  </CustomAction>
<!-- Per Item Dropdown (ECB)-->
  <CustomAction 
    Id="UserInterfaceCustomActions.ECBItemToolbar"
    RegistrationType="List"
    RegistrationId="101"
    Type="ECBItem" 
    Location="EditControlBlock"
    Sequence="106"
    Title="MY ECB ITEM">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?ECBItem"/>
  </CustomAction>
<!-- Display Form Toolbar -->
  <CustomAction 
    Id="UserInterfaceCustomActions.DisplayFormToolbar"
    RegistrationType="List"
    RegistrationId="101"
    Location="DisplayFormToolbar"
    Sequence="106"
    Title="MY DISPLAY FORM TOOLBAR">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?DisplayFormToolbar"/>
  </CustomAction>
<!-- Edit Form Toolbar -->
  <CustomAction 
    Id="UserInterfaceCustomActions.EditFormToolbar"
    RegistrationType="List"
    RegistrationId="101"
    Location="EditFormToolbar"
    Sequence="106"
    Title="MY EDIT FORM TOOLBAR">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?EditFormToolbar"/>
  </CustomAction>
<!-- Site Settings -->
  <CustomAction 
    Id="UserInterfaceCustomActions.SiteSettings"
    GroupId="Customization"
    Location="Microsoft.SharePoint.SiteSettings"
    Sequence="106"
    Title="MY SITE SETTINGS LINK">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?Customization"/>
  </CustomAction>
<!-- Content Type Settings -->
  <CustomAction 
    Id="UserInterfaceCustomActions.ContentTypeSettings"
    GroupId="General"
    Location="Microsoft.SharePoint.ContentTypeSettings"
    Sequence="106"
    Title="MY CONTENT TYPE SETTINGS LINK">
    <UrlAction Url="/_layouts/CustomActionsHello.aspx?General"/>
  </CustomAction>
</Elements>

Other common GroupId values that can be used include ViewToolbar, ViewSelectorMenu, and PersonalActions (Welcome menu)

Adicione um arquivo CustomActionsHello.aspx such as a seguinte o Diretório \TEMPLATE\LAYOUTS \TEMPLATE\LAYOUTS para servir como destino para os vínculos criados na etapa anterior.

                          <%@ Page Language="C#"  Inherits="System.Web.UI.Page"%>
<%
string clientQuery = Page.ClientQueryString;
if (clientQuery == "NewMenu")
{
    Response.Write("You came from the new document menu.");
}
else if (clientQuery == "UploadMenu")
{
    Response.Write("You came from the upload menu.");
}
else if (clientQuery == "ActionsMenu")
{
    Response.Write("You came from the actions menu.");
}
else if (clientQuery == "SettingsMenu")
{
    Response.Write("You came from the settings menu.");
}
else if (clientQuery == "SiteActions")
{
    Response.Write("You came from the Site Actions menu.");
}
else if (clientQuery == "ECBItem")
{
    Response.Write("You came from the document's context menu.");
}
else if (clientQuery == "DisplayFormToolbar")
{
    Response.Write("You came from the display item properties form.");
}
else if (clientQuery == "EditFormToolbar")
{
    Response.Write("You came from the edit item properties form.");
}
else if (clientQuery == "Customization")
{
    Response.Write("You came from the Site Settings menu.");
}
else if (clientQuery.StartsWith("General"))
{
    Response.Write("You came from the Content Type Settings menu.");
}
%>

Em um prompt de comando, tipo o seguinte comandos para instalar o recurso na implantação, ativar o recurso em um subsite especificado e, em seguida, redefinir Serviços de Informações da Internet da Microsoft (IIS) para que as alterações tenham efeito.

                             a. stsadm -o installfeature -filename UserInterfaceCustomActions\feature.xml
   b. stsadm -o activatefeature -filename UserInterfaceCustomActions\feature.xml -url https://Server/Site/Subsite
   c. iisreset

Para ver os vários personalizado ações que você adicionou, navegar para a seguinte locais a home page de um site na coleção de site:
1. Clique em ações site para ver a nova ação de menu Site Actions.
2. Clique em definições do site sobre o menu Site Actions para ver uma nova ação na seção de Look and Feel da página Site Settings.
3. Navegar para uma biblioteca documento e aberto cada menu sobre a barra de ferramentas para ver uma nova ação em cada menu.
4. In a document library that contains items, click the down arrow for an item to see the new action on the edit control block menu.
5. On the edit control block menu for an item, click View Properties and Edit Properties to see new actions on the Display form and Edit form toolbars.

Consulte também

Conceitos

Locais de ação personalizada e identificações de padrão

Compartilhar via