Paso 2: Creación del elemento de menú de bloque de control de edición
Última modificación: martes, 06 de abril de 2010
Hace referencia a: SharePoint Server 2010
En este tema se muestra cómo modificar el menú contextual de elemento de lista, también conocido como menú de bloque de control de edición (ECB), para incluir un elemento que inicia del trabajo de conversión de documento de los Servicios de automatización de Word.
Adición del elemento de menú de ECB
La solución que se crea en este tutorial crea una entrada de menú contextual de elemento de lista para archivos .docx de Microsoft Word. Cuando los usuarios abren el menú contextual de documento para un archivo .docx determinado, pueden hacer clic en la nueva entrada para iniciar la conversión del documento. Para modificar el menú de ECB, debe crear una nueva característica y, a continuación, agregar un nuevo elemento de menú contextual.
Para crear una característica
En el Explorador de soluciones, haga clic con el botón secundario en Características y, a continuación, haga clic en Agregar característica.
Escriba un título para la característica; por ejemplo, Convertir documento.
Escriba una descripción para la característica; por ejemplo, Esta característica convierte documentos con formato Office Open XML de Word mediante Word Automation Services.
Acepte el ámbito predeterminado de la característica (Web) que proporciona a los administradores de conjuntos o granjas de servidores de SharePoint Server 2010 la capacidad para habilitar o deshabilitar la característica en cada sitio.
Después de crear la característica, agregue el nuevo elemento de menú contextual.
Para agregar un elemento de menú contextual
En el Explorador de soluciones, haga clic con el botón secundario en el proyecto, elija Agregar y, a continuación, haga clic en Nuevo elemento....
En el cuadro de diálogo Agregar nuevo elemento, seleccione Elemento vacío para crear un archivo de elemento en blanco al que puede agregar el código XML que define el elemento de menú contextual.
Escriba un nombre para el elemento; por ejemplo, ElementoDeMenúContextual.
Haga clic en Agregar para agregar el elemento al proyecto. El nuevo elemento aparece en el Explorador de soluciones.
En el Explorador de soluciones, haga doble clic en Elements.xml para abrirlo para su edición.
En el XML del archivo Elements.xml, agregue el siguiente código XML en el elemento <Elements>.
<CustomAction Id="ConvertDocument" RegistrationType="FileType" RegistrationId="docx" Location="EditControlBlock" Sequence="106" Title="Convert Document"></CustomAction>El código XML define la nueva acción personalizada de conversión de documento, mediante la configuración de los siguientes atributos:
Id especifica un identificador exclusivo y arbitrario para esta acción; en este caso, ConvertDocument.
RegistrationType especifica cuándo aparece el elemento de menú contextual. En este caso, debe usar FileType para indicar que el nuevo elemento de menú contextual se asocia a la extensión de nombre de archivo específica.
RegistrationId especifica el tipo de archivo que se va a usar para el elemento de menú contextual. En este caso, puede usar docx para limitar el elemento de menú a archivos que tienen la extensión de nombre de archivo .docx.
Location especifica dónde se va a agregar el elemento de menú. En este caso, debe usar EditControlBlock para colocar la acción en el menú contextual de elemento de lista.
Sequence especifica dónde aparece un elemento en relación a los demás elementos del menú.
Title especifica el nombre del elemento de menú personalizado; por ejemplo, ConvertDocument.
En el elemento <CustomAction>, agregue el siguiente código XML.
<UrlAction Url="~site/_layouts/ConvertItem/ConvertItem.aspx?ListId={ListId}&ItemId={ItemId}&ItemUrl={ItemUrl}"/>El código XML define una dirección URL de una página web de SharePoint que se abre cuando el usuario invoca esta acción personalizada. La dirección URL comienza con ~site/, que resuelve a la dirección URL del sitio actual de SharePoint Server 2010. La dirección URL también especifica tres parámetros de consulta y sus tokens asociados:
{ListId}, que resuelve al identificador de la lista primaria.
{ItemId}, que resuelve al identificador del elemento de lista.
{ItemUrl}, que resuelve a la dirección URL relativa de sitio del elemento de lista.
Vea también
Tareas
Paso 3: creación de una página de la aplicación web para iniciar conversiones
Paso 4: creación de una página de la aplicación web para supervisar conversiones
Paso 5: creación e implementación de la solución del menú ECB