Exemplo: expandir tipo de cartão do assistente (cartão personalizado)

Aprenda como descarregar o exemplo e que recursos existem para criar ações personalizadas ou saiba como estender o cartão de ação assistente.

Criar um cartão de ação personalizado

O seguinte processo explica como criar um cartão personalizado:

Passo 1: Descarregue a solução de exemplo para o tipo de cartão do Assistente de Extensão.
Passo 2: Constrói a solução (ExtPkgDeployer.sln).
Passo 3: Importa o pacote usando a ferramenta package deployer.
Passo 4: Verifica o novo tipo de cartão.
Passo 5: Crie cartão de ação para o novo tipo de cartão usando a Web API.
Passo 6: Verifica a nova placa personalizada.

Pré-requisitos

Reveja os pré-requisitos antes de criar os cartões personalizados na sua organização:

Tem de ter a ferramenta Package Deployer (packagedeployer.exe) para implementar pacotes. Para descarregar o package deployer, consulte Download tools from NuGet.
Para utilizar esta funcionalidade, tem de adquirir uma licença do Dynamics 365 Sales Insights ou iniciar uma avaliação para utilizar as funcionalidades do Sales Insights.

Passo 1: Faça o download da solução de exemplo para extensão do tipo de cartão do Assistente

Transferir a solução de cartão personalizado de exemplo.

Os exemplos mostram como criar um cartão personalizado no Assistente de forma programática.

Vá para o caminho ExtPkgDeployer\PkgFolder\extensibility_example_sol\WebResources. Na pasta WebResources, pode ver três ficheiros que são necessários para criar um cartão personalizado.

Definição do esquema (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)
Comando (new_commands8db43275-0291-401d-923a-90a6c373cc18)
Ícone (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Definição do esquema (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

A definição do esquema para o novo tipo de cartão.

Observação

Certifique-se de que o valor de ID do tipo de cartão é maior do que 10.000.

<?xml version="1.0" encoding="utf-8" ?>
<entity name="cardtype" displayname="Action Card Type">
  <cardname>Extensibility Example</cardname>
  <cardtypeid>aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb</cardtypeid>
  <cardtype>11000</cardtype>
  <cardtypeicon>webresources/new_msicon</cardtypeicon>
  <softtitle>Extensibility Example</softtitle>
  <summarytext>RA Card Extensibility Example</summarytext> 
  <actions>{"WebClient":{"Actions":{"Open":"Mscrm.HomepageGrid.actioncard.CardCommand"},"Default":{"Open":"Mscrm.HomepageGrid.actioncard.CardCommand"}}, "Mobile":{"Actions":{"Open":"Mscrm.HomepageGrid.actioncard.CardCommand"}}}</actions>
</entity>

Comando (new_commands8db43275-0291-401d-923a-90a6c373cc18)

O ficheiro contém o comando para a carta de ação.

function CardCommand() {
	window.open("https://aka.ms/salesai-raext");
}

Quando executas o comando, o RibbonDiff definido na customization.xml da entidade ActionCard invoca o comando.

<ImportExportXml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entities>
    <Entity>
      <Name LocalizedName="ActionCard" OriginalName="ActionCard">ActionCard</Name>
      <ObjectTypeCode>9962</ObjectTypeCode>
      <RibbonDiffXml>
        <CustomActions>
          <CustomAction Id="Mscrm.HomepageGrid.actioncard.CardCommand.CustomAction" Location="Mscrm.HomepageGrid.actioncard.MainTab.Actions.Controls._children" Sequence="12">
            <CommandUIDefinition>
              <Button Id="Mscrm.HomepageGrid.actioncard.CardCommand" ToolTipTitle="Open" ToolTipDescription="Open" Command="Mscrm.HomepageGrid.actioncard.CardCommand" Sequence="12" LabelText="Open" Alt="Open" Image16by16="/WebResources/new_msicon" Image32by32="/WebResources/new_msicon" TemplateAlias="o1" ModernImage="new_msicon" />
            </CommandUIDefinition>
          </CustomAction>
          <CustomAction Id="Mscrm.SubGrid.actioncard.CardCommand.CustomAction" Location="Mscrm.SubGrid.actioncard.MainTab.Actions.Controls._children" Sequence="57">
            <CommandUIDefinition>
              <Button Id="Mscrm.HomepageGrid.actioncard.CardCommand" ToolTipTitle="Open" ToolTipDescription="Open" Command="Mscrm.HomepageGrid.actioncard.CardCommand" Sequence="29" LabelText="Open" Alt="Open" Image16by16="/WebResources/new_msicon" Image32by32="/WebResources/new_msicon" TemplateAlias="o1" ModernImage="new_msicon" />
            </CommandUIDefinition>
          </CustomAction>
        </CustomActions>
        <CommandDefinitions>
          <CommandDefinition Id="Mscrm.HomepageGrid.actioncard.CardCommand">
            <EnableRules >
              <EnableRule Id="Mscrm.SelectionCountExactlyOne" />
              <EnableRule Id="Mscrm.NotOffline" />
            </EnableRules>
            <DisplayRules>
            </DisplayRules>
            <Actions>
              <JavaScriptFunction FunctionName="CardCommand" Library="$webresource:new_commands">
                <CrmParameter Value="SelectedControl" />
                <CrmParameter Value="SelectedControlSelectedItemReferences" />
              </JavaScriptFunction>
            </Actions>
          </CommandDefinition>
        </CommandDefinitions>
        <RuleDefinitions>
          <TabDisplayRules />
          <DisplayRules>
          </DisplayRules>
          <EnableRules/>
        </RuleDefinitions>    
      </RibbonDiffXml>       
    </Entity>
  </Entities>
  <Roles></Roles>
  <Workflows></Workflows>
  <FieldSecurityProfiles></FieldSecurityProfiles>
  <Templates />
  <EntityMaps />
  <EntityRelationships />
  <OrganizationSettings />
  <optionsets />
  <WebResources>
	<WebResource>
      <WebResourceId>{6aa7c568-4830-4da6-89f9-18a8fd9c2285}</WebResourceId>
      <Name>new_msicon</Name>
      <DisplayName>new_msicon</DisplayName>
      <WebResourceType>5</WebResourceType>
      <IntroducedVersion>1.0</IntroducedVersion>
      <IsEnabledForMobileClient>0</IsEnabledForMobileClient>
      <IsAvailableForMobileOffline>0</IsAvailableForMobileOffline>
      <DependencyXml>&lt;Dependencies&gt;&lt;Dependency componentType="WebResource"/&gt;&lt;/Dependencies&gt;</DependencyXml>
      <IsCustomizable>1</IsCustomizable>
      <CanBeDeleted>1</CanBeDeleted>
      <IsHidden>0</IsHidden>
      <FileName>/WebResources/new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285</FileName>
    </WebResource>
    <WebResource>
      <WebResourceId>{8db43275-0291-401d-923a-90a6c373cc18}</WebResourceId>
      <Name>new_commands</Name>
      <DisplayName>new_commands</DisplayName>
      <WebResourceType>3</WebResourceType>
      <IntroducedVersion>1.0</IntroducedVersion>
      <IsEnabledForMobileClient>0</IsEnabledForMobileClient>
      <IsAvailableForMobileOffline>0</IsAvailableForMobileOffline>
      <DependencyXml>&lt;Dependencies&gt;&lt;Dependency componentType="WebResource"/&gt;&lt;/Dependencies&gt;</DependencyXml>
      <IsCustomizable>1</IsCustomizable>
      <CanBeDeleted>1</CanBeDeleted>
      <IsHidden>0</IsHidden>
      <FileName>/WebResources/new_commands8db43275-0291-401d-923a-90a6c373cc18</FileName>
    </WebResource>
	<WebResource>
      <WebResourceId>{9dd7e039-33a1-4778-9972-66536dc5e829}</WebResourceId>
      <Name>new_cardtype_schema</Name>
      <DisplayName>cardtype_schema</DisplayName>
      <WebResourceType>4</WebResourceType>
      <IntroducedVersion>1.0</IntroducedVersion>
      <IsEnabledForMobileClient>0</IsEnabledForMobileClient>
      <IsAvailableForMobileOffline>0</IsAvailableForMobileOffline>
      <DependencyXml>&lt;Dependencies&gt;&lt;Dependency componentType="WebResource"/&gt;&lt;/Dependencies&gt;</DependencyXml>
      <IsCustomizable>1</IsCustomizable>
      <CanBeDeleted>1</CanBeDeleted>
      <IsHidden>0</IsHidden>
      <FileName>/WebResources/new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829</FileName>
    </WebResource>
  </WebResources>
  <Languages>
    <Language>1033</Language>
  </Languages>
</ImportExportXml>

Ícone (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

O ficheiro contém o ícone que a carta utiliza.

Passo 2: criar a solução (ExtPkgDeployer.sln)

Abrir o Prompt de Comando (cmd).
Vá para a pasta raiz. C:\<directory>\RACards Extensibility Example\RACards Extensibility Example\ExtPkgDeployer\PkgFolder
Executa o comando para construir a solução. msbuild ExtPkgDeployer.sln

A construção é bem-sucedida. Pode ver que debaixo de <folder>\ExtPkgDeployer\bin\Debug, os PkgFolder e os ExtPkgDeployer.dll são gerados.

Passo 3: importar o pacote utilizando a ferramenta Package Deployer

Copie o PkgFolder e o ExtPkgDeployer.dll da pasta <folder>\ExtPkgDeployer\bin\Debug e cole-os na localização da <PackageDeployerToolLocation>\tools.
Execute a ferramenta ao clicar duas vezes em PackageDeployer.exe na pasta onde guardou a ferramenta Package Deployer.
No ecrã de introdução da ferramenta Package Deployer, selecione Continuar.
No ecrã de autenticação, introduza as informações de autenticação para ligar à instância do Dynamics 365 Sales onde que pretende implementar o pacote. Se tiver várias organizações e quiser selecionar a organização em que pretende implementar o pacote do Unified Service Desk, selecione a caixa de verificação Apresentar lista de organizações disponíveis. Escolha Iniciar sessão.
O ecrã seguinte mostra informações detalhadas sobre o pacote selecionado e os itens que serão instalados na sua instância do Dynamics 365 Sales. Reveja as informações e selecione Seguinte.
O ecrã Pronto para Instalar mostra o pacote selecionado para implementação e o nome da organização do Dynamics 365 Sales onde será implementado. Reveja as informações e selecione Seguinte.
O ecrã seguinte mostra o estado de validação do pacote selecionado para ser implementado. Depois de concluir a validação com êxito, selecione Seguinte.
A página seguinte apresenta o estado da implementação do pacote. Clique em Seguinte.
O ecrã seguinte apresenta o nome e as informações sobre o pacote que acabou de implementado. Reveja as informações e escolha Concluir para sair da ferramenta Package Deployer.

Depois de implementar o pacote, é criado um novo tipo de cartão com um ID - 00aa00aa-bb11-cc22-dd33-44ee44ee44ee, que é definido no esquema (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829).

Passo 4: validar o novo tipo de cartão

Verifique o tipo de cartão com um ID '00aa00aa-bb11-cc22-dd33-44ee44ee44ee'. Envie um pedido de método GET.

Pedido

GET [Organization URI]/api/data/v9.0/cardtype(00aa00aa-bb11-cc22-dd33-44ee44ee44ee) HTTP/1.1  
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Resposta

{
"@odata.context":"https://[Organization URI]/api/data/v9.0/$metadata#cardtype/$entity",
"@odata.etag":"W/"662120\"",
"boolcardoption":false,
"clientavailability":3,
"ispreviewcard":true,
"cardname":"ExtExample",
"cardtypeid":"2183dfc0-3c1c-45b7-a331-943880c25c6",
"cardtypeicon":"webresources/new_msicon",
"intcardoption":0,
"isenabled":true,
"hassnoozedismiss":true,
"softtitle":"Extensibility Example",
"cardtype":11000,
"isliveonly":false,
"_modifiedby_value":"50673658-c5d6-e811-a98c-000d3a1df431",
"versionnumber":662120,
"isbasecard":false,
"actions":"{\"WebClient\":{\"Actions\":{\"Open\":\"Mscrm.HomepageGrid.actioncard.CardCommand\"},\"Default\":{\"Open\":\"Mscrm.HomepageGrid.actioncard.CardCommand\"}}, \"Mobile\":{\"Actions\":{\"Open\":\"Mscrm.HomepageGrid.actioncard.CardCommand\"}}}",
"publishername":"adminsocial",
"modifiedon":"2018-10-26T12:26:14Z",
"summarytext":"RA Card Extensibility Example",
"_transactioncurrencyid_value":null,
"importsequencenumber":null,
"createdon":null,
"overriddencreatedon":null,
"_modifiedonbehalfby_value":null,
"_createdonbehalfby_value":null,
"_createdby_value":null,
"scheduletime":null,
"exchangerate":null,
"grouptype":null,
"stringcardoption":null,
"lastsynctime":null
}

Passo 5: criar o Cartão de ação para o novo tipo de cartão utilizando a API Web

Crie um Cartão de Ação para o novo tipo de cartão criado utilizando o Package Deployer. Envie um pedido de método POST.

Pedido

POST http://[Organization URI]/api/data/v9.0/actioncards HTTP/1.1
Content-Type: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0  
{
"cardtypeid@odata.bind": "/cardtype(2183dfc0-3c1c-45
b7-a331-1943880c25c6)",
"startdate": "2018-10-20T01:01:01Z",
"expirydate": "2018-10-25T01:01:01Z",
"visibility": true,
"priority": 2000,
"description": "This card should be visible between
start and end date mentioned above",
"title" : "Extensibility Example",
"cardtype": 11000,
"ownerid@odata.bind" : "/systemusers({USER_ID})"
}

Resposta

HTTP/1.1 204 No Content  
OData-Version: 4.0  
OData-EntityId: http://[Organization URI]/api/data/v9.0/actioncard(00aa00aa-bb11-cc22-dd33-44ee44ee44ee)

Observação

Abra a consola do browser e execute o comando, sessionStorage.clear(); para limpar a cache da sessão.

Passo 6: validar o novo cartão personalizado

Pode verificar se os cartões personalizados são criados na sua organização como utilizador final e como administrador.

Como utilizador final

Inicie sessão no Dynamics 365 Sales.
Na secção Assistente, pode ver o cartão de ação que criou.

Como administrador

Inicie sessão no Dynamics 365 Sales e aceda à aplicação do Hub de Vendas.
Aceda a Alterar área e selecione Definições do Sales Insights.
No mapa do site, selecione Cartões de informações em Assistente para aceder à página Gerir cartões de informações.
Na página Gerir cartões de informações encontrará uma opção para ativar os cartões de ação personalizados criados na sua organização.

Para obter mais informações sobre como ativar cartões, consulte Ativar ou desativar cartões de insights.

Não consegue encontrar a funcionalidade na sua aplicação?

Existem algumas possibilidades:

Você não tem a licença necessária para usar esse recurso. Consulte a tabela de comparação e o guia de licenciamento para ver quais as funcionalidades disponíveis com a sua licença.
Você não tem a função de segurança necessária para usar esse recurso.
- Para configurar ou configurar um recurso, você precisa ter as funções Administração e personalização
- Para usar recursos relacionados a vendas, você precisa ter as funções de vendas principais
- Algumas tarefas requerem funções funcionais específicas.
O seu administrador não ativou a funcionalidade.
Sua organização está usando um aplicativo personalizado. Contacte o seu administrador para saber os passos exatos. As etapas descritas neste artigo são específicas para os aplicativos prontos para uso do Sales Hub e do Sales Professional.

Criar cartões personalizados no Assistente

Configurar Assistente

Orientar as comunicações com os clientes com o assistente

Comentários

Esta página foi útil?

Last updated on 2026-05-01

Exemplo: expandir tipo de cartão do assistente (cartão personalizado)

Criar um cartão de ação personalizado

Pré-requisitos

Passo 1: Faça o download da solução de exemplo para extensão do tipo de cartão do Assistente

Definição do esquema (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

Comando (new_commands8db43275-0291-401d-923a-90a6c373cc18)

Ícone (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Passo 2: criar a solução (ExtPkgDeployer.sln)

Passo 3: importar o pacote utilizando a ferramenta Package Deployer

Passo 4: validar o novo tipo de cartão

Pedido

Resposta

Passo 5: criar o Cartão de ação para o novo tipo de cartão utilizando a API Web

Pedido

Resposta

Passo 6: validar o novo cartão personalizado

Não consegue encontrar a funcionalidade na sua aplicação?

Informações relacionadas

Comentários

Recursos adicionais