Intégrer Microsoft Dynamics CRM 2015 avec Parature

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Améliorez la productivité de vos agents de service en les aidant à trouver rapidement des informations précises et à les fournir aux clients depuis Microsoft Dynamics 365 en activant l'intégration à la gestion des connaissances Parature.Parature, de Microsoft est une solution de service clientèle basée sur le cloud qui fournit un accès rapide aux informations cohérentes et organisées par la gestion des connaissances, le libre-service intelligent et les interactions multicanales. Pour plus d'informations sur Parature, voir À propos de Parature.

Contenu de la rubrique

Activer l'intégration à la gestion des connaissances Parature

Créer et gérer des métadonnées d'enregistrement de base de connaissances

Associer un enregistrement de la base de connaissances à une instance d'entité

Activer l'intégration à la gestion des connaissances Parature

Vous pouvez activer l'intégration avec la gestion des connaissances Parature pour votre instance Dynamics 365 à l'aide du client Web ; vous ne pouvez pas effectuer l'opération via le SDK.Pour plus d'informations :TechNet : Connecter Microsoft Dynamics CRM à la base de connaissances Parature

Après l'activation de l'intégration à la gestion des connaissances Parature, les développeurs peuvent activer ou détecter l'intégration de gestion des connaissances Parature pour une entité dans Dynamics 365 à l'aide de l'attribut IsKnowledgeManagementEnabled. Vous pouvez activer l'intégration de Parature pour uniquement les entités qui peuvent être dans une relation d'entité plusieurs à plusieurs, qui peuvent être déterminées à l'aide de l'attribut CanBeInManyToMany de l'entité.

Lorsque vous activez l'intégration de Parature pour une entité, une relation plusieurs-à-plusieurs est créée automatiquement entre l'entité et l'entité KnowledgeBaseRecord avec le nom suivant : KnowledgeBaseRecord_<Nom_Entité>. Par exemple, si vous activez l'intégration de Parature pour l'entité Account, le nom de la relation plusieurs-à-plusieurs sera KnowledgeBaseRecord_Account.

Par défaut, l'intégration de la gestion des connaissances est activée pour l'entité Incident. L'exemple de code suivant montre comment détecter et activer l'intégration de gestion des connaissances pour une entité :

RetrieveEntityRequest entityRequest = new RetrieveEntityRequest
{
    EntityFilters = EntityFilters.All,
    LogicalName = Incident.EntityLogicalName,

    // Retrieve only the currently published changes, ignoring the changes 
    // that have not been published.
    RetrieveAsIfPublished = false
};
RetrieveEntityResponse entityResponse = (RetrieveEntityResponse)_serviceProxy.Execute(entityRequest);

if (entityResponse.EntityMetadata.IsKnowledgeManagementEnabled == true)
{
    Console.WriteLine("Verified that knowledge management is enabled for Incident entity.\n");
    return;
}
else
{
    // Enable knolwledge management for the Incident entity.
    Console.WriteLine("Knowledge management is not enabled for the Incident entity.");
    entityResponse.EntityMetadata.IsKnowledgeManagementEnabled = true;

    // Create an update request.                    
    UpdateEntityRequest updateRequest = new UpdateEntityRequest
    {
        Entity = entityResponse.EntityMetadata
    };
    _serviceProxy.Execute(updateRequest);

    // Publish the entity.
    // All customizations must be published before they can be used.
    PublishAllXmlRequest enableRequest = new PublishAllXmlRequest();
    _serviceProxy.Execute(enableRequest);
    Console.WriteLine("Enabled Knowledge management for the Incident entity.");
}

Pour obtenir l'exemple de code complet, voir Exemple : Créer et associer un enregistrement de la base de connaissances à un incident

Lorsque vous activez la gestion des connaissances Parature pour votre instance Dynamics 365, vous pouvez ajouter un contrôle de recherche dans la base de connaissances aux formulaires des entités qui ont été activées pour l'intégration de gestion des connaissances. Vous pouvez utiliser le contrôle de recherche dans la base de connaissances pour afficher les suggestions automatiques dans les résultats de la recherche, définir les filtres de recherche et spécifier les actions contextuelles pouvant être effectuées sur un article de la base de connaissances.Pour plus d'informations :TechNet : Ajout du contrôle de recherche dans la Base de connaissances aux formulaires Microsoft Dynamics CRM.

Le contrôle de recherche de la base de connaissances fournit la prise en charge de la programmabilité pour automatiser ou améliorer l'expérience de l'utilisateur lors de son utilisation.Pour plus d'informations :Contrôle de recherche de la Base de connaissances Parature (référence côté client)

Créer et gérer des métadonnées d'enregistrement de base de connaissances

Vous pouvez créer et gérer des métadonnées d'enregistrements de base de connaissances avec l'entité ParatureKnowledgeBaseRecord. Certaines informations stockées par cette entité sont affichées dans le tableau suivant.

L'exemple de code suivant montre comment créer une instance d'enregistrement de la base de connaissances :

// Create a knowledge base record instance        
KnowledgeBaseRecord kbRecord = new KnowledgeBaseRecord
{
    // These are sample values. Replace them with
    // appropriate values as per your integrated 
    // Parature  instance.
    PrivateUrl = "http://www.demo.parature.com/internal",
    PublicUrl = "http://www.demo.parature.com",
    Title = "How to track shipping?",
    UniqueId = "8000/8467/Article/23782"
};
_kbRecordId = _serviceProxy.Create(kbRecord);
Console.WriteLine("Created knowledge base record with ID: '{0}'.\n", _kbRecordId.ToString());

Pour obtenir l'exemple de code complet, voir Exemple : Créer et associer un enregistrement de la base de connaissances à un incident

Associer un enregistrement de la base de connaissances à une instance d'entité

Vous pouvez associer par programme une instance KnowledgeBaseRecord à une instance d'entité à l'aide de la relation plusieurs-à-plusieurs qui est créée automatiquement lorsque vous avez activé l'intégration Parature pour l'entité. Lorsque vous associez une instance KnowledgeBaseRecord à une instance d'entité, un enregistrement pour la relation est créé dans une entité avec intersection appelée : **<Nom_Entité>KnowledgeBaseRecord. Par exemple, lorsque vous associez l'instance KnowledgeBaseRecord à une instance Account pour la première fois, une entité avec intersection appelée AccountKnowledgeBaseRecord est créée, et un enregistrement avec le mappage d'association est créé dans l'entité avec intersection.

L'exemple de code suivant montre comment associer une instance KnowledgeBaseRecord à une instance Incident :

// Associate the knowledge base record with an incident record

// Step 1: Create a collection of knowledge base record that will be 
// associated to the incident. In this case, we have only a single
// knowledge base record to be associated.
EntityReferenceCollection relatedEntities = new EntityReferenceCollection();
relatedEntities.Add(new EntityReference(KnowledgeBaseRecord.EntityLogicalName, _kbRecordId));

// Step 2: Create an object that defines the relationship between knowledge base record and incident.
// Use the many-to-many relationship name (KnowledgeBaseRecord_Incident) between knowledge base
// record and incident.
Relationship relationship = new Relationship("KnowledgeBaseRecord_Incident");

// Step 3: Associate the knowledge base record with the incident record.
_serviceProxy.Associate(Incident.EntityLogicalName, _incidentId, relationship,
    relatedEntities);

Pour l'exemple de code complet, notamment savoir comment dissocier une instance KnowledgeBaseRecord d'une instance Incident, voir Exemple : Créer et associer un enregistrement de la base de connaissances à un incident.

Les données stockées dans KnowledgeBaseRecord et les entités avec intersection (ici IncidentKnowledgeBaseRecord) peuvent être utilisées avec des outils tels que Power BI pour générer des rapports sur l'impact de la base de connaissances Parature lors du traitement des requêtes des clients.

Voir aussi

Messages et méthodes de l'entité KnowledgeBaseRecord
Exemple : Créer et associer un enregistrement de la base de connaissances à un incident
TechNet : Connecter Microsoft Dynamics CRM à la Base de connaissances Parature
Contrôle de recherche de la Base de connaissances Parature (référence côté client)
TechNet : Ajouter le contrôle de recherche dans la Base de connaissances aux formulaires Microsoft Dynamics CRM
Entités Incident (incident)

© 2017 Microsoft. Tous droits réservés. Copyright