openForm (JavaScript-ohjelmointirajapinnan viite) Dynamics 365 Channel Integration Framework 1.0:lle

Avaa entiteettilomakkeen tai pikaluontilomakkeen.

Syntax

Microsoft.CIFramework.openForm(entityFormOptions,formParameters).then(successCallback,errorCallback);

Parameters

Nimi	Type	Pakollinen	Kuvaus
entityFormOptions	JSON-objekti	Kyllä	Entiteettilomakkeen asetukset lomakkeen avaamista varten. Objekti sisältää seuraavat attribuutit: - cmdbar - createFromEntity - entityId - entiteetin nimi - formId -korkeus - navBar - openInNewWindow - windowPosition - prosessitunnus - processInstanceId -suhde - valitseStageId - useQuickCreateForm -leveys Katso entityFormOptions objektitaulukosta tietoja attribuuteista.
formParametrit	Objekti	Ei	Sanasto-olio, joka välittää lomakkeeseen ylimääräisiä parametreja. Virheelliset parametrit aiheuttavat virheen. Lisätietoja parametrien välittämisestä lomakkeeseen on kohdissa Kenttäarvojen määrittäminen lomakkeeseen välitettyjen parametrien avulla ja Lomakkeen määrittäminen hyväksymään mukautettuja kyselymerkkijonon parametreja.
onnistuminenTakaisinsoitto	Function	Ei	Toiminto, joka suoritetaan, kun toiminto onnistuu.
errorCallback	Function	Ei	Toiminto, joka suoritetaan, kun toiminto epäonnistuu.

entityFormOptions objektin attribuutit

Seuraavassa taulukossa kuvataan parametrin entityFormOptions määritteet.

Note

Määritteet ovat valinnaisia.

Määritteen arvo	Type	Kuvaus
cmd-palkki	totuusarvo	Ilmaisee, näytetäänkö komentopalkki. Jos et määritä tätä parametria, komentopalkki näkyy oletusarvoisesti.
createFromEntity	Valinta	Ilmaisee tietueen, joka antaa oletusarvot yhdistettyjen määritearvojen perusteella. Hakuobjektilla on seuraavat String-tyyppiset ominaisuudet: entityType, , idja name (valinnainen).
entityId	String	Sen entiteettitietueen tunnus, jolle lomake näytetään.
entiteetin nimi	String	Sen entiteetin looginen nimi, jolle lomake näytetään.
formId	String	Näytettävän lomakkeen esiintymän tunnus.
korkeus	Numero	Näytettävän lomakeikkunan korkeus pikseleinä.
navBar	String	Määrittää, näytetäänkö siirtymispalkki ja onko sovelluksessa siirtyminen käytettävissä sivustokartassa määritettyjen alueiden ja alialueiden avulla. Kelvollisia arvoja ovat: on: Navigointipalkki tulee näkyviin. Tämä on oletustoiminta, jos parametria navBar ei käytetä. off: Navigointipalkkia ei näytetä. Käyttäjä voi navigoida käyttämällä muita käyttöliittymän elementtejä tai Eteen- ja Eteenpäin-painikkeita. entity: Entiteettilomakkeessa vain liittyvien entiteettien siirtymisvaihtoehdot ovat käytettävissä. Kun olet siirtynyt liittyvään entiteettiin, siirtymispalkissa näkyy Takaisin-painike, jonka avulla voit palata alkuperäiseen tietueeseen.
openInNewWindow	totuusarvo	Ilmaisee, näytetäänkö lomake uudessa ikkunassa.
windowPosition	Numero	Ilmaisee lomakkeen sijainnin ikkunassa. Kelvolliset arvot ovat: 1 keskiasentoon ja 2 sivuasentoon.
processId	String	Lomakkeessa näytettävän liiketoimintaprosessin tunnus.
processInstanceId	String	Lomakkeessa näytettävän liiketoimintaprosessin ilmentymän tunnus.
yhteys	JSON-objekti	Ilmaisee suhdeobjektin, joka näyttää lomakkeen liittyvät tietueet. Katso relationship objektitaulukosta tietoja attribuuteista.
valitseStageId	String	Liiketoimintaprosessin ilmentymän valitun vaiheen tunnus.
useQuickCreateForm	Numero	Näytettävän lomakeikkunan leveys pikseleinä.

relationship objektin attribuutit

Seuraavassa taulukossa kuvataan parametrin objektimääritteen relationship määritteetentityFormOptions.

Note

Määritteet ovat valinnaisia.

Määritteen arvo	Type	Kuvaus
attribuutin nimi	String	Suhteessa käytetyn määritteen nimi.
Nimi	String	Suhteen nimi.
navigointiOminaisuus	String	Suhteen siirtymisominaisuuden nimi.
suhteen tyyppi	Numero	Suhteen tyyppi. Kelvolliset arvot ovat: 0 yksi-moneen-yhteydelle ja 1 monta-moneen-yhteydelle.
roolin tyyppi	Numero	Roolityyppi suhteessa. Kelvollisia arvoja ovat: 1 for referring ja 2 AssociationEntity.

Palauta arvo

Jos onnistuu, palauttaa Promise-olion, joka sisältää merkkijonon.

Esimerkki:

Seuraava mallikoodi avaa uuden tapauslomakkeen, jossa on esitäytetyt arvot tietyille kentille, kuten yhteyshenkilön tunnukselle ja kuvaukselle.

var id = "5af02e2a-d0d1-e811-8158-000d3af97055"
var title = "Sample Case Form"
var entityFormOptions = {};
    entityFormOptions["entityName"] = "incident";
    
var formParameters = {};
    //pre-populate some fields based on the context
    formParameters["title"] = title;
    formParameters["customerid"] = id;
    formParameters["customeridtype"] = "contact";
    formParameters["caseorigincode"] = 1;
    formParameters["description"] = "Opened the form with pre-populated details like title, contact id, and description.";

//Open the form
Microsoft.CIFramework.openForm(JSON.stringify(entityFormOptions), JSON.stringify(formParameters)).then(
      function (success) {
        console.log(success);
    },
    function (error) {
        console.log(error);
    }
  );