Csatlakozás a Microsoft Dataverse-hez az Azure Logic Apps munkafolyamataiból

A következőkre vonatkozik: Azure Logic Apps (Használat + Standard)

Fontos

2022. augusztus 30-án a Common Data Service 2.0, más néven Microsoft Dataverse (Örökölt) összekötői műveletei átkerülnek az aktuális Microsoft Dataverse-összekötőre. Az örökölt műveletek az "örökölt" címkét, míg az aktuális műveletek az "előzetes verzió" címkét viselik. Az aktuális Dataverse-összekötőt bármely meglévő vagy új logikaialkalmazás-munkafolyamatban használhatja. A visszamenőleges kompatibilitás érdekében a meglévő munkafolyamatok továbbra is együttműködnek az örökölt Dataverse-összekötővel. Győződjön meg azonban arról, hogy áttekinti ezeket a munkafolyamatokat, és azonnal frissíti őket.

2023 októbere óta az örökölt verzió elérhetetlenné vált az új munkafolyamatokhoz. A meglévő munkafolyamatok továbbra is működnek, de az új munkafolyamatokhoz a Dataverse-összekötő aktuális műveleteit kell használnia. A rendszer bejelenti az örökölt műveletek és eseményindítók leállítási dátumának ütemtervét. További információkért tekintse meg az Azure Logic Appshez készült Microsoft Dataverse (örökölt) összekötőt, amely elavult, és lecserélődik egy másik összekötőre.

Ha olyan automatizált munkafolyamatokat szeretne létrehozni és futtatni, amelyek sorokat hoznak létre és kezelnek a Microsoft Dataverse-adatbázisban, használhatja az Azure Logic Appst és a Microsoft Dataverse-összekötőt. Ezek a munkafolyamatok létrehozhatnak és frissíthetnek sorokat, valamint egyéb műveleteket hajthatnak végre. A Dataverse-adatbázisból is lekérheti az adatokat, és elérhetővé teheti a kimenetet a munkafolyamatokban használandó egyéb műveletekhez. Ha például sorokat ad hozzá, frissít vagy töröl a Dataverse-adatbázisban, az Office 365 Outlook-összekötő használatával küldhet e-mailt.

Ez az útmutató bemutatja, hogyan hozhat létre olyan munkafolyamatot, amely feladatsort hoz létre új érdeklődősor létrehozásakor.

Összekötőkkel kapcsolatos segédlet

Az összekötő Swagger-leírása, például műveletek, korlátok és egyéb részletek alapján a felügyelt összekötő referenciaoldalán talál műszaki információkat.

Előfeltételek

• Azure-fiók és -előfizetés. Ha nem rendelkezik Azure-előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

• Dataverse Data Service-környezet és -adatbázis, amely egy olyan hely, ahol a szervezet üzleti adatokat tárol, kezel és oszt meg egy Dataverse-adatbázisban. További információkat találhat az alábbi forrásokban:

  • Tudnivalók: Dataverse-környezetek létrehozása és kezelése

  • Power Platform – Környezetek áttekintése

• Alapszintű ismeretek a Használat vagy a Standard logikai alkalmazás munkafolyamatainak létrehozásáról, valamint arról a logikai alkalmazásról, ahonnan a Dataverse-adatbázisban lévő sorokat el szeretné érni. A Dataverse-eseményindító használatához üres munkafolyamattal kell kezdenie. További információkat találhat az alábbi forrásokban:

  • Példa használati logikai alkalmazás munkafolyamatának létrehozása

  • Példa standard logikai alkalmazás munkafolyamatának létrehozása

Dataverse trigger hozzáadása

Amikor olyan eseményindítót vagy műveletet ad hozzá, amely egy szolgáltatáshoz vagy rendszerhez csatlakozik, és nincs meglévő vagy aktív kapcsolata, az Azure Logic Apps kéri, hogy adja meg a kapcsolati adatokat, amelyek a kapcsolat típusától függően változnak, például:

• A fiók hitelesítő adatai
• A kapcsolathoz használandó név
• A kiszolgáló vagy a rendszer neve
• A használni kívánt hitelesítési típus
• Egy kapcsolati sztring

Ez a példa a Dataverse eseményindítót használja, amely egy sor hozzáadása, frissítése vagy törlésekor elindítja a munkafolyamatot.

Feljegyzés

A Dataverse-összekötő műveletspecifikus paraméterekkel és adatbázis-specifikus paraméterekkel rendelkezik. Ha például kiválaszt egy táblát, az adott táblához elérhető paraméterek eltérőek és eltérnek a többi táblától.

Standard

1. Az Azure Portalon nyissa meg a Standard logikai alkalmazás erőforrását és az üres munkafolyamatot a tervezőben.

2. A tervezőn kövesse az alábbi általános lépéseket a Sor hozzáadása, módosítása vagy törlése után nevű Microsoft Dataverse-eseményindító hozzáadásához.

3. Ha a rendszer kéri, jelentkezzen be a Dataverse-környezetbe vagy -adatbázisba.

4. Az eseményindító információs mezőjében adja meg a szükséges értékeket.

   A példa eseményindítója: Sor hozzáadása, módosítása vagy törlése.

   

5. Ha végzett, mentse a logikai alkalmazás munkafolyamatát. A tervező eszköztárán válassza a Mentés lehetőséget.

6. Most adjon hozzá legalább egy műveletet a munkafolyamathoz az eseményindító aktiválásakor. Hozzáadhat például egy Dataverse-műveletet vagy egy olyan műveletet, amely az eseményindító kimenetei alapján küld e-mailt.

Fogyasztás

1. Az Azure Portalon nyissa meg a Consumption logikai alkalmazás erőforrását és az üres munkafolyamatot a tervezőben.

2. A tervezőn kövesse az alábbi általános lépéseket a Sor hozzáadása, módosítása vagy törlése után nevű Microsoft Dataverse-eseményindító hozzáadásához.

3. Ha a rendszer kéri, jelentkezzen be a Dataverse-környezetbe vagy -adatbázisba.

4. Az eseményindító információs mezőjében adja meg a szükséges értékeket.

   A példa eseményindítója: Sor hozzáadása, módosítása vagy törlése.

   

5. Ha végzett, mentse a logikai alkalmazás munkafolyamatát. A tervező eszköztárán válassza a Mentés lehetőséget.

6. Most adjon hozzá legalább egy műveletet a munkafolyamathoz az eseményindító aktiválásakor. Hozzáadhat például egy Dataverse-műveletet vagy egy olyan műveletet, amely az eseményindító kimenetei alapján küld e-mailt.

Dataverse-művelet hozzáadása

Amikor olyan eseményindítót vagy műveletet ad hozzá, amely egy szolgáltatáshoz vagy rendszerhez csatlakozik, és nincs meglévő vagy aktív kapcsolata, az Azure Logic Apps kéri, hogy adja meg a kapcsolati adatokat, amelyek a kapcsolat típusától függően változnak, például:

• A fiók hitelesítő adatai
• A kapcsolathoz használandó név
• A kiszolgáló vagy a rendszer neve
• A használni kívánt hitelesítési típus
• Egy kapcsolati sztring

Ez a példa a Dataverse műveletet használja, amely új sort ad hozzá az adatbázishoz.

Feljegyzés

A Dataverse-összekötő műveletspecifikus paraméterekkel és adatbázis-specifikus paraméterekkel rendelkezik. Ha például kiválaszt egy táblát, az adott táblához elérhető paraméterek eltérőek és eltérnek a többi táblától.

Standard

1. Az Azure Portalon nyissa meg a standard logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.

2. A tervezőn kövesse az alábbi általános lépéseket az Új sor hozzáadása nevű Microsoft Dataverse művelet hozzáadásához.

3. Ha a rendszer kéri, jelentkezzen be a Dataverse-környezetbe vagy -adatbázisba.

4. A műveletinformációs mezőben adja meg a szükséges értékeket.

   A példaművelethez lásd : Új sor hozzáadása.

   

5. Ha végzett, mentse a logikai alkalmazás munkafolyamatát. A tervező eszköztárán válassza a Mentés lehetőséget.

6. Ha szeretné, folytassa a további műveletek hozzáadását.

Fogyasztás

1. Az Azure Portalon nyissa meg a Consumption logikai alkalmazás erőforrását és munkafolyamatát a tervezőben.

2. A tervezőn kövesse az alábbi általános lépéseket az Új sor hozzáadása nevű Microsoft Dataverse művelet hozzáadásához.

3. Ha a rendszer kéri, jelentkezzen be a Dataverse-környezetbe vagy -adatbázisba.

4. A műveletinformációs mezőben adja meg a szükséges értékeket.

   A példaművelethez lásd : Új sor hozzáadása.

   

5. Ha végzett, mentse a logikai alkalmazás munkafolyamatát. A tervező eszköztárán válassza a Mentés lehetőséget.

6. Ha szeretné, folytassa a további műveletek hozzáadását.

A munkafolyamat tesztelése

A munkafolyamat teszteléséhez és aktiválásához kövesse az alábbi lépéseket:

Standard

1. A munkafolyamat menüjében válassza az Áttekintés lehetőséget.

2. Az Áttekintés eszköztáron válassza a Futtatás futtatása lehetőséget>.

3. Reprodukálja azokat a feltételeket, amelyekre az eseményindítónak szüksége van a munkafolyamat futtatásához.

Fogyasztás

1. A tervező eszköztáron válassza az Eseményindító futtatása parancsot>.

2. Reprodukálja azokat a feltételeket, amelyekre az eseményindítónak szüksége van a munkafolyamat futtatásához.

Sorok visszaadása szűrő alapján

A sorokat visszaíró műveletekhez, például a Sorok listázása művelethez használhat egy ODATA-lekérdezést, amely a megadott szűrő alapján ad vissza sorokat. Beállíthatja például, hogy a művelet csak az aktív felhasználói fiókokhoz tartozó sorokat adja vissza. A példaműveletről további információt a Listasorok című témakörben talál.

Standard

1. A tervezőben a műveletben nyissa meg a Speciális paraméterek listát, és válassza a Sorok szűrése tulajdonságot.

   

2. A műveletben most megjelenő Szűrősorok tulajdonságban adjon meg egy ODATA-lekérdezési kifejezést, például:

   statuscode eq 1

   

A rendszer lekérdezési beállításaival kapcsolatos $filter további információkért lásd : Adatok lekérdezése a Webes API használatával – Eredmények szűrése.

Fogyasztás

1. A tervezőben a műveletben nyissa meg az Új paraméterlista hozzáadása elemet, és válassza a Sorok szűrése tulajdonságot.

   

2. A műveletben most megjelenő Szűrősorok tulajdonságban adjon meg egy ODATA-lekérdezési kifejezést, például:

   statuscode eq 1

   

A rendszer lekérdezési beállításaival kapcsolatos $filter további információkért lásd : Adatok lekérdezése a Webes API használatával – Eredmények szűrése.

Sorok visszaadása rendezési sorrend alapján

A sorokat visszaíró műveletekhez, például a Sorok listázása művelethez olyan ODATA-lekérdezést használhat, amely egy adott sorozat sorait adja vissza, amely a művelet által visszaadott soroktól függően változik. Beállíthatja például, hogy a művelet a fióknév szerint rendezett sorokat adja vissza. A példaműveletről további információt a Listasorok című témakörben talál.

Standard

1. A tervezőben a műveletben nyissa meg a Speciális paraméterek listát, és válassza a Rendezés szempontja tulajdonságot.

   

2. A műveletben most megjelenő Rendezés szempontja tulajdonságban adja meg a rendezéshez használandó oszlopnevet, például a nevet:

   

A rendszer lekérdezési beállításaival kapcsolatos $orderby további információkért lásd : Adatok lekérdezése a Webes API használatával – Rendezés szempontja.

Fogyasztás

1. A tervezőben a műveletben nyissa meg az Új paraméter hozzáadása listát, és válassza a Rendezés szempontja tulajdonságot.

   

2. A műveletben most megjelenő Rendezés szempontja tulajdonságban adja meg a rendezéshez használandó oszlopnevet, például a nevet:

   

A rendszer lekérdezési beállításaival kapcsolatos $orderby további információkért lásd : Adatok lekérdezése a Webes API használatával – Rendezés szempontja.

Mező adattípusai

Egy eseményindítóban vagy műveletben a mezőérték adattípusának meg kell egyeznie a mező szükséges adattípusával. Ez a követelmény akkor érvényes, ha manuálisan adja meg az értéket, vagy kiválasztja az értéket a dinamikus tartalomlistából.

Feljegyzés

A Dataverse-összekötő műveletspecifikus paraméterekkel és adatbázis-specifikus paraméterekkel rendelkezik. Ha például kiválaszt egy táblát, az adott táblához elérhető paraméterek eltérőek és eltérnek a többi táblától.

Tegyük fel például, hogy van egy Feladatok nevű táblája. Ez a tábla olyan mezőket tartalmaz, amelyek csak az adott táblára vonatkoznak, míg a többi táblának saját mezői vannak. A PéldaFeladatok táblában az alábbi táblázat néhány mintamezőtípust és azokat az adattípusokat ismerteti, amelyeket ezek a mezők az értékükhöz igényelnek.

Mező	Adattípus	Leírás
Szövegmező	Egy szövegsor	Egy sornyi szöveget vagy dinamikus tartalmat igényel, amely rendelkezik a szöveg adattípusával, például a következő tulajdonságokat: - Leírás - Kategória
Egész szám mező	Egész szám	Egész vagy dinamikus tartalomra van szükség, amely egész szám adattípussal rendelkezik, például a következő tulajdonságokat: - Készültségi szint - Időtartam
Dátum mező	Dátum és idő	A dátumot MM/DD/YYY formátumban kell megadni, vagy olyan dinamikus tartalmat, amely dátum adattípussal rendelkezik, például a következő tulajdonságokat: - Létrehozás dátuma: - Kezdés dátuma - Tényleges kezdés - Tényleges vég - Határidő
Egy másik entitássorra hivatkozó mező	Elsődleges kulcs	Mind a sorazonosítót, például a GUID azonosítót, mind a keresési típust meg kell követelni, ami azt jelenti, hogy a dinamikus tartalomlistából származó értékek nem fognak működni, például ezek a tulajdonságok: - Tulajdonos: Érvényes felhasználói azonosítónak vagy csoportsor-azonosítónak kell lennie. - Tulajdonos típusa: Olyan keresési típusnak kell lennie, mint például systemusers vagy teams, vagy. - Ami a következőt illeti: Érvényes sorazonosítónak kell lennie, például fiókazonosítónak vagy partnersor-azonosítónak. - Típussal kapcsolatban: Keresési típusnak kell lennie, például accounts vagy contacts, vagy. - Ügyfél: Érvényes sorazonosítónak kell lennie, például fiókazonosítónak vagy kapcsolattartósor-azonosítónak. - Ügyfél típusa: A keresési típusnak kell lennie, például accounts vagy contacts, illetve.

Tegyük fel, hogy a Feladatok példatáblában az Új sor hozzáadása művelettel hoz létre egy új sort, amely más entitássorokhoz, különösen egy felhasználói sorhoz és egy fióksorhoz van társítva. Ebben a műveletben tehát meg kell adnia az entitássorok azonosítóit és keresési típusait olyan értékekkel, amelyek megfelelnek a vonatkozó tulajdonságok várt adattípusainak.

• A felhasználóazonosítót megadó Tulajdonos tulajdonság és a keresési típust meghatározó systemusers Tulajdonos típus tulajdonság alapján a művelet az új sort egy adott felhasználóhoz társítja.

• A sorazonosítót meghatározó Regarding tulajdonság és a keresési típust meghatározó accounts Kapcsolódó típus tulajdonság alapján a művelet egy adott fiókkal társítja az új sort.

Standard

Fogyasztás

Hibaelhárítás

Hívások több környezetből

A Dataverse-összekötő információkat tárol azokról a logikai alkalmazás-munkafolyamatokról, amelyek értesítést kapnak és igényelnek az adatbázis-entitások változásairól a callbackregistrations Dataverse-adatbázisban található entitás használatával. Dataverse-szervezet másolása esetén a webhookok is másolásra kerülnek. Ha a szervezetet a szervezetre leképezett munkafolyamatok letiltása előtt másolja, a másolt webhookok is ugyanarra a logikaialkalmazás-munkafolyamatra mutatnak, amelyek ezután több szervezettől kapnak értesítéseket.

A nemkívánatos értesítések leállításához törölje az callbackregistrations értesítést küldő entitást a következő lépésekkel:

1. Azonosítsa és jelentkezzen be a Dataverse-szervezetbe, ahonnan el szeretné távolítani az értesítéseket.

2. A Chrome böngészőben keresse meg a törölni kívánt visszahívási regisztrációt.

   1. Tekintse át az összes visszahívási regisztráció általános listáját az alábbi OData URI-n, hogy megtekinthesse az entitáson belüli callbackregistrations adatokat:

      https://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations:

      Feljegyzés

      Ha a rendszer nem ad vissza értékeket, előfordulhat, hogy nincs engedélye az entitástípus megtekintésére, vagy ha nem jelentkezett be a megfelelő szervezetbe.

   2. Szűrjön az eseményindító entitás logikai nevére entityname és a logikai alkalmazás munkafolyamatának (üzenetének) megfelelő értesítési eseményre. Minden eseménytípus az üzenet egész számára van leképezve az alábbiak szerint:

      Eseménytípus	Üzenet egésze
      Létrehozás	0
      Törlés	2
      Frissítés	3
      CreateOrUpdate	4
      CreateOrDelete	5
      UpdateOrDelete	6
      CreateOrUpdateOrDelete	7

      Az alábbi példa bemutatja, hogyan szűrhet Create értesítéseket egy nevesített nov_validation entitásra az alábbi OData URI használatával egy mintaszervezet esetében:

      https://fabrikam-preprod.crm1.dynamics.com/api/data/v9.0/callbackregistrations?$filter=entityname eq 'nov_validation' and message eq 1

      

      Feljegyzés

      Ha ugyanahhoz az entitáshoz vagy eseményhez több eseményindító is létezik, a listát további szűrőkkel, például az createdon _owninguser_value attribútumokkal szűrheti. A tulajdonos felhasználójának neve a következő alatt /api/data/v9.0/systemusers({id})jelenik meg: .

   3. Miután megtalálta a törölni kívánt visszahívás-regisztráció azonosítóját, kövesse az alábbi lépéseket:

      1. A Chrome böngészőben nyissa meg a Chrome fejlesztői eszközeit (billentyűzet: F12).

      2. Az ablak tetején kattintson a Konzol fülre.

      3. A parancssorban adja meg ezt a parancsot, amely kérést küld a megadott visszahívási regisztráció törlésére:

         fetch('http://{organization-name}.crm{instance-number}.dynamics.com/api/data/v9.0/callbackregistrations({ID-to-delete})', { method: 'DELETE'})

         Fontos

         Győződjön meg arról, hogy a kérést egy nem egyesített ügyféloldalról (UCI) készíti el, például az OData vagy az API válaszoldaláról. Ellenkező esetben a app.js fájl logikája megzavarhatja ezt a műveletet.

   4. Ha ellenőrizni szeretné, hogy a visszahívási regisztráció már nem létezik-e, ellenőrizze a visszahívási regisztrációk listáját.

Duplikált "callbackregistrations" entitás

A Standard logikai alkalmazás munkafolyamataiban, bizonyos feltételek mellett, például a példányok újratelepítése vagy az alkalmazás újraindítása esetén a Microsoft Dataverse-eseményindító duplikált futtatást indít el, amely létrehoz egy ismétlődő callbackregistrations entitást a Dataverse-adatbázisban. Ha Dataverse-eseményindítóval kezdődő standard munkafolyamatot szerkeszt, ellenőrizze, hogy az callbackregistrations entitás duplikálva van-e. Ha az ismétlődés létezik, törölje manuálisan az ismétlődő entitást callbackregistrations .

Következő lépések

• Felügyelt összekötők az Azure Logic Appshez
• Beépített összekötők az Azure Logic Appshez
• Mik azok az összekötők az Azure Logic Appsben?