openForm (referenca klijentskog API-ja)

Otvara obrazac entiteta ili obrazac za brzo stvaranje.

Napomena

Da biste glavni obrazac otvorili kao dijaloški okvir, koristite metodu navigateTo . Dodatne informacije: Otvaranje glavnog obrasca u dijaloškom okviru pomoću klijentskog API-ja

Sintaksa

Xrm.Navigation.openForm(entityFormOptions, formParameters).then(successCallback, errorCallback);

Parametara

Ime	Tip	Obvezno	Opis
entityFormOptions	Objekt	Da	Mogućnosti obrasca za otvaranje obrasca. Prikaz objekta entityFormOptions
formParameters	Objekt	Ne	Objekt rječnika koji obrascu prosljeđuje dodatne parametre. Nevažeći parametri uzrokovat će pogrešku. Informacije o proslijeđenju parametara u obrazac potražite u člancima Postavljanje vrijednosti stupaca pomoću parametara proslijeđenih u obrazac i Konfiguriranje obrasca za prihvaćanje prilagođenih parametara niza upita.
successCallback	Function	Ne	Funkcija koja se izvršava prilikom spremanja zapisa u obrazac za brzo stvaranje. Ova funkcija je proslijeđena kao parametar. Objekt ima polje sa savedEntityReference sljedećim svojstvima radi prepoznavanja prikazanih ili stvorenih zapisa: - entityType: Logički naziv tablice. - id: Prikaz niza GUID vrijednosti za zapis. - name: vrijednost primarnog stupca prikazanog ili stvorenog zapisa. NAPOMENA: - Funkcija successCallback se ne izvršava kada otvorite obrazac za postojeći ili novi zapis. - Funkcija successCallback se izvršava samo kada spremite zapis u obrazac za brzo stvaranje koji je otvoren pomoću metode openForm.
errorCallback	Function	Ne	Funkcija koja se izvršava kada operacija ne uspije.

entityFormOptions objekt

Objekt sadrži sljedeće vrijednosti:

Ime	Tip	Obvezno	Opis
entityName	String	Da	Logički naziv tablice za prikaz obrasca.
entityId	String	Ne	ID zapisa tablice za prikaz obrasca.
formId	String	Ne	ID instance obrasca koja će se prikazati.
cmdbar	Booleova vrijednost	Ne	Označava treba li prikazati naredbenu traku. Ako ne navedete ovaj parametar, naredbena traka prikazuje se prema zadanim postavkama. Potrebno je prosud'eti openInNewWindow parametar kao true.
createFromEntity	Pretraživanje	Ne	Određuje zapis koji će navesti zadane vrijednosti na temelju vrijednosti mapiranih stupaca. Objekt s vrijednostima ima sljedeća svojstva niza: entityType, i id(neobavezno name ).
openInNewWindow	Booleova vrijednost	Ne	Označava treba li obrazac prikazati u novom prozoru ili na novoj kartici. true Ako navedete i ne navedete vrijednosti za visinu ili širinu, obrazac će se prikazati na novoj kartici. Otvaranjem obrasca u novom prozoru ili na novoj kartici prikaz obrasca spor je u usporedbi s otvaranjem obrasca na istoj kartici. Umjesto toga razmislite o otvaranju obrasca u glavnom dijaloškom okviru obrasca. Ovo svojstvo trenutno nije podržano za obrasce za brzo stvaranje jer se ne može otvoriti u novom prozoru ili kartici.
height	Broj	Ne	Visina prozora obrasca koji će se prikazati u pikselima. Potrebno je prosud'eti openInNewWindow parametar kao true.
width	Broj	Ne	Širina prozora obrasca koji će se prikazati u pikselima. Potrebno je prosud'eti openInNewWindow parametar kao true.
navbar	String	Ne	Kontrolira hoće li se navigacijska traka prikazati i je li navigacija aplikacijom dostupna pomoću područja i potpodručja definiranih na karti web-mjesta. Valjane su vrijednosti: on, off, ili entity. Zahtijeva prosli program openInNewWindow parametar kao istinit. - on: Prikazana je navigacijska traka. To je zadano ponašanje ako se ne koristi parametar navigacijske trake. - off: Navigacijska traka se ne prikazuje. Ljudi se mogu kretati pomoću drugih elemenata korisničkog sučelja ili gumba za povratak i naprijed. - entity: Na obrascu su dostupne samo mogućnosti navigacije za povezane tablice. Nakon navigacije do povezane tablice na navigacijskoj traci prikazuje se gumb natrag da bi se omogućio povratak na izvorni zapis.
relationship	Objekt	Ne	Definirajte objekt odnosa da biste prikazali povezane zapise na obrascu. Prikaz objekta odnosa
selectedStageId	String	Ne	ID odabrane faze u instanci poslovnog procesa.
useQuickCreateForm	Booleova vrijednost	Ne	Označava treba li otvoriti obrazac za brzo stvaranje. U tablici mora biti omogućena mogućnost Dopusti brzo stvaranje da bi se obrazac za brzo stvaranje prikazao, a u aplikaciju morate dodati i tablicu i obrazac za brzo stvaranje. Ako ne navedete vrijednost , useQuickCreateFormzadana će se vrijednost postaviti na false.

objekt relationship

Objekt sadrži sljedeće vrijednosti.

Ime	Tip	Opis
attributeName	String	Naziv stupca koji se koristi za odnos.
name	String	Naziv stupca koji se koristi za odnos.
navigationPropertyName	String	Naziv stupca koji se koristi za odnos.
relationshipType	Broj	Vrsta odnosa. Navedite jednu od sljedećih vrijednosti: - 0:OneToMany - 1:ManyToMany
roleType	Broj	Vrsta uloge u odnosu. Navedite jednu od sljedećih vrijednosti: - 1:referenciranje - 2:AssociationEntity

Primjedbe

Ovu metodu morate koristiti za otvaranje tablica ili brzog stvaranja obrazaca umjesto zastarjelih metoda Xrm.Utility.openEntityForm i Xrm.Utility.openQuickCreate .

Pomoću funkcije setActiveProcess prikažite određeni poslovni proces i postaviteActiveProcessInstance da biste prikazali određenu instancu poslovnog procesa na obrascu.

Primjeri

Prvi primjer: otvaranje obrasca za postojeći zapis

Sljedeći ogledni kod otvara obrazac kontakta radi prikaza postojećeg zapisa kontakta:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["entityId"] = "00aa00aa-bb11-cc22-dd33-44ee44ee44ee";

// Open the form.
Xrm.Navigation.openForm(entityFormOptions).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

Drugi primjer: otvaranje obrasca za novi zapis

Sljedeći ogledni kod otvara obrazac kontakta s unaprijed popunjenim vrijednostima radi stvaranja novog zapisa:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

Treći primjer: otvaranje obrasca za novi zapis (složeno pretraživanje)

Sljedeći ogledni kod otvara obrazac aktivnosti s unaprijed popunjenim vrijednostima (uključujući složeno pretraživanje) radi stvaranja novog zapisa:

var entityFormOptions = {};
entityFormOptions["entityName"] = "email";

// Set default values for the Contact form
var formParameters = {};
formParameters["subject"] = "Sample";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["regardingobjectid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["regardingobjectidname"] = "Admin user"; // Name of the user.
formParameters["regardingobjectidtype"] = "systemuser"; // Table name. 
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

Četvrti primjer: otvaranje obrasca za brzo stvaranje

Sljedeći ogledni kod otvara obrazac za brzo stvaranje kontakta s unaprijed popunjenim vrijednostima:

var entityFormOptions = {};
entityFormOptions["entityName"] = "contact";
entityFormOptions["useQuickCreateForm"] = true;

// Set default values for the Contact form
var formParameters = {};
formParameters["firstname"] = "Sample";
formParameters["lastname"] = "Contact";
formParameters["fullname"] = "Sample Contact";
formParameters["emailaddress1"] = "contact@adventure-works.com";
formParameters["jobtitle"] = "Sr. Marketing Manager";
formParameters["donotemail"] = "1";
formParameters["description"] = "Default values for this record were set programmatically.";

// Set lookup column
formParameters["preferredsystemuserid"] = "3493e403-fc0c-eb11-a813-002248e258e0"; // ID of the user.
formParameters["preferredsystemuseridname"] = "Admin user"; // Name of the user.
formParameters["preferredsystemuseridtype"] = "systemuser"; // Table name.
// End of set lookup column

// Open the form.
Xrm.Navigation.openForm(entityFormOptions, formParameters).then(
    function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    });

Povezani članci

Xrm.Navigation