Stvaranje prilagođenih poslovnih aplikacija i upravljanje njima u sustavu Customer Engagement pomoću koda

2025-05-12

Poslovne aplikacije u sustavu Dynamics 365 Customer Engagement modularne su namjenski izrađene aplikacije koje pružaju funkcije temeljene na ulogama relevantne za određeno područje rada. Ove aplikacije korisnicima olakšavaju brzo pronalaženje stvari koje trebaju raditi svaki dan pružajući jednostavno i intuitivno sučelje. Na primjer, poslovna aplikacija Sales pruža jednostavniju, manju kartu web-mjesta samo s odgovarajućim skupom obrazaca, prikaza, nadzornih ploča i tijekova procesa koji su relevantni za prodavače.

Administratori sustava i osobe za prilagodbu mogu korisnicima omogućiti pristup tim poslovnim aplikacijama pomoću sigurnosnih uloga; Korisnici mogu pristupiti samo onim aplikacijama za koje imaju dopuštenje.

Napomena

Prilagođene poslovne aplikacije u sustavu Dynamics 365 Customer Engagement iste su kao i aplikacije utemeljene na modelu u usluzi Power Apps; Oba su izgrađena na istoj osnovnoj platformi. Dodatne informacije: Što su aplikacije stvorene prema modelu?

Osim stvaranja prilagođenih poslovnih aplikacija pomoću dizajnera aplikacija, možete programski stvarati prilagođene poslovne aplikacije i upravljati njima u sustavu Dynamics 365 Customer Engagement (on-premises).

Važno

Ne morate pisati kod za izradu prilagođenih poslovnih aplikacija ako ne trebate! Dizajner aplikacija pruža jednostavnije i intuitivnije iskustvo za izradu prilagođenih poslovnih aplikacija bez potrebe za pisanjem koda pružajući informacijsku strukturu temeljenu na pločicama i pojednostavljeno sučelje. Pogledajte ovdje: Dizajniranje prilagođenih poslovnih aplikacija pomoću dizajnera aplikacija

Izrada prilagođene poslovne aplikacije uključuje sljedeće korake:

Stvorite instancu entiteta AppModule da biste definirali svoju aplikaciju i njezina svojstva.
Dodajte ili uklonite komponente u svoju aplikaciju, kao što su entitet, karta web-mjesta i druge komponente za vašu prilagođenu aplikaciju AddAppComponents pomoću radnji and RemoveAppComponents .
Pomoću ValidateApp funkcije provjerite ima li u aplikaciji potrebnih komponenti koje nedostaju.
Objavite svoju aplikaciju.
Povežite odgovarajuće sigurnosne uloge s prilagođenom poslovnom aplikacijom da biste omogućili pristup korisnicima.

Izrada poslovne aplikacije i definiranje njezinih svojstava

Da biste mogli stvoriti aplikaciju, morate imati sigurnosnu ulogu administratora sustava ili osobe za prilagodbu sustava ili ekvivalentne dozvole.

Da biste stvorili aplikaciju, morate navesti barem sljedeća svojstva:

naziv: jedinstven za vašu aplikaciju
uniquename: može se razlikovati od naziva vaše aplikacije i može sadržavati samo engleske znakove i brojeve. Prilikom stvaranja ove aplikacije naziv se automatski prefiksom izdavača rješenja (na primjer 'new_').
webresourceid: ID web-resursa koji želite postaviti kao ikonu slike za svoju aplikaciju. Sustav vam pruža zadani web-resurs (ID: 953b9fac-1e5e-e611-80d6-00155ded156f) koji možete koristiti kao ikonu za svoju aplikaciju.

Sljedeći zahtjev web-API-ja stvara vrstu objedinjenog sučelja aplikacije:

POST [Organization URI]/api/data/v9.1/appmodules HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
    "name": "SDKTestApp",
    "uniquename":"SDKTestApp",
    "webresourceid":"953b9fac-1e5e-e611-80d6-00155ded156f"    
}

Zaglavlje odgovora OData-EntityId sadrži URI stvorene aplikacije.

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

Dodavanje ili uklanjanje komponenti iz poslovne aplikacije

Možete dodati ili ukloniti komponente u aplikaciji kao što su karta web-mjesta, entitet, nadzorna ploča, tijekovi poslovnog procesa, prikazi i obrasci koje želite uključiti u svoju poslovnu aplikaciju. Detaljne informacije o komponentama koje se mogu dodati u poslovnu aplikaciju potražite u članku Dodavanje ili uređivanje komponenti aplikacije u dizajneru aplikacija.

Upotrijebite AddAppComponents radnju ili AddAppComponentsRequest poruku da biste dodali komponente u svoju poslovnu aplikaciju. Akcija zahtijeva da navedete sljedeće:

AppId: ID aplikacije u koju želite dodati komponente
Komponente Zbirka komponenti koje treba dodati. Morate navesti ID i vrstu entiteta komponente koju želite dodati. Popis vrsta entiteta u web-API-ju sustava Customer Engagement potražite u odjeljku Web API Entity Type Reference.

Sljedeći zahtjev za web-API dodaje prikaz (savedquery) i obrazac (systemform) u vašu aplikaciju:

POST [Organization URI]/api/data/v9.1/AddAppComponents HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
	"AppId":"00001111-aaaa-2222-bbbb-3333cccc4444",
	"Components":[
		{
			"savedqueryid":"00000000-0000-0000-00aa-000000666000",
			"@odata.type":"Microsoft.Dynamics.CRM.savedquery"
		},
		{
			"formid":"c9e7ec2d-efca-4e4c-b3e3-f63c4bba5e4b",
			"@odata.type":"Microsoft.Dynamics.CRM.systemform"
		}
	]
}

Da biste uklonili komponentu iz aplikacije, upotrijebite RemoveAppComponents radnju ili RemoveAppComponentsRequest poruku. Ova akcija uzima isti skup parametara kao i akcija AddAppComponents .

Sljedeći zahtjev za web-API uklanja vlasnički pregled (spremljeni upit) iz vaše aplikacije:

POST [Organization URI]/api/data/v9.1/RemoveAppComponents HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{
	"AppId":"00001111-aaaa-2222-bbbb-3333cccc4444",
	"Components":[
		{
			"savedqueryid":"00000000-0000-0000-00aa-000000666000",
			"@odata.type":"Microsoft.Dynamics.CRM.savedquery"
		}
	]
}

Provjera valjanosti poslovne aplikacije

Provjera valjanosti aplikacije uključuje provjeru svih ovisnosti za komponente koje ste dodali u poslovnu aplikaciju kako biste bili sigurni da vaša aplikacija radi dobro. To je isto kao i klik na Provjeri valjanost u dizajneru aplikacija. Dodatne informacije: Provjera valjanosti aplikacije

Upotrijebite funkciju ValidateApp ValidateAppRequest ili poruku za provjeru valjanosti aplikacije. Sljedeći zahtjev za web-API pokazuje kako provjeriti valjanost poslovne aplikacije s ID-om: 00001111-aaaa-2222-bbbb-3333cccc4444:

GET [Organization URI]/api/data/v9.1/ValidateApp(AppModuleId=00001111-aaaa-2222-bbbb-3333cccc4444)

Ako nema pogrešaka u provjeri valjanosti, odgovor je sljedeći:

HTTP/1.1 200 OK
OData-Version: 4.0

{
    "@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.ValidateAppResponse",
    "AppValidationResponse": {
        "ValidationSuccess": true,
        "ValidationIssueList": []
    }
}

Ako postoje problemi s provjerom valjanosti u vašoj aplikaciji, odgovor prikazuje pogreške/upozorenja u zbirci ValidationIssueList :

HTTP/1.1 200 OK
OData-Version: 4.0

{
    "@odata.context": "[Organization URI]/api/data/v9.1/$metadata#Microsoft.Dynamics.CRM.ValidateAppResponse",
    "AppValidationResponse": {
        "ValidationSuccess": false,
        "ValidationIssueList": [
            {
                "ErrorType": "Error",
                "Message": "App does not contain Site Map",
                "DisplayName": null,
                "ComponentId": "00000000-0000-0000-0000-000000000000",
                "ComponentType": 0,
                "ComponentSubType": 0,
                "ParentEntityId": "00000000-0000-0000-0000-000000000000",
                "ParentEntityName": null,
                "CRMErrorCode": -2147155684,
                "RequiredComponents": []
            },
            {
                "ErrorType": "Warning",
                "Message": "Account doesn’t reference a form or view. App users will see all forms and views.",
                "DisplayName": null,
                "ComponentId": "00000000-0000-0000-0000-000000000000",
                "ComponentType": 0,
                "ComponentSubType": 0,
                "ParentEntityId": "00000000-0000-0000-0000-000000000000",
                "ParentEntityName": null,
                "CRMErrorCode": -2147155691,
                "RequiredComponents": []
            }
        ]
    }
}

Objavite svoju poslovnu aplikaciju

Nakon što dodate potrebne komponente u prilagođenu poslovnu aplikaciju i potvrdite je, morate je objaviti da biste je učinili dostupnom korisnicima.

Upotrijebite PublishXml radnju ili PublishXmlRequest poruku da biste objavili prilagođenu poslovnu aplikaciju. Sljedeći zahtjev pokazuje kako objaviti poslovnu aplikaciju s ID-om: 00001111-aaaa-2222-bbbb-3333cccc4444:

POST [Organization URI]/api/data/v9.1/PublishXml HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{  
  "ParameterXml":"<importexportxml><appmodules><appmodule>00001111-aaaa-2222-bbbb-3333cccc4444</appmodule></appmodules></importexportxml>"
}

Upravljanje pristupom poslovnoj aplikaciji pomoću sigurnosnih uloga

Da biste korisnicima omogućili pristup svojim aplikacijama kako bi im mogli pristupiti iz područja Postavke>Moje aplikacije ili početne stranice sustava Dynamics 365 Customer Engagement (on-premises), možete povezati sigurnosne uloge sa svojim poslovnim aplikacijama. Korisnici dodijeljeni povezanim sigurnosnim ulogama i mogu vidjeti i koristiti vaše poslovne aplikacije u sustavu Customer Engagement.

Upotrijebite svojstvo appmoduleroles_association navigacije entiteta AppModule entiteta da biste poslovnu aplikaciju povezali sa sigurnosnom ulogom. Sljedeći zahtjev pokazuje kako povezati poslovnu aplikaciju sa sigurnosnom ulogom:

POST [Organization URI]/api/data/v9.1/appmodules(00001111-aaaa-2222-bbbb-3333cccc4444)appmoduleroles_association/$ref HTTP/1.1
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0
Accept: application/json

{  
  "@odata.id":"[Organization URI]/api/data/v9.1/roles(<roleId>)"
}

Da biste prekinuli povezanost sigurnosne uloge s poslovnom aplikacijom, koristite zahtjev DELETE s istim svojstvom navigacije. Na primjer:

DELETE [Organization URI]/api/data/v9.1/appmodules(00001111-aaaa-2222-bbbb-3333cccc4444)/appmoduleroles_association/$ref?$id=[Organization URI]/api/data/v9.1/roles(<roleId)

Upravljanje poslovnim aplikacijama i njihovim komponentama

Ovaj odjeljak sadrži informacije o dohvaćanju aplikacija, ažuriranju svojstava aplikacije, dohvaćanju komponenti aplikacije i brisanju aplikacija.

Dohvaćanje objavljenih aplikacija

Da biste dohvatili objavljene aplikacije, upotrijebite sljedeći zahtjev:

GET [Organization URI]/api/data/v9.1/appmodules?$select=name

Dohvaćanje neobjavljenih aplikacija

Za dohvaćanje neobjavljenih aplikacija koristite funkciju RetrieveUnpublishedMultiple . Na primjer:

GET [Organization URI]/api/data/v9.1/appmodules/Microsoft.Dynamics.CRM.RetrieveUnpublishedMultiple()?$select=name

Dohvaćanje komponenti u objavljenoj poslovnoj aplikaciji

Da biste dohvatili komponente aplikacije za poslovnu aplikaciju, upotrijebite funkciju RetrieveAppComponents RetrieveAppComponentsRequest ili poruku. Na primjer:

GET [Organization URI]/api/data/v9.1/RetrieveAppComponents(AppModuleId=00001111-aaaa-2222-bbbb-3333cccc4444)

Dohvaćanje sigurnosnih uloga povezanih s objavljenom poslovnom aplikacijom

Da biste dohvatili sigurnosne uloge povezane s vašom poslovnom aplikacijom, upotrijebite mogućnost upita $expand sustava sa svojstvom appmoduleroles_association navigacije. Na primjer, evo zahtjeva za dohvaćanje svih sigurnosnih uloga povezanih s poslovnom aplikacijom s ID-om: 00001111-aaaa-2222-bbbb-3333cccc4444:

GET [Organization URI]/api/data/v9.1/appmodules(00001111-aaaa-2222-bbbb-3333cccc4444)?$expand=appmoduleroles_association&$select=name,appmoduleroles_association

Brisanje poslovnih aplikacija

Upotrijebite zahtjev DELETE da biste izbrisali poslovnu aplikaciju. Na primjer:

DELETE [Organization URI]/api/data/v9.1/appmodules(00001111-aaaa-2222-bbbb-3333cccc4444)

Podrška za klijentski API za poslovne aplikacije

Za rad s poslovnim aplikacijama možete koristiti sljedeće klijentske API-je:

Pogledajte

Dizajniranje prilagođenih poslovnih aplikacija pomoću dizajnera aplikacija