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.
Támogatott képességek
Ez a Xero-összekötő a következő képességekhez támogatott:
Támogatott képességek | IR |
---|---|
Copy tevékenység (forrás/-) | ① ② |
Keresési tevékenység | ① ② |
(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 és OAuth 1.0 hitelesítés. Az OAuth 1.0 esetében az összekötő a Xero privát alkalmazást támogatja, 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 használja az alábbi eszközök vagy SDK-k egyikét:
- Az Adatok másolása eszköz
- The Azure portal
- A .NET SDK
- A Python SDK
- Azure PowerShell
- A REST API
- Az Azure Resource Manager-sablon
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:
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.
Csatlakozás or 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 társított szolgáltatás esetében a következő tulajdonságok támogatottak:
Property | Leírás | Required |
---|---|---|
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 : |
||
házigazda | A Xero-kiszolgáló végpontja (api.xero.com ). |
Igen |
authenticationType | Az engedélyezett értékek és OAuth_1.0 a OAuth_2.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:
Property | Leírás | Required |
---|---|---|
típus | Az adathalmaz típustulajdonságának a következőnek kell lennie: XeroObject | Igen |
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 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:
Property | Leírás | Required |
---|---|---|
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. For example: "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 banki tranzakciók például összetett "LineItems" adatstruktúrával
Bank_Transaction_ID
rendelkeznek, így a banki tranzakciók adatai táblázatraBank_Transaction
vannak leképezve, ésBank_Transaction_Line_Items
idegen kulccsal összekapcsolják őket.A Xero-adatok két sémán keresztül érhetők el:
Minimal
(alapértelmezett) ésComplete
. 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_Telefon
- Contacts_Addresses
- Contacts_Purchases_Tracking_Categories
- Credit_Notes
- Credit_Notes_Allocations
- Expense_Claims
- Expense_Claim_Validation_Errors
- Invoices
- Invoices_Credit_Notes
- Invoices_ előrefizetések
- Invoices_Overpayments
- Manual_Journals
- Túlfizetések
- Overpayments_Allocations
- Előlegek
- Prepayments_Allocations
- Receipts
- 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.
Kapcsolódó tartalom
A másolási tevékenység által támogatott adattárak listáját a támogatott adattárakban találja.