Adibidea Dataverse kode baxuko pluginak (aurrebista)

[Gai hau aurre-argitaratutako dokumentazioa da eta aldaketak jasan ditzake.]

Adibide-plugin hauen helburua zure aplikazioetan integratzen hasten laguntzea da. Ulertuko duzu egile-esperientziak Microsoft Dataverse esamoldeekin babestutako API pertsonalizatuak egiletzea barne hartzen duela, barneko edo kanpoko ekintzak eragin ditzaketenak Power Fx . Dataverse

Garrantzitsua da

• Kode baxuko berehalako plugin-ak lehenesten dira eta ez dira funtzio gisa ematen. Kode baxuko berehalako pluginak funtzioekin ordezkatzen dira. Informazio gehiago: Funtzioak Microsoft Dataverse (aurrebista)
• Hau aurreikuspen-eginbidea da.
• Aurrebista-eginbideak ez daude ekoizpenerako diseinatuta, eta funtzionalitate murriztua izan dezakete. Eginbide horiek kaleratze ofiziala baino lehen dauden erabilgarri, bezeroek atzitu eta beren oharrak eman ditzaten.

Aurrebaldintza

Datu-gertaerarako adibide-pluginetako bat erabiltzeko Dataverse azeleragailua aplikazioa instalatu behar da ingurunean. Informazio gehiago: Kode baxuko plug-in bat sortzeko aurrebaldintzak

Oharra

Posta elektronikoaren txantiloiak taula jakin batzuetarako soilik daude eskuragarri. Informazio gehiago: Sortu posta elektronikorako txantiloiak

Itzuli balio ez negatiboa

Adibide honek Abs() funtzioa erabiltzen du bere argumentuaren balio ez-negatiboa itzultzeko. Zenbaki bat negatiboa bada, Abs ek baliokide positiboa itzultzen du.

1. Erreproduzitu Dataverse Azeleragailua aplikaziora, hautatu komando-barran Ekintza berria>Berehalako plugina.

2. Eman bistaratzeko izena, hala nola formula izena eta deskribapena.

3. Sortu Out parametro bat zentzuzkoa den espero den portaera baliozkotzeko, adibidez kate bat. Aukeran, erabili sarrera-parametroak probak errazteko, zentzuzkoa dena formularekin.

4. Formula-editorean, bildu Out parametroa kortxete artean:

   {Out: "" }
   

5. Sartu formula probatzen duen adierazpen bat:

   • Egiaztatu intellisense-k formula onartzen duela (testua urdin argi bihurtzen da).
   • Inplementatu emaitza balioztatzen laguntzeko irteera ematen duen adierazpen bat, adibidez.

   {Out: "Abs(-5) = 5: " & Text( Abs(-5) = 5 )  }
   

6. Hautatu Hurrengoa eta, ondoren, hautatu Gorde.

7. Hautatu Proba formula probatzeko. Erabili irteera-parametroa emaitza balioztatzeko.

Sarreraren baliozkotzea eta errore pertsonalizatuak

Bikoiztuen detekzioa

Ezarri zerbitzariaren sarrerako baliozkotzea, esate baterako, errore-mezu pertsonalizatua botatzen duen bikoiztutako errore-hautematea.

1. Erreproduzitu Dataverse Azeleragailua aplikaziora, hautatu komando-barran Ekintza berria>Plugin automatizatua.
2. Izena koadroan, idatzi Bikoiztutako egiaztapena.
3. Taularako, hautatu Kontaktua.
4. Exekutatu plugin hau errenkada denean, hautatu Sortua.
5. Formula laukian, idatzi formula hau:

 If( !IsBlank(LookUp([@Contacts],'Last Name'=ThisRecord.'Last Name' && 'First Name'=ThisRecord.'First Name')),
    Error("You have existing contacts with the same first name and last name")
)

6. Hautatu Gorde.

Probatu plugina

1. Plugin-a probatzeko, sortu mihise-aplikazio bat kontaktuen taula erabiliz, pauso hauek jarraituz: Zehaztu taula bat.
2. Sortu kontaktu-errenda bat.
3. Sortu beste kontaktu bat aurreko urratseko izen bera duena.
4. Mezu bat bistaratzen da aurkitutako erregistro bikoiztuak adierazten duena. Hautatu Ez ikusi eta gorde errore-mezuen abisuan.

Errore-mezu pertsonalizatu hau bistaratzen da: Bi kontaktu dituzu izen-abizenak.

Datuen balidazioa

Erakutsi errore mota zehatzak ErrorKind zenbakia erabiliz.

1. Sortu plug-in automatizatu berri bat.

2. Eman balio hauek:

   • Izena: Sarreraren baliozkotzea
   • Deskribapena: Baliozko data egiaztatzen du eta errore bat botatzen du baliogabea bada
   • Mahaia: Hitzordua
   • Exekutatu plugin hau errenkada: Eguneratuta dagoenean

3. Sartu beheko formula:

   If(ThisRecord.'Due Date' < Now(), 
    Error({ Kind: ErrorKind.Validation , Message: "The due date cannot be in the past" })
   );
   

4. Aukera aurreratuak atalean, ezarri Noiz exekutatu behar den hauEragiketa aurreko; arau hau datuak gorde aurretik exekutatu nahi dituzu datu baliogabeak saihesteko.

5. Hautatu Gorde.

Joan Error() funtziora errore pertsonalizatuei buruz gehiago jakiteko.

Bidali mezu elektronikoa datu-gertaera batean oinarrituta

Aurrebaldintzak:

• Zerbitzariaren sinkronizazioa zure ingurunerako konfiguratuta dago. Informazio gehiago: Konfiguratu posta elektronikoaren, hitzorduen, kontaktuen eta zereginen zerbitzariaren sinkronizazioa
• Posta elektronikoaren txantiloia.

Posta elektronikoaren txantiloiaren adibidea

Hona hemen SenMail oinarritutako datuen gertaerarako sor dezakezun posta elektronikoko txantiloiaren adibide bat:

• Txantiloi mota: Globala
• Izena: Eskatu Eskerrik asko
• Deskribapena: Erabili txantiloi hau bezero bati zurekin eskaera egiteagatik eskerrak emateko.
• Gaia: Thank you for your order <orderconfirmation-{!salesorder:Order Number; }>
• Gorputza: Erabili kode hau.

   Hello {!Sales Order:First Name;},
   Order Type: {! Sales Order: Order Type;},
   Location Type: {! Sales Order: Location Type;},
   Address1: {! Sales Order: Address 1;},
   Address2: {! Sales Order: Address 2;},
   Preferred Service Start Date 1: {! Sales Order: Preferred Service Start Date;},
   Next Step- We take upto 48 hrs to schedule an in-person and will notify you as soon as we have a In-person Technician allocated at your site. For any questions, please contact us at 1-800-CON-SOLAR
   Yours Sincerely, 
   Contoso Sales 

Sortu plug-in automatikoa

1. Erreproduzitu Dataverse Azeleragailua aplikaziora eta, ondoren, hautatu +Plugin berriaPlugin automatizatuak azpian.
2. Sartu informazio hau:

   • Izena: SendEmailUponCreate

   • Taula: Hautatu salmenta-eskaeren taula-izen logikoa, hau da, SalesOrder. Gertaera hau Salmenta Eskaerak taulan oinarritzen da.

   • Exekutatu plugin hau errenkada honekin: Sortu

   • Formula: itsatsi beheko kodea Formula kutxan. SendEmailFromTemplate funtzioari buruzko informazio gehiago lortzeko, hona SendEmailFromTemplate ekintza.

     XSendEmailFromTemplate(
         LookUp('Email Templates',StartsWith(title,"Order Thank You")).'Email Template',
     ThisRecord,
     LookUp(Users,'Primary Email'="sampleemail@sample.com"),[ThisRecord.Email]
     )
     

3. Hautatu Aurreratua>Eragiketa osteko.
4. Hautatu Gorde.

Berrespen-mezua Plugina ongi gorde da agertzen da.

Bidali aplikazioko jakinarazpenak berehalako ekintza batean oinarrituta

Aplikazio barruko jakinarazpenei esker, arduradunek testuinguruko jakinarazpenak eta ekintzak egiteko moduko jakinarazpenak konfigura ditzakete erabiltzaileentzat ereduetan oinarritutako aplikazioetan.

Sortu aplikazio barruko jakinarazpena bidaltzen duen kode baxuko plugina

1. Erreproduzitu Dataverse azeleragailua aplikaziora eta, ondoren, hautatu +Plugin berriaBerehalako pluginak azpian.
2. Sartu informazio hau, hautatu Hurrengoa:
   • Izena: Notify Technican1
   • Deskribapena: Berehalako plug-in honek aplikazioaren erabiltzaileari jakinarazten dio.
3. Definizioak orrian, sortu sarrera-parametroak datu mota hauekin:
   • OrderID: Katea
   • TeknikariEmail: String
4. Formula. Itsatsi hurrengo kodea Formula koadroan. Funtzio honi buruzko informazio gehiago lortzeko, joan SendAppNotification Actionra.

    XSendAppNotification(
    	"New service",
    	LookUp(Users,'Primary Email'=TechnicianEmail),
    	"You have a new solar panel installation scheduled on "& LookUp('Scheduling Results','OrderId'=OrderID).'ServiceDate'&" in "& LookUp('Service Orders','Order Number'=OrderID).City &". Contact the coordinator with any questions.",
    [
    	XCreateSidePaneActionForEntity(
        		"View order",
    		OrderID,
    		"Sales Order",
    		"cr8b8_serviceorder1",
    		LookUp('Service Orders','Order Number'=OrderID).'Service Order'
        	)
    	]
    )
   

5. Hautatu Hurrengoa.
6. Laburpena orrian, hautatu Gorde.

Deitu aplikazioko jakinarazpena berehalako ekintza

1. Hautatu mihise-aplikazio bat eta, ondoren, hautatu Editatu komando-barran (edo sortu berri bat).
2. Hautatu pantaila ezkerreko nabigazio-panelean edo sortu berri bat.
3. Txertatu menuan, gehitu Botoia orrian TestuaAbisatu teknikari erabiliz.
4. Hautatu botoia eta idatzi honako hau fx formula-barran, non DataCardValue17 Eskaera IDa duen zutabea den eta DataCardValue15 helbide elektronikoa duen zutabea. Adibide honetan, Service Order App izeneko mihise-aplikazioa erabiltzen da.

    Environment.cr8b8_Notifytechnician1({
          OrderID: DataCardValue17.Text,
       TechnicianEmail: DataCardValue15.Text 
    });
   
      	Notify("The technician was notified!", NotificationType.Success, 2000);
   
   

   
5. Gorde eta Argitaratu zure aldaketak.

Aplikazioan jakinaraztea teknikari-ekintza hautatzen denean, aplikazioko jakinarazpen bat bidaltzen zaio zerbitzu-aginduari esleitu zaion teknikariari. Jakinarazpeneko ekintza batek zerbitzu-eskaeraren xehetasunak irekitzen ditu alboko panel batean.

Lagin ezazu berehalako plug-in MSN Weather konektorearekin

Plugin honek kokapen zehatz bateko uneko eguraldia itzultzen du MSN Eguraldi-konektorea erabiliz.

Aurrebaldintzak:

• Kode baxuko plug-in bat sortzeko aurrebaldintzak
• MSN Eguraldiaren konektorea onartzen da ingurunean

1. Sortu MSN Eguraldirako konexio-erreferentzia bat ingurunean oraindik eskuragarri ez badago:

2. Kopiatu zatia:

3. Amaitu formula editatzen intellisense erabiliz eta kontsumitu konektorearen erantzunaren propietateak behar bezala:

4. Gorde IcM

5. Probatu plugina

Eskupekoa

Erabili With() funtzioa ekintza batetik erantzun osoa harrapatzeko, erantzunak izan ditzakeen propietate desberdinetara sartu nahi badituzu. Beheko adibidean, sarrera-parametroa Location (katea) eta irteera-parametroa Out (katea) daude.

With({ /* Capture current weather response from connector */
c: new_MsnWeather.CurrentWeather( Location, "Imperial" ).responses.weather.current
},{	/* Return concatenated weather details */
Out: "Current temp: " & c.temp & " degrees. Feels like " & c.feels & " degrees. Wind speed is " & c.windSpd & " mph."
})

Jardunbide egokiak

Begizta infinituko erroreak kudeatzea kode baxuko plugin automatizatuetan

Ez idatzi adabaki-adierazpenik plugin automatizatu batean "Eguneratu" gertaeran, non adabakia pluginaren mahai berean gertatzen ari den. Horrek begizta amaigabeak eta osagarriak gauzatzean huts egitea dakar.

Eredu problematikoa: Patch() formula erabiltzeak beste eguneratze bat abiarazten du.

Gomendatutako eredua: erabili Set() formula arazo hau saihesteko.

Ikusi ere

Kode baxuko pluginak Power Fx (aurrebista)