openForm (kliento API nuoroda)

Atidaro objekto formą arba sparčiojo kūrimo formą.

Pastaba.

Norėdami atidaryti pagrindinę formą kaip dialogo langą, naudokite metodą navigateTo . Daugiau informacijos: Atidarykite pagrindinę formą dialogo lange naudodami kliento API

Sintaksė

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

Parametrai

Pavadinimą	Rūšis	Privalomas	Apibūdinimas
`entityFormOptions`	Objektas	Taip	Formos parinktys formai atidaryti. Peržiūrėti entityFormOptions objektą
`formParameters`	Objektas	No	Žodyno objektas, perduodantis formai papildomus parametrus. Neteisingi parametrai sukels klaidą. Informacijos apie parametrų rodymą formoje žr . Stulpelių reikšmių nustatymas naudojant į formą perduotus parametrus ir Formos konfigūravimas, kad būtų priimti pasirinktiniai užklausų eilutės parametrai.
`successCallback`	Funkcija	No	Funkcija, vykdoma įrašant įrašą sparčiojo kūrimo formoje. Ši funkcija perduodama kaip parametras objektas. Objekte yra masyvas `savedEntityReference` su šiomis ypatybėmis, kad būtų galima identifikuoti rodomą (-us) arba sukurtą (-us) įrašą (-us): - `entityType`: Loginis lentelės pavadinimas. - `id`: įrašo GUID reikšmės eilutės atvaizdavimas. - `name`: rodoma arba kuriamo įrašo pirminė stulpelio reikšmė. PASTABA: - Kai `successCallback` atidarote esamo arba naujo įrašo formą, funkcija nevykdoma. - Funkcija `successCallback` vykdoma tik tada, kai įrašote įrašą greito kūrimo formoje, kuri buvo atidaryta naudojant metodą openForm.
`errorCallback`	Funkcija	No	Funkcija, kurią reikia vykdyti, kai operacija nepavyksta.

entityFormOptions objektas

Objekte yra šios reikšmės:

Pavadinimą	Rūšis	Privalomas	Apibūdinimas
`entityName`	String	Taip	Loginis lentelės pavadinimas, skirtas formai rodyti.
`entityId`	String	No	Lentelės įrašo ID, skirtas formai rodyti.
`formId`	String	No	Rodytinas formos egzemplioriaus ID.
`cmdbar`	Bulio logika	No	Nurodo, ar rodyti komandų juostą. Jei nenurodysite šio parametro, komandų juosta bus rodoma pagal numatytuosius nustatymus. Reikia perduoti `openInNewWindow` parametrą kaip teisingą.
`createFromEntity`	Peržvalga	No	Nurodo įrašą, kuris pateiks numatytąsias reikšmes, pagrįstas susietų stulpelių reikšmėmis. Peržvalgos objektas turi šias eilutės ypatybes: `entityType`, `id`ir `name` (pasirinktinai).
`openInNewWindow`	Bulio logika	No	Nurodo, ar rodyti formą naujame lange, ar naujame skirtuke. Jei nurodysite `true` ir nenurodysite aukščio ar pločio reikšmių, forma bus rodoma naujame skirtuke. Atidarius formą naujame lange arba naujame skirtuke formos vaizdas generuojamas lėtai, palyginti su formos atidarymu tame pačiame skirtuke; verčiau atidarykite formą pagrindinės formos dialogo lange. Sparčiojo kūrimo formos šiuo metu nepalaiko šios ypatybės, nes jos negalima atidaryti naujame lange arba skirtuke.
`height`	Skaičius	No	Formos lango aukštis, kuris bus rodomas pikseliais. Reikia perduoti `openInNewWindow` parametrą kaip teisingą.
`width`	Skaičius	No	Formos lango plotis, rodomas pikseliais. Reikia perduoti `openInNewWindow` parametrą kaip teisingą.
`navbar`	String	No	Kontroliuoja, ar rodoma naršymo juosta ir ar galima naršyti taikomosioje programoje, naudojant svetainės struktūroje apibrėžtas sritis ir parajonius. Leistinos reikšmės yra: `on`, `off`arba `entity`. Būtina perduoti openInNewWindow parametrą kaip teisingą. - `on`: rodoma naršymo juosta. Tai yra numatytasis veikimas, jei naršymo juostos parametras nenaudojamas. - `off`: naršymo juosta nerodoma. Žmonės gali naršyti naudodami kitus vartotojo sąsajos elementus arba mygtukus atgal ir pirmyn. - `entity`: formoje galimos tik susijusių lentelių naršymo parinktys. Naršant į susijusią lentelę, naršymo juostoje rodomas mygtukas Atgal, kad būtų galima grįžti į pradinį įrašą.
`relationship`	Objektas	No	Apibrėžkite ryšio objektą, kad formoje būtų rodomi susiję įrašai. Peržiūrėti ryšio objektą
`selectedStageId`	String	No	Verslo proceso egzemplioriaus pasirinkto etapo ID.
`useQuickCreateForm`	Bulio logika	No	Nurodo, ar atidaryti sparčiojo kūrimo formą. Kad būtų rodoma sparčiojo kūrimo forma, lentelėje turi būti įgalinta parinktis Leisti spartųjį kūrimą , be to, į taikomąją programą turite įtraukti lentelę ir sparčiojo kūrimo formą. Jei nenurodysite `useQuickCreateForm`reikšmės , numatytoji reikšmė bus nustatyta kaip `false`.

ryšio objektas

Objektas turi šias reikšmes.

Pavadinimą	Rūšis	Apibūdinimas
`attributeName`	String	Ryšio stulpelio pavadinimas.
`name`	String	Ryšio stulpelio pavadinimas.
`navigationPropertyName`	String	Ryšio stulpelio pavadinimas.
`relationshipType`	Skaičius	Santykių tipas. Nurodykite vieną iš šių reikšmių: - 0:OneToMany - 1:ManyToMany
`roleType`	Skaičius	Vaidmens tipas ryšyje. Nurodykite vieną iš šių reikšmių: - 1: nuoroda - 2:AssociationEntity

Pastabos

Turite naudoti šį metodą norėdami atidaryti lentelę arba sparčiojo kūrimo formas, o ne pasenusius "Xrm.Utility.openEntityForm " ir "Xrm.Utility.openQuickCreate" metodus.

Naudokite setActiveProcess norėdami parodyti konkretų verslo procesą ir setActiveProcessInstance , kad formoje būtų rodomas konkretus verslo proceso egzempliorius.

Pavyzdžiai

1 pavyzdys: atidaryti esamo įrašo formą

Šis kodo pavyzdys atidaro kontakto formą, kad būtų rodomas esamas kontakto įrašas:

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 pavyzdys: naujo įrašo formos atidarymas

Šis kodo pavyzdys atidaro kontaktų formą su iš anksto įvestomis reikšmėmis, kad sukurtų naują įrašą:

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 pavyzdys: naujo įrašo formos atidarymas (sudėtinga peržvalga)

Toliau pateiktame kodo pavyzdyje atidaroma veiklos forma su iš anksto įvestomis reikšmėmis (įskaitant sudėtingą peržvalgą), kad būtų galima sukurti naują įrašą:

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 pavyzdys: atidaryti sparčiojo kūrimo formą

Šis kodo pavyzdys atidaro sparčiojo kontakto kūrimo formą su iš anksto įvestomis reikšmėmis:

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

Xrm.Navigation

Atsiliepimus

Ar šis puslapis buvo naudingas?

Last updated on 2025-10-04