AsTypeFuntzioak IsType

Function Applies to
AsType Oihalezko aplikazioak Copilot Studio Ereduetan oinarritutako aplikazioak Power Platform CLI Dataverse funtzioak Power Pages
IsType Canvas apps Copilot Studio Model-driven apps Dataverse funtzioak Power Pages

Erregistro-erreferentzia bat taula mota zehatz bat den (IsType) egiaztatzen du, eta erreferentzia mota horretan tratatzen du (AsType).

Note

PAC CLI pac power-fx komandoek ez dute onartzen IsType.

Description

eta funtzioak AsTypeIsType erregistro erreferentziak (adibidez, Dataverse-ko bilaketa polimorfikoak) eta balio dinamikoak zuzenean erabil daitezkeen balio tipoetan bihurtzeko erabil daitezke.

Record References

Irakurri Erregistroen erreferentziak eta bilaketa polimorfikoak ulertzea sarrera zabalagoa eta xehetasun gehiago lortzeko.

Bilaketa-eremu batek taula jakin bateko erregistroak aipatzen ditu normalean. Taula-mota ondo ezarrita dagoenez, atzitu bilaketa-eremuetara puntu-notazio sinplea erabiliz. Adibidez, First( Accounts ).'Primary Contact'.'Full Name' joaten da Kontuak taulatik Lehen mailako kontaktua erregistrora Kontaktuak taulakoa eta ateratzen du Izen osoa eremua.

Microsoft Dataverse-k halaber, bilaketa-eremu polimorfikoak onartzen ditu, adibide hauetan bezala, taula multzo bateko erregistroak aipa daitezke.

Lookup field Erreferentzia egin diezaioke
Owner Erabiltzaileak edo Taldeak
Customer Kontuak edo Kontaktuak
Regarding Kontuak, Kontaktuak, Ezagutza-artikuluak, etab.

Mihise aplikazioko formuletan, erabili erreferentziako erreferentziak bilaketa bilaketak polimorfoekin lan egiteko. Erregistro-erreferentzia batek taula desberdinei erreferentzia egin diezaiekeenez, ezin duzu jakin exekuzio-garaian zein eremu dauden erabilgarri formula bat idazten duzunean. Record.Field notazioa ez dago erabilgarri. Formula horiek aplikazioak exekutatzen duenean aurkitzen dituen erregistroetara egokitu behar dira.

Funtzioak IsType egiaztatzen du erregistro-erreferentzia batek taula mota zehatz bati erreferentzia egiten dion ala ez. Funtzioak boolear egia edo faltsua itzultzen du.

Funtzioak AsType erregistro erreferentzia bat taula mota zehatz gisa tratatzen du, casting ere deitzen zaiona. Emaitza taularen erregistro bat balitz bezala erabiltzen duzu, eta Record.Field notazioa erabiliko duzu erregistro horretako eremu guztiak atzitzeko. Erreferentzia mota zehatz batekoa ez bada, errore bat gertatuko da.

Erabili funtzio hauek elkarrekin lehenik eta behin erregistro baten taula mota egiaztatzeko, eta, ondoren, mota horretako erregistro gisa tratatzeko, eremuak erabilgarri egon daitezen:

If( IsType( First( Accounts ).Owner, Users ),
    AsType( First( Accounts ).Owner, Users ).'Full Name',
    AsType( First( Accounts ).Owner, Teams ).'Team Name'
)

Funtzio hauek erregistro-erreferentzia bateko eremuetara atzitzen badituzu soilik behar dituzu. Adibidez, erregistro-erreferentziak erabiltzen dituzu Iragazkia funtzioan IsTypeAsType:

Filter( Accounts, Owner = First( Users ) )

Era berean, erregistroko erreferentziak erabil ditzakezu Patch funtzioa:

Patch( Accounts, First( Accounts ), { Owner: First( Teams ) } )

Funtzio hauek erregistro-testuinguru batean erabiltzen dituzunean, adibidez, Galeria edo Editatu inprimaki-kontrol batean, baliteke desanbiguazio-eragile orokorra behar izatea taula motari erreferentzia egiteko. Adibidez, formula honek Enpresaren izenabezeroaren bilaketa den kontaktuen zerrenda bistaratzen duen galeria batentzat funtzionatzen du:

If( IsType( ThisItem.'Company Name', Accounts ),
    AsType( ThisItem.'Company Name', Accounts ).'Account Name',
    AsType( ThisItem.'Company Name', Contacts ).'Full Name'
)

Bi funtzioetarako, zehaztu mota taularekin konektatutako datu-iturriaren izena erabiliz. Formula funtziona dezan, gehitu datu-iturri bat aplikazioari egiaztatu edo bota nahi dituzun motetarako. Adibidez, gehitu Erabiltzaileen taula datu-iturri gisa, IsType bilaketa eta taula horretako erregistroak erabili AsType nahi badituzu. Gehitu zure aplikazioan erabiltzen dituzun datu-iturriak soilik; Ez duzu bilaketa batek erreferentzia ditzakeen taula guztiak gehitu behar.

Erregistroaren erreferentzia hutsik badago, IsType FALSE itzultzen du, eta AsTypehutsik itzultzen du. Erregistro baten hutsik eremu guztiak ere hutsik dira.

Dynamic values

Web API bateko balio dinamikoa edo [ParseJSON funtzioa] balio zehatz batera bihurtu behar da Power Fx-en erabili ahal izateko. Hona hemen aukera batzuk:

  1. Idatzi inplizituki eremua erabiltzen duzun puntuan. Adibidez, objektu bat zenbaki bihurtzen da eragilearekin + erabiltzen baduzu, zenbaki bihur badaiteke. Aukera honek ustekabeko bihurketak eragin ditzake eta ezin ditu erregistro eta taula osorik bihurtu.
  2. Esplizituki idatzi eremu bakoitza banan-banan Dezimal, Testua, DateTime, GUID eta beste motako eraikitzaile-funtzioak. Aukera hau zure formuletarako inbaditzaileena da, eremu bakoitza bereizita egin behar duzulako.
  3. Idatzi esplizituki JSON ParseJSON funtzioaren bigarren argumentuarekin. Aukera hau erraza da eta Dynamic balioa behar izatea saihesten du.
  4. Idatzi esplizituki balio dinamikoa funtzioa erabiliz AsType . Mota ere egiazta dezakezu funtzioarekin IsType bihurketa probatu aurretik.

Syntax

AsType( ErregistroErreferentzia, Taula Mota )

  • RecordReference - Beharrezkoa. Erregistroaren erreferentzia, askotan hainbat tauletako erregistro bati erreferentzia egiten dion bilaketa-eremua.
  • TableType - Beharrezkoa. Erregistroa jaurtitzeko taula zehatza.

AsType( DynamicValue, TypeSpecification )

  • DynamicValue - Beharrezkoa. ParseJSON funtzioaren edo API deiaren balio dinamikoa.
  • TypeSpecification - Beharrezkoa. Type funtzioarekin definitzen duzun motaren izena edo motaren zehaztapena.

IsType( ErregistroErreferentzia, Taula Mota )

  • RecordReference - Beharrezkoa. Erregistroaren erreferentzia, taula anitzetako erregistroa aipa dezakeen bilaketa-eremua.
  • TableType - Beharrezkoa. Proba egiteko taula zehatza.

IsType( DynamicValue, TypeSpecification )

  • DynamicValue - Beharrezkoa. ParseJSON funtzioaren edo API dei baten balio dinamikoa.
  • TypeSpecification - Beharrezkoa. Mota funtziorekin definitutako mota-izena edo motaren zehaztapena.

Examples

Record References

Ulertu erregistro-erreferentziak eta bilaketa polimorfikoak adibide zabalak ditu.

  1. Sortu mihiseen aplikazio bat tabletarako.

  2. Ezkerreko panelean, hautatu Datuak>Gehitu datuak, eta gehitu Kontuak eta Kontaktuak taulak.

    Aplikazio zuria bi datu iturriekin: kontuak eta kontaktuak.

  3. Ezkerreko panelean, hautatu + (Txertatu) >Diseinua>Galeria bertikal hutsa.

    Txertatu galeriaren kontrola hutsik bertikalaren diseinua.

  4. Aukeratu Konektatu datuekin, eta hautatu Kontaktuak datu-iturburu gisa.

  5. Ezarri galeriaren diseinua Titulua eta azpititulua gisa.

    Ireki diseinu-hautatzailea propietateen paneletik.

    Ezarri diseinua Titulua eta azpititulua.

  6. Datuak panelean, ireki Title1 zerrenda eta gero hautatu Izena.

    Ezarri izenburuaren balioa.

  7. Hautatu botoia Subtitle1 etiketa kontrola.

    Ezarri azpitituluen balioa.

  8. Ezarri Testua propietatea Subtitle1 formula honetan:

    If( IsBlank( ThisItem.'Company Name' ), "--",
        IsType( ThisItem.'Company Name', Accounts ),
            "Account: " & AsType( ThisItem.'Company Name', Accounts ).'Account Name',
        "Contact: " & AsType( ThisItem.'Company Name', Contacts ).'Full Name'
    )
    

    Pantaila osatuta dago galerian nahastuta dauden kontuak eta kontaktuak erakutsiz.

    Galeriako azpitituluak balio hauek erakusten ditu:

    • "-" bada 'Sozietatearen izena' dago hutsik.
    • "Kontua:" eta Kontuen Izena eremua Kontuak taulako Enpresaren Izena eremuak kontu bati erreferentzia egiten badio.
    • "Kontaktua:" eta Kontaktuak taulako Izen osoa eremua, Enpresaren izena eremuak kontaktu bati erreferentzia egiten badio.

    Zure emaitzak desberdinak izan daitezke, laginaren datuak alda daitezkeelako emaitza mota gehiago erakusteko.

Dynamic values

Ondorengo adibideek JSON erregistro sinple bat erakusten dute, ParseJSONekAsType eta IsTypePac CLI Power Fx REPL-ek hainbat modutan interpretatuta.

Lehenengo adibide honetan, ez zaio motari buruzko informaziorik ematen ParseJSONi, beraz, balio dinamiko bat itzultzen du.

>> Set( rec, ParseJSON( "{""a"":1}" ) )
rec: <Dynamic: Use Value, Text, Boolean, or other functions to establish the type>

Eremua inplizituki zenbaki bihurtzen da zenbakizko testuinguruan erabiltzen denean.

>> 1 + rec.a
2

Alternatiba gisa, adibide honek esplizituki idatzitako Power Fx erregistro batean bihurtzen du bigarren argumentuarekin ParseJSON.

>> ParseJSON( "{""a"":1}", Type( {a: Number} ) )
{a:1}

Eta beste alternatiba bat, adibide honek esplizituki bihurtzen du erregistroa Power Fx erregistro tipografiko batera erabiliz AsType.

>> AsType( ParseJSON( "{""a"":1}" ), Type( {a: Number} ) )
{a:1}

Azkenik, ziur ez bazaude, adibide honek mota probatzen du funtzioarekin IsType bihurtu aurretik.

>> IsType( ParseJSON( "{""a"":1}" ), Type( {a: Number} ) )
true