Partajați prin

Invocați o funcție din aplicație, flux, cod sau altă funcție (previzualizare)

[Acest subiect este documentație de prelansare și poate suferi modificări.]

Puteți invoca funcții în Dataverse de la o aplicație canvas, o pagină personalizată într-o aplicație bazată pe model, un flux, cod sau dintr-o altă funcție.

Important

  • Aceasta este o caracteristică de previzualizare.
  • Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalitate restricționată. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.

Invocați o funcție dintr-o aplicație canvas sau dintr-o pagină personalizată

  1. Din zona Funcții din Power Apps (make.powerapps.com), selectați funcția pe care doriți să o invocați dintr-o aplicație canvas sau dintr-o pagină personalizată.
  2. Selectați Copiați fragmentul de cod în bara de comandă.
  3. Lipiți și salvați formula copiată într-un editor de text, Notepad sau într-un loc la care vă puteți referi cu ușurință.
  4. În Power Apps Studio:
    1. Creați sau editați o aplicație canvas sau o pagină personalizată în Power Apps Studio.
    2. În panoul de navigare din stânga, sub fila Surse de date , selectați Adăugați date și căutați opțiunea Mediu din conectorul Dataverse și selectați-o.
    3. Introduceți următoarele componente pe pânză:
      • Adăugați controale de intrare care corespund tipului de date al fiecărui parametru, cum ar fi introducerea unui număr.
      • Adăugați un buton pentru a apela funcția.
      • Adăugați un control de ieșire care corespunde tipului de date al parametrului dvs., cum ar fi introducerea unui număr.
  5. Selectați butonul pe care l-ați creat și, în proprietatea OnSelect , introduceți funcția dvs., cum ar fi Environment.new_calculatesum.
  6. Mapați fiecare parametru de intrare Value pentru a face referire la controalele de intrare corespunzătoare:
    • Dacă funcția dvs. este Environment.new_CalculateSum({ X: Value, Y: Value });, ar putea fi rescrisă ca: Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value });.
    • Pentru a seta rezultatul funcției, actualizați formula la „Set(result, Environment.new_CalculateSum({ X: NumberInput1.value, Y: NumberInput2.value }))”.
  7. Selectați controlul de ieșire și setați proprietatea „Valoare” cu o formulă „rezultat.z”.

Previzualizați aplicația, introduceți valorile de intrare 1 și 2 și selectați butonul. Rezultatul ar trebui să fie afișat în câmpul de ieșire.

Invocați funcții dintr-un flux în cloud Power Automate

  1. Într-un flux cloud, adăugați o nouă acțiune din conectorul Microsoft Dataverse .
  2. Selectați acțiunea numită Efectuați o acțiune nelegată
  3. Selectați funcția dvs. Funcția are un nume unic cu un prefix.
  4. Furnizați valori pentru toți parametrii de intrare (dacă există).

Invocați funcții din Dataverse API-ul web

Urmați pașii pentru secțiunile de acțiuni nelegate din articolul Invocarea API-urilor personalizate din API-ul web (în funcție de domeniul adecvat al plug-in-ului).

Invocați funcțiile existente din noile funcții

Pentru a invoca o funcție existentă într-o funcție nouă, utilizați sintaxa: Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN})

Deoarece ieșirea este întotdeauna o înregistrare, utilizați notația cu puncte pentru a accesa parametrii de ieșire. De exemplu, dacă funcția „ExistingFunction” are doi parametri de ieșire definiți ca out1 și out2, îi puteți accesa în oricare dintre aceste două moduri:

  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out1
  • Environment.ExistingFunction({inputParam1: value1, inputParam2: value2, ... inputParamN: valueN}).out2

Limitări cu funcții în Dataverse

  • Obiectul limbaj de mediu trebuie citit pentru a accesa funcții noi din aplicațiile canvas existente. Pentru orice funcții create după ce ați adăugat sursa de date a tabelului de mediu la o aplicație canvas existentă, trebuie să eliminați și să citiți Power Fx obiectul limbaj de mediu. Apoi vedeți lista actualizată de funcții ca acțiuni.
  • Suport imbricat. Funcțiile pot apela numai acțiunile Microsoft publicate de Microsoft din Power Fx expresii.
  • Unele Collect scenarii necesită Patch. Există unele scenarii în care Collect() nu funcționează. Soluția este să utilizați Patch() așa cum se arată în exemplul de completare a coloanei de aici.
Patch(Faxes,
       Collect(Faxes, {  Subject : "Sub1" } ),
       { Regarding : First(Accounts) }
    )

Depanați și obțineți ajutor cu funcțiile dvs

Dacă întâmpinați probleme la crearea sau rularea funcției, utilizați funcția trace() pentru depanare sau accesați Limitări cu funcții în Dataverse pentru problemele comune care pot apărea.

Depanare folosind funcția trace().

  1. Pentru a depana folosind funcția de urmărire, asigurați-vă că activați plug-in-ul și urmărirea activității fluxului de lucru personalizat.
  2. Accesați Power Apps (make.powerapps.com), selectați Setări pictograma roată din dreapta sus, apoi selectați Setări avansate.
  3. Selectați Setări > Audit > Setări globale de audit.
  4. În fila Personalizare , asigurați-vă că Activați înregistrarea în jurnalul de urmărire din plug-in este activată pentru Toate.

După ce activați urmărirea, puteți începe să utilizați funcțiile trace() pentru a depana Power Fx formulele. Aflați mai multe despre cum să utilizați funcția trace() în interiorul unei Power Fx expresii: funcția de urmărire - Power Platform.

Contactează ajutor + asistență

Pentru probleme cu funcții care nu sunt acoperite în Microsoft Dataverse sfaturile pentru pluginuri cu cod redus și probleme cunoscute, cum ar fi erorile nedocumentate primite, utilizați experiența de asistență Ajutor + și includeți următoarele informații:

  • Tipul problemei- Dataverse Web API și SDK.
  • Subtip de problemă.

Exemple de funcții

Creați și utilizați funcții în Microsoft Dataverse

  • Last updated on