Définir une entité de configuration étendue pour le compte de l’instance de canal

Canaux applicables : SMS uniquement

Lorsque vous créez un canal SMS personnalisé, vous devez définir une entité pour représenter la configuration étendue pour le compte de l’instance de canal (msdyn_channelinstanceaccount). Par exemple, vous pouvez avoir un compte MessageBird pour lequel vous avez activé plusieurs numéros. Le compte de l’instance de canal a une relation 1 à N avec les instances de canal que vous avez créées (dans cet exemple, les numéros de téléphone MessageBird).

Important

Pour autoriser Customer Insights - Journeys à accéder à l’entité de configuration étendue lors de la soumission, vous devez ajouter des privilèges Lire pour l’entité de configuration étendue au rôle « Utilisateur des services de définitions de canal Cxp ».

Pour chaque solution de canal personnalisé, vous devez :

1. Créer une entité personnalisée pour représenter la configuration étendue de l’entité Compte de l’instance de canal définie dans la solution de base.

   Le nom de l’entité est attribué à l’attribut msdyn_channeldefinitionaccountexternalentity à l’étape de définition du canal.

2. Ajouter une relation à l’entité de base Compte de l’instance de canal dans l’attribut msdyn_extendedentityid.

   Cet attribut est une recherche polymorphique. Voici un exemple de la relation au format XML :

<?xml version="1.0" encoding="utf-8"?>
<EntityRelationships xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <EntityRelationship Name="msdyn_ChannelInstanceAccount_extendedentityid_cr65f_samplechannelinstanceaccount">
    <EntityRelationshipType>OneToMany</EntityRelationshipType>
    <IsCustomizable>0</IsCustomizable>
    <IntroducedVersion>1.0.0.0</IntroducedVersion>
    <IsHierarchical>0</IsHierarchical>
    <ReferencingEntityName>msdyn_ChannelInstanceAccount</ReferencingEntityName>
    <ReferencedEntityName>cr65f_samplechannelinstanceaccount</ReferencedEntityName>
    <CascadeAssign>NoCascade</CascadeAssign>
    <CascadeDelete>RemoveLink</CascadeDelete>
    <CascadeReparent>NoCascade</CascadeReparent>
    <CascadeShare>NoCascade</CascadeShare>
    <CascadeUnshare>NoCascade</CascadeUnshare>
    <CascadeRollupView>NoCascade</CascadeRollupView>
    <IsValidForAdvancedFind>1</IsValidForAdvancedFind>
    <ReferencingAttributeName>msdyn_extendedentityId</ReferencingAttributeName>
    <RelationshipDescription>
      <Descriptions>
        <Description description="" languagecode="1033" />
      </Descriptions>
    </RelationshipDescription>
    <EntityRelationshipRoles>
      <EntityRelationshipRole>
        <NavPaneDisplayOption>UseCollectionName</NavPaneDisplayOption>
        <NavPaneArea>Details</NavPaneArea>
        <NavPaneOrder>10000</NavPaneOrder>
        <NavigationPropertyName>msdyn_extendedentityid_cr65f_samplechannelinstanceaccount</NavigationPropertyName>
        <RelationshipRoleType>1</RelationshipRoleType>
      </EntityRelationshipRole>
      <EntityRelationshipRole>
        <NavigationPropertyName>msdyn_ChannelInstanceAccount_extendedentityid_cr65f_samplechannelinstanceaccount</NavigationPropertyName>
        <RelationshipRoleType>0</RelationshipRoleType>
      </EntityRelationshipRole>
    </EntityRelationshipRoles>
  </EntityRelationship>
</EntityRelationships>

1. Créez un formulaire pour exposer les champs de configuration.

   Le formulaire ne doit pas nécessairement contenir d’attributs tels que le nom ou la description, car ils proviennent de contrôles Customer Insights - Journeys personnalisés. Le formulaire est chargé dans l’assistant de configuration de SMS de Customer Insights - Journeys (étape de configuration). L’ID de formulaire est attribué à l’attribut msdyn_channeldefinitionaccountexternalformid à l’étape de définition du canal.

   Par exemple, dans un SMS, le formulaire ressemble à ceci :