Introducción a las fuentes de actividades en Dynamics 365 Customer Engagement

Como programador que implementa escenarios de colaboración con fuentes de actividades, debería familiarizarse con la terminología de fuentes de actividades, las definiciones y el modelo de entidad.

Conceptos de fuentes de actividades

La siguiente tabla contiene definiciones de fuentes de actividades.

Término	Descripción
Muro	Un lugar de Dynamics 365 Customer Engagement (on-premises) donde se muestran fuentes de actividades como actualizaciones breves.
Muro de registros	Lugar de Dynamics 365 Customer Engagement (on-premises) en el que se muestran las fuentes de actividades de un registro, por ejemplo, una cuenta o un cliente potencial. En la aplicación web Dynamics 365 Customer Engagement (on-premises), el muro de registros se muestra como Novedades del registro. El muro de registros contiene publicaciones relacionadas con el registro o que mencionan el registro. Si un registro es el usuario del sistema (usuario), el muro también contiene las publicaciones creadas por el usuario.
Muro personal	Muro personal de un usuario. En la aplicación web Dynamics 365 Customer Engagement (on-premises), es el muro de Novedades del usuario. Este muro contiene las publicaciones sobre los registros que el usuario está siguiendo, las publicaciones que están relacionadas con el usuario o que mencionan al usuario.
Publicación automática	Publicación generada por Dynamics 365 Customer Engagement (on-premises) mediante la aplicación de una regla de publicación automática en caso de que se produzca un evento, como la creación de una cuenta o el cierre de una oportunidad lograda. Una publicación automática se puede mostrar en un muro de registros o en el muro personal. El texto de publicación automática se localiza. Nota: al crear una nueva oportunidad, se genera una publicación automática si se especifica uno de los siguientes atributos: CustomerId, ParentAccountId o ParentContactId.
Publicación manual (publicación del usuario)	Una publicación creada por un usuario de Dynamics 365 Customer Engagement (on-premises). Una publicación manual se puede mostrar en un muro de registros o en el muro personal.
Regla de publicación automática	Regla utilizada por Dynamics 365 Customer Engagement (on-premises) para generar una publicación automática cuando aparezca un evento. Por ejemplo, se puede especificar una regla puede para generar una publicación automática cuando se crea una nueva oportunidad para una cuenta.
Mención	Parte de una publicación que hace referencia a un registro de Dynamics 365 Customer Engagement (on-premises). Una publicación puede tener varias menciones.
Comentario	Comentario agregado a una publicación. Los comentarios se relacionan con una publicación primaria. No puede existir sin una publicación primaria. Si se elimina una publicación primaria, los comentarios de la publicación también se eliminan.
Seguir	Las acciones realizadas por un usuario en un registro de aplicaciones Dynamics 365 Customer Engagement (on-premises) que permite al usuario ver las publicaciones sobre el registro en su muro personal. Nota: para Dynamics 365 for Customer Engagement (on-premises), el número máximo de registros que se pueden seguir es 5000. El número predeterminado de registros que el usuario puede seguir es 1000. El valor predeterminado es configurable y puede cambiarlo el administrador o un usuario con los permisos para modificar los valores de la implementación.
Dejar de seguir	Acciones realizadas por un usuario en un registro de Dynamics 365 Customer Engagement (on-premises) que detienen la visualización de las publicaciones sobre ese registro en el muro personal del usuario.
Me gusta	Acciones realizadas por un usuario en una publicación que expresa que al usuario le gustó la publicación. Nota:
Ya no me gusta	Acción realizadas por un usuario para eliminar que le ha gustado la publicación. Nota:
Hilo o conversación	Recopilación de publicaciones y de todos los comentarios relacionados.
Ver	Vista de registros de la entidad basados en una consulta.

Nota

Las publicaciones manuales y automáticas que se crean mediante programación pueden tener hasta 2.000 caracteres. Las publicaciones creadas en la aplicación web Dynamics 365 Customer Engagement (on-premises) pueden tener hasta 1.000 caracteres. Los comentarios que se crean mediante programación pueden tener hasta 1.000 caracteres, pero los comentarios creados en la aplicación web están limitados a 500 caracteres.

Entidades de fuentes de actividades

La tabla siguiente contiene información sobre las entidades de fuentes de actividades.

Entidad	Descripción
Post	Representa publicaciones automáticas o una publicación manual (usuario).
PostComment	Representa un comentario en una publicación de fuente de actividades.
PostFollow	Representa un seguimiento de publicación que indica que un usuario sigue un registro. La eliminación del registro PostFollow es una acción de "dejar de seguir".
PostLike	Representa que al usuario le gustó la publicación. La eliminación del registro PostLike es una acción de "ya no me gusta".
msdyn_PostConfig	Contiene la configuración de la fuente de actividades para una entidad y se usa para habilitar o deshabilitar una entidad para fuentes de actividades.
msdyn_PostRuleConfig	Contiene la configuración de la regla de fuentes de actividades para una entidad y se usa para habilitar o deshabilitar una regla de publicación automática para una entidad.
msdyn_PostAlbum	Contiene imágenes del perfil del usuario que están almacenadas como archivos adjuntos y aparecen en entradas.

Me gusta/ya no me gusta

Con me gusta/ya no me gusta, puede expresar una opinión inmediata sobre una publicación. Esto permite que su comunicación resulte más personal e interactiva. Utilice Me gusta/Ya no me gusta para intercambiar kudos con sus compañeros de trabajo, para elogiar el trabajo de sus subordinados y evaluar la popularidad de las publicaciones. La acción llevada a cabo por los usuarios de Dynamics 365 Customer Engagement (on-premises) que muestran que les gusta una publicación en particular se denomina Me gusta. La acción realizadas por un usuario de Dynamics 365 Customer Engagement (on-premises) para deshacer el "Me gusta" de una publicación recibe el nombre de Ya no me gusta. Puede agregar un "Me gusta" a la publicación; sin embargo, es posible que una publicación "guste" a varios usuarios. Para agregar un "Me gusta" a una publicación, cree el registro de PostLike y asócielo con el registro de Post primario. Para eliminar el "Me gusta" de la publicación, elimine el registro de PostLike.

Menciones

Durante discusiones en un grupo, a menudo necesita hacer referencia a una persona específica (un usuario de Dynamics 365 Customer Engagement (on-premises)), o a un registro, como una cuenta, y compartir esta información con otros usuarios. En las fuentes de actividades de Dynamics 365 Customer Engagement (on-premises), esta acción se denomina "mención." Las publicaciones que mencionan un usuario pueden mostrarse en el muro de registros del usuario y el muro personal del usuario ("Novedades" en aplicaciones Dynamics 365 Customer Engagement (on-premises)). Las publicaciones que mencionan un registro se muestran en el muro del registro.

Para agregar una mención a una publicación, use una expresión en el siguiente formato en el atributo de Post.Text:

@[Entity,ID,"Display String"].

Nota

No hay espacios después de comas en esta expresión.

En la siguiente tabla se describen los parámetros de la expresión:

Parámetro	Descripción
Entity	Nombre lógico de una entidad o el código de tipo de entidad para el registro que se menciona en la publicación.
ID	El identificador del registro que se menciona en la publicación.
Display String	El texto que desea que aparezcan en la mención, como el nombre de un registro.

Los códigos de tipo de entidad de todas las entidades predeterminadas (no personalizadas) están predefinidos. Para obtener más información, consulte Entidades IOrganizationService. Para ver los metadatos de las entidades de su organización, instale la solución Explorador de metadatos que se describe en Exploración de los metadatos de su organización. También puede examinar la documentación de referencia para las entidades en la Referencia de entidad.

Puede especificar varias menciones en este atributo. Para recuperar los datos contenidos en la mención, analice la cadena del atributo de Text para buscar caracteres “@[“ que separan menciones de otras menciones o texto.

Para obtener más información sobre menciones de publicaciones, consulte Publicación de blog: Cómo hacer menciones con fuentes de actividades.

Visualización de datos en el muro de registros o el muro personal

Para recuperar las publicaciones para mostrar en un muro de registros o un muro personal, puede usar el mensaje de RetrieveRequest o el mensaje de RetrieveMultipleRequest. Sin embargo, para recuperar las páginas de publicaciones con comentarios y "me gusta" asociados en una sola llamada, puede usar mensajes especiales de fuentes de actividades.

Para recuperar páginas de publicaciones con comentarios asociados y "me gusta" de un muro de registros, use el mensaje de RetrieveRecordWallRequest. Para recuperar páginas de publicaciones con comentarios asociados y "me gusta" de un muro personal, use el mensaje de RetrievePersonalWallRequest.

Las siguientes publicaciones con comentarios se muestran en el muro de registros:

• Publicaciones relacionadas con un registro. El identificador de registro se especifica en el atributo Post.RegardingObjectId.

• Publicaciones que mencionan un registro. El identificador de registro se especifica en el atributo Post.Text.

• En un registro de usuario del sistema (usuario), el muro también incluye las publicaciones creadas por el usuario. El atributo de Post.RegardingObjectId contiene el identificador de usuario actual.

  Las siguientes publicaciones con comentarios se muestran en su muro personal (usuario) (Novedades en Dynamics 365 Customer Engagement (on-premises)):

• Publicaciones relacionadas con usted. El atributo de Post.RegardingObjectId contiene su identificador de usuario.

• Publicaciones que le mencionan a usted. Su identificador de usuario se especifica en el atributo de Post.Text.

• Publicaciones sobre un registro o que mencionan un registro que sigue.

Nota

Solamente puede seguir los registros en los que tenga privilegios de lectura y derechos de acceso. Si pierde permisos de lectura, se eliminará un seguimiento automáticamente. Todos los usuarios de Dynamics 365 Customer Engagement (on-premises) se siguen a sí mismos automáticamente. Solamente puede ver las publicaciones relacionadas con los registros o que mencionan los registros en los que tiene privilegios de lectura y derechos de acceso.

Si crea el registro PostFollow para la cuenta A y establece el atributo OwnerId en el PostFollow en el usuario B, este seguirá la cuenta. A.

Para obtener más información acerca de la seguridad basada en roles y en registros, consulte El modelo de seguridad de Dynamics 365 Customer Engagement (on-premises).

Vea también

Entidades de Fuentes de actividades
RetrieveRecordWallRequest
RetrievePersonalWallRequest
Configuración de Fuentes de actividades
Conectarse a Yammer
Ejemplo: Colaborar con fuentes de actividades
Entrada de blog: Trabajar con Fuentes de actividades usando el SDK de Microsoft CRM
Entrada de blog: Cómo hacer menciones con Fuentes de actividades
Entrada de blog: Mostrar la imagen de Facebook de un contacto en Microsoft Dynamics CRM 2011
Entrada de blog: Administración de datos para entidades de Fuentes de actividades
Entrada de blog: Cómo agregar un muro de registros a un formulario
Entrada de blog: Solución de fuentes de actividades y entorno de desarrollo