Пример: Проширени тип картице помоћника (прилагођена картица)

Чланак
08/28/2024

Сазнајте како да преузмете и који ресурси су присутни да креирате прилагођене акције или сазнате о проширењу картице радње помоћника.

Захтеви за лиценцу и улогу

Тип захтева	Морате имати
Дозволу	Dynamics 365 Sales Premium Више информација: Дyнамицс 365 Продајне цене
Безбедносне улоге	< ДИЦТ__стручњак за прилагођавање система >Сyстем Цустомизер Више информација: Унапред дефинисане безбедносне улоге за продају

Креирање прилагођене картице радње

Следећи процес објашњава како да креирате прилагођену картицу:

корак 1: Преузмите решење за узорак типа ектенд Помоћник картица
корак 2: Изградите решење (ЕxтПкгДеплоyер.слн)
корак 3: Увезите пакет помоћу алата за деплоиер пакета
корак 4: Проверите нови тип картица
корак 5: Креирајте картица акције за нови тип картица користећи Веб АПИ.
корак 6: Проверите нови прилагођени картица

Предуслови

Преглед предуслова пре него што будете могли да креирате прилагођене картице у вашој организацији:

Морате да имате алатку Package Deployer (packagedeployer.exe) да бисте применили пакете. Да бисте преузели пакет деплоиер, погледајте Преузимање алата из NuGet
Да бисте користили ову функцију, морате купити лиценцу Дyнамицс 365 Салес Инсигхтс или започети пробни период да бисте користили функције Салес Инсигхтс.

1. корак: Преузимање пробног решења проширеног типа картице помоћника

Преузмите узорак прилагођеног решења картица.

Примери показују како да програмски креирате прилагођену картицу у помоћнику.

Иди на стазу ExtPkgDeployer\PkgFolder\extensibility_example_sol\WebResources. У фолдеру ВебРесоурцес можете видети три датотеке које су потребне за креирање прилагођеног картица.

Дефиниција шеме (неw_цардтyпе_сцхемаxмл 9dd7e039-33a1-4778-9972-66536dc5e829)
Команда (неw_цоммандс 8db43275-0291-401d-923a-90a6c373cc18)
Икона (неw_мсицон 6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Дефиниција шеме (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

Садржи дефиницију шеме за нови тип картице.

Белешка

Уверите се да је вредност ID-а за тип картице већа од 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>

Команда (new_commands8db43275-0291-401d-923a-90a6c373cc18)

Датотека садржи команду за картицу радње.

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

Када извршите команду, команда се позива преко дефинисаног RibbonDiff у цустомизатион.xмл ентитета АцтионЦард .

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

Икона (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

Датотека садржи икону која се користи за картицу.

2. корак: Израда решења (ExtPkgDeployer.sln)

Отворите командну линију (cmd).
Идите на основну фасциклу. C:\<directory>\RACards Extensibility Example\RACards Extensibility Example\ExtPkgDeployer\PkgFolder
Извршите команду за израду решења. msbuild ExtPkgDeployer.sln

Изградња је успешна, и можете видети да су испод <folder>\ExtPkgDeployer\bin\Debug, и PkgFolder ExtPkgDeployer.dll генерисани.

3. корак: Увоз пакета помоћу алатке Package Deployer

Копирајте PkgFolder и ExtPkgDeployer.dll из фасцикле <folder>\ExtPkgDeployer\bin\Debug и налепите га на <PackageDeployerToolLocation>\tools локацију.
Покрените алат тако што ћете двапут кликнути на фасциклу PackageDeployer.exe у којој сте сачували алат за деплоиер пакета.
На уводном екрану Package Deployer алата изаберите Настави.
На екрану за потврду идентитета, наведите детаље за потврду идентитета да бисте се повезали са инстанцом услуге Dynamics 365 Sales на коју желите да примените пакет. Ако имате више организација и желите да изаберете организацију у којој ћете применити пакет Unified Service Desk, потврдите избор у пољу за потврду „Прикажи листу доступних организација“. Изаберите Пријава.
На следећем екрану приказане су детаљне информације о изабраном пакету и ставкама које ће бити инсталиране на инстанци услуге Dynamics 365 Sales. Прегледајте информације и изаберите Следећи.
Екран Спреман за инсталацију приказује пакет изабран за примену и име организације Дyнамицс 365 Салес у коју ће бити распоређен. Прегледајте информације и изаберите Следећи.
На следећем екрану приказан је status провере ваљаности пакета изабраног за примену. Након што се валидација успешно заврши, изаберите Следећи .
На следећој страници приказан је status примене пакета. Кликните на дугме Даље.
На следећем екрану су приказани име и информације о пакету који сте управо применили. Прегледајте информације и изаберите Заврши да бисте изашли из алатке Package Deployer .

Након што примените пакет, креира се нови тип картица са ИД - 2183dfc0-3c1c-45b7-a331-1943880c25c6, који је дефинисан у шеми (неw_цардтyпе_сцхемаxмл 9dd7e039-33a1-4778-9972-66536dc5e829).

4. корак: Потврда новог типа картице

Проверите тип картице са ID-ом „2183dfc0-3c1c-45b7-a331-1943880c25c6“. Пошаљите захтев GET методи.

Захтев

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

Одговор

{
"@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. корак: Креирање картице радње за нови тип картице помоћу Web API-ја

Креирајте картицу радње за нови тип картице креиран помоћу алатке Package Deployer. Пошаљите захтев POST методи.

Request

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)

Белешка

Отворите конзолу претраживача и покрените команду,да sessionStorage.clear(); обришете кеш меморију сесије.

6. корак: Потврда нове прилагођене картице

Можете да проверите да су прилагођене картице креиране у вашој организацији као крајњи корисника и као администратор.

Као крајњи корисник

Пријавите се на Дyнамицс 365 Салес.
У Помоћник секцији можете видети креирану акцију картица.

Као администратор

Пријавите се на Дyнамицс 365 Салес и идите на < ДИЦТ__Чвориште за продају > Салес Хуб апликацију.
Идите на Промени област и изаберите Салес Инсигхтс сеттингс.
На ситемап-у изаберите Инсигхтс Картице ундер Помоћник да бисте отишли на Управљање увидом Картице паге.
На страници Управљање увидом Картице видите опцију за омогућавање креираних прилагођених акција Картице у вашој организацији.

Да бисте сазнали више о томе како да омогућите Картице, погледајте Укључивање или искључивање увида Картице.

Не можете да пронађете опције у апликацији?

Постоје три могућности:

Немате потребну лиценцу или улогу. Проверите одељак Захтеви за лиценцу и улогу на врху ове странице.
Администратор није укључио функцију.
Ваша организација користи прилагођену апликацију. Проверите са администратором који су тачни кораци. Кораци описани у овом чланку специфични су за унапред припремљено чвориште за продају и апликацију Sales Professional.

Креирајте прилагођене Картице у Помоћник

Конфигуришите Помоћник

Водите комуникацију са клијентима са Помоћник

Делите путем

Пример: Проширени тип картице помоћника (прилагођена картица)

Захтеви за лиценцу и улогу

Креирање прилагођене картице радње

Предуслови

1. корак: Преузимање пробног решења проширеног типа картице помоћника

Дефиниција шеме (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

Команда (new_commands8db43275-0291-401d-923a-90a6c373cc18)

Икона (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

2. корак: Израда решења (ExtPkgDeployer.sln)

3. корак: Увоз пакета помоћу алатке Package Deployer

4. корак: Потврда новог типа картице

Захтев

Одговор

5. корак: Креирање картице радње за нови тип картице помоћу Web API-ја

Request

Response

6. корак: Потврда нове прилагођене картице

Не можете да пронађете опције у апликацији?

Повратне информације

Додатни ресурси

Делите путем

Пример: Проширени тип картице помоћника (прилагођена картица)

Захтеви за лиценцу и улогу

Креирање прилагођене картице радње

Предуслови

1. корак: Преузимање пробног решења проширеног типа картице помоћника

Дефиниција шеме (new_cardtype_schemaxml9dd7e039-33a1-4778-9972-66536dc5e829)

Команда (new_commands8db43275-0291-401d-923a-90a6c373cc18)

Икона (new_msicon6aa7c568-4830-4da6-89f9-18a8fd9c2285)

2. корак: Израда решења (ExtPkgDeployer.sln)

3. корак: Увоз пакета помоћу алатке Package Deployer

4. корак: Потврда новог типа картице

Захтев

Одговор

5. корак: Креирање картице радње за нови тип картице помоћу Web API-ја

Request

Response

6. корак: Потврда нове прилагођене картице

Не можете да пронађете опције у апликацији?

Сродне информације

Повратне информације

Додатни ресурси