Jagamisviis:

Näidis. Abilise kaardi tüübi laiendamine (kohandatud kaart)

  • Artikkel

Vaadake, kuidas alla laadida ja millised ressursid on kohandatud toimingute loomiseks saadaval, või uurige, kuidas laiendada abilise toimingukaarti.

Litsentsi- ja rollinõuded

Nõude tüüp Teil peab olema
Litsents Dynamics 365 Sales Premium
Lisateave: Dynamics 365 Salesi hinnakujundus
Turberollid süsteemikohandaja
Lisateave: Müügi jaoks eelmääratletud turberollid

Kohandatud toimingukaardi loomine

Järgmises toimingus kirjeldatakse, kuidas luua kohandatud kaarti.

  • 1. samm: Laadige alla laiendus- Abimees kaart tüüpi näidislahendus
  • 2 . samm:Lahenduse koostamine (ExtPkgDeployer.sln)
  • samm 3: Paketi importimine tööriista Package Deployer abil
  • 4. samm: Uue kaart tüübi kinnitamine
  • samm 5: Looge Web API abil uue kaart tüübi jaoks toimingu kaart.
  • samm 6: Uue kohandatud kaart kinnitamine

Eeltingimused

Enne organisatsioonis kohandatud kaartide loomist vaadake üle eeltingimused.

  • Pakettide juurutamiseks on teil vaja tööriista Package Deployer (packagedeployer.exe). Teavet paketi juurutaja allalaadimise kohta leiate teemast Tööriistade allalaadimine saidilt NuGet

  • Selle funktsiooni kasutamiseks peate ostma Dynamics 365 Sales Insightsi litsentsi või alustama prooviversiooni, et kasutada Sales Insightsi funktsioone.

1. etapp. Laadige alla abilise kaardi tüübi laiendamise näidislahendus

Laadige alla kohandatud kaart näidislahendus.

Näidised demonstreerivad, kuidas abilises programmiliselt kohandatud kaarti luua.

Mine teele ExtPkgDeployer\PkgFolder\extensibility_example_sol\WebResources. Kaustas WebResources näete kolme faili, mis on vajalikud kohandatud kaart loomiseks.

  • Skeemi määratlus (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

  • Käsk (new_commands8db43275-0291-401d-923a-90a6c373cc18)

  • Ikoon (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Skeemi määratlus (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

See sisaldab uue kaarditüübi skeemi määratlust.

Märkus.

Veenduge, et kaarditüübi ID väärtus oleks suurem kui 10000.

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

Käsk (new_commands8db43275-0291-401d-923a-90a6c373cc18)

Fail sisaldab toimingukaardi käsku.

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

Käsu täitmisel käivitatakse käsk ActionCardi RibbonDiff olemi customization.xml määratletud kaudu .

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

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

Fail sisaldab kaardi jaoks kasutatavat ikooni.

2. etapp. Looge lahendus (ExtPkgDeployer.sln)

  1. Avage käsuviip (cmd).

  2. Minge juurkausta. C:\<directory>\RACards Extensibility Example\RACards Extensibility Example\ExtPkgDeployer\PkgFolder

  3. Lahenduse loomiseks käivitage käsk. msbuild ExtPkgDeployer.sln

Ehitamine on edukas ja näete, et all <folder>\ExtPkgDeployer\bin\DebugPkgFolder on loodud ja ExtPkgDeployer.dll loodud.

3. etapp. Importige pakett tööriistaga Package Deployer

  1. Kopeerige PkgFolder ja kaustast ExtPkgDeployer.dll ning <folder>\ExtPkgDeployer\bin\Debug kleepige see asukohta. <PackageDeployerToolLocation>\tools

  2. Käivitage tööriist, topeltklõpsates kaustas tööriista PackageDeployer.exe Package Deployer salvestasite.

  3. Valige tööriista sissejuhatuse kuval Package Deployer Jätka .

  4. Sisestage autentimiskuval autentimisandmed, et luua ühendus Dynamics 365 Salesi eksemplariga, kuhu soovite paketi juurutada. Kui teil on mitu organisatsiooni ja soovite valida organisatsiooni, kuhu Unified Service Deski pakett juurutada, märkige ruut Kuva saadaolevate organisatsioonide loend. Valige Logi sisse.

  5. Järgmisel kuval näidatakse üksikasjalikku teavet valitud paketi ja üksuste kohta, mis teie Dynamics 365 Salesi eksemplari installitakse. Vaadake teave üle ja valige nupp Edasi.

  6. Installimiseks valmis kuval kuvatakse juurutamiseks valitud pakett ja selle Dynamics 365 Salesi organisatsiooni nimi, kus see juurutatakse. Vaadake teave üle ja valige nupp Edasi.

  7. Järgmisel kuval kuvatakse juurutamiseks valitud paketi valideerimisolek. Kui valideerimine on edukalt lõpule viidud, valige Edasi .

  8. Järgmisel lehel kuvatakse paketi juurutamise olek. Klõpsake valikut Edasi.

  9. Järgmisel kuval kuvatakse äsjajuurutatud paketi nimi ja teave selle kohta. Vaadake teave üle ja valige tööriistast väljumiseks käsk Valmis Package Deployer .

Pärast paketi juurutamist luuakse uus kaart tüüp ID-ga 2183dfc0-3c1c-45b7-a331-1943880c25c6, mis on määratletud skeemis (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829).

4. etapp: Kinnitage uus kaarditüüp

Kontrollige kaardi tüüpi ID-ga '2183dfc0-3c1c-45b7-a331-1943880c25c6'. Saatke GET-meetodi taotlus.

Taotlus

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

Tagasiside

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

5. etapp. Looge uue kaarditüübi jaoks toimingukaart Web API abil

Looge Package Deployeriga loodud kaarditüüpi jaoks toimingukaart. Saatke POST-meetodi taotlus.

Taotle

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)

Märkus.

Avage brauseri konsool ja käivitage käsk, sessionStorage.clear(); seansi vahemälu tühjendamiseks.

6. etapp. Kinnitage uus kohandatud kaart

Lõppkasutajana ja administraatorina saate kontrollida, kas kohandatud kaardid luuakse teie organisatsioonis.

Lõppkasutajana

  1. Logige sisse rakendusse Dynamics 365 Sales.

  2. Jaotises Abimees näete loodud toimingut kaart.

    laiendatud toimingukaardi näidis

Administraatorina

  1. Logige sisse rakendusse Dynamics 365 Sales ja avage müügikeskus rakendus .

  2. Avage jaotis Ala muutmine ja valige Sales Insightsi sätted.

  3. Valige saidikaardil Insights Kaardid under Abimees , et minna lehele Halda ülevaadet Kaardid .

  4. Lehel Ülevaate haldamine Kaardid kuvatakse suvand organisatsioonis loodud kohandatud toimingute Kaardid lubamiseks.

Lisateavet Kaardid lubamise kohta leiate teemast Ülevaadete sisse- või väljalülitamine Kaardid.

Kas te ei leia oma rakenduses suvandeid?

On kolm võimalikku põhjust.

  • Teil pole vajalikku litsentsi ega rolli.
  • Teie administraator pole funktsiooni sisse lülitanud.
  • Teie organisatsioon kasutab kohandatud rakendust. Küsige täpseid juhiseid oma administraatorilt. Selles artiklis kirjeldatud toimingud on seotud kasutusvalmis müügikeskusega ja rakendusega Sales Professional.

Vaata ka

Kohandatud Kaardid loomine Abimees

Abimees konfigureerimine

Kliendisuhtluse suunamine Abimees