Kopírování dat z Xero pomocí služby Azure Data Factory nebo Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data z Xero. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor Xero je podporovaný pro následující funkce:

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Konkrétně tento konektor Xero podporuje:

• Ověřování OAuth 2.0
• Všechny tabulky Xero (koncové body rozhraní API) s výjimkou sestav.
• Verze Windows v tomto článku.

Začínáme

K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:

• Nástroj pro kopírování dat
• Azure Portal
• Sada .NET SDK
• Sada Python SDK
• Azure PowerShell
• Rozhraní REST API
• Šablona Azure Resource Manageru

Vytvoření propojené služby pro Xero pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu pro Xero v uživatelském rozhraní webu Azure Portal.

1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:

   • Azure Data Factory
   • Azure Synapse

   

2. Vyhledejte Xero a vyberte konektor Xero.

   

3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

   

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor Xero.

Vlastnosti propojené služby

Pro propojenou službu Xero se podporují následující vlastnosti:

Příklad: Ověřování OAuth 2.0

{
    "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říklad: Ověřování OAuth 1.0

{
    "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
            }
        }
    }
}

Ukázková hodnota privátního klíče:

Zahrňte veškerý text ze souboru .pem včetně konců řádků unixu(\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-----"

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Xero.

Chcete-li kopírovat data z Xero, nastavte vlastnost typu datové sady na XeroObject. Podporují se následující vlastnosti:

Příklad

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

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Xero.

Xero jako zdroj

Pokud chcete kopírovat data z Xero, nastavte typ zdroje v aktivitě kopírování na XeroSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Příklad:

"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>"
            }
        }
    }
]

Při zadávání dotazu Xero si poznamenejte následující:

• Tabulky se složitými položkami se rozdělí na více tabulek. Například bankovní transakce mají složitou datovou strukturu LineItems, takže data bankovní transakce jsou mapována na tabulku Bank_Transaction a Bank_Transaction_Line_Items, s Bank_Transaction_ID jako cizí klíč pro jejich propojení.

• Data Xero jsou k dispozici prostřednictvím dvou schémat: Minimal (výchozí) a Complete. Schéma Dokončeno obsahuje tabulky požadovaných volání, které před vytvořením požadovaného dotazu vyžadují další data (např. sloupec ID).

Následující tabulky mají stejné informace ve schématu Minimum a Complete. Pokud chcete snížit počet volání rozhraní API, použijte minimální schéma (výchozí).

• Bank_Transactions
• Contact_Groups
• Kontakty
• Contacts_Sales_Tracking_Categories
• Contacts_Phones
• Contacts_Addresses
• Contacts_Purchases_Tracking_Categories
• Credit_Notes
• Credit_Notes_Allocations
• Expense_Claims
• Expense_Claim_Validation_Errors
• Faktury
• Invoices_Credit_Notes
• Invoices_ zálohy
• Invoices_Overpayments
• Manual_Journals
• Přeplatky
• Overpayments_Allocations
• Zálohy
• Prepayments_Allocations
• Účtenky
• Receipt_Validation_Errors
• Tracking_Categories

Následující tabulky lze dotazovat pouze s úplným schématem:

• Complete.Bank_Transaction_Line_Items
• Complete.Bank_Transaction_Line_Item_Tracking
• Complete.Contact_Group_Contacts
• Complete.Contacts_Contact_ Osoby
• Complete.Credit_Note_Line_Items
• Complete.Credit_Notes_Line_Items_Tracking
• platby Complete.Expense_Claim_
• 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

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Související obsah

Seznam podporovaných úložišť dat aktivitou kopírování najdete v podporovaných úložištích dat.