openForm (sklic na API odjemalca)

Odpre obrazec entitete ali obrazec za hitro ustvarjanje.

opomba,

Če želite glavni obrazec odpreti kot pogovorno okno, uporabite metodo navigateTo . Več informacij: Odprite glavni obrazec v pogovornem oknu z API-jem odjemalca

Sintaksa

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

Parametri

Ime	Vnesi	Zahtevano	Opis
entityFormOptions	Predmet	Da	Možnosti obrazca za odpiranje obrazca. Ogled predmeta entityFormOptions
formParameters	Predmet	Ne	Predmet slovarja, ki obrazcu posreduje dodatne parametre. Neveljavni parametri povzročijo napako. Če želite več informacij o podajanju parametrov obrazcu, glejte Nastavitev vrednosti stolpcev s parametri, posredovanih obrazcu, in Konfiguracija obrazca za sprejemanje parametrov poizvedbe po meri.
successCallback	Function	Ne	Funkcija, ki se izvede, ko je zapis shranjen v obrazcu za hitro ustvarjanje. Ta funkcija sprejme predmet kot parameter. Predmet ima matriko s savedEntityReference temi lastnostmi za prepoznavanje prikazanih ali ustvarjenih zapisov: - entityType: Logično ime tabele. - id: Predstavitev niza vrednosti GUID za zapis. - name: Vrednost primarnega stolpca zapisa, ki je prikazan ali ustvarjen. OPOMBA: – Funkcija successCallback se ne izvede, ko odprete obrazec za obstoječi ali nov zapis. – Funkcija successCallback se izvede le, ko shranite zapis v obrazec za hitro ustvarjanje, ki je bil odprt z metodo openForm.
errorCallback	Function	Ne	Funkcija, ki se izvede, ko operacija ne uspe.

entityFormOptions object

Predmet vsebuje te vrednosti:

Ime	Vnesi	Zahtevano	Opis
entityName	String	Da	Logično ime tabele, za katero želite prikazati obrazec.
entityId	String	Ne	ID zapisa tabele, za katero želite prikazati obrazec.
formId	String	Ne	ID primerka obrazca, ki bo prikazan.
cmdbar	Bool	Ne	Označuje, ali naj se prikaže ukazna vrstica. Če tega parametra ne navedete, je ukazna vrstica privzeto prikazana. Parameter je treba openInNewWindow podati kot »true«.
createFromEntity	Iskanje	Ne	Določi zapis, ki zagotavlja privzete vrednosti glede na preslikane vrednosti stolpcev. Predmet za iskanje ima te lastnosti niza: entityType, idin name (izbirno).
openInNewWindow	Bool	Ne	Označuje, ali naj bo obrazec prikazan v novem oknu ali novem zavihku. true Če določite in ne določite vrednosti za višino ali širino, se obrazec prikaže na novem zavihku. Če odprete obrazec v novem oknu ali na novem zavihku, je upodabljanje obrazca počasno v primerjavi z odpiranjem obrazca na istem zavihku; namesto tega raje poskusite odpreti obrazec v glavnem pogovornem oknu obrazca. Ta lastnost trenutno ni podprta za obrazce za hitro ustvarjanje, ker jih ni mogoče odpreti v novem oknu ali zavihku.
height	Število	Ne	Višina okna obrazca, ki bo prikazana v slikovnih pikah. Parameter je treba openInNewWindow podati kot »true«.
width	Število	Ne	Širina okna obrazca, ki bo prikazana v slikovnih pikah. Parameter je treba openInNewWindow podati kot »true«.
navbar	String	Ne	Nadzira, ali je prikazana vrstica za krmarjenje in ali je na voljo krmarjenje po aplikaciji z uporabo območij in podobmočij, določenih na zemljevidu mesta. Veljavne vrednosti so: on, offali entity. Zahteva, da parameter openInNewWindow poda kot »true«. - on: Prikaže se vrstica za krmarjenje. To je privzeto vedenje, če parameter vrstice za krmarjenje ni uporabljen. - off: Vrstica za krmarjenje ni prikazana. Ljudje lahko krmarijo z drugimi elementi uporabniškega vmesnika ali gumbi za nazaj in naprej. - entity: V obrazcu so na voljo le možnosti krmarjenja za sorodne tabele. Po krmarjenju do povezane tabele se v vrstici za krmarjenje prikaže gumb za vračanje nazaj, ki omogoča vrnitev v izvirni zapis.
relationship	Predmet	Ne	Določite predmet relacije, če želite prikazati zapise v relaciji v obrazcu. Ogled predmeta relacije
selectedStageId	String	Ne	ID izbrane stopnje v primerku poslovnega procesa.
useQuickCreateForm	Bool	Ne	Označuje, ali je treba odpreti obrazec za hitro ustvarjanje. V tabeli mora biti omogočena možnost »Dovoli hitro ustvarjanje«, da je obrazec za hitro ustvarjanje prikazan, v program pa morate dodati tudi tabelo in obrazec za hitro ustvarjanje. Če ne določite vrednosti , je useQuickCreateFormprivzeta vrednost nastavljena na false.

predmet relacije

Predmet ima te vrednosti.

Ime	Vnesi	Opis
attributeName	String	Ime stolpca, uporabljenega za relacijo.
name	String	Ime stolpca, uporabljenega za relacijo.
navigationPropertyName	String	Ime stolpca, uporabljenega za relacijo.
relationshipType	Število	Vrsta razmerja. Navedite eno od teh vrednosti: - 0:OneToMany - 1:ManyToMany
roleType	Število	Vrsta vloge v relaciji. Navedite eno od teh vrednosti: - 1:Sklicevanje - 2:AssociationEntity

Pripombe

Ta način morate uporabiti za odpiranje tabel ali obrazcev za hitro ustvarjanje namesto zastaranih metod Xrm.Utility.openEntityForm in Xrm.Utility.openQuickCreate .

Uporabite setActiveProcess za prikaz določenega poslovnega procesa in nastaviteActiveProcessInstance za prikaz določenega primerka poslovnega procesa v obrazcu.

Primeri

1. primer: Odpiranje obrazca za obstoječi zapis

Ta vzorčna koda odpre obrazec stika za prikaz obstoječega zapisa stika:

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

2. primer: Odpiranje obrazca za nov zapis

Ta vzorčna koda odpre obrazec stika z nekaterimi vnaprej izpolnjenimi vrednostmi, da ustvari nov zapis:

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

3. primer: Odpiranje obrazca za nov zapis (kompleksno iskanje)

Ta vzorčna koda odpre obrazec dejavnosti z nekaterimi vnaprej izpolnjenimi vrednostmi (vključno z zapletenim iskanjem), da ustvarite nov zapis:

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

4. primer: Odpiranje obrazca za hitro ustvarjanje

Ta vzorčna koda odpre obrazec za hitro ustvarjanje stika z nekaterimi vnaprej izpolnjenimi vrednostmi:

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

Xrm.Navigation