openForm (odkaz na klientske rozhranie API)

Otvorí formulár entity alebo formulár rýchleho vytvorenia.

Poznámka

Ak chcete otvoriť hlavný formulár ako dialógové okno, použite namiesto toho metódu navigateTo . Viac informácií: Otvorte hlavný formulár v dialógovom okne pomocou klientskeho API

Syntax

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

Parametre

Meno	Typ	Požaduje sa	Popis
`entityFormOptions`	Namietať	Áno	Možnosti formulára na otvorenie formulára. Zobraziť objekt entityFormOptions
`formParameters`	Namietať	Nie	Objekt slovníka, ktorý odovzdáva formuláru ďalšie parametre. Neplatné parametre spôsobia chybu. Informácie o prenose parametrov do formulára nájdete v téme Nastavenie hodnôt stĺpcov pomocou parametrov odovzdaných formuláru a Konfigurácia formulára na prijímanie vlastných parametrov reťazca dotazu.
`successCallback`	Function	Nie	Funkcia, ktorá sa vykoná po uložení záznamu vo formulári rýchleho vytvorenia. Táto funkcia sa odovzdá objektu ako parameter. Objekt má `savedEntityReference` pole s nasledujúcimi vlastnosťami na identifikáciu zobrazených alebo vytvorených záznamov: - `entityType`: Logický názov tabuľky. - `id`: Vyjadrenie reťazca hodnoty GUID pre záznam. - `name`: Hodnota primárneho stĺpca záznamu zobrazeného alebo vytvoreného. POZNÁMKA: – Funkcia sa `successCallback` nevykoná, keď otvoríte formulár pre existujúci alebo nový záznam. – Táto funkcia sa `successCallback` spustí iba vtedy, keď uložíte záznam vo formulári rýchleho vytvorenia, ktorý bol otvorený pomocou metódy openForm.
`errorCallback`	Function	Nie	Funkcia, ktorá sa vykoná v prípade zlyhania operácie.

objekt entityFormOptions

Objekt obsahuje nasledujúce hodnoty:

Meno	Typ	Požaduje sa	Popis
`entityName`	String	Áno	Logický názov tabuľky, pre ktorý sa má zobraziť formulár.
`entityId`	String	Nie	ID záznamu tabuľky, pre ktorý sa má zobraziť formulár.
`formId`	String	Nie	ID inštancie formulára, ktorá sa má zobraziť.
`cmdbar`	Bool	Nie	Označuje, či sa má zobraziť panel príkazov. Ak tento parameter nezadáte, predvolene sa zobrazí panel príkazov. Vyžaduje odovzdanie `openInNewWindow` parametra ako true.
`createFromEntity`	Vyhľadávanie	Nie	Určí záznam, ktorý bude poskytovať predvolené hodnoty na základe namapovaných hodnôt stĺpcov. Vyhľadávací objekt má nasledujúce vlastnosti String: `entityType`, `id`a `name` (voliteľné).
`openInNewWindow`	Bool	Nie	Udáva, či sa má zobraziť formulár v novom okne alebo na novej karte. Ak zadáte a nezadáte `true` hodnoty pre výšku alebo šírku, formulár sa zobrazí na novej karte. Otvorenie formulára v novom okne alebo na novej karte spôsobí pomalé vykresľovanie formulára v porovnaní s otvorením formulára na tej istej karte. Zvážte otvorenie formulára v hlavnom dialógovom okne formulára. Táto vlastnosť momentálne nie je podporovaná pre formuláre rýchleho vytvorenia, pretože sa nedajú otvoriť v novom okne alebo karte.
`height`	Číslo	Nie	Výška okna formulára, ktorá sa má zobraziť v pixeloch. Vyžaduje odovzdanie `openInNewWindow` parametra ako true.
`width`	Číslo	Nie	Šírka okna formulára, ktorá sa má zobraziť v pixeloch. Vyžaduje odovzdanie `openInNewWindow` parametra ako true.
`navbar`	String	Nie	Určuje, či sa zobrazí navigačný panel a či je k dispozícii navigácia v aplikácii pomocou oblastí a podoblastí definovaných v mape lokality. Platné hodnoty sú: `on`, `off`alebo `entity`. Vyžaduje odovzdanie parametra openInNewWindow ako hodnotu true. - `on`: Zobrazí sa navigačný panel. Toto je predvolené správanie, ak sa parameter navigačného panela nepoužíva. - `off`: Navigačný panel sa nezobrazuje. Ľudia môžu navigovať pomocou iných prvkov používateľského rozhrania alebo tlačidiel späť a dopredu. - `entity`: Vo formulári sú k dispozícii len možnosti navigácie pre súvisiace tabuľky. Po prechode na súvisiacu tabuľku sa na navigačnom paneli zobrazí tlačidlo Späť, aby sa umožnilo návrat k pôvodnému záznamu.
`relationship`	Namietať	Nie	Definovanie objektu vzťahu na zobrazenie súvisiacich záznamov vo formulári. Zobraziť objekt vzťahu
`selectedStageId`	String	Nie	ID vybratej fázy v inštancii obchodného procesu.
`useQuickCreateForm`	Bool	Nie	Udáva, či sa má otvoriť formulár na rýchle vytvorenie. Tabuľka musí mať povolenú možnosť Povoliť rýchle vytvorenie , aby sa zobrazil formulár rýchleho vytvorenia a musíte tiež pridať tabuľku a formulár rýchleho vytvorenia do aplikácie. Ak hodnotu nezadáte `useQuickCreateForm`, predvolená hodnota bude nastavená na `false`.

objekt vzťahu

Objekt má nasledujúce hodnoty.

Meno	Typ	Popis
`attributeName`	String	Názov stĺpca použitého pre vzťah.
`name`	String	Názov stĺpca použitého pre vzťah.
`navigationPropertyName`	String	Názov stĺpca použitého pre vzťah.
`relationshipType`	Číslo	Typ vzťahu. Zadajte jednu z nasledujúcich hodnôt: – 0:OneToMany – 1:ManyToMany
`roleType`	Číslo	Typ roly vo vzťahu. Zadajte jednu z nasledujúcich hodnôt: - 1:Odkazovanie - 2:PriradenieEntita

Poznámky

Túto metódu musíte použiť na otvorenie tabuliek alebo rýchle vytvorenie formulárov namiesto zastaraných metód Xrm.Utility.openEntityForm a Xrm.Utility.openQuickCreate .

Pomocou možnosti setActiveProcess môžete zobraziť konkrétny obchodný proces a nastaviťActiveProcessInstance na zobrazenie konkrétnej inštancie obchodného procesu vo formulári.

Príklady

Príklad 1: Otvorenie formulára pre existujúci záznam

Nasledujúci vzorový kód otvorí formulár kontaktu na zobrazenie existujúceho záznamu kontaktu:

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

Príklad 2: Otvorenie formulára pre nový záznam

Nasledujúci vzorový kód otvorí formulár kontaktu s niektorými vopred vyplnenými hodnotami na vytvorenie nového záznamu:

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

Príklad 3: Otvorenie formulára pre nový záznam (komplexné vyhľadávanie)

Nasledujúci vzorový kód otvorí formulár aktivity s niektorými vopred vyplnenými hodnotami (vrátane zložitého vyhľadávania) na vytvorenie nového záznamu:

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

Príklad 4: Otvorenie formulára na rýchle vytvorenie

Nasledujúci vzorový kód otvorí formulár rýchleho vytvorenia kontaktu s vopred vyplnenými hodnotami:

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

Pripomienky

Bola táto stránka užitočná?

Last updated on 2025-10-04