Esimerkki: Avustajan korttityypin laajentaminen (mukautettu kortti)

Lue, miten voit ladata mallin ja mitä resursseja on saatavilla mukautettujen toimintojen luomiseen tai avustajatoiminnon kortin laajentamiseen.

Mukautetun toimintokortin luominen

Seuraava prosessi selittää, miten mukautettu kortti luodaan:

Vaihe 1: Lataa laajennusavustajakortin tyyppimalliratkaisu.
Vaihe 2: Luo ratkaisu (ExtPkgDeployer.sln).
Vaihe 3: Tuo paketti paketin käyttöönottotyökalun avulla.
Vaihe 4: Tarkista uuden kortin tyyppi.
Vaihe 5: Luo toimintokortti uudelle korttityypille käyttämällä WWW-ohjelmointirajapintaa.
Vaihe 6: Tarkista uusi mukautettu kortti.

Vaatimukset

Tutustu edellytyksiin, ennen kuin luot mukautettuja kortteja organisaatiossa:

Tarvitset pakettien käyttöönottamiseen Package Deployer -työkalun (packagedeployer.exe). Jos haluat ladata paketin käyttöönottotoiminnon, lue ohjeartikkeli Työkalujen lataaminen NuGetista.
Tämän toiminnon käyttämistä varten sinun on ostettava Dynamics 365 Sales Insights -käyttöoikeus tai aloitettava kokeiluversion käyttö, jotta voit käyttää Sales Insights -toimintoja.

Vaihe 1: Laajennetun avustajan korttityypin malliratkaisun lataaminen

Lataa mukautetun kortin näyteratkaisu.

Näytteet osoittavat, miten mukautettu kortti luodaan avustajassa ohjelmallisesti.

Siirry polkuun ExtPkgDeployer\PkgFolder\extensibility_example_sol\WebResources. WebResources-kansiossa on kolme tiedostoa, joita tarvitaan mukautetun kortin luomiseen.

Skeeman määritys (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)
Komento (new_commands8db43275-0291-401d-923a-90a6c373cc18)
Kuvake (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Skeeman määritys (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

Uuden korttityypin rakennemääritys.

Huomautus

Varmista, että korttityypin tunnuksen arvo on suurempi kuin 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>

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

Tiedosto sisältää toimintokortin komennon.

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

Kun suoritat komennon, RibbonDiff ActionCard-entiteetin customization.xml määritetty toiminto käynnistää komennon.

<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>

Kuvake (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Tiedosto sisältää kuvakkeen, jota kortti käyttää.

Vaihe 2: Ratkaisun muodostaminen (ExtPkgDeployer.sln)

Avaa komentokehote (cmd).
Siirry juurikansioon. C:\<directory>\RACards Extensibility Example\RACards Extensibility Example\ExtPkgDeployer\PkgFolder
Luo ratkaisu suorittamalla komento. msbuild ExtPkgDeployer.sln

Koonti onnistui. Näet, että <folder>\ExtPkgDeployer\bin\Debug, PkgFolder ja ExtPkgDeployer.dll:n alla luodaan sisältö.

Vaihe 3: Paketin tuonti Package Deployer -työkalulla

Kopioi PkgFolder ja ExtPkgDeployer.dll<folder>\ExtPkgDeployer\bin\Debug-kansiosta ja liitä ne sijaintiin <PackageDeployerToolLocation>\tools.
Suorita työkalu kaksoisnapsauttamalla PackageDeployer.exe-tiedostoa siinä kansiossa, johon olet tallentanut Package Deployer -työkalun.
Valitse Package Deployer -työkalun johdantonäytössä Jatka.
Ilmoita todennusnäytössä todennustiedot ja muodosta yhteys Dynamics 365 Sales -esiintymään, johon haluat asentaa paketin. Jos organisaatioita on useita ja haluat valita organisaation, jossa Unified Service Desk -paketti otetaan käyttöön, valitse Näytä käytettävissä olevien organisaatioiden luettelo -valintaruutu. Valitse Sisäänkirjaus.
Seuraavassa näytössä näkyvät valitun paketin yksityiskohtaiset tiedot ja muut Dynamics 365 Sales -esiintymään asennettavat kohteet. Tarkasta tiedot ja valitse Seuraava.
Valmis asennusta varten -näytössä on käyttöönottoa varten valittu paketti ja sen Dynamics 365 Sales -organisaation nimi, jossa käyttöönotto tehdään. Tarkasta tiedot ja valitse Seuraava.
Seuraavassa näytössä on käyttöönottoa varten valitun paketin tila. Kun tarkistus on tehty, valitse Seuraava.
Seuraavalla sivulla on paketin käyttöönoton tila. Valitse Seuraava.
Seuraavassa näytössä näkyvät juuri käyttöönotetun paketin nimi ja tiedot. Tarkista tiedot ja valitse Valmis, kun haluat sulkea Package Deployer -työkalun.

Kun paketti on otettu käyttöön, uusi korttityyppi luodaan. Sen tunnus, 00aa00aa-bb11-cc22-dd33-44ee44ee44ee, on määritetty rakenteessa (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829).

Vaihe 4: Uuden korttityypin tarkistaminen

Tarkista kortin tyyppi tunnuksella 00aa00aa-bb11-cc22-dd33-44ee44ee44ee. Lähetä GET-menetelmäpyyntö.

Pyyntö

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

Vastaus

{
"@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
}

Vaihe 5: Toimintokortin luominen uudelle korttityypille verkko-ohjelmointirajapinnassa

Luo toimintokortti Package Deployerilla luodulle uudelle korttityypille. Lähetä POST-menetelmäpyyntö.

Pyyntö

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})"
}

Vastaus

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)

Huomautus

Avaa selainkonsoli ja tyhjennä istunnon välimuisti suorittamalla komento sessionStorage.clear();.

Vaihe 6: Uuden mukautetun kortin tarkistaminen

Voit tarkistaa, että organisaatioon on luotu loppukäyttäjän ja järjestelmänvalvojan mukautetut kortit.

Loppukäyttäjänä

Kirjaudu Dynamics 365 Salesiin.
Luotu toimintokortti näkyy Avustaja-osassa.

Järjestelmänvalvojana

Kirjaudu Dynamics 365 Salesiin ja siirry myyntikeskussovellukseen.
Valitse ensin Vaihda aluetta ja sitten Sales Insightsin asetukset.
Siirry Oivalluskorttien hallinta -sivulle valitsemalla Avustaja-kohdassa Tietokortit.
Oivalluskorttien hallinta -sivulla on asetus, jolla voit ottaa luodut mukautetut toimintokortit käyttöön organisaatiossa.

Lisätietoja korttien käyttöönottamisesta on kohdassa Tietokorttien ottaminen käyttöön tai poistaminen käytöstä.

Etkö löydä ominaisuutta sovelluksestasi?

Mahdollisuuksia on muutamia:

Sinulla ei ole tämän ominaisuuden käyttämiseen tarvittavaa käyttöoikeutta. Katso vertailutaulukosta ja käyttöoikeusoppaasta, mitkä ominaisuudet ovat käytettävissä lisenssissäsi.
Sinulla ei ole tämän ominaisuuden käyttämiseen tarvittavaa käyttöoikeusroolia.
- Jotta voit asentaa tai määrittää ominaisuuden, sinulla on oltava hallinta- ja mukautusroolit
- Jos haluat käyttää myyntiin liittyviä ominaisuuksia, sinulla on oltava ensisijaiset myyntiroolit
- Jotkin tehtävät edellyttävät tiettyjä toiminnallisia rooleja.
Järjestelmänvalvojasi ei ole ottanut ominaisuutta käyttöön.
Organisaatiossasi käytetään mukautettua sovellusta. Pyydä tarkat vaiheet järjestelmänvalvojaltasi. Tässä artikkelissa kuvatut vaiheet koskevat valmiita Myyntikeskus- ja Myyntiammatti-sovelluksia.

Mukautettujen korttien luominen avustajassa

Avustajan määrittäminen

Asiakasviestinnän ohjaus avustajan avulla

Palaute

Onko tästä sivusta apua?

Last updated on 2026-05-01

Esimerkki: Avustajan korttityypin laajentaminen (mukautettu kortti)

Mukautetun toimintokortin luominen

Vaatimukset

Vaihe 1: Laajennetun avustajan korttityypin malliratkaisun lataaminen

Skeeman määritys (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

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

Kuvake (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Vaihe 2: Ratkaisun muodostaminen (ExtPkgDeployer.sln)

Vaihe 3: Paketin tuonti Package Deployer -työkalulla

Vaihe 4: Uuden korttityypin tarkistaminen

Pyyntö

Vastaus

Vaihe 5: Toimintokortin luominen uudelle korttityypille verkko-ohjelmointirajapinnassa

Pyyntö

Vastaus

Vaihe 6: Uuden mukautetun kortin tarkistaminen

Etkö löydä ominaisuutta sovelluksestasi?

Liittyvät tiedot

Palaute

Lisäresursseja