Compartilhar via


Definir uma entidade de configuração estendida para a conta da instância do canal

Canais aplicáveis: somente SMS

Quando você cria um canal de SMS personalizado, precisa definir uma entidade para representar a configuração estendida para a conta de instância do canal (msdyn_channelinstanceaccount). Por exemplo, você pode ter uma conta do MessageBird para a qual habilitou vários números de telefone. A conta da instância do canal tem um relacionamento 1:N com as instâncias do canal que você criou (neste exemplo, os números de telefone MessageBird).

Importante

Para permitir que Customer Insights - Journeys acesse a entidade de configuração estendida durante o envio, você precisa adicionar privilégios Read para a entidade de configuração estendida à função "Usuário de Serviços de Definições de Canal Cxp".

Para cada solução de canal personalizado, você deve:

  1. Crie uma entidade personalizada para representar a configuração estendida da entidade Conta de Instância do Canal definida na solução base.

    O nome da entidade é atribuído ao atributo msdyn_channeldefinitionaccountexternalentity na etapa de definição do canal.

  2. Adicione um relacionamento à entidade base Conta de Instância do Canal no atributo msdyn_extendedentityid.

    Esse atributo é uma pesquisa polimórfica. Veja um exemplo do relacionamento no 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. Crie um formulário para expor os campos de configuração.

    O formulário não precisa conter atributos como nome ou descrição, pois eles vêm de controles personalizados do Customer Insights - Journeys. O formulário é carregado no assistente de instalação de SMS do Customer Insights - Journeys (etapa de configurações). A ID do formulário é atribuída ao atributo msdyn_channeldefinitionaccountexternalformid na etapa de definição do canal.

    Por exemplo, no SMS, o formulário tem esta aparência:

    Captura de tela de um formulário para um canal do SMS.