Introdução aos feeds de atividades
Publicado: janeiro de 2017
Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Como desenvolvedor que implementa cenários de colaboração com feeds de atividades, você deve se familiarizar com a terminologia, definições e modelo de entidade dos feeds de atividades.
Neste tópico
Conceitos de feeds de atividades
Entidades dos feeds de atividades
Menções
Como exibir dados no mural de registro ou no mural pessoal
Conceitos de feeds de atividades
A tabela a seguir contém definições dos feeds de atividades.
Termo |
Descrição |
|---|---|
Mural |
Um local no Microsoft Dynamics 365, onde os feeds de atividades são exibidos como atualizações breves. |
Mural de Registros |
Um local no Microsoft Dynamics 365, onde os feeds de atividades de um registro, como uma conta ou um cliente potencial, são exibidos. No aplicativo Web do Microsoft Dynamics 365, o mural de registro é mostrado como Novidades do registro. O mural de registro contém as postagens referentes ao registro que mencionam o registro. Se um registro for o usuário do sistema (usuário), o mural também contém as postagens que são criadas pelo usuário. |
Mural pessoal |
Um mural pessoal de um usuário. No aplicativo Web do Microsoft Dynamics 365, ele é o mural Novidades do usuário. O mural contém as postagens sobre os registros que o usuário está acompanhando, as postagens referentes ao usuário ou que mencionam o usuário. |
Postagem Automática |
Uma postagem gerada pelo Microsoft Dynamics 365, com a aplicação de uma regra de postagem automática no caso de um evento, como a criação de uma conta ou o fechamento de uma oportunidade ganha. Uma postagem automática pode ser mostrada em um mural de registro ou um mural pessoal. O texto da postagem automática é localizado. Observação Ao criar uma nova oportunidade, uma postagem automática será gerada se um dos seguintes atributos for especificado: CustomerId, ParentAccountId ou ParentContactId. |
Postagem manual (Postagem do usuário) |
Uma postagem criada por um usuário do Microsoft Dynamics 365. Uma postagem manual pode ser mostrada em um mural de registro ou um mural pessoal. |
Regra de Postagem automática |
Uma regra usada pelo Microsoft Dynamics 365 para gerar uma postagem automática durante a ocorrência de um evento. Por exemplo, uma regra pode especificar a geração de uma postagem automática quando uma oportunidade é criada para uma conta. |
Menção |
Uma parte de uma postagem que se refira a um registro do Microsoft Dynamics 365. Uma postagem pode ter várias menções. |
Comentário |
Uma observação adicionada a uma postagem. Um comentário está relacionado a uma postagem principal. Ele não pode existir sem uma postagem principal. Se uma postagem principal for excluída, os comentários da postagem também serão excluídos. |
Seguir |
Uma ação executada por um usuário em um registro do Microsoft Dynamics 365, que permite a esse usuário ver as postagens sobre o registro em seu mural pessoal. Observação Para Dynamics 365 (local), o número de registros máximo é 5000. O número de registros padrão do usuário é 1000. O valor padrão é configurado e pode ser alterado pelo administrador ou por um usuário com as permissões para alterar as configurações de implantação. |
Parar de seguir |
Uma ação executada por um usuário em um registro do Microsoft Dynamics 365, que interrompe a exibição das postagens sobre esse registro no mural pessoal de um usuário. |
Como |
Uma ação executada por um usuário em uma postagem, que expressa que o usuário gostou da postagem. Observação |
Gostar (desfazer) |
Uma ação executada por um usuário para remover a ação Gostar da postagem. Observação |
Thread ou conversa |
Um conjunto de postagens e todos os comentários relacionados. |
Exibir |
Uma exibição de registros da entidade com base em uma consulta. |
Observação
Postagens manuais e automáticas que são criadas de forma programática podem conter até 2.000 caracteres. As postagens criadas no aplicativo Web do Microsoft Dynamics 365 podem conter até 1.000 caracteres. Os comentários que são criados de forma programática podem conter até 1.000 caracteres, mas os comentários criados no aplicativo Web são limitados a 500 caracteres.
Entidades dos feeds de atividades
A tabela a seguir contém informações sobre as entidades dos feeds de atividades.
Entidade |
Descrição |
|---|---|
Post |
Representa uma postagem automática ou postagem manual (usuário). |
PostComment |
Representa um comentário sobre uma postagem do feed de atividades. |
PostFollow |
Representa o acompanhamento de uma postagem que indica que um usuário acompanha um registro. Excluir o registro de PostFollow é uma ação de “deixar de acompanhar”. |
PostLike |
Representa que o usuário gostou da postagem. Excluir o registro de PostLike é uma ação de “gostar (desfazer)”. |
msdyn_PostConfig |
Contém a configuração dos feeds de atividades de uma entidade e é usada para habilitar ou desabilitar uma entidade dos feeds de atividades. |
msdyn_PostRuleConfig |
Contém a configuração de regra do feed de atividades de uma entidade e é usada para habilitar ou desabilitar uma regra de postagem automática de uma entidade. |
msdyn_PostAlbum |
Contém imagens de perfil de usuário que são armazenadas como anexos e exibidas em postagens. |
Gostar/Gostar (desfazer)
Com a ação Gostar/Gostar (desfazer), é possível expressar uma opinião imediata sobre uma postagem. Isso torna a comunicação mais personalizável e interativa. Use a ação Gostar/Gostar (desfazer) para trocar elogios com seus colegas, elogiar o trabalho dos seus subordinados e avaliar a popularidade das postagens. Uma ação executada pelos usuários do Microsoft Dynamics 365 que indicam gostar de uma postagem específica é chamada Gostar. Uma ação executada por um usuário do Microsoft Dynamics 365 para desfazer a ação “Gostar” em uma postagem é chamada Gostar (desfazer). É possível adicionar uma ação “Gostar” à postagem; no entanto, uma postagem pode ser “gostada” por vários usuários. Para adicionar uma ação “Gostar” a uma postagem, crie o registro PostLike e associe-o ao registro principal do Post. Para remover a ação “Gostar” da postagem, exclua o registro PostLike.
Menções
Durante as discussões de um grupo, frequentemente é necessário fazer referência a uma pessoa específica (um usuário do Microsoft Dynamics 365) ou a um registro, como uma conta, e compartilhar essas informações com outros usuários. Em Microsoft Dynamics 365 Feeds de Atividades, essa ação é chamada de "menção". As postagens que mencionam um usuário podem ser visualizadas no mural de registro de usuário e no mural pessoal do usuário ("Novidades" em Microsoft Dynamics 365). As postagens que mencionam um registro são exibidas no mural de registro.
Para adicionar uma menção a uma postagem, use uma expressão no seguinte formato no atributo Post.Text:
@[Entity,ID,"Display String"].
Observação
Não há espaço depois das vírgulas nesta expressão.
A tabela a seguir descreve os parâmetros da expressão:
Parâmetro |
Descrição |
|---|---|
Entity |
O nome lógico da entidade ou um código do tipo da entidade do registro que é mencionado na postagem. |
ID |
O ID do registro que é mencionado na postagem. |
Display String |
O texto que você deseja exibir na menção, como o nome do registro. |
Os códigos do tipo da entidade de todas as entidades padrão (não personalizadas) são predefinidos. Para obter mais informações, consulte Entidades de serviço de organização.Para exibir os metadados de entidade da sua organização, instale a solução Navegador dos Metadados descrita em Procurar os metadados da sua organização. Também é possível exibir os metadados de uma organização não personalizada no arquivo do Excel chamado EntityMetadata.xlsx, incluído na pasta de nível superior do download do SDK.
É possível especificar várias menções neste atributo. Para recuperar os dados contidos na menção, analise a cadeia de caracteres no atributo Text para pesquisar pelos caracteres “@[“ que separam as menções de outras menções ou texto.
Para obter informações adicionais sobre menções de postagem, consulte Postagem de blog: Como fazer menções com Feeds de Atividades.
Como exibir dados no mural de registro ou no mural pessoal
Para recuperar postagens para a exibição em um mural de registro ou um mural pessoal, é possível usar a mensagem RetrieveRequest ou a mensagem RetrieveMultipleRequest. Entretanto, para recuperar várias páginas de postagens com comentários e ações de gostar associados em uma única chamada, é possível usar mensagens especiais de feeds de atividades.
Para recuperar várias páginas de postagens com comentários e ações de gostar associados, use a mensagem RetrieveRecordWallRequest. Para recuperar várias páginas de postagens com comentários e ações de gostar associados para um mural pessoal, use a mensagem RetrievePersonalWallRequest.
As seguintes postagens com comentários são exibidas no Mural de Registro:
Postagens que se refiram a um registro. O ID do registro é especificado no atributo Post.RegardingObjectId.
Postagens que mencionem um registro. O ID do registro é especificado no atributo Post.Text.
Para o registro de um usuário do sistema (usuário), o mural também inclui as postagens criadas pelo usuário. O atributo Post.RegardingObjectId contém o ID atual do usuário.
As seguintes postagens com comentários são exibidas no Mural Pessoal (Usuário) (Novidades do Microsoft Dynamics 365):
Postagens que se refiram a você. O atributo Post.RegardingObjectId contém a seu ID de usuário.
Postagens que mencionem você. Seu ID de usuário é especificado no atributo Post.Text.
Postagens que se refiram a um registro ou que mencionem um registro que você acompanha.
Observação
Somente é possível acompanhar os registros aos quais você tenha privilégios e direitos de acesso. Se você perder permissões de leitura, um acompanhamento é automaticamente removido. Todos os usuários do Microsoft Dynamics 365 automaticamente acompanham a si mesmos. É possível ver somente as postagens que se referem aos registros ou que mencionam os registros aos quais você tem privilégios e direitos de acesso.
Se você criar o registro PostFollow para a conta A e definir o OwnerId em PostFollow para o usuário B, o usuário B acompanhará a conta A.
Para obter mais informações sobre segurança baseada em função e em registro, consulte O modelo de segurança do Microsoft Dynamics 365.
Confira Também
RetrieveRecordWallRequest
RetrievePersonalWallRequest
Entidades dos feeds de atividades
Configurar feeds de atividades
Conectar ao Yammer
Exemplo: Colabore com os feeds de atividades
Postagem do blog: Trabalhando com Feed de Atividades usando o SDK do Microsoft CRM
Postagem do blog: Como fazer menções com Feeds de Atividades
Postagem do blog: Exibindo a imagem doFacebook de um contato Microsoft Dynamics CRM de 2011
Postagem do blog: Gerenciamento de dados para entidades de Feeds de Atividades
Postagem do blog: Como adicionar um mural de registro a um formulário
Postagem de blog: Solução e ambiente de desenvolvimento de Feeds de Atividades
Microsoft Dynamics 365
© 2017 Microsoft. Todos os direitos reservados. Direitos autorais