Kopiera data från QuickBooks Online med Azure Data Factory eller Synapse Analytics (förhandsversion)

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från QuickBooks Online. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Viktigt!

Den här anslutningsappen är för närvarande i förhandsversion. Du kan prova och ge oss feedback. Om du vill skapa ett beroende på anslutningsappar som är i förhandsversion i din lösning kan du kontakta Azure-supporten.

Funktioner som stöds

Den här QuickBooks-anslutningsappen stöds för följande funktioner:

Funktioner som stöds IR
Kopieringsaktivitet (källa/-) (1) (2)
Sökningsaktivitet (1) (2)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.

Den här anslutningsappen stöder QuickBooks OAuth 2.0-autentisering.

Komma igång

Om du vill utföra kopieringsaktiviteten med en pipeline kan du använda något av följande verktyg eller SDK:er:

Skapa en länkad tjänst till QuickBooks med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till QuickBooks i azure-portalens användargränssnitt.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

  2. Sök efter QuickBooks och välj QuickBooks-anslutningsappen.

    Skärmbild av QuickBooks-anslutningsappen.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Skärmbild av konfiguration av länkad tjänst för QuickBooks.

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för QuickBooks-anslutningstjänsten.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade QuickBooks-tjänsten:

Property Beskrivning Obligatoriskt
type Typegenskapen måste anges till: QuickBooks Ja
connectionProperties En grupp med egenskaper som definierar hur du ansluter till QuickBooks. Ja
Under connectionProperties:
slutpunkt Slutpunkten för QuickBooks Online-servern. (det vill quickbooks.api.intuit.com) Ja
companyId Företags-ID för QuickBooks-företaget att auktorisera. Information om hur du hittar företags-ID finns i Hur hittar jag mitt företags-ID. Ja
consumerKey Klient-ID för ditt QuickBooks Online-program för OAuth 2.0-autentisering. Läs mer här. Ja
consumerSecret Klienthemligheten för ditt QuickBooks Online-program för OAuth 2.0-autentisering. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault. Ja
refreshToken OAuth 2.0-uppdateringstoken som är associerad med QuickBooks-programmet. Läs mer här. Obs! Uppdateringstoken upphör att gälla efter 180 dagar. Kunden måste regelbundet uppdatera uppdateringstoken.
Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault.
Ja
useEncryptedEndpoints Anger om datakällans slutpunkter krypteras med HTTPS. Standardvärdet är sant. Nej

Exempel:

{
    "name": "QuickBooksLinkedService",
    "properties": {
        "type": "QuickBooks",
        "typeProperties": {
            "connectionProperties": {
                "endpoint": "quickbooks.api.intuit.com",
                "companyId": "<company id>",
                "consumerKey": "<consumer key>", 
                "consumerSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "refreshToken": {
                     "type": "SecureString",
                     "value": "<refresh token>"
            	},
                "useEncryptedEndpoints": true
            }
        }
    }
}

Hantera uppdateringstoken för den länkade tjänsten

När du använder QuickBooks Online-anslutningsappen i en länkad tjänst är det viktigt att hantera OAuth 2.0-uppdateringstoken från QuickBooks korrekt. Den länkade tjänsten använder en uppdateringstoken för att hämta nya åtkomsttoken. QuickBooks Online uppdaterar dock uppdateringstoken regelbundet och ogiltigförklarar den tidigare. Den länkade tjänsten uppdaterar inte uppdateringstoken automatiskt i Azure Key Vault, så du måste hantera uppdatering av uppdateringstoken för att säkerställa oavbruten anslutning. Annars kan det uppstå autentiseringsfel när uppdateringstoken upphör att gälla.

Du kan uppdatera uppdateringstoken manuellt i Azure Key Vault baserat på QuickBooks Onlines policy för förfallodatum för uppdateringstoken. Men en annan metod är att automatisera uppdateringar med en schemalagd aktivitet eller Azure-funktion som söker efter en ny uppdateringstoken och uppdaterar den i Azure Key Vault.

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av QuickBooks-datauppsättningen.

Om du vill kopiera data från QuickBooks Online anger du datauppsättningens typegenskap till QuickBooksObject. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Typegenskapen för datamängden måste anges till: QuickBooksObject Ja
tableName Tabellens namn. Nej (om "fråga" i aktivitetskällan har angetts)

Exempel

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av QuickBooks-källan.

QuickBooks som källa

Om du vill kopiera data från QuickBooks Online anger du källtypen i kopieringsaktiviteten till QuickBooksSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: QuickBooksSource Ja
query Använd den anpassade SQL-frågan för att läsa data. Exempel: "SELECT * FROM "Bill" WHERE Id = '123'". Nej (om "tableName" i datauppsättningen har angetts)

Exempel:

"activities":[
    {
        "name": "CopyFromQuickBooks",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<QuickBooks input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "QuickBooksSource",
                "query": "SELECT * FROM \"Bill\" WHERE Id = '123' "
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Kopiera data från Quickbooks Desktop

Kopieringsaktiviteten i tjänsten kan inte kopiera data direkt från Quickbooks Desktop. Om du vill kopiera data från Quickbooks Desktop exporterar du dina Quickbooks-data till en CSV-fil (kommaavgränsade värden) och laddar sedan upp filen till Azure Blob Storage. Därifrån kan du använda tjänsten för att kopiera data till valfri mottagare.

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.