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

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 Synapse Analytics-pijplijn om gegevens te kopiëren uit QuickBooks Online. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Belangrijk

Deze connector is momenteel beschikbaar in preview. U kunt het uitproberen en ons feedback geven. Neem contact op met de ondersteuning van Azure als u een afhankelijkheid van preview-connectors wilt opnemen in uw oplossing.

Ondersteunde mogelijkheden

Deze 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 de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

Deze 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:

• Het hulpprogramma voor het kopiëren van gegevens
• Azure Portal
• De .NET-SDK
• De Python-SDK
• Azure PowerShell
• De REST API
• Een Azure Resource Manager-sjabloon

Een gekoppelde service maken voor QuickBooks met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor QuickBooks in de gebruikersinterface van Azure Portal.

1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

   Azure Data Factory

   

   Azure Synapse

   

2. Zoek naar QuickBooks en selecteer de QuickBooks-connector.

   

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

   

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt voor het definiëren van Data Factory-entiteiten die specifiek zijn voor de QuickBooks-connector.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde QuickBooks-service:

Eigenschappen	Beschrijving	Vereist
type	De eigenschap Type moet worden ingesteld op: QuickBooks	Ja
connectionProperties	Een groep eigenschappen die definieert hoe u verbinding maakt met QuickBooks.	Ja
Onder connectionProperties:
endpoint	Het eindpunt van de QuickBooks Online-server. (dat wil quickbooks.api.intuit.com)	Ja
companyId	De bedrijfs-id van het bedrijf QuickBooks dat moet worden geautoriseerd. Zie Hoe kan ik mijn bedrijfs-id vinden voor informatie over het vinden van de bedrijfs-id.	Ja
consumerKey	De client-id van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Hier vindt u meer informatie.	Ja
consumerSecret	Het clientgeheim van uw QuickBooks Online-toepassing voor OAuth 2.0-verificatie. Markeer dit veld als SecureString om 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. Hier vindt u meer informatie. Het vernieuwingstoken wordt na 180 dagen verlopen. De klant moet het vernieuwingstoken regelmatig bijwerken. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault.	Ja
useEncryptedEndpoints	Hiermee geeft u op of de eindpunten van de gegevensbron zijn versleuteld met HTTPS. De standaardwaarde is waar.	Nee

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 echter regelmatig het vernieuwingstoken bij, waarbij de vorige wordt 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 zodra het vernieuwingstoken is verlopen.

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

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door de QuickBooks-gegevensset.

Als u gegevens uit QuickBooks Online wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op QuickBooksObject. De volgende eigenschappen worden ondersteund:

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

Voorbeeld

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

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen 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 worden ondersteund door de QuickBooks-bron.

QuickBooks als bron

Als u gegevens uit QuickBooks Online wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op QuickBooksSource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: QuickBooksSource	Ja
query	Gebruik de aangepaste SQL-query om gegevens te lezen. Voorbeeld: "SELECT * FROM "Bill" WHERE Id = '123'".	Nee (als 'tableName' in de gegevensset is opgegeven)

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

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.

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.