Uso de módulos para incluir archivos en la solución

  • Artículo

Es posible que en ocasiones quiera implementar archivos en el servidor de SharePoint, independientemente de su tipo de archivo, como nuevas páginas maestras. Para ello, puede usar Módulos (no los confunda con los módulos de código de Visual Basic). Los módulos son contenedores de archivos en una solución de SharePoint. Cuando se implementa la solución, los archivos del módulo se copian en las carpetas especificadas en el servidor de SharePoint.

Elementos y elementos de módulo

Para crear un módulo, debe elegirlo en el cuadro de diálogo Agregar nuevo elemento para agregarlo a un proyecto. Después, modifique su archivo Elements.xml para incluir los nombres de los archivos que quiera implementar, dónde se encuentran en el sistema y dónde se deben copiar en el servidor de SharePoint.

Este es un ejemplo del archivo Elements.xml de un módulo:

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
    <Module Name="Module1">
        <File Path="Module1\Sample.txt" Url="Module1/Sample.txt" />
    </Module>
</Elements>

Los módulos recién creados contienen los siguientes archivos predeterminados:

Nombre de archivo Descripción
Elements.xml El archivo de definición del módulo.
Sample.txt Un archivo de marcador de posición que actúa como ejemplo de un archivo en el módulo.

El archivo Elements.xml contiene los elementos siguientes:

Nombre del elemento Descripción
Elementos Contiene todos los elementos definidos en el módulo.
Módulo El elemento de módulo tiene un solo atributo, Name, que especifica el nombre del módulo en el formato <Module Name="Module1">.

Tenga en cuenta que si cambia el nombre del módulo (o su propiedad Nombre de carpeta), tendrá que actualizar manualmente el nombre en el elemento Módulo.

Si especifica un subdirectorio para los archivos en el elemento Módulo, Windows SharePoint Services (WSS) creará automáticamente una estructura de directorios coincidente para ellos.
Archivo El elemento Archivo tiene dos parámetros, Path y Url.

- Path: nombre y ubicación del archivo en la solución de SharePoint. El formato es Path="Module1\Sample.txt".

- Url: ubicación donde se va a implementar el archivo en el servidor de SharePoint. El formato es Url="Module1/Sample.txt".

- Type: atributo opcional con dos valores: GhostableInLibrary y Ghostable. El formato es Type="GhostableInLibrary". La especificación de GhostableInLibrary significa que el archivo se agregará a una biblioteca de documentos de SharePoint junto con un elemento de lista para acompañar el archivo cuando se agrega a la biblioteca. Al especificar Ghostable, el archivo se agrega a SharePoint fuera de la biblioteca de documentos.

Cada archivo que quiera implementar necesita una entrada de elemento <File> independiente en Elements.xml.

Consulte también