Adatok másolása a Xeroból a Azure Data Factory vagy a Synapse Analytics használatával

A KÖVETKEZŐKRE VONATKOZIK: Azure Data Factory Azure Synapse Analytics

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet egy Azure Data Factory vagy Synapse Analytics-folyamatban adatok másolásához a Xero-ból. A másolási tevékenység áttekintési cikkére épül, amely általános áttekintést nyújt a másolási tevékenységről.

Támogatott képességek

Ez a Xero-összekötő a következő tevékenységekhez támogatott:

A Xero adatait átmásolhatja bármely támogatott fogadóadattárba. A másolási tevékenység által forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Ez a Xero-összekötő a következőket támogatja:

  • OAuth 2.0 és OAuth 1.0 hitelesítés. Az OAuth 1.0 esetében az összekötő támogatja a Xero privát alkalmazását , nyilvános alkalmazást azonban nem.
  • Minden Xero-tábla (API-végpont) a "Jelentések" kivételével.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához az alábbi eszközök vagy SDK-k egyikét használhatja:

Társított szolgáltatás létrehozása a Xero szolgáltatáshoz felhasználói felület használatával

Az alábbi lépésekkel hozhat létre társított szolgáltatást a Xero számára a Azure Portal felhasználói felületén.

  1. Tallózással lépjen a Azure Data Factory vagy Synapse-munkaterület Kezelés lapjára, válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

  2. Keresse meg a Xero-t, és válassza ki a Xero-összekötőt.

    Select the Xero connector.

  3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

    Configure a linked service to Xero.

Összekötő konfigurációjának részletei

A következő szakaszok a Xero-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságokat ismertetik.

Társított szolgáltatás tulajdonságai

A Xero társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Tulajdonság Leírás Kötelező
típus A típustulajdonságnak a következőre kell állítania: Xero Yes
connectionProperties A Xero-hoz való csatlakozás módját meghatározó tulajdonságok csoportja. Yes
A következő alatt connectionProperties:
gazda A Xero-kiszolgáló végpontja (api.xero.com). Yes
authenticationType Az engedélyezett értékek a következők: OAuth_2.0 és OAuth_1.0. Yes
consumerKey OAuth 2.0 esetén adja meg a Xero-alkalmazás ügyfél-azonosítóját .
OAuth 1.0 esetén adja meg a Xero alkalmazáshoz társított fogyasztói kulcsot.
Jelölje meg ezt a mezőt SecureString-ként, hogy biztonságosan tárolja, vagy hivatkozzon egy Azure-Key Vault tárolt titkos kódra.
Yes
privateKey OAuth 2.0 esetén adja meg a Xero-alkalmazás titkos ügyfélkulcsát .
OAuth 1.0 esetén adja meg a privát Xero-alkalmazáshoz létrehozott .pem fájl titkos kulcsát. Vegye figyelembe , hogy az 512 numbitet tartalmazó privatekey.pem létrehozása az 1024 használatával openssl genrsa -out privatekey.pem 512nem támogatott. A .pem fájl összes szövegének belefoglalása a Unix-sorvégződésekkel (\n) együtt, lásd az alábbi példát.

Jelölje meg ezt a mezőt SecureString-ként, hogy biztonságosan tárolja, vagy hivatkozzon egy Azure-Key Vault tárolt titkos kódra.
Yes
tenantId A Xero-alkalmazáshoz társított bérlőazonosító. OAuth 2.0-hitelesítés esetén alkalmazható.
Megtudhatja, hogyan szerezheti be a bérlőazonosítót a Hozzáférésre jogosult bérlők szakaszból.
Igen OAuth 2.0-hitelesítés esetén
refreshToken OAuth 2.0-hitelesítés esetén alkalmazható.
Az OAuth 2.0 frissítési jogkivonat a Xero alkalmazáshoz van társítva, és a hozzáférési jogkivonat frissítésére szolgál; a hozzáférési jogkivonat 30 perc után lejár. Ebből a cikkből megtudhatja, hogyan működik a Xero engedélyezési folyamata, és hogyan szerezheti be a frissítési jogkivonatot. Frissítési jogkivonat beszerzéséhez le kell kérnie a offline_access hatókört.
Ismert korlátozás: Megjegyzés: A Xero alaphelyzetbe állítja a frissítési jogkivonatot a hozzáférési jogkivonat frissítéséhez való használat után. Az üzembe helyezett számítási feladatok esetében minden másolási tevékenység futtatása előtt be kell állítania egy érvényes frissítési jogkivonatot a szolgáltatás számára.
Jelölje meg ezt a mezőt SecureString-ként, hogy biztonságosan tárolja, vagy hivatkozzon egy Azure-Key Vault tárolt titkos kódra.
Igen OAuth 2.0-hitelesítés esetén
useEncryptedEndpoints Meghatározza, hogy az adatforrásvégpontok HTTPS-kapcsolattal legyenek-e titkosítva. Az alapértelmezett érték az igaz. No
useHostVerification Megadja, hogy az állomásnév kötelező-e a kiszolgáló tanúsítványában ahhoz, hogy megegyezik-e a kiszolgáló állomásnevével, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték az igaz. No
usePeerVerification Meghatározza, hogy ellenőrizni kell-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték az igaz. No

Példa: OAuth 2.0-hitelesítés

{
    "name": "XeroLinkedService",
    "properties": {
        "type": "Xero",
        "typeProperties": {
            "connectionProperties": { 
                "host": "api.xero.com",
                "authenticationType":"OAuth_2.0", 
                "consumerKey": {
                    "type": "SecureString",
                    "value": "<client ID>"
                },
                "privateKey": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "tenantId": "<tenant ID>", 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true
            }            
        }
    }
}

Példa: OAuth 1.0-hitelesítés

{
    "name": "XeroLinkedService",
    "properties": {
        "type": "Xero",
        "typeProperties": {
            "connectionProperties": {
                "host": "api.xero.com", 
                "authenticationType":"OAuth_1.0", 
                "consumerKey": {
                    "type": "SecureString",
                    "value": "<consumer key>"
                },
                "privateKey": {
                    "type": "SecureString",
                    "value": "<private key>"
                }, 
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
}

Minta titkoskulcs-érték:

A .pem fájl összes szövegének belefoglalása, beleértve a Unix-sorvégződéseket (\n).

"-----BEGIN RSA PRIVATE KEY-----\nMII***************************************************P\nbu****************************************************s\nU/****************************************************B\nA*****************************************************W\njH****************************************************e\nsx*****************************************************l\nq******************************************************X\nh*****************************************************i\nd*****************************************************s\nA*****************************************************dsfb\nN*****************************************************M\np*****************************************************Ly\nK*****************************************************Y=\n-----END RSA PRIVATE KEY-----"

Adatkészlet tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a Xero-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a Xero-ból, állítsa az adathalmaz típustulajdonságát XeroObject értékre. A következő tulajdonságok támogatottak:

Tulajdonság Leírás Kötelező
típus Az adathalmaz típustulajdonságának a következőre kell állítania: XeroObject Yes
tableName A tábla neve. Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

{
    "name": "XeroDataset",
    "properties": {
        "type": "XeroObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Xero linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a Xero-forrás által támogatott tulajdonságok listáját tartalmazza.

Xero forrásként

Ha adatokat szeretne másolni a Xero-ból, állítsa be a másolási tevékenység forrástípusát a XeroSource-ra. A másolási tevékenység forrás szakasza a következő tulajdonságokat támogatja:

Tulajdonság Leírás Kötelező
típus A másolási tevékenység forrásának típustulajdonságának a következőre kell állítania: XeroSource Yes
lekérdezés Az adatok olvasásához használja az egyéni SQL lekérdezést. Példa: "SELECT * FROM Contacts". Nem (ha "tableName" van megadva az adathalmazban)

Példa

"activities":[
    {
        "name": "CopyFromXero",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Xero input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "XeroSource",
                "query": "SELECT * FROM Contacts"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

A Xero-lekérdezés megadásakor vegye figyelembe a következőket:

  • Az összetett elemeket tartalmazó táblák több táblára lesznek felosztva. A banktranzakciók például összetett adatstruktúrával (LineItems) vannak, így a banki tranzakciók adatai táblára Bank_Transaction vannak leképezve, és Bank_Transaction_Line_Itemsidegen Bank_Transaction_ID kulcsként összekapcsolják őket.

  • A Xero-adatok két sémán keresztül érhetők el: Minimal (alapértelmezett) és Complete. A Complete séma előfeltételként szolgáló hívástáblákat tartalmaz, amelyek további adatokat (például azonosító oszlopot) igényelnek a kívánt lekérdezés végrehajtása előtt.

Az alábbi táblázatok ugyanazokat az információkat tartalmazzák a Minimális és a Teljes sémában. Az API-hívások számának csökkentéséhez használja a Minimális sémát (alapértelmezett).

  • Bank_Transactions
  • Contact_Groups
  • Kapcsolattartók
  • Contacts_Sales_Tracking_Categories
  • Contacts_Phones
  • Contacts_Addresses
  • Contacts_Purchases_Tracking_Categories
  • Credit_Notes
  • Credit_Notes_Allocations
  • Expense_Claims
  • Expense_Claim_Validation_Errors
  • Számlák
  • Invoices_Credit_Notes
  • Invoices_ előrefizetések
  • Invoices_Overpayments
  • Manual_Journals
  • Túlfizetések
  • Overpayments_Allocations
  • Előlegek
  • Prepayments_Allocations
  • Nyugták
  • Receipt_Validation_Errors
  • Tracking_Categories

A következő táblák csak teljes sémával kérdezhetők le:

  • Complete.Bank_Transaction_Line_Items
  • Complete.Bank_Transaction_Line_Item_Tracking
  • Complete.Contact_Group_Contacts
  • Complete.Contacts_Contact_ Személyek
  • Complete.Credit_Note_Line_Items
  • Complete.Credit_Notes_Line_Items_Tracking
  • Complete.Expense_Claim_ kifizetések
  • Complete.Expense_Claim_Receipts
  • Complete.Invoice_Line_Items
  • Complete.Invoices_Line_Items_Tracking
  • Complete.Manual_Journal_Lines
  • Complete.Manual_Journal_Line_Tracking
  • Complete.Overpayment_Line_Items
  • Complete.Overpayment_Line_Items_Tracking
  • Complete.Prepayment_Line_Items
  • Complete.Prepayment_Line_Item_Tracking
  • Complete.Receipt_Line_Items
  • Complete.Receipt_Line_Item_Tracking
  • Complete.Tracking_Category_Options

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Következő lépések

A másolási tevékenység által támogatott adattárak listáját a támogatott adattárakban találja.