Adatok másolása a Xero-ból az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet egy Azure Data Factory vagy Synapse Analytics-folyamatban az adatok Xero-ból való másolásához. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Feljegyzés

A Xero-összekötő OAuth-hitelesítést igényel, és nem kiszolgálók közötti használatra készült.

Fontos

A Xero-összekötő 2.0-s verziója továbbfejlesztett natív Xero-támogatást biztosít. Ha a Xero-összekötő 1.0-s verzióját használja a megoldásban, frissítse a Xero-összekötőt2026. március 31-e előtt. Ebben a szakaszban a 2.0-s és az 1.0-s verzió közötti különbségről olvashat.

Támogatott képességek

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

Támogatott képességek	integrációs modul
Copy tevékenység (forrás/-)	(1) (2)
Keresési tevékenység	(1) (2)

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A 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-hitelesítés.
Minden Xero-tábla (API-végpont) a "Jelentések" kivételével.
Windows-verziók ebben a cikkben.

Feljegyzés

A Xero OAuth 1.0 hitelesítésének naplemente miatt frissítsen OAuth 2.0 hitelesítési típusra, ha jelenleg OAuth 1.0 hitelesítési típust használ.

Első lépések

A másolási tevékenység végrehajtásához egy folyamattal használhatja az alábbi eszközök vagy SDK-k egyikét:

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

Az alábbi lépésekkel hozzon létre társított szolgáltatást a Xero-hoz az Azure Portal felhasználói felületén.

Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:
- Azure Data Factory
- Azure Synapse
Keresse meg a Xero-t, és válassza ki a Xero-összekötőt.
Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

Az ö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ágok részleteit ismertetik.

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

A Xero-összekötő mostantól támogatja a 2.0-s verziót. Ebben a szakaszban frissítheti a Xero-összekötőjét az 1.0-s verzióról újabb verzióra. A tulajdonság részleteiért tekintse meg a megfelelő szakaszokat.

2.0-s verzió
1.0-s verzió

2.0-s verzió

A Xero társított szolgáltatás a következő tulajdonságokat támogatja a 2.0-s verzió alkalmazásakor:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőre kell állítania: Xero	Igen
verzió	A megadott verzió. Az érték `2.0`.	Igen
állomás	A Xero-kiszolgáló végpontja (`api.xero.com`).	Igen
clientId	Adja meg a Xero-alkalmazás ügyfélazonosítóját . Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
clientSecret	Adja meg a Xero-alkalmazás ügyfélkulcsát . Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
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 ellenőrzéséből.	Igen
refreshToken	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 folyamat, é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örét. Ismert korlátozás: Megjegyzés: A Xero visszaá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 használatához. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs futtatókörnyezet. Ha nincs megadva érték, a tulajdonság az alapértelmezett Azure-integrációs modult használja. Használhatja a saját üzemeltetésű integrációs modult, amelynek verziója 5.61-es vagy újabb.	Nem

Példa:

{
    "name": "XeroLinkedService",
    "properties": {
        "type": "Xero",
        "typeProperties": {
            "host": "api.xero.com",
            "clientId": "<client ID>",
            "clientSecret": "<client secret>",
            "tenantId": "<tenant ID>", 
            "refreshToken": {
                "type": "SecureString",
                "value": "<refresh token>"
            },
            "authenticationType":"OAuth_2.0", 
            "version": "2.0"         
        }
    }
}

1.0-s verzió

A Xero társított szolgáltatás az alábbi tulajdonságokat támogatja az 1.0-s verzió alkalmazásakor:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőre kell állítania: Xero	Igen
connectionProperties	A Xero-hoz való csatlakozás módját meghatározó tulajdonságok csoportja.	Igen
A következő alatt `connectionProperties`:
állomás	A Xero-kiszolgáló végpontja (`api.xero.com`).	Igen
authenticationType	Az engedélyezett értékek és `OAuth_2.0`a `OAuth_1.0` .	Igen
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 SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
privateKey	OAuth 2.0 esetén adja meg a Xero-alkalmazás ügyfélkulcsát . OAuth 1.0 esetén adja meg a Xero privát alkalmazáshoz létrehozott .pem fájl titkos kulcsát. Vegye figyelembe, hogy a privatekey.pem 512`openssl genrsa -out privatekey.pem 512`numbittel való létrehozásához az 1024 nem támogatott. Adja meg a .pem fájl összes szövegét, beleértve a Unix-sorvégződéseket(\n), lásd az alábbi mintát. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
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 ellenőrzéséből.	OAuth 2.0-hitelesítés esetén igen
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 folyamat, é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örét. Ismert korlátozás: Megjegyzés: A Xero visszaá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 használatához. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	OAuth 2.0-hitelesítés esetén igen
useEncryptedEndpoints	Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz.	Nem
useHostVerification	Megadja, hogy a kiszolgáló tanúsítványában kötelező-e a gazdagépnév, hogy megfeleljen a kiszolgáló gazdagépnevének a TLS-en keresztüli csatlakozáskor. Az alapértelmezett érték igaz.	Nem
usePeerVerification	Megadja, hogy ellenőrizze-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem

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 titkos kulcs értéke:

Adja meg a .pem fájl összes szövegét, 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-----"

Adathalmaz 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.

Az adatok Xero-ból való másolásához á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őnek kell lennie: XeroObject	Igen
tábla	A tábla neve. A táblanevek az objektum nevét használják, például: `Accounts`. Ez a tulajdonság csak a 2.0-s verzióban támogatott.	Igen
tableName	A tábla neve. A táblanevek például `"Global"."Accounts"`az előtaggal rendelkező objektumneveket használják. Ez a tulajdonság csak az 1.0-s verzióban támogatott.	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"
        }
    }
}

Az összekötő 2.0-s verziója a következő Xero-táblákat támogatja:

Accounts
Bank_Tranzakció_Sor tételek
Banki átutalások
Budgets
Contacts_Addresses
Kapcsolat_Csoport_Kapcsolatok
Contacts_Phones
Jóváírási_jegy_tételsorok
Hiteljegyzetek Sor Tételek Követése
Pénznemek
Számla_sor_tételek
Számla sor tételeinek nyomon követése
Elemek
Naplók
Naplóvonalak
Napló_sor_követési_kategóriák
Manual_Journals
Kézi_Napló_Sorok
Szervezetek
Előre fizetett tételek
Projektek
Projektfelhasználók
Megrendelési_sor_tétel
Adó_kulcsok
Tracking_Categories
Nyomkövetési_kategóriák_beállításai
Felhasználók

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 mint forrás

Az adatok Xero-ból való másolásához állítsa a másolási tevékenység forrástípusát a XeroSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

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őnek kell lennie: XeroSource	Igen
lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. Például: `"SELECT * FROM Contacts"`	Nem (ha "tableName" van megadva az adathalmazban)

Feljegyzés

query a 2.0-s verzió nem támogatja.

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 banki tranzakciók például összetett "LineItems" adatstruktúrával Bank_Transaction rendelkeznek, így a banki tranzakciók adatai táblázatra Bank_Transaction_Line_Items vannak leképezve, és Bank_Transaction_IDidegen kulccsal ö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 igényelnek (például azonosító oszlop) 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

A Xero adattípus-leképezése

Amikor adatokat másol a Xero-ból, a következő leképezések vonatkoznak a Xero adattípusaitól a szolgáltatás által használt belső adattípusokra. Ha szeretné megtudni, hogyan képezi le a másolási tevékenység a forrássémát és az adattípust a célhelyre, tekintse meg a séma- és adattípus-leképezéseket.

Xero adattípus	Köztes szolgáltatás adattípusa (a 2.0-s verzióhoz)	Köztes szolgáltatás adattípusa (1.0-s verzióhoz)
Lánc	Lánc	Lánc
Date	Lánc	Date
DateTime	Lánc	Lánc
logikai	logikai	logikai
Szám (alapértelmezett)	Int32	Int32
Nagy számok	Int64	Int64

Keresési tevékenység tulajdonságai

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

A Xero-összekötő életciklusa és frissítése

Az alábbi táblázat a Xero-összekötő különböző verzióinak kiadási fázisát és változásnaplóit mutatja be:

verzió	Kiadási szakasz	Változások naplója
1.0-s verzió	Bejelentett támogatás megszűnése	/
2.0-s verzió	Elérhető GA-verzió	• A társított szolgáltatásban a `consumerKey` a `clientId`-re lesz cserélve, és a `privateKey` a `clientSecret`-re. • Használja a `table` a `tableName` helyett adathalmazokban. Az `table` értéke az objektum neve, például `Accounts`. • A saját üzemeltetésű integrációs modul verziójának 5.61-es vagy újabb verziónak kell lennie. • A dátum sztring adattípusként van beolvasva. • Bizonyos Xero-táblák támogatása. A támogatott táblalistában válassza az Adathalmaz tulajdonságai lehetőséget. • `useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` nem támogatott a társított szolgáltatásban. • `query` nem támogatott. • Az OAuth 1.0 hitelesítés nem támogatott.

A Xero-összekötő frissítése az 1.0-s verzióról a 2.0-s verzióra

A Csatolt szolgáltatás szerkesztése lapon válassza ki a 2.0-s verziót, és konfigurálja a csatolt szolgáltatást a Csatolt szolgáltatás tulajdonságai 2.0-s verziójára hivatkozva.
A Xero társított szolgáltatás 2.0-s verziójának adattípus-leképezése eltér az 1.0-s verziótól. A legújabb adattípus-leképezés megismeréséhez tekintse meg a Xero adattípus-leképezését.
Ha a saját üzemeltetésű integrációs modult használja, annak verziójának 5.61-es vagy újabbnak kell lennie.
A 2.0-s verzió helyett table használjatableName. A részletes konfigurációért lépjen az Adathalmaz tulajdonságai elemre.
query csak az 1.0-s verzió támogatja. A table helyett a verzió 2.0-ban query-t kell használnia.
Vegye figyelembe, hogy a 2.0-s verzió bizonyos Xero-táblákat támogat. A támogatott táblalistában válassza az Adathalmaz tulajdonságai lehetőséget.

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

Visszacsatolás

Hasznos volt ez az oldal?

Last updated on 2026-01-04

Megosztás:

Adatok másolása a Xero-ból az Azure Data Factory vagy a Synapse Analytics használatával

Támogatott képességek

Első lépések

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

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

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

2.0-s verzió

1.0-s verzió

Adathalmaz tulajdonságai

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

Xero mint forrás

A Xero adattípus-leképezése

Keresési tevékenység tulajdonságai

A Xero-összekötő életciklusa és frissítése

A Xero-összekötő frissítése az 1.0-s verzióról a 2.0-s verzióra

Kapcsolódó tartalom

Visszacsatolás

További források