Comience a desarrollar con características sociales en SharePoint
Empiece a programar con fuentes sociales y publicaciones de microblog de SharePoint, siguiendo personas y contenido (documentos, sitios y etiquetas) y trabajando con perfiles de usuario.
¿cómo se puede usar características sociales en soluciones y aplicaciones?
Configurar el entorno de desarrollo
escenarios de desarrollo para características sociales
guías de procedimientos para programar con características sociales
API para programar con características sociales
solicitudes de permisos para obtener acceso a las características sociales
¿Cómo puedo usar las características sociales en aplicaciones y soluciones de SharePoint?
Las características sociales de las aplicaciones y soluciones de SharePoint pueden ayudar a las personas a conectarse, comunicarse y colaborar entre sí y buscar, realizar un seguimiento y compartir contenido e información importantes. Puede agregar nuevas características sociales o ampliar las características que ya están disponibles en SharePoint. Por ejemplo, puede crear una aplicación que le permite buscar y seguir las personas que tienen un interés común, crear una visualización personalizada de los datos de la fuente o publicar actividades personalizadas a la fuente.
Las características descritas en este artículo se alinean a las personas, fuentes y funcionalidad siguiente que se encuentra en los sitios personales y sitios de grupo. El modelo de la experiencia y reputación de foro en sitios de la Comunidad no exponen una API específica, por lo que usar el sitio de SharePoint y API de lista directamente a ampliar la funcionalidad de ese. Para más información, consulte Nueva función Sitio de la comunidad.
Antes de comenzar a desarrollar, debe conocer donde se ejecutará el código, qué entorno SharePoint se ejecutará en y qué funcionalidad proporcionará. Estos factores le ayudarán a elegir el tipo de aplicación para crear y qué API o API usar. Consulte Choose the right API set in SharePoint and SharePoint Add-ins compared with SharePoint solutions (Elegir el conjunto de API adecuado en complementos de SharePoint y SharePoint en comparación con las soluciones de SharePoint ) para obtener información que pueda ayudarle a decidir.
Configurar el entorno de desarrollo
Para empezar a desarrollar con funciones sociales, necesitará:
SharePoint o SharePoint Online
Visual Studio 2012 o Visual Studio 2013, con Office Developer Tools para Visual Studio 2013 o versiones posteriores
Para obtener más instrucciones, vea Configurar un entorno de desarrollo general para SharePoint y Configurar características de informática social en SharePoint.
Escenarios de desarrollo para características sociales en SharePoint
Escenarios de desarrollo de alto nivel para características sociales incluyen trabajar con fuentes sociales, seguir a gente y contenido (documentos, sitios y etiquetas) y trabajar con las propiedades de usuario. Tabla 1 contiene vínculos a artículos que describen las API principales que usar para tener acceso a funcionalidad para cada escenario y tareas comunes de programación.
Los artículos siguientes describen las API de principales y tareas de programación para el escenario de desarrollo determinado:
Procedimientos para la programación con características sociales en SharePoint
Después de configurar el entorno de desarrollo y elija el escenario, puede empezar a programar con características sociales. La tabla 1 contiene vínculos a artículos que muestran cómo realizar tareas de programación básicas con características sociales.
Tabla 1. Artículos de procedimientos para el desarrollo con características sociales
Área de característica | Descripción |
---|---|
Cómo: Aprender a leer y escribir en la fuente social mediante el modelo de objetos de cliente de .NET en SharePoint | Recorra los pasos detallados para crear una aplicación que lea y escriba en la fuente social utilizando el modelo de objetos de cliente .NET. |
Cómo: Obtenga información sobre cómo leer y escribir en la fuente social utilizando el servicio REST de SharePoint | Eche un vistazo a través de los pasos detallados para crear una aplicación que lee y escribe en la fuente social con el servicio REST. |
Cómo: Crear y eliminar publicaciones y recuperar la fuente social mediante el modelo de objetos de cliente de .NET en SharePoint | Obtenga información sobre cómo crear y eliminar y entradas de microblog y recuperar fuentes sociales mediante el modelo de objetos de cliente. NET. |
Cómo: Crear y eliminar publicaciones y recuperar la fuente social mediante el modelo de objetos de JavaScript en SharePoint | Obtenga información sobre cómo crear y eliminar y entradas de microblog y recuperar fuentes sociales mediante el modelo de objetos de JavaScript. |
Cómo: Incluir menciones, etiquetas y vínculos a sitios y documentos en publicaciones en SharePoint | Obtenga información sobre cómo agregar objetos de SocialDataItem a las entradas de microblog, que se presenta como menciones, etiquetas y vínculos en fuentes sociales. |
Cómo: Insertar imágenes, vídeos y documentos en publicaciones en SharePoint | Obtenga información sobre cómo agregar objetos de SocialAttachment a las entradas de microblog, que se presenta como imágenes incrustadas, vídeos y documentos en fuentes sociales. |
Procedimiento para seguir a las personas mediante el modelo de objetos de cliente de .NET en SharePoint | Obtenga información sobre cómo trabajar con las características de seguimiento de personas mediante el modelo de objetos de cliente de .NET. |
Procedimiento para seguir a las personas mediante el modelo de objetos de JavaScript en SharePoint | Obtenga información sobre cómo trabajar con las características de seguimiento de personas mediante el modelo de objeto JavaScript. |
Cómo: seguir documentos y sitios mediante el uso del modelo de objetos de cliente de .NET en SharePoint | Obtenga información sobre cómo trabajar con las características de seguimiento de contenido mediante el modelo de objetos de cliente de .NET. |
Cómo seguir documentos, sitios y etiquetas mediante el uso del servicio REST en SharePoint | Obtenga información sobre cómo trabajar con las características de seguimiento de contenido mediante el servicio REST. |
Recuperar propiedades de perfil de usuario usando el modelo de objetos de cliente .NET en SharePoint | Aprenda a recuperar propiedades de perfiles de usuario con el modelo de objetos de cliente .NET. |
Procedimiento para recuperar propiedades de perfil de usuario mediante el modelo de objetos de JavaScript en SharePoint | Obtenga información sobre cómo recuperar las propiedades de perfil de usuario mediante el modelo de objetos de JavaScript. |
Cómo trabajar con perfiles de usuario y perfiles de organización con el modelo de objetos del servidor en SharePoint | Aprenda a crear, recuperar y administrar perfiles de usuario y propiedades mediante el modelo de objetos de servidor. |
API para programar con características sociales de SharePoint
Aunque soluciones y aplicaciones tener acceso a SharePoint de manera diferente, después de obtener acceso a SharePoint usar las API sociales de básicamente de la misma manera. En la tabla 2 se muestran las API para programar con características de fuentes, perfiles de usuario y siguientes en SharePoint y las rutas de acceso a los archivos de origen en el servidor.
Tabla 2. API para programar con características sociales
Nombre de la API | Origen y la ruta de acceso |
---|---|
El modelo de objetos de cliente de .NET | Microsoft.SharePoint.Client.UserProfiles.dll en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI |
Modelo de objetos de cliente de Silverlight | Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin |
Modelo de objetos de cliente móvil | Microsoft.SharePoint.Client.UserProfiles.Phone.dll en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin |
Modelo de objetos de JavaScript | SP.UserProfiles.js en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS |
Servicio Transferencia de estado representacional (REST) | http://<site url>/_api/social.feed http://<site url>/_api/social.following http://<site url>/_api/SP.UserProfiles.PeopleManager |
Modelo de objetos de servidor | Microsoft.Office.Server.UserProfiles.dll en %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI |
Nota:
No todas las funciones de servidor en el ensamblado Microsoft.Office.Server.UserProfiles está disponible desde la API de cliente. Para ver qué API están disponibles, vea el espacio de nombres Microsoft.SharePoint.Client.Social y el espacio de nombres Microsoft.SharePoint.Client.UserProfiles .
Solicitudes de permisos para obtener acceso a características sociales de Complementos de SharePoint
Una Complemento de SharePoint debe solicitar los permisos que necesita tener acceso a recursos de SharePoint desde el usuario que lo instala. Por ejemplo, una aplicación que publica en la fuente debería solicitar permiso de Write (como mínimo) a la fuente. Especifique los permisos que necesita la aplicación en el archivo AppManifest.xml en Visual Studio.
Las solicitudes de permisos de aplicación tengan un ámbito para el escenario de implementación de SharePoint. La tabla 3 muestra los nombres de ámbito (con el URI de ámbito correspondiente) y los derechos disponibles para obtener acceso a las características sociales. Para obtener más información, vea Permisos de complemento en SharePoint, Tipos de directiva de autorización de complementos en SharePoint y Planeamiento de la administración de permisos de aplicaciones en SharePoint.
Tabla 3. Ámbitos de permisos de aplicación y derechos disponibles para las características sociales en SharePoint
Nombre de ámbito | Descripción | Derechos disponibles |
---|---|---|
Perfiles de usuariohttp://sharepoint/social/tenant |
Ámbito de la solicitud de permiso utilizado para acceder a todos los perfiles de usuario. Solo se puede cambiar la imagen de perfil; todas las demás propiedades de perfil de usuario son de solo lectura para complementos de SharePoint. Debe ser instalado por un administrador de inquilinos. | Read, Write, Manage, FullControl |
Incorporación principalhttp://sharepoint/social/core |
El ámbito de solicitud de permiso utilizado para tener acceso el usuario contenido seguido y shared metadatos que se usan en las características de microblogs. Este ámbito sólo se aplica a los sitios personales que admiten después de contenido. Si la aplicación se instala en cualquier otro tipo de sitio, use el ámbito de inquilino. | Read, Write, Manage, FullControl |
Fuente de noticiashttp://sharepoint/social/microfeed |
El ámbito de solicitud de permiso que se usa para tener acceso a la fuente del usuario o la fuente del equipo. Este ámbito se aplica a los sitios personales que admiten microblogs o a los sitios de equipo donde se activa la característica de Fuente de sitio. Si la aplicación se instala en cualquier otro tipo de sitio, use el ámbito de inquilino. | Read, Write, Manage, FullControl |
http://sharepoint/social/trimming |
Este ámbito de solicitud de permiso se utiliza para determinar si se va a mostrar el contenido de restricciones de seguridad en la fuente social a las aplicaciones. Si no se concede este permiso de confianza elevada, se recorta parte del contenido (por ejemplo, las actividades sobre documentos y sitios que la aplicación no tiene permisos para) de los datos de la fuente que se devuelven a la aplicación, incluso si el usuario tiene permisos suficientes. Este permiso debe agregarse manualmente al archivo de manifiesto de la aplicación. | Read, Write, Manage, FullControl |
¿Qué necesita tener en cuenta al solicitar permisos de aplicación
Debe tener en cuenta las siguientes consideraciones cuando se especifican los permisos de aplicación para las características sociales:
No se permiten las aplicaciones que especifica los derechos de FullControl para las aplicaciones de Tienda Office. Se permiten únicamente los derechos Read, Writey Manage para aplicaciones de Tienda Office.
Puede especificar permisos para la alimentación y las siguientes características con el núcleo, suministro de noticias y ámbitos de inquilino (
http://sharepoint/content/tenant
). El ámbito de inquilino representa todo arrendamiento donde está instalada una aplicación, incluidos los ámbitos de núcleo y el suministro de noticias. Por lo que si la aplicación ya especifica los derechos que necesita en el ámbito de inquilino, no necesitará solicitar permisos en el ámbito principal o suministro de noticias.Durante el desarrollo, usar el ámbito de inquilino si recibe un "SocialListNotFound: la lista Social no existe en el sitio personal" o el mensaje "Archivo no encontrado". Si desea usar el ámbito principal o suministro de noticias en su aplicación, puede probar los permisos abriendo la aplicación desde el catálogo de aplicaciones.
El ámbito principal se aplica a los sitios personales que admiten después de contenido. El ámbito de suministro de noticias se aplica a los sitios personales que admiten microblogs o a los sitios de equipo donde se activa la característica de Fuente de sitio. Si la aplicación se instalará en cualquier otro tipo de sitio, debe usar el ámbito de inquilino. Vea Arrendamientos y ámbitos de implementación de los complementos para SharePoint.
Aplicaciones que solicitan derechos para el ámbito de los perfiles de usuario deben estar instaladas por un administrador de inquilinos y no se puede instalar en la versión de Office 365 Small Business Premium de SharePoint Online.
Si no se cumplen los requisitos de activación de licencias o característica para características sociales y de microblogs, los usuarios reciben un mensaje que indica que no se puede instalar la aplicación.
Las aplicaciones que se inician fuera de SharePoint pueden solicitar permiso sobre la marcha (excepto Control total). Para obtener más información, vea Flujo de OAuth de código de autorización para complementos de SharePoint.
Vea también
Artículos sobre conceptos
Novedades para desarrolladores en características sociales y de colaboración en SharePoint
Planeación de sistemas sociales y de colaboración en SharePoint
Configuración de características de informática social en SharePoint
Terminología y conceptos de informática social en SharePoint
Documentación de referencia