Megosztás a következőn keresztül:

Tesztkapcsolat megvalósítása

  • Cikk

A tesztkapcsolat egy egyszerű belépési pont, amely meghatározható egy összekötőhöz a Azure Logic Apps, Power Automate, or használatával való használatra Power Apps. Ha egy műveletet tesz elérhetővé a tesztelési kapcsolatban, az összekötő elvégezheti a kapcsolati paraméterek tervezéskori és futtatáskori érvényesítését.

Előfeltételek

Új tesztkapcsolati művelet hozzáadása

A műveletek rendkívül egyszerűen adhatók hozzá a TestConnection elemhez. Választhat, hogy egy meglévő műveletet használ a kapcsolat teszteléséhez, vagy hozzáadhat egy külön, csak a kapcsolati paraméterek tesztelésére használt műveletet. A műveletnek „get” típusúnak kell lennie, és támogatnia kell a paraméter nélküli vagy a nem módosítható paraméterekkel rendelkező hívásokat.

Egy új művelet hozzáadása erre a célra így nézhet ki a OpenAPI specifikációban:

    "/diagnostics/testconnection": {
      "get": {
        "tags": [ "Diagnostics" ],
        "operationId": "TestMyAPIConnection",
        "consumes": [],
        "produces": [],
        "responses": {
          "200": { "description": "OK" },
          "default": { "description": "Operation Failed." }
        },
        "x-ms-visibility": "internal"
      }
    }

Fontos

Figyelje meg, hogy a műveletet internal műveletként jelöli meg a rendszer. Ha új belépési pontot ad hozzá erre a célra, erősen ajánlott elrejteni ezt a műveletet a felhasználó elől a láthatóság megjelölésével.

A tesztkapcsolatként használt végpontot úgy kell azonosítani, hogy egy bővítményt kell hozzáadni a legfelső szinten az API-hoz a következő módon:

 "x-ms-capabilities": {
    "testConnection": {
      "operationId": "TestMyAPIConnection",
      "parameters": {}
    }
  }

Az operationId ebben az attribútumban megadottnak ugyanazon OpenAPI specifikáción belül kell léteznie ahhoz, hogy érvényes legyen.

Meglévő művelet újrafelhasználása tesztkapcsolathoz

Gyakran egyszerűbb és kezelhetőbb azonosítani egy meglévő műveletet, amely nagy költségek vagy késés nélkül ellenőrizheti a kapcsolat életképességét. Ez új művelet hozzáadása nélkül végezhető el: egyszerűen jelezni kell, hogy melyik műveletet használja és (ha van ilyen) melyik paramétert adja át a rendszer.

Az alábbi példa egy meghívott GetTables "get" műveletet használ, amelynek sikeresnek kell lennie, ha a kapcsolat érvényes és a paraméterek helyesek. Annak érdekében, hogy a tesztkapcsolati művelet a lehető leggyorsabban végrehajtható legyen, a példa egy paramétert is hozzáad a híváshoz, amely meghatározza, hogy csak az első sort kell visszaadni.

 "x-ms-capabilities": {
    "testConnection": {
      "operationId": "GetTables",
      "parameters": {
        "$top": 1
      }
    }
  }

Tesztkapcsolat megvalósítása

Ha tesztkapcsolatot kell megvalósítania, és más meglévő művelet nem megfelelő erre a célra, ezt egy egyszerű háttérhívással teheti meg. A műveletnek nem kell paramétereket felvennie, vagy semmilyen tartalmat visszaadnia. Az URL-cím elérési útja szintén nem fontos, és igény szerint kiválasztható. A tesztkapcsolat-hívás sikerének egyetlen mércéje a HTTP-hívásból származó sikeres válasz (például 200). A csatlakozási tesztműveleten belül a szerződés azt kéri, hogy az összekötő érvényesítse a hitelesítési környezetet és a kapcsolati paramétereket.

Ez úgy valósítható meg, hogy lekérdez valami egyszerűt a háttérben, amely felhasználja a hitelesítési paramétereket és minden olyan adatbázist vagy hatókört, amely esetleg implikálható. Egy egyszerű táblázat felső sorának lekérdezése a kapcsolattesztelési módszerek egy jó példája.

Visszajelzés küldése

Nagyra értékeljük az összekötőplatform problémáival kapcsolatos visszajelzéseket és az új funkciókkal kapcsolatos ötleteket. Ha visszajelzést szeretne küldeni, lépjen a Problémák küldése vagy segítség kérése az összekötőkkel kapcsolatban részre, és válassza ki a visszajelzés típusát.