Introduction aux flux d’activités dans Dynamics 365 Customer Engagement

En tant que développeur qui implémente des scénarios de collaboration avec les flux d’activités, vous devez vous familiariser avec la terminologie, les définitions et le modèle d’entité des flux d’activités.

Concepts de flux d’activités

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

Terme	Description
Mur	Emplacement dans Dynamics 365 Customer Engagement (on-premises) où les flux d’activités sont affichés sous forme de brèves mises à jour.
Mur d’enregistrement	Emplacement dans Dynamics 365 Customer Engagement (on-premises) où les flux d’activités pour 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’enregistrement apparaît sous la forme Nouveautés pour l’enregistrement. Le mur d’enregistrement contient les publications qui concernent l’enregistrement ou qui en font mention. Si un enregistrement est l’utilisateur système (utilisateur), le mur contient également les publications créées par l’utilisateur.
Mur personnel	Mur personnel à un utilisateur. Dans l’application web Dynamics 365 Customer Engagement (on-premises), il s’agit du mur Nouveautés de l’utilisateur. Ce mur contient les publications sur les enregistrements que l’utilisateur suit, les publications qui concernent l’utilisateur ou qui en font mention.
Publication automatique	Publication générée par Dynamics 365 Customer Engagement (on-premises) en appliquant une règle de publication automatique en cas d’événement, comme la création d’un compte ou la fermeture d’une opportunité conclue. Une publication automatique peut être affichée sur un mur d’enregistrement ou un mur personnel. Le texte de la publication automatique est localisé. Remarque : 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é : CustomerId, ParentAccountId ou ParentContactId.
Publication automatique (publication utilisateur)	Publication créée par un utilisateur Dynamics 365 Customer Engagement (on-premises). 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 (on-premises) 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.
Mention	Partie d’une publication qui fait référence à un enregistrement Dynamics 365 Customer Engagement (on-premises). Une publication peut contenir plusieurs mentions.
Commentaire	Remarque ajoutée sur une publication. Un commentaire est lié à une publication parente. Il ne peut pas exister sans publication parente. Si une publication parente est supprimée, les commentaires de la publication le sont également.
Suivi	Action effectuée par un utilisateur sur un enregistrement des applications Dynamics 365 Customer Engagement (on-premises) qui permet à cet utilisateur d’afficher les publications relatives à l’enregistrement sur son mur personnel. Remarque : pour Dynamics 365 for Customer Engagement (on-premises), le nombre maximal d’enregistrements autorisés à suivre est 5 000. Le nombre d’enregistrements par défaut que l’utilisateur peut suivre est 1 000. La valeur par défaut est configurable et peut être changée par un administrateur ou un utilisateur disposant des autorisations pour modifier les paramètres de déploiement.
Ne plus suivre	Action effectuée par un utilisateur sur un enregistrement Dynamics 365 Customer Engagement (on-premises) qui empêche l’affichage des publications relatives à cet enregistrement sur son mur personnel.
J’aime	Action effectuée par un utilisateur sur une publication qui exprime qu’il a aimé la publication. Remarque :
Je n’aime plus	Action effectuée par un utilisateur pour supprimer la mention J’aime de la publication. Remarque :
Fil de discussion ou conversation	Collection de publications et tous les commentaires associés.
Affichage	Vue des enregistrements d’entité basés sur une requête.

Note

Les publications manuelles et automatiques créées par programme peuvent comporter jusqu’à 2 000 caractères. Les publications créées dans l’application web Dynamics 365 Customer Engagement (on-premises) peuvent comporter jusqu’à 1 000 caractères. Les commentaires créés par programme peuvent contenir jusqu’à 1 000 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é	Description
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 qui annule le suivi.
PostLike	Indique 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és.
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 stockées sous forme de pièces jointes et affichées dans des publications.

J’aime/Je n’aime plus

Avec les mentions J’aime/Je n’aime plus, vous pouvez exprimer une opinion immédiate sur une publication. Cela rend votre communication plus personnalisable et interactive. Utilisez les mentions J’aime/Je n’aime plus pour échanger des compliments avec vos collègues, saluer le travail de vos subordonnés et évaluer la popularité des publications. Une action effectuée par les utilisateurs Dynamics 365 Customer Engagement (on-premises) pour indiquer qu’ils aiment une publication spécifique est appelée J’aime. Une action effectuée par un utilisateur Dynamics 365 Customer Engagement (on-premises) pour annuler la mention « J’aime » sur une publication est appelée Je n’aime plus. Vous pouvez ajouter une mention « J’aime » à la publication ; toutefois, une publication peut être « aimée » par plusieurs utilisateurs. Pour ajouter une mention « J’aime » à une publication, créez l’enregistrement PostLike et associez-le à l’enregistrement Post parent. Pour supprimer la mention « J’aime » de la publication, supprimez l’enregistrement PostLike.

Mentions

Pendant les discussions au sein d’un groupe, vous devez souvent référencer 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. Dans les flux d’activités Dynamics 365 Customer Engagement (on-premises), cette action est appelée une « mention. » Les publications qui mentionnent un utilisateur peuvent être affichées sur le mur d’enregistrement et le mur personnel de l’utilisateur (« Nouveautés » dans les applications Dynamics 365 Customer Engagement (on-premises)). Les publications qui mentionnent un enregistrement sont affichées sur le mur de l’enregistrement.

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

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

Note

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

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

Paramètre	Description
Entity	Nom logique d’entité ou code de type d’entité pour l’enregistrement mentionné dans la publication.
ID	ID de l’enregistrement mentionné dans la publication.
Display String	Texte à afficher dans la mention, par exemple 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, voir 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 d’autres mentions ou du texte.

Pour plus d’informations sur les mentions de publication, consultez Billet de blog : Comment utiliser les mentions dans les flux d’activités.

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

Pour récupérer des publications pour les afficher sur un mur d’enregistrement ou un mur personnel, vous pouvez utiliser le message RetrieveRequest ou le message RetrieveMultipleRequest. Toutefois, pour récupérer les pages de publications avec les commentaires et les mentions J’aime associés dans un appel unique, vous pouvez utiliser des messages de flux d’activités 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 publications avec les commentaires et les mentions J’aime associés pour un mur personnel, utilisez le message RetrievePersonalWallRequest.

Les publications suivantes avec les commentaires sont affichées sur le Mur d’enregistrement :

• Publications concernant un enregistrement. L’ID d’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 d’utilisateur actuel.

  Les publications suivantes avec les commentaires sont affichées sur Votre mur personnel (utilisateur) (Nouveautés dans Dynamics 365 Customer Engagement (on-premises)) :

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

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

• Publications qui vous concernent ou qui mentionnent un enregistrement que vous suivez.

Note

Vous pouvez suivre uniquement les enregistrements pour lesquels vous disposez de privilèges et de droits d’accès en lecture. Si vous perdez vos autorisations en lecture, un suivi est automatiquement supprimé. Tous les utilisateurs Dynamics 365 Customer Engagement (on-premises) se suivent automatiquement. Vous pouvez afficher uniquement les publications qui concernent ou mentionnent les enregistrements pour lesquels vous disposez de privilèges et de droits d’accès en lecture.

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 la sécurité basée sur les enregistrements, voir Modèle de sécurité de Dynamics 365 Customer Engagement (on-premises).

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 des flux d’activités à l’aide du Kit de développement logiciel (SDK) de Microsoft CRM
Billet de blog : Comment utiliser les mentions dans les flux d’activités
Billet de blog : Afficher l’image Facebook d’un contact dans Microsoft Dynamics CRM 2011
Billet de blog : Gestion des données pour les entités de flux d’activités
Billet de blog : Comment ajouter un mur d’enregistrement à un formulaire
Billet de blog : Solution de flux d’activités et environnement de développement