Esimerkki: Avustajan korttityypin laajentaminen (mukautettu kortti)

Artikkeli
03/23/2023

Lisätietoja lataustavoista ja käytettävissä olevista resursseista, jotka liittyvät mukautettujen toimintojen luontiin, sekä avustajan toimintokortin laajentamisesta.

Lisenssi- ja roolivaatimukset

Vaatimustyyppi	Tarvitaan
Käyttöoikeus	Dynamics 365 Sales Premium Lisätietoja: Dynamics 365 Salesin hinnoittelu
Käyttöoikeusroolit	Järjestelmän mukauttaja Lisätietoja: Salesin esimääritetyt käyttöoikeusroolit

Mukautetun toimintokortin luominen

Seuraava prosessi selittää, miten mukautettu kortti luodaan:

Vaihe 1: Laajennetun avustajan korttityypin malliratkaisun lataaminen
Vaihe 2: Ratkaisun muodostaminen (ExtPkgDeployer.sln)
Vaihe 3: Paketin tuonti Package Deployer -työkalulla
Vaihe 4: Uuden korttityypin tarkistaminen
Vaihe 5: Toimintokortin luominen uudelle korttityypille verkko-ohjelmointirajapinnassa.
Vaihe 6: Uuden mukautetun kortin tarkistaminen

Edellytykset

Tutustu edellytyksiin, ennen kuin luot mukautettuja kortteja organisaatiossa:

Tarvitset pakettien käyttöönottamiseen Package Deployer -työkalun (packagedeployer.exe). Lisätietoja Package Deployerin lataamisesta on kohdassa 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)

Sisältää uuden korttityypin rakennemäärityksen.

Muistiinpano

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>2183dfc0-3c1c-45b7-a331-1943880c25c6</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, komennon kutsumisessa on käytössä RibbonDiff, joka on määritetty Toimintokortti-entiteetin customization.xml-tiedostossa.

<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ää kortissa käytettävän kuvakkeen.

Vaihe 2: Ratkaisun muodostaminen (ExtPkgDeployer.sln)

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

Koonti onnistui ja kohdassa<folder>\ExtPkgDeployer\bin\Debug nähdään, että PkgFolder ja ExtPkgDeployer.dll on luotu.

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, 2183dfc0-3c1c-45b7-a331-1943880c25c6, on määritetty rakenteessa (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829).

Vaihe 4: Uuden korttityypin tarkistaminen

Tarkista kortin tyyppi tunnuksella 2183dfc0-3c1c-45b7-a331-1943880c25c6. Lähetä GET-menetelmäpyyntö.

Pyyntö

GET [Organization URI]/api/data/v9.0/cardtype(2183dfc0-3c1c-45b7-a331-1943880c25c6) 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ö.

Pyydä

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

Response

HTTP/1.1 204 No Content  
OData-Version: 4.0  
OData-EntityId: http://[Organization URI]/api/data/v9.0/actioncard(2183dfc0-3c1c-45b7-a331-1943880c25c6)

Muistiinpano

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ä asetuksia sovelluksesta?

Mahdollisuuksia on kolme:

Sinulla ei ole tarvittavaa käyttöoikeutta tai roolia. Tarkista tämän sivun yläosassa oleva Käyttöoikeus- ja roolivaatimukset -osio.
Järjestelmänvalvojasi ei ole ottanut ominaisuutta käyttöön.
Organisaatiosi käyttää mukautettua sovellusta. Kysy tarkemmat vaiheet järjestelmänvalvojaltasi. Tässä artikkelissa kuvatut ohjeet koskevat käyttövalmiita Myyntikeskus- ja Sales Professional -sovelluksia.

Mukautettujen korttien luominen avustajassa

Avustajan määrittäminen

Asiakasviestinnän ohjaus avustajan avulla

Jaa

Esimerkki: Avustajan korttityypin laajentaminen (mukautettu kortti)

Lisenssi- ja roolivaatimukset

Mukautetun toimintokortin luominen

Edellytykset

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

Pyydä

Response

Vaihe 6: Uuden mukautetun kortin tarkistaminen

Etkö löydä asetuksia sovelluksesta?

Palaute

Lisäresursseja

Jaa

Esimerkki: Avustajan korttityypin laajentaminen (mukautettu kortti)

Lisenssi- ja roolivaatimukset

Mukautetun toimintokortin luominen

Edellytykset

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

Pyydä

Response

Vaihe 6: Uuden mukautetun kortin tarkistaminen

Etkö löydä asetuksia sovelluksesta?

Liittyvät tiedot

Palaute

Lisäresursseja