openForm (Ügyfél API-referencia)

Megnyit egy entitásűrlapot vagy egy gyorslétrehozási űrlapot.

Megjegyzés:

A főűrlap párbeszédpanelként való megnyitásához használja inkább a navigateTo metódust. További információ: Fő űrlap megnyitása párbeszédpanelen az ügyfél API használatával

Szemantika

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

Paraméterek

Név	Típus	Kötelező	Description
`entityFormOptions`	Objektum	Igen	Űrlapbeállítások az űrlap megnyitásához. Az entityFormOptions objektum megtekintése
`formParameters`	Objektum	Nem	Szótárobjektum, amely további paramétereket ad át az űrlapnak. Az érvénytelen paraméterek hibát okoznak. A paraméterek űrlapnak való átadásáról további információt az oszlopértékek beállítása az űrlapnak átadott paraméterek használatával , valamint az űrlap konfigurálása egyéni lekérdezési paraméterek elfogadásához című témakörben talál.
`successCallback`	Funkció	Nem	A gyors létrehozási űrlapon a rekord mentésekor végrehajtandó függvény. Ez a függvény egy objektumot ad át paraméterként. Az objektum egy `savedEntityReference` tömböt használ, amely a következő tulajdonságokkal rendelkezik a megjelenített vagy létrehozott rekord(ok) azonosításához: - `entityType`: A tábla logikai neve. - `id`: A rekord GUID-értékének sztring-ábrázolása. - `name`: A megjelenített vagy létrehozott rekord elsődleges oszlopértéke. MEGJEGYZÉS: – A `successCallback` függvény nem lesz végrehajtva, amikor űrlapot nyit meg egy meglévő vagy új rekordhoz. – A `successCallback` függvény csak akkor lesz végrehajtva, ha az openForm metódussal megnyitott gyors létrehozási űrlapon ment egy rekordot.
`errorCallback`	Funkció	Nem	A művelet sikertelensége esetén végrehajtandó függvény.

entityFormOptions objektum

Az objektum a következő értékeket tartalmazza:

Név	Típus	Kötelező	Description
`entityName`	Lánc	Igen	A tábla logikai neve az űrlap megjelenítéséhez.
`entityId`	Lánc	Nem	A táblarekord azonosítója az űrlap megjelenítéséhez.
`formId`	Lánc	Nem	A megjelenítendő űrlappéldány azonosítója.
`cmdbar`	Boole	Nem	Azt jelzi, hogy meg kell-e jeleníteni a parancssávot. Ha nem adja meg ezt a paramétert, alapértelmezés szerint a parancssáv jelenik meg. A paraméter igazként való átadását `openInNewWindow` igényli.
`createFromEntity`	Lookup	Nem	Olyan rekordot jelöl ki, amely a megfeleltetett oszlopértékek alapján adja meg az alapértelmezett értékeket. A keresési objektum a következő sztringtulajdonságokkal rendelkezik: `entityType`, `id`és `name` (nem kötelező).
`openInNewWindow`	Boole	Nem	Azt jelzi, hogy új ablakban vagy új lapon jelenjen-e meg az űrlap. Ha magassági vagy szélességi értékeket ad meg `true` , és nem ad meg értékeket, az űrlap egy új lapon jelenik meg. Ha új ablakban vagy új lapon nyit meg egy űrlapot, az űrlap megjelenítése lassúvá válik az űrlap ugyanazon lapra való megnyitásához képest; érdemes inkább a főűrlapon megnyitni egy űrlapot. Ez a tulajdonság jelenleg nem támogatott a gyors létrehozási űrlapok esetében, mivel nem nyithatóak meg új ablakban vagy lapon.
`height`	Szám	Nem	A megjelenítendő űrlapablak magassága képpontban. A paraméter igazként való átadását `openInNewWindow` igényli.
`width`	Szám	Nem	A képpontban megjelenítendő űrlapablak szélessége. A paraméter igazként való átadását `openInNewWindow` igényli.
`navbar`	Lánc	Nem	Azt szabályozza, hogy megjelenjen-e a navigációs sáv, és hogy az alkalmazásnavigáció elérhető-e az oldaltérképen meghatározott területek és alterületek használatával. Az érvényes értékek a következők: `on`, `off`vagy `entity`. Az openInNewWindow paraméter igazként való átadását igényli. - `on`: Megjelenik a navigációs sáv. Ez az alapértelmezett viselkedés, ha a navigációs paraméter nincs használatban. - `off`: A navigációs sáv nem jelenik meg. A felhasználók a felhasználói felület más elemeivel vagy a vissza és előre gombokkal navigálhatnak. - `entity`: Űrlapon csak a kapcsolódó táblák navigációs beállításai érhetők el. Miután navigált egy kapcsolódó táblára, megjelenik egy vissza gomb a navigációs sávon, amely lehetővé teszi az eredeti rekordra való visszatérést.
`relationship`	Objektum	Nem	Definiáljon egy kapcsolatobjektumot a kapcsolódó rekordok űrlapon való megjelenítéséhez. Kapcsolatobjektum megtekintése
`selectedStageId`	Lánc	Nem	Az üzletifolyamat-példány kiválasztott szakaszának azonosítója.
`useQuickCreateForm`	Boole	Nem	Azt jelzi, hogy meg kell-e nyitni egy gyors létrehozási űrlapot. A táblázatnak engedélyeznie kell a Gyors létrehozás engedélyezése beállítást a gyors létrehozási űrlap megjelenítéséhez, és hozzá kell adnia a táblázatot és a gyors létrehozási űrlapot az alkalmazáshoz. Ha nem adja meg az értékét `useQuickCreateForm`, az alapértelmezett érték lesz beállítva `false`.

kapcsolatobjektum

Az objektum az alábbi értékekkel rendelkezik.

Név	Típus	Description
`attributeName`	Lánc	A kapcsolathoz használt oszlop neve.
`name`	Lánc	A kapcsolathoz használt oszlop neve.
`navigationPropertyName`	Lánc	A kapcsolathoz használt oszlop neve.
`relationshipType`	Szám	Kapcsolat típusa. Adja meg az alábbi értékek egyikét: - 0:OneToMany - 1:ManyToMany
`roleType`	Szám	Szerepkör típusa a kapcsolatban. Adja meg az alábbi értékek egyikét: - 1:Hivatkozás - 2:AssociationEntity

Megjegyzések

Ezzel a módszerrel kell megnyitnia a táblázatot vagy a gyors létrehozási űrlapokat az elavult Xrm.Utility.openEntityForm és az Xrm.Utility.openQuickCreate metódus helyett.

A setActiveProcess használatával megjeleníthet egy adott üzleti folyamatot, a setActiveProcessInstance pedig megjeleníthet egy adott üzleti folyamatpéldányt az űrlapon.

Példák

1. példa: Űrlap megnyitása meglévő rekordhoz

Az alábbi mintakód megnyit egy névjegyűrlapot egy meglévő partnerrekord megjelenítéséhez:

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. példa: Űrlap megnyitása új rekordhoz

Az alábbi mintakód egy névjegyűrlapot nyit meg néhány előre kitöltött értékkel egy új rekord létrehozásához:

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. példa: Űrlap megnyitása új rekordhoz (összetett keresés)

Az alábbi mintakód egy tevékenységűrlapot nyit meg néhány előre kitöltött értékkel (beleértve egy összetett keresést is) egy új rekord létrehozásához:

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. példa: Gyors létrehozási űrlap megnyitása

Az alábbi mintakód egy gyors kapcsolatfelvételi űrlapot nyit meg néhány előre kitöltött értékkel:

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

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2025-10-04