Présentation des flux d’activité

En tant que développeur mettant en œuvre des scénarios de collaboration avec des flux d’activité, vous devez vous familiariser avec la terminologie, les définitions et le modèle d’entité des flux d’activité.

Concepts de flux d’activités

Le tableau suivant contient les définitions des flux d’activité.

Terme	Descriptif
Mur	Emplacement dans Dynamics 365 Customer Engagement (local) où les flux d’activité sont affichés sous forme de courtes mises à jour.
Mur d’enregistrements	Emplacement dans Dynamics 365 Customer Engagement (sur site) où les flux d'activités d’un enregistrement, tel qu’un compte ou un prospect, sont affichés. Dans l’application Web Dynamics 365 Customer Engagement (on-premises), le mur d’enregistrements s’affiche comme Quoi de neuf pour l’enregistrement. Le mur d’enregistrement contient des messages qui concernent l’enregistrement ou qui mentionnent l’enregistrement. Si un enregistrement est l’utilisateur système (utilisateur), le mur contient également les publications créées par l’utilisateur.
Mur personnel	Un mur qui est personnel à un utilisateur. Dans l’application Web Dynamics 365 Customer Engagement (on-premises), c'est le mur "Quoi de neuf" de l'utilisateur. Ce mur contient les messages sur les enregistrements que l’utilisateur suit, les messages qui concernent l’utilisateur ou qui mentionnent l’utilisateur.
Publication automatique	Une publication générée par Dynamics 365 Customer Engagement (sur site) en appliquant une règle de publication automatique en cas d’événement, tel que la création d’un compte ou la clôture d’une opportunité gagnée. Une publication automatique peut être affichée sur un mur d’enregistrement ou un mur personnel. Le texte de la publication automatique est localisé. Note: Lors de la création d’une opportunité, une publication automatique est générée si l’un des attributs suivants est spécifié : CustomerIdou ParentAccountIdParentContactId.
Publication automatique (publication utilisateur)	Une publication créée par un utilisateur de Dynamics 365 Customer Engagement (local). Une publication manuelle peut être affichée sur un mur d’enregistrement ou un mur personnel.
Règle de publication automatique	Règle utilisée par Dynamics 365 Customer Engagement (local) pour générer une publication automatique lorsqu’un événement se produit. Par exemple, une règle peut spécifier de générer une publication automatique lorsqu’une nouvelle opportunité est créée pour un compte.
Mentionner	Une partie d'une publication qui fait référence à un enregistrement Dynamics 365 Customer Engagement (sur site). Un message peut avoir plusieurs mentions.
Commentaire	Une remarque qui est ajoutée sur un post. Un commentaire est lié à une publication parente. Il ne peut exister sans un poste parent. Si un message parent est supprimé, les commentaires du message sont également supprimés.
Suivre	Action effectuée par un utilisateur sur un enregistrement Dynamics 365 Customer Engagement (local) qui permet à cet utilisateur de voir les publications relatives à l’enregistrement sur son mur personnel. Note: Pour Dynamics 365 for Customer Engagement (on-premises), le nombre maximal autorisé d’enregistrements à suivre est de 5000. Le nombre d’enregistrements par défaut que l’utilisateur peut suivre est de 1000. La valeur par défaut est configurable et peut être modifiée par un administrateur ou un utilisateur autorisé à modifier les paramètres de déploiement.
Ne plus suivre	Action effectuée par un utilisateur sur un enregistrement Dynamics 365 Customer Engagement (local) qui empêche l’affichage des publications concernant cet enregistrement sur le mur personnel de l’utilisateur.
Comme	Action effectuée par un utilisateur sur une publication qui indique que l’utilisateur a aimé la publication. Remarque :
Je n’aime plus	Action entreprise par un utilisateur pour supprimer le J’aime de la publication. Remarque :
Fil de discussion ou conversation	Une collection de messages et de tous les commentaires associés.
Afficher	Vue des enregistrements d'entités basée sur une requête.

Remarque

Les publications manuelles et automatiques créées par programmation peuvent comporter jusqu’à 2000 caractères. Les publications créées dans l’application Web Dynamics 365 Customer Engagement (on-premises) peuvent comporter jusqu’à 1000 caractères. Les commentaires créés par programme peuvent comporter jusqu’à 1000 caractères, mais les commentaires créés dans l’application Web sont limités à 500 caractères.

Entités de flux d’activités

Le tableau suivant contient des informations sur les entités de flux d’activités.

Entité	Descriptif
Post	Représente une publication automatique ou une publication manuelle (utilisateur).
PostComment	Représente un commentaire sur une publication de flux d’activités.
PostFollow	Représente un suivi de publication qui indique qu’un utilisateur suit un enregistrement. La suppression de l’enregistrement PostFollow est une action de « désabonnement ».
PostLike	Indique que l’utilisateur a aimé la publication. La suppression de l’enregistrement PostLike est une action qui annule la mention J’aime.
msdyn_PostConfig	Contient la configuration du flux d’activité pour une entité et est utilisé pour activer ou désactiver une entité pour les flux d’activité.
msdyn_PostRuleConfig	Contient la configuration de la règle de flux d’activité pour une entité et est utilisé pour activer ou désactiver une règle de publication automatique pour une entité.
msdyn_PostAlbum	Contient des images de profil utilisateur qui sont stockées en tant que pièces jointes et affichées dans les publications.

J’aime/Je n’aime pas

Avec J’aime/Je n’aime pas, vous pouvez exprimer un avis immédiat sur une publication. Cela rend votre communication plus personnelle et interactive. Utilisez J'aime/Je n'aime pas pour échanger des kudos avec vos collègues, féliciter le travail de vos subordonnés et évaluer la popularité des publications. Une action effectuée par les utilisateurs de Dynamics 365 Customer Engagement (on-premises) montrant qu’ils aiment une publication particulière est appelée J’aime. Une action effectuée par un utilisateur de Dynamics 365 Customer Engagement (local) pour annuler le « J’aime » sur une publication est appelée « Je n’aime pas ». Vous pouvez ajouter un « J’aime » à la publication ; Cependant, un message peut être « aimé » par plusieurs utilisateurs. Pour ajouter un « J’aime » à une publication, créez l’enregistrement PostLike et associez-le à l’enregistrement parent Post . Pour supprimer la mention « J’aime » de la publication, supprimez l’enregistrement PostLike.

Mentions

Au cours des discussions au sein d’un groupe, vous devez souvent faire référence à une personne spécifique (un utilisateur Dynamics 365 Customer Engagement (on-premises)) ou à un enregistrement, tel qu’un compte, et partager ces informations avec d’autres personnes. Dans les flux d’activité Dynamics 365 Customer Engagement (on-premises), cette action est appelée « mention ». Les messages qui mentionnent un utilisateur peuvent être affichés sur le mur d’enregistrements de l’utilisateur et sur le mur personnel de l’utilisateur (« Nouveautés » dans Dynamics 365 Customer Engagement (on-premises)) applications. Les messages qui mentionnent un enregistrement sont affichés sur le mur de l'enregistrement.

Pour ajouter une mention à un article, utilisez une expression au format suivant dans l’attribut Post.Text :

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

Remarque

Il n’y a pas d’espace après les virgules dans cette expression.

Le tableau suivant décrit les paramètres de l’expression :

Paramètre	Descriptif
Entity	Nom logique d’entité ou code de type d’entité pour l’enregistrement mentionné dans l’article.
ID	L’ID de l’enregistrement mentionné dans le message.
Display String	Le texte que vous souhaitez afficher dans la mention, tel que le nom d’un enregistrement.

Les codes de type d’entité pour toutes les entités par défaut (non personnalisées) sont prédéfinis. Pour plus d’informations, consultez Entités IOrganizationService. Pour afficher les métadonnées d’entité pour votre organisation, installez la solution Navigateur de métadonnées décrite dans l’article Accès aux métadonnées de votre organisation. Vous pouvez également accéder à la documentation de référence pour les entités dans Référence d’entité.

Vous pouvez spécifier plusieurs mentions dans cet attribut. Pour récupérer les données contenues dans la mention, analysez la chaîne dans l’attribut Text pour rechercher les caractères « @[ » qui séparent les mentions des autres mentions ou textes.

Pour plus d’informations sur les mentions de publication, consultez Billet de blog : Comment faire des mentions avec des flux d’activité.

Affichage des données sur le mur d’enregistrement ou le mur personnel

Pour récupérer des messages à afficher sur un mur d’enregistrement ou un mur personnel, vous pouvez utiliser le message RetrieveRequest ou le message RetrieveMultipleRequest. Cependant, pour récupérer des pages de publications avec des commentaires et des likes associés en un seul appel, vous pouvez utiliser des messages de flux d’activité spéciaux.

Pour récupérer des pages de publications avec les commentaires et les mentions J’aime associés pour un mur d’enregistrement, utilisez le message RetrieveRecordWallRequest. Pour récupérer des pages de messages avec des commentaires et des likes associés pour un mur personnel, utilisez le RetrievePersonalWallRequest message.

Les messages suivants avec des commentaires sont affichés sur le mur d’enregistrement :

• Publications concernant un enregistrement. L’ID de l’enregistrement est spécifié dans l’attribut Post.RegardingObjectId .

• Publications qui mentionnent un enregistrement. L’ID d’enregistrement est spécifié dans l’attribut Post.Text .

• Pour un enregistrement d’utilisateur système (utilisateur), le mur inclut également les publications créées par l’utilisateur. L’attribut Post.RegardingObjectId contient l’ID utilisateur actuel.

  Les messages suivants avec des commentaires s’affichent sur l’applicationVotre mur personnel (utilisateur) (Nouveautés de Dynamics 365 Customer Engagement (on-premises)) :

• Publications qui vous concernent. L’attribut Post.RegardingObjectId contient votre ID utilisateur.

• Des messages qui vous mentionnent. Votre ID utilisateur est spécifié dans l’attribut Post.Text .

• Les messages qui concernent un enregistrement ou qui mentionnent un enregistrement que vous suivez.

Remarque

Vous ne pouvez suivre que les enregistrements sur lesquels vous disposez de privilèges de lecture et de droits d’accès. Si vous perdez les autorisations de lecture, un suivi est automatiquement supprimé. Tous les utilisateurs de Dynamics 365 Customer Engagement (on-premises) se suivent automatiquement. Vous ne pouvez voir que les messages qui concernent les enregistrements ou mentionner les enregistrements sur lesquels vous avez des privilèges de lecture et des droits d’accès.

Si vous créez l’enregistrement PostFollow pour le compte A et définissez le paramètre OwnerId de PostFollow sur l’utilisateur B, l’utilisateur B suit le compte A.

Pour plus d’informations sur la sécurité basée sur les rôles et les enregistrements, voir Modèle de sécurité de Dynamics 365 Customer Engagement (local).

Voir aussi

Entités de flux d’activités
RetrieveRecordWallRequest
RetrievePersonalWallRequest
Configurer Flux d’activités
Se connecter à Yammer
Exemple : collaborer avec des flux d'activités
Billet de blog : Utilisation du flux d’activité à l’aide du SDK Microsoft CRM
Article de blog : Comment faire des mentions avec des flux d’activité
Billet de blog : Affichage de l’image Facebook d’un contact dans Microsoft Dynamics CRM 2011
Article de blog : Gestion des données pour les entités Flux d'activités
Article de blog : Comment ajouter un mur d’enregistrements à un formulaire
Article de blog : Solution de flux d’activités et environnement de développement