Seguir conteúdo no SharePoint

Saiba mais sobre tarefas de programação comuns para seguir conteúdos (documentos, sites e etiquetas) no SharePoint.

APIs para seguir conteúdos no SharePoint

Quando os usuários seguem documentos, sites ou marcas, atualizações de status de documentos, conversas em sites e notificações da marca usam Mostrar em seu newsfeed. Os recursos relacionados ao conteúdo a seguir podem ser vistos no news feed e as páginas de conteúdo a seguir.

O SharePoint fornece as seguintes APIs que pode utilizar para seguir conteúdos através de programação:

  • Modelos de objeto do cliente para código gerenciado

    • Modelo de objeto do cliente .NET

    • Modelo de objeto do cliente Silverlight

    • Modelo de objeto do cliente móvel

  • Modelo de objeto do JavaScript

  • Serviço de Representational State Transfer (REST)

  • Modelo de objeto de servidor

Como prática recomendada no desenvolvimento do SharePoint, use APIs do cliente, sempre que possível. APIs do cliente incluem modelos de objeto do cliente, um modelo de objeto JavaScript e um serviço REST. Para obter mais informações sobre as APIs no SharePoint e quando utilizá-las, consulte Escolher o conjunto de API correto no SharePoint.

Cada API inclui um objeto Gerenciador de que você usa para executar tarefas de núcleo de conteúdo a seguir.

Observação

[!OBSERVAçãO] As APIs do mesmas são usadas para seguir pessoas. Consulte Seguir pessoas no SharePoint para obter uma descrição geral das tarefas Seguir Pessoas.

A tabela 1 mostra o gerente e outros objetos de chave (ou recursos REST) nas APIs e a biblioteca de classes (ou ponto de acesso) onde você pode encontrá-los.

Observação

[!OBSERVAçãO] Modelos de objeto do cliente móvel e do Silverlight não são incluídos na tabela 1 ou tabela 2 porque eles fornecem a mesma funcionalidade de núcleo como o modelo de objeto do cliente .NET e usam as mesmas assinaturas. Modelo de objeto do cliente do Silverlight é definido em Microsoft.SharePoint.Client.UserProfiles.Silverlight.dll e o modelo de objeto do cliente móvel é definido em Microsoft.SharePoint.Client.UserProfiles.Phone.dll.

Tabela 1. APIs do SharePoint utilizadas para seguir conteúdos programaticamente

API Objetos de chave
Modelo de objeto do cliente .NET
Veja: How to: Follow documents and sites by using the .NET client object model in SharePoint (Como: Seguir documentos e sites com o modelo de objeto de cliente .NET no SharePoint)
Objeto de gestor: SocialFollowingManager
Espaço de nomes principal: Microsoft.SharePoint.Client.Social
Outros objetos-chave: SocialActor , SocialActorInfo , SocialActorType , SocialActorTypes
Biblioteca de classes: Microsoft.SharePoint.Client.UserProfiles.dll
Modelo de objeto do JavaScript Objeto de gestor: SocialFollowingManager
Espaço de nomes principal: SP. Social
Outros objetos-chave: SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Biblioteca de classes: SP.UserProfiles.js
Serviço REST
Veja Como: Seguir documentos, sites e etiquetas com o serviço REST no SharePoint
Recurso do gestor: social.following
Espaço de nomes principal (OData): sp.social.SocialRestFollowingManager
Outros recursos principais: SocialActor, SocialActorInfo, SocialActorType, SocialActorTypes
Ponto de acesso: <siteUri>/_api/social.following
Modelo de objeto do servidor Objeto de gestor: SPSocialFollowingManager
Espaço de nomes principal: Microsoft.Office.Server.Social
Outros objetos-chave: SPSocialActor , SPSocialActorInfo , SPSocialActorType , SPSocialActorTypes
Biblioteca de classes: Microsoft.Office.Server.UserProfiles.dll

Tarefas de programação comuns para seguir conteúdos no SharePoint

A Tabela 2 mostra tarefas de programação comuns para seguir conteúdos e os membros que utiliza para as executar. Membros são provenientes do modelo de objeto do cliente .NET (CSOM), o modelo de objeto de JavaScript (JSOM), serviço REST e modelo de objeto do servidor (SSOM).

Observação

[!OBSERVAçãO] As APIs do mesmas são usadas para seguir pessoas. Consulte Seguir pessoas no SharePoint para obter uma descrição geral das tarefas Seguir Pessoas.

Tabela 2. API para tarefas comuns para seguir conteúdos no SharePoint

Tarefa Members
Criar uma instância de um objeto do Gerenciador no contexto do usuário atual CSOM: SocialFollowingManager
JSOM: SocialFollowingManager
REST: <siteUri>/_api/social.following
SSOM: SPSocialFollowingManager
Criar uma instância de um objeto de gestor no contexto de um utilizador especificado CSOM: não foi implementado
JSOM: não foi implementado
REST: não implementado
SSOM: SPSocialFollowingManager (sobrecarregado)
Peça ao utilizador atual para começar a seguir (pare de seguir) um item CSOM: Follow ( StopFollowing )
JSOM: follow ( stopFollowing)
REST: POST<siteUri>/_api/social.following/Follow ( <siteUri>/_api/social.following/StopFollowing) e transmita o parâmetro actor no corpo do pedido
SSOM: Follow ( StopFollowing )
Saiba se o utilizador atual está a seguir um item específico CSOM: IsFollowed
JSOM: isFollowed
REST: POST<siteUri>/_api/social.following/IsFollowed e transmita o parâmetro do ator no corpo do pedido
SSOM: IsFollowed
Obter os documentos, sites e/ou etiquetas que o utilizador atual está a seguir CSOM: GetFollowed
JSOM: getFollowed
REST: GET<siteUri>/_api/social.following/my/Followed(types=2) (documentos = 2, sites = 4, etiquetas = 8.md)
SSOM: GetFollowed
Obter a contagem de documentos, sites e/ou etiquetas que o utilizador está a seguir CSOM: GetFollowedCount
JSOM: getFollowedCount
REST: GET<siteUri>/_api/social.following/my/FollowedCount(types=2) (documentos = 2, sites = 4, etiquetas = 8.md)
SSOM: GetFollowedCount
Obter o URI do site que lista os documentos seguidos do utilizador atual CSOM: FollowedDocumentsUri
JSOM: followedDocumentsUri
REST: OBTER<siteUri>/_api/social.following/my/FollowedDocumentsUri
SSOM: FollowedDocumentsUri
Obter o URI do site que lista os sites seguidos do utilizador atual CSOM: FollowedSitesUri
JSOM: followedSitesUri
REST: OBTER<siteUri>/_api/social.following/my/FollowedSitesUri
SSOM: FollowedSitesUri

Observação

Para obter exemplos que mostram como utilizar o serviço REST para seguir conteúdos, consulte Como: Seguir documentos, sites e etiquetas com o serviço REST no SharePoint.

Como obter o GUID de uma etiqueta com base no nome da etiqueta com o modelo de objeto JavaScript

Para começar e parar de seguir uma etiqueta ou para saber se o utilizador atual está a segui-la, tem de utilizar o GUID da etiqueta. O código seguinte mostra como obter o GUID com base no nome da etiqueta.

Antes de executar o código, tem de adicionar uma referência a sp.taxonomy.js e alterar o nome da etiqueta de marcador de posição com o nome de uma etiqueta existente.


function getTagGuid() {
    var tagName = '#tally';
    var clientContext = new SP.ClientContext.get_current();
    var label = SP.Taxonomy.LabelMatchInformation.newObject(clientContext);
    label.set_termLabel(tagName);
    label.set_trimUnavailable(false);
    var taxSession = SP.Taxonomy.TaxonomySession.getTaxonomySession(clientContext);
    var termStore = taxSession.getDefaultKeywordsTermStore();
    var termSet = termStore.get_hashTagsTermSet();
    terms = termSet.getTerms(label);
    clientContext.load(terms);
    clientContext.executeQueryAsync(
        function () {
            var tag = terms.get_item(0);
            if (tag !== null) {
                var tagGuid = tag.get_id().toString();
                if (!SP.ScriptUtility.isNullOrEmptyString(tagGuid)) {
                    alert(tagGuid);
                }
            }
        },
        function (sender, args) {
            alert(args.get_message());
        }
    );
}

Confira também