Gegevens kopiëren uit QuickBooks Online met behulp van Azure Data Factory of Azure Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit gebruikt in een Azure Data Factory- of Azure Synapse Analytics-pijplijn om gegevens te kopiëren uit QuickBooks Online. Het is gebaseerd op het overzichtsartikel over de kopieeractiviteit.

Belangrijk

De QuickBooks-connector versie 1.0 bevindt zich in de verwijderingsfase. U wordt aangeraden om de QuickBooks-connector te upgraden van versie 1.0 naar 2.0.

Ondersteunde mogelijkheden

De QuickBooks-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Copy-activiteit (bron/-)	(1) (2)
Activiteit Lookup	(1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen of sinks.

De connector ondersteunt OAuth 2.0-verificatie voor QuickBooks.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

• Tool Gegevens kopiëren
• Azure-portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure Resource Manager-sjabloon

Een gekoppelde service maken voor QuickBooks met behulp van de gebruikersinterface

1. Ga in Azure Portal naar uw Azure Data Factory- of Azure Synapse-werkruimte.

2. Ga naar het tabblad Beheren , selecteer Gekoppelde services en selecteer vervolgens Nieuw.

   Azure Data Factory

   

   Azure Synapse

   

3. Zoek naar QuickBooks en selecteer vervolgens de QuickBooks-connector.

   

4. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

   

Configuratiedetails van connector

U gebruikt eigenschappen om Data Factory-entiteiten te definiëren die specifiek zijn voor de QuickBooks-connector.

Eigenschappen van gekoppelde service

De QuickBooks-connector ondersteunt nu versie 2.0. Als u uw QuickBooks-connector wilt upgraden van versie 1.0 naar versie 2.0, raadpleegt u de procedure verderop in dit artikel. In de volgende secties worden de eigenschapsdetails voor de twee versies beschreven.

Versie 2.0

De gekoppelde QuickBooks-service ondersteunt de volgende eigenschappen voor connectorversie 2.0:

Eigenschappen	Beschrijving	Vereist
type	Het type gekoppelde service. Deze moet worden ingesteld op QuickBooks.	Ja
version	De versie die je opgeeft. De waarde is 2.0.	Ja
endpoint	Het eindpunt van de QuickBooks Online-server. De waarde is quickbooks.api.intuit.com.	Ja
companyId	De bedrijfs-id van het bedrijf QuickBooks dat moet worden geautoriseerd. Zie het Help-onderwerp QuickBooks Online voor informatie over het vinden van de bedrijfs-id.	Ja
consumerKey	De client-id van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Meer informatie.	Ja
consumerSecret	Het clientgeheim van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Markeer dit veld om SecureString het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Ja
refreshToken	Het OAuth 2.0-vernieuwingstoken dat is gekoppeld aan de QuickBooks-toepassing. Meer informatie. Markeer dit veld om SecureString het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Het refresh token verloopt na 180 dagen, dus klanten moeten het regelmatig vernieuwen.	Ja

Hier is een voorbeeld:

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

Versie 1.0

De gekoppelde QuickBooks-service ondersteunt de volgende eigenschappen voor connectorversie 1.0:

Eigenschappen	Beschrijving	Vereist
type	Het type gekoppelde service. Deze moet worden ingesteld op QuickBooks.	Ja
connectionProperties	Een groep eigenschappen waarmee wordt gedefinieerd hoe u verbinding maakt met QuickBooks.	Ja
Onder connectionProperties:
endpoint	Het eindpunt van de QuickBooks Online-server. De waarde is quickbooks.api.intuit.com.	Ja
companyId	De bedrijfs-id van het bedrijf QuickBooks dat moet worden geautoriseerd. Zie het Help-onderwerp QuickBooks Online voor informatie over het vinden van de bedrijfs-id.	Ja
consumerKey	De client-id van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Meer informatie.	Ja
consumerSecret	Het clientgeheim van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Markeer dit veld om SecureString het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Ja
refreshToken	Het OAuth 2.0-vernieuwingstoken dat is gekoppeld aan de QuickBooks-toepassing. Meer informatie. Markeer dit veld om SecureString het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Het refresh token verloopt na 180 dagen, dus klanten moeten het regelmatig vernieuwen.	Ja
useEncryptedEndpoints	Hiermee geeft u op of de eindpunten van de gegevensbron worden versleuteld via HTTPS. De standaardwaarde is true.	Nee

Hier is een voorbeeld:

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

Vernieuwingstokens verwerken voor de gekoppelde service

Wanneer u de QuickBooks Online-connector in een gekoppelde service gebruikt, is het belangrijk om OAuth 2.0-vernieuwingstokens van QuickBooks correct te beheren.

De gekoppelde service gebruikt een vernieuwingstoken om nieuwe toegangstokens te verkrijgen. QuickBooks Online werkt het refresh-token echter regelmatig bij. Met deze actie wordt het vorige token ongeldig.

De gekoppelde service werkt het vernieuwingstoken niet automatisch bij in Azure Key Vault, dus u moet het bijwerken van het vernieuwingstoken beheren om een ononderbroken verbinding te garanderen. Anders kunnen er verificatiefouten optreden nadat de refresh-token is verlopen.

U kunt het vernieuwingstoken in Azure Key Vault handmatig bijwerken op basis van het QuickBooks Online-beleid voor het verlopen van vernieuwingstokens. Een andere benadering is het automatiseren van updates met behulp van een geplande taak of een Azure-functie die controleert op een nieuw vernieuwingstoken en deze bijwerkt in Azure Key Vault.

Eigenschappen van gegevensset

Zie Gegevenssets in Azure Data Factory en Azure Synapse Analytics voor een volledige lijst met beschikbare secties en eigenschappen voor het definiëren van gegevenssets.

Als u gegevens uit QuickBooks Online wilt kopiëren, stelt u de type eigenschap van de gegevensset in op QuickBooksObject. De QuickBooks-gegevensset ondersteunt de volgende eigenschappen:

Eigenschappen	Beschrijving	Vereist
type	Het type gegevensset. Deze moet worden ingesteld op QuickBooksObject.	Ja
tableName	Naam van de tabel.	Nee (als query in de activiteitsbron is opgegeven)

Hier is een voorbeeld:

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

De connectorversie 2.0 ondersteunt de volgende QuickBooks-tabellen:

• Account
• Koppelbaar
• Attachable_AttachableRef
• Attachable_AttachableRef_CustomField
• Rekening
• BillPayment_Line
• BillPayment_Line_LinkedTxn
• Factuur_Rekening_Gebaseerde_Kostenregel
• Factuur_Item_Gebaseerde_Kostenregel
• Bill_LinkedTxn
• Rekeningbetaling
• Bill_TxnTaxDetail_TaxLine
• Begroting
• Budget_Detail
• Class
• BedrijfValuta_CustomField
• CompanyInfo_NameValue
• Bedrijfs_Valuta
• Bedrijfsinformatie
• Kredietkaartbetaling
• CreditMemo_CustomField
• Creditnota_Omschrijving_Lijn
• CreditMemo_Discount_Line
• Creditnota_Groep_Individueel_Item_Regel
• CreditMemo_Group_Item_Line
• CreditMemo_Sales_Item_Line
• CreditMemo_Subtotal_Line
• CreditMemo_TxnTaxDetail_TaxLine (CreditMemo_Transactietaxdetail_Belastingregel)
• Credit_Memo
• Customer
• Klanttype
• Afdeling
• Deponeren
• Deposit_CustomField
• Deposit_Line
• Deposit_Line_CustomField
• Stortings_Gekoppelde_Transactie_Detail
• Storting_Gekoppeld_Transactie_Regel
• Deposit_TxnTaxDetail_TaxLine
• Werknemer
• Schatten
• Estimate_CustomField
• Schatting_Beschrijving_Regel
• Estimate_Discount_Line
• Schat_Groep_Individueel_Item_Regel
• Estimate_Group_Item_Line
• Estimate_LinkedTxn
• Estimate_Sales_Item_Line
• Estimate_Subtotal_Line
• Estimate_TxnTaxDetail_TaxLine
• Invoice
• Factuur_AangepastVeld
• Factuur_Omschrijving_Regel
• Factuur_Korting_Regel
• Factuur_Groep_Individueel_Item_Regel
• Factuur_Groep_Item_Regel
• Invoice_LinkedTxn (Factuur_GekoppeldTransactie)
• Factuur_Verkoop_Artikel_Regel
• Factuur_Subtotaal_Regel
• Invoice_TxnTaxDetail_TaxLine
• Item
• JournalCode_CustomField
• JournaalInvoer_Omschrijving_Regel
• DagboekInschrijving_Regel
• JournalEntry_TxnTaxDetail_TaxLine
• Dagboek_Code
• Journal_Entry
• Betaling
• Betaling_Lijn
• Payment_Line_LinkedTxn
• Betaalmethode
• Preferences
• Voorkeuren_VerkopenFormuliervoordelen_AangepastVeld
• Preferences_OtherPrefs_NameValue
• Voorkeuren_LeverancierEnAankopenVoorkeurs_POAangepastVeld
• Inkoop
• Aankoop_Account_Gebaseerde_Onkosten_Regel
• Aankoop_Item_Gebaseerde_Kostenregel
• Purchase_TxnTaxDetail_TaxLine
• Inkooporder
• Aankooporder_AangepastVeld
• PurchaseOrder_Rekening_Gebaseerde_Onkost_Lijn
• Uitgave Regel op basis van Inkooporder Artikel
• Aankooporder_LinkedTxn
• PurchaseOrder_TxnTaxDetail_TaxLine
• TerugkerendeTransactie
• TerugkerendeTransactieRegels
• TerugbetalingOntvangst_AangepastVeld
• Teruggavebon_Beschrijving_Regel
• Terugbetalingsbewijs_Kortingsregel
• Terugbetalingsbon_Groep_Individueel_Item_Regel
• TerugbetalingOntvangst_Groep_Item_Regel
• Terugbetalingsbon_Verkopen_Artikel_Regel
• Terugbetalingsbon_Subtotaal_Regel
• RefundReceipt_TxnTaxDetail_TaxLine
• Terugbetalingsbewijs
• ReimburseCharge
• ReimburseCharge_Line
• Verkoopbon_AangepastVeld
• Verkoopbon_Omschrijving_Rij
• Verkoopbon_Korting_Regel
• VerkoopBon_Groep_Individueel_Artikel_Regel
• Verkoopbon_Groep_Artikel_Regel
• SalesReceipt_Sales_Item_Line
• Verkoopbon_Subtotaal_Regel
• SalesReceipt_TxnTaxDetail_TaxLine
• Verkoopbon
• BelastingClassificatie
• TaxCode_Aankoopbelastingtarievenlijst_BelastingtariefDetail
• TaxCode_SalesTaxRateList_TaxRateDetail
• Belastingdienst
• Tax_Code
• Belastingtarief
• Termijn
• Tijd_Activiteit
• Overdracht
• Leverancier
• VendorCredit_Account_Based_Expense_Line
• Leverancierskrediet_Itemgebaseerd_Kostenregel
• Leverancierskrediet

Eigenschappen van de kopieeractiviteit

Zie Pijplijnen en activiteiten in Azure Data Factory en Azure Synapse Analytics voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die door de QuickBooks-bron worden ondersteund.

QuickBooks als bron

Als u gegevens uit QuickBooks Online wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op QuickBooksSource. De QuickBooks-gegevensset ondersteunt de volgende eigenschappen in de sectie source van de kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	Het type bron van de kopieeractiviteit. Deze moet worden ingesteld op QuickBooksSource.	Ja
query	Gebruik de aangepaste SQL-query om gegevens te lezen. Voor versie 2.0 van de QuickBooks-connector kunt u alleen de systeemeigen QuickBooks-query gebruiken, met beperkingen. Zie Querybewerkingen en syntaxis op de site Intuit Developer voor meer informatie. Voor versie 1.0 van de QuickBooks-connector kunt u de SQL-92-query gebruiken. Voorbeeld: "SELECT * FROM "Bill" WHERE Id = '123'".	Nee (als tableName in de gegevensset is opgegeven)

Hier is een voorbeeld:

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

Zie Pijplijnen en activiteiten in Azure Data Factory en Azure Synapse Analytics voor een volledige lijst met beschikbare secties en eigenschappen voor het definiëren van activiteiten.

Gegevens kopiëren vanuit QuickBooks Desktop

De kopieeractiviteit in de service kan geen gegevens rechtstreeks vanuit QuickBooks Desktop kopiëren. Als u gegevens uit QuickBooks Desktop wilt kopiëren, exporteert u uw QuickBooks-gegevens naar een CSV-bestand (door komma's gescheiden waarden) en uploadt u het bestand vervolgens naar Azure Blob Storage. Van daaruit kunt u de service gebruiken om de gegevens naar de sink van uw keuze te kopiëren.

Mapping van gegevenstypen voor QuickBooks

Wanneer u gegevens kopieert uit QuickBooks, zijn de volgende toewijzingen van toepassing op de interne gegevenstypen die door de service worden gebruikt. Zie Schema- en gegevenstypetoewijzing in kopieeractiviteit voor meer informatie over hoe de kopieeractiviteit het bronschema en het gegevenstype toewijst aan de sink.

QuickBooks-gegevenstype	Tussentijds servicedatatype (voor versie 2.0)	Interim service-gegevenssoort (voor versie 1.0)
String	string	string
Boolean	bool	bool
DateTime	datetime	datetime
Decimal	decimal (15,2)	decimal (15, 2)
Enum	string	string
Date	datetime	datetime
BigDecimal	decimal (15,2)	decimal (15, 2)
Integer	int	int

Eigenschappen van opzoekactiviteit

Zie Lookup-activiteit in Azure Data Factory en Azure Synapse Analytics voor meer informatie over de eigenschappen van de opzoekactiviteit.

Levenscyclus van de Quickbooks-connector en upgrade

De volgende tabel bevat een overzicht van de versies van de QuickBooks-connector:

Versie	Releasefase	Wijzigingslogboek
1.0	Removed	Niet van toepassing.
2.0	Algemene beschikbaarheid	Systeemeigen QuickBooks-query wordt ondersteund, met beperkingen. GROUP BY componenten, JOIN componenten en statistische functies (Avg, Max, Sum) worden niet ondersteund. Zie Querybewerkingen en syntaxis op de site Intuit Developer voor meer informatie. De SQL-92-query wordt niet ondersteund. De useEncryptedEndpoints eigenschap wordt niet ondersteund. Ondersteuning voor specifieke Quickbooks-tabellen. Ga voor de lijst met ondersteunde tabellen naar Eigenschappen van gegevensset.

De Quickbooks-connector upgraden van versie 1.0 naar versie 2.0

1. Ga in Azure Portal naar uw Azure Data Factory- of Azure Synapse-werkruimte.

2. Ga naar het tabblad Beheren , selecteer Gekoppelde services en selecteer vervolgens Bewerken voor de gekoppelde service.

3. Selecteer in het deelvenster Gekoppelde service bewerken2.0 voor de versie. Zie de eigenschappen van de gekoppelde service voor versie 2.0 eerder in dit artikel voor meer informatie.

4. Als u een SQL-query gebruikt in de bron van de kopieeractiviteit of de opzoekactiviteit die verwijst naar de gekoppelde versie 1.0-service, moet u deze converteren naar de systeemeigen QuickBooks-query. Meer informatie over de systeemeigen query van de eigenschappen van de kopie-activiteit eerder in dit artikel en over querybewerkingen en syntaxis op de Intuit Developer-site.

5. Houd er rekening mee dat versie 2.0 specifieke Quickbooks-tabellen ondersteunt. Ga voor de lijst met ondersteunde tabellen naar Eigenschappen van gegevensset.

Gerelateerde inhoud

• Zie Ondersteunde gegevensarchieven en -indelingen voor een lijst met gegevensarchieven die door de kopieeractiviteit worden ondersteund als bronnen en sinks.