Tutorial: Creación de una lista, tipo de contenido y columna de sitio para SharePoint

Los procedimientos siguientes muestran cómo crear columnas de sitio de SharePoint personalizadas (o campos), así como un tipo de contenido que las usa. También muestra cómo crear una lista que use el tipo de contenido nuevo.

En este tutorial se incluyen las tareas siguientes:

• Creación de columnas de sitio personalizadas.

• Creación de un tipo de contenido personalizado.

• Creación de una lista.

• Pruebe la aplicación.

  Nota:

  Es posible que tu equipo muestre nombres o ubicaciones diferentes para algunos de los elementos de la interfaz de usuario de Visual Studio en las siguientes instrucciones. La edición de Visual Studio que se tenga y la configuración que se utilice determinan estos elementos. Para obtener más información, vea Personalizar el IDE.

Requisitos previos

Necesitará los componentes siguientes para completar este tutorial:

• Ediciones compatibles de Windows y SharePoint.

• Visual Studio 2019

Creación de columnas de sitio personalizadas

En este ejemplo se crea una lista para administrar pacientes en un hospital. Primero, debe crear un proyecto de SharePoint en Visual Studio y agregarle columnas de sitio, como se indica abajo.

Para crear el proyecto

1. En el menú Archivo, de Visual Studio, seleccione Nuevo>Proyecto.

2. En el cuadro de diálogo Crear un proyecto nuevo, seleccione el proyecto vacío de SharePoint para la versión concreta de SharePoint que ha instalado. Por ejemplo, si tiene instalado SharePoint 2016, seleccione la plantilla SharePoint 2016 - Proyecto vacío.

   Nota

   También puede buscar plantillas escribiendo SharePoint en el cuadro de texto Buscar en la parte superior del cuadro de diálogo Crear un nuevo proyecto. También puede filtrar la lista de plantillas para mostrar solo las plantillas de Office y SharePoint seleccionando "Office" en el cuadro desplegable Tipo de proyecto. Para obtener más información, consulte Creación de un proyecto en Visual Studio.

3. Cambie el nombre del proyecto a Clinic y, después, seleccione el botón Crear.

4. En el cuadro de diálogo Especifique el sitio y el nivel de seguridad de la depuración, escriba la dirección URL del sitio local de SharePoint al que desea agregar el nuevo elemento de campo personalizado o use la ubicación predeterminada (http://<SystemName>/).

5. En la sección ¿Cuál es el nivel de confianza de esta solución de SharePoint?, use el valor predeterminado Implementar como solución en espacio aislado.

   Para obtener más información sobre las soluciones en espacio aislado y las de granja de servidores, consulte Consideraciones sobre las soluciones de espacio aislado.

6. Elija el botón Finalizar. Ahora, el proyecto aparece en el Explorador de soluciones.

Instrucciones para la adición de columnas de sitio

1. Agregue una columna de sitio nueva. Para ello, en el Explorador de soluciones, haga clic con el botón derecho en el proyecto Clinic y, después, seleccione Agregar>Nuevo elemento.

2. En el cuadro de diálogo Agregar nuevo elemento, seleccione Columna de sitio, cambie el nombre a PatientName y, después, seleccione el botón Agregar.

3. En el archivo Elements.xml de la columna de sitio, deje el valor Type como Text, cambie el valor Group a Clinic Site Columns. Cuando haya finalizado, el archivo Elements.xml de la columna de sitio debe tener un aspecto similar al del ejemplo siguiente.

   <Field
        ID="{f9ba60d1-5631-41fb-b016-a38cf48eef63}"
        Name="PatientName"
        DisplayName="Patient Name"
        Type="Text"
        Required="FALSE"
        Group="Clinic Site Columns">
   </Field>
   

   Sugerencia

   Visual Studio agregará automáticamente un espacio en DisplayName si usa mayúsculas y minúsculas Camel en el nombre de la columna de sitio. Se recomienda no usar espacios en el nombre de la columna de sitio, ya que puede causar problemas al intentar implementar la solución en SharePoint.

4. Con el mismo procedimiento, agregue dos columnas de sitio más al proyecto: PatientID (Type = "Integer") y DoctorName (Type = "Text"). Establezca su valor Group en Clinic Site Columns.

Creación de un tipo de contenido personalizado

Ahora, cree un tipo de contenido (basado en el tipo de contenido Contactos) que incluya las columnas de sitio que creó en el procedimiento anterior. Al basar un tipo de contenido en otro ya existente, puede ahorrar tiempo porque el tipo de contenido base proporciona varias columnas de sitio para su uso en el nuevo.

Instrucciones para la creación de un tipo de contenido personalizado

1. Agregue un tipo de contenido al proyecto. Para ello, en el Explorador de soluciones, elija el nodo de proyecto.

2. En la barra de menús, elija Proyecto>Agregar nuevo elemento.

3. En Visual C# o Visual Basic, expanda el nodo SharePoint y, después, seleccione el nodo 2010.

4. En el panel Plantillas, seleccione la plantilla Tipo de contenido, cambie el nombre a Información del paciente y, después, seleccione el botón Agregar.

   Se abre el Asistente para la personalización de SharePoint.

5. En la lista Which base content type should this content type inherit from (¿Qué tipo de contenido base debe heredar de este tipo de contenido?), seleccione Contacto como el tipo de contenido en el que basar el nuevo tipo de contenido y, después, el botón Finalizar.

   Esta acción le proporciona acceso a otras columnas de sitio potencialmente útiles en el tipo de contenido Contacto, además de las columnas de sitio que definió anteriormente.

6. Después de que aparezca el diseñador Tipo de contenido, en la pestaña Columnas, agregue las tres columnas de sitio que definió anteriormente: Nombre del paciente, Id. del paciente y Nombre del médico. Para agregar estas columnas, elija el primer cuadro de lista de la lista de columnas del sitio en Nombre para mostrar y, después, seleccione cada columna de sitio de la lista de una en una.

   Sugerencia

   Para elegir las columnas de sitio más rápidamente, filtre la lista escribiendo las primeras letras del nombre de la columna.

7. Además de las tres columnas de sitio personalizadas, agregue la columna de sitio Comentarios desde la lista de columnas del sitio.

8. Active la casilla Obligatorio para las columnas de sitio Nombre del paciente e Id. del paciente para convertirlos en campos obligatorios.

9. En la pestaña Tipo de contenido, asegúrese de que su nombre es Información del paciente y, después, cambie la descripción a Tarjeta información del paciente.

10. Cambie el Nombre de grupo a Tipo de contenido Clinic y deje la otra configuración en los valores predeterminados.

11. En la barra de menús, elija Archivo>Guardar todo y, después, cierre el diseñador Tipo de contenido.

Crear una lista

Ahora, cree una lista que use el nuevo tipo de contenido y las columnas de sitio.

Instrucciones para la creación de una lista

1. Agregue una lista al proyecto. Para ello, en el Explorador de soluciones, seleccione el nodo de proyecto.

2. En la barra de menús, elija Proyecto>Agregar nuevo elemento.

3. En Visual C# o Visual Basic, expanda el nodo SharePoint.

4. En el panel Plantillas, seleccione la plantilla Lista, cambie el nombre a Pacientes y, después, seleccione el botón Agregar.

5. Deje el valor Customize the list based on (Personalizar la lista en función de) en Predeterminado (lista personalizada) y, después, seleccione el botón Finalizar.

6. En el Diseñador de listas, seleccione el botón Tipos de contenido para mostrar el cuadro de diálogo Configuración de tipo de contenido.

7. Seleccione la fila nueva, luego, el tipo de contenido Información del paciente en la lista de tipos de contenido y, después, el botón Aceptar.

   Esta acción agrega todas las columnas de sitio del tipo de contenido Información del paciente a la lista.

8. Elimine todas las columnas de sitio de la lista, excepto las siguientes:

   • Id. de paciente

   • Nombre del paciente

   • Teléfono particular

   • Correo electrónico

   • Nombre del médico

   • Comentarios

9. En Nombre para mostrar de la columna, seleccione una fila vacía, agregue una columna de lista personalizada y asígnele el nombre Hospital. Deje su tipo de datos como Texto de una sola línea.

   La columna de lista personalizada solo se aplica a esta lista. Al agregar una columna de lista personalizada a una lista, se crea y establece como lista predeterminada un tipo de contenido de lista nuevo, que incluye todas las columnas agregadas a la lista.

   Sugerencia

   Si selecciona una columna de la lista de columnas de sitio, se usará una columna de sitio existente. Pero si escribe un valor de nombre de columna sin elegir ninguna columna de la lista, se crea una columna de lista personalizada, incluso si ya existe una columna con el mismo nombre en la lista.

   Opcionalmente, en lugar de establecer el tipo de datos de la columna de lista personalizada en Texto de una sola línea, podría establecer el tipo de datos de esta columna en Búsqueda y sus valores se recuperarían de una tabla u otra lista. Para obtener información sobre las columnas de búsqueda, consulte Enumeración de relaciones en SharePoint 2010 y Búsquedas y relaciones entre listas.

10. Junto a las casillas Id. del paciente y Nombre del paciente, active la casilla Obligatorio.

11. En la pestaña Vistas, seleccione una fila vacía para crear una vista. Escriba Detalles del paciente en una fila en blanco en la columna Nombre de la vista.

    En la pestaña Vistas, puede especificar las columnas que desea que aparezcan en la lista de SharePoint.

12. Seleccione la nueva fila Detalles del paciente y, después, elija el botón Establecer como predeterminado.

    La vista nueva es ahora la vista predeterminada de la lista.

13. Agregue las columnas siguientes a la lista Columnas seleccionadas en el orden que se indica:

    • Id. de paciente

    • Nombre del paciente

    • Teléfono particular

    • Correo electrónico

    • Nombre del médico

    • Hospital

    • Comentarios

14. En la lista Propiedades, seleccione la propiedad Ordenar y agrupar y, después, el botón de puntos suspensivos para mostrar el cuadro de diálogo Ordenar y agrupar.

15. En la lista Nombre de columna, seleccione Nombre del paciente, asegúrese de que la columna Ordenar está establecida en Ascendente y, después, seleccione el botón Aceptar.

Prueba de la aplicación

Ahora que la lista, las columnas de sitio personalizadas, el tipo de contenido están listos, impleméntelos en SharePoint y ejecute la aplicación para probarlo.

Para probar la aplicación

1. En la barra de menús, pulse Archivo>Guardar todo.

2. Presione la tecla F5 para ejecutar la aplicación.

   La aplicación se compila y, después, sus características se implementan en SharePoint y se activan.

3. En la barra de navegación rápida, seleccione el vínculo Pacientes para mostrar la lista Pacientes.

   Los nombres de columna de la lista deben coincidir con los especificados en la pestaña Vistas de Visual Studio.

4. Seleccione el vínculo Agregar nuevo elemento para crear una tarjeta de información de pacientes.

5. Escriba información en los campos y, después, elija el botón Guardar.

   El nuevo registro aparece en la lista.

Contenido relacionado

• Creación de listas, tipos de contenido y columnas de sitio para SharePoint
• Desarrollar soluciones de SharePoint
• Procedimiento para crear un tipo de campo personalizado
• Tipos de contenido
• Columnas