Introdução ao desenvolvimento de recursos sociais no SharePoint
Comece a programar com feeds sociais e postagens de microblog do SharePoint, seguindo pessoas e conteúdo (documentos, sites e marcas) e trabalhando com perfis de usuário.
como usar recursos sociais em aplicativos e soluções?
Configurar o ambiente de desenvolvimento
cenários de desenvolvimento para recursos sociais
instruções para programação com recursos sociais
APIs para programação com recursos sociais
solicitações de permissão para acessar os recursos sociais
Como posso usar recursos sociais em aplicativos e soluções do SharePoint?
Recursos sociais em aplicativos e soluções do SharePoint podem ajudar as pessoas a se conectar, se comunicar e colaborar entre si e encontrar, acompanhar e compartilhar conteúdo e informações importantes. Você pode adicionar novos recursos sociais ou estender os recursos que já estão disponíveis no SharePoint. Por exemplo, você pode criar um aplicativo que permite que você encontre e siga as pessoas que têm um interesse comum, crie uma visualização personalizada dos dados feeds ou publicar atividades personalizadas para o feed.
Os recursos descritos neste artigo são alinhados à pessoas, feeds e seguinte funcionalidade que você pode encontrar em sites de equipe e sites pessoais. Modelo de experiência e reputação do fórum em Sites da comunidade não expõem uma API específica, para que você usar o site do SharePoint e APIs de lista diretamente para estender a essa funcionalidade. Para obter mais informações, consulte Novo recurso Site da Comunidade.
Antes de começar a desenvolver, você deve saber onde seu código será executado, qual ambiente SharePoint será executado em e funcionalidade para a qual irá fornecer. Esses fatores ajudarão-lo a escolher o tipo de aplicativo para criar e quais API ou as APIs de usar. Consulte Escolher o conjunto de API correto nos suplementos do SharePoint e do SharePoint em comparação com as soluções do SharePoint para obter informações que possam ajudá-lo a decidir.
Configurar o ambiente de desenvolvimento
Para começar a desenvolver com recursos sociais, você precisará de:
SharePoint ou SharePoint Online
Visual Studio 2012 ou Visual Studio 2013, com Ferramentas de Desenvolvedor do Office para Visual Studio 2013 - ou mais recente
Para obter mais diretrizes, consulte Configurar um ambiente de desenvolvimento geral para o SharePoint e configurar recursos de computação social no SharePoint.
Cenários de desenvolvimento para recursos sociais no SharePoint
Cenários de desenvolvimento de alto nível para recursos sociais incluem como trabalhar com feeds sociais, acompanhar pessoas e conteúdo (documentos, sites e marcas) e como trabalhar com propriedades de usuário. Tabela 1 contém links para artigos que descrevem as APIs principais que você usa para acessar a funcionalidade para cada cenário e tarefas de programação comuns.
Os seguintes artigos descrevem as APIs principal e tarefas de programação para o cenário de desenvolvimento específico:
Instruções para programação com recursos sociais no SharePoint
Depois de configurar seu ambiente de desenvolvimento e escolha seu cenário, você pode começar Programando com recursos sociais. Tabela 1 contém links para artigos que mostram como realizar tarefas de programação básicas com recursos sociais.
Tabela 1. Artigos de instruções para desenvolver com recursos sociais
| Área de recurso | Descrição |
|---|---|
| Como ler e gravar no feed social usando o modelo de objeto cliente .NET no SharePoint | Explore as etapas detalhadas para a criação de um aplicativo que lê e grava o feed social usando o modelo de objeto do cliente .NET. |
| Como: aprender a ler e gravar no feed social usando o serviço REST no SharePoint | Explore as etapas detalhadas para a criação de um aplicativo que lê e grava o feed social usando o serviço REST. |
| Como criar e excluir postagens e recuperar o feed social usando o modelo de objeto cliente .NET no SharePoint | Saiba como criar e excluir e postagens de microblog e recuperar feeds sociais, usando o modelo de objeto do cliente .NET. |
| Como criar e excluir postagens e recuperar o feed social usando o modelo de objeto JavaScript no SharePoint | Saiba como criar e excluir e postagens de microblog e recuperar feeds sociais, usando o modelo de objeto JavaScript. |
| Como incluir menções, marcas e links para sites e documentos em postagens no SharePoint | Saiba como adicionar objetos SocialDataItem a postagens de microblog, que são processadas como menções, marcas e links nos feeds sociais. |
| Como inserir imagens, vídeos e documentos em postagens no SharePoint | Saiba como adicionar objetos SocialAttachment a postagens de microblog, que são processadas como imagens incorporadas, vídeos e documentos em feeds sociais. |
| Como seguir as pessoas usando o modelo de objeto cliente .NET no SharePoint | Saiba como trabalhar com os recursos de pessoas a seguir usando o modelo de objeto do cliente .NET. |
| Como seguir as pessoas usando o modelo de objeto JavaScript no SharePoint | Saiba como trabalhar com os recursos de pessoas a seguir usando o modelo de objeto JavaScript. |
| Como seguir os documentos e sites usando o modelo de objeto de cliente .NET no SharePoint | Saiba como trabalhar com os recursos seguintes conteúdo usando o modelo de objeto do cliente .NET. |
| Como seguir os documentos, sites, e marcas usando o serviço de REST do SharePoint | Saiba como trabalhar com os recursos seguintes conteúdo usando o serviço REST. |
| Como: recuperar propriedades de perfil de usuário usando o modelo de objeto de cliente .NET no SharePoint | Saiba como recuperar as propriedades de perfil de usuário usando o modelo de objeto do cliente .NET. |
| Como: recuperar propriedades de perfil de usuário usando o modelo de objeto JavaScript do SharePoint | Saiba como recuperar as propriedades de perfil de usuário usando o modelo de objeto do JavaScript. |
| Como: trabalhar com perfis de usuário e perfis de organização usando o modelo de objeto de servidor do SharePoint | Saiba como criar, recuperar e gerenciar perfis de usuário e propriedades usando o modelo de objeto do servidor. |
APIs para programação com recursos sociais do SharePoint
Apesar de aplicativos e soluções acessam SharePoint diferente, após acessar SharePoint você usa as APIs sociais basicamente da mesma maneira. A Tabela 2 mostra as APIs para programação com recursos de feed, seguindo e perfis de usuário no SharePoint e os caminhos para os arquivos de origem no servidor.
Tabela 2. APIs para programação com recursos sociais
| Nome da API | Origem e o caminho |
|---|---|
| Modelo de objeto do cliente .NET | Microsoft.SharePoint.Client.UserProfiles.dll em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI |
| Modelo de objeto do cliente Silverlight | Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin |
| Modelo de objeto do cliente móvel | Microsoft.SharePoint.Client.UserProfiles.Phone.dll em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\ClientBin |
| Modelo de objeto do JavaScript | SP.UserProfiles.js em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS |
| Serviço de Representational State Transfer (REST) | http://<site url>/_api/social.feedhttp://<site url>/_api/social.followinghttp://<site url>/_api/SP.UserProfiles.PeopleManager |
| Modelo de objeto do servidor | Microsoft.Office.Server.UserProfiles.dll em %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\ISAPI |
Observação
Nem todas as funcionalidades do lado do servidor no assembly Microsoft.Office.Server.UserProfiles estão disponível de APIs do cliente. Para ver quais APIs estão disponíveis, consulte o namespace Microsoft.SharePoint.Client.Social e o namespace Microsoft.SharePoint.Client.UserProfiles .
Solicitações de permissão para acessar os recursos sociais no Suplementos do SharePoint
Um Suplemento do SharePoint deve solicitar as permissões necessárias para acessar os recursos do SharePoint do usuário que instalará esse recurso. Por exemplo, um aplicativo que envia o feed deve solicitar Write permissão (no mínimo) o feed. Especifique as permissões de que seu aplicativo precisa no arquivo AppManifest.xml no Visual Studio.
Solicitações de permissão do aplicativo têm o escopo para o cenário de implantação do SharePoint. A tabela 3 mostra os nomes de escopo (com escopo correspondente URIs) e os direitos disponíveis para acessar os recursos sociais. Para obter mais informações, confira Permissões de suplemento no SharePoint, tipos de política de autorização de suplemento no SharePoint e Gerenciamento de permissões de aplicativo de plano no SharePoint.
Tabela 3. Escopos de permissão de aplicativo e direitos disponíveis para recursos sociais no SharePoint
| Nome do escopo | Descrição | Direitos disponíveis |
|---|---|---|
Perfis dos Usuárioshttp://sharepoint/social/tenant |
O escopo de solicitação de permissão usado para acessar todos os perfis de usuário. Somente a imagem de perfil pode ser alterada; todas as outras propriedades de perfil de usuário são somente leitura para suplementos do SharePoint. Deve ser instalado por um administrador de locatário. | Ler, Gravar, Gerenciar, ControleTotal |
Serviços básicoshttp://sharepoint/social/core |
O escopo de solicitação de permissão usado para o usuário de acessar conteúdo que seguem e compartilhados metadados que são usados pelos recursos de microblog. Este escopo só se aplica aos sites pessoais que oferecem suporte ao seguinte conteúdo. Se o aplicativo instala em qualquer outro tipo de site, use o escopo de locatário. | Ler, Gravar, Gerenciar, ControleTotal |
Feed de notíciashttp://sharepoint/social/microfeed |
O escopo de solicitação de permissão usado para acessar o feed do usuário ou o feed de equipe. Este escopo aplica-se para sites pessoais que oferecem suporte a microblog ou para sites de equipe, onde o recurso de Feed de Site é ativado. Se o aplicativo instala em qualquer outro tipo de site, use o escopo de locatário. | Leitura, gravação, gerenciar, controle total |
http://sharepoint/social/trimming |
Este escopo de solicitação de permissão usado para determinar se deseja exibir o conteúdo de segurança-aparada no feed social aos aplicativos. Se essa permissão de alta confiança não é concedida, algum conteúdo (por exemplo, atividades sobre documentos e sites que o aplicativo não tem permissões para) é cortado dos dados feeds que são retornados para o aplicativo, mesmo se o usuário tem permissões suficientes. Esta permissão deve ser adicionado manualmente ao arquivo de manifesto do aplicativo. | Ler, Gravar, Gerenciar, ControleTotal |
Você precisará de considerar ao solicitar permissões de aplicativo
Quando você especificar permissões de aplicativo para recursos sociais, você deve estar ciente das seguintes considerações:
Aplicativos que especificam os direitos FullControl não são permitidos para Office Store aplicativos. Apenas os direitos Read, Writee Manage são permitidos para Office Store aplicativos.
Você pode especificar permissões de feed e os recursos a seguir usando o núcleo, News Feed e escopos de locatário (
http://sharepoint/content/tenant). O escopo de locatário representa toda aluguel onde um aplicativo está instalado, incluindo os escopos de núcleo e News Feed. Portanto, se seu aplicativo já especifica os direitos que ele precisa no escopo de locatário, você não precisará solicitar permissões no escopo do núcleo ou News Feed.Durante o desenvolvimento, use o escopo de locatário, se você receber um "SocialListNotFound: lista Social não existe no seu site pessoal" ou "Arquivo não encontrado" mensagem. Se você quiser usar o escopo de núcleo ou News Feed em seu aplicativo, você pode testar as permissões abrindo o aplicativo de catálogo de aplicativos.
O escopo de núcleo se aplica aos sites pessoais que oferecem suporte ao seguinte conteúdo. O escopo de News Feed aplica-se para sites pessoais que oferecem suporte a microblog ou para sites de equipe, onde o recurso de Feed de Site é ativado. Se o aplicativo será instalado em qualquer outro tipo de site, você deverá usar o escopo de locatário. Consulte Aluguéis são e escopos de implantação para o SharePoint Add-ins.
Aplicativos que solicitar direitos para o escopo de perfis de usuário devem ser instalados por um administrador de locatário, e eles não podem ser instalados na versão do Office 365 Small Business Premium do SharePoint Online.
Se os requisitos de ativação de licenciamento ou recurso para os recursos de microblog e social não forem atendidos, os usuários obtém uma mensagem informando que não é possível instalar o aplicativo.
Os aplicativos que são iniciados fora do SharePoint podem solicitar permissão em tempo real (exceto Controle Total). Para saber mais, consulte Fluxo OAuth do código de autorização para suplementos do SharePoint.
Confira também
Artigos conceituais
Documentação de referência