Копирование данных из QuickBooks Online с помощью Azure Data Factory или Azure Synapse Analytics

ПРИМЕНИМО К: Azure Data Factory Azure Synapse Analytics

В этой статье описывается, как использовать действие копирования в конвейере Azure Data Factory или Azure Synapse Analytics для копирования данных из QuickBooks Online. Он базируется на обзорной статье об операции копирования.

Поддерживаемые возможности

Соединитель QuickBooks поддерживается для следующих возможностей:

(1) Azure среды выполнения интеграции (2) локальная среда выполнения интеграции

Список хранилищ данных, поддерживаемых в качестве источников или приемников, см. в разделе "Поддерживаемые хранилища данных".

Соединитель поддерживает проверку подлинности QuickBooks OAuth 2.0.

Начало работы

Для выполнения действия копирования с конвейером можно использовать один из следующих средств или пакетов SDK:

• Средство копирования данных
• портал Azure
• SDK .NET
• пакет SDK Python
• Azure PowerShell
• REST API
• шаблон Azure Resource Manager

Создание связанной службы в QuickBooks с помощью пользовательского интерфейса

1. На портале Azure перейдите в рабочую область Azure Data Factory или Azure Synapse.

2. Перейдите на вкладку "Управление ", выберите "Связанные службы" и нажмите кнопку "Создать".

   • Фабрика данных Azure
   • Azure Synapse

   

3. Найдите QuickBooks и выберите соединитель QuickBooks.

   

4. Настройте сведения о службе, проверьте подключение и создайте связанную службу.

   

Сведения о конфигурации соединителя

Параметры используются для настройки сущностей службы Data Factory, относящихся к коннектору QuickBooks.

Свойства связанной службы

Соединитель QuickBooks теперь поддерживает версию 2.0. Чтобы обновить соединитель QuickBooks с версии 1.0 до версии 2.0, см. процедуру далее в этой статье. В следующих разделах описаны характеристики для обеих версий.

Версия 2.0

Связанная служба QuickBooks поддерживает следующие свойства соединителя версии 2.0:

Ниже приведен пример:

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

Версия 1.0

Связанная служба QuickBooks поддерживает следующие свойства соединителя версии 1.0:

Ниже приведен пример:

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

Обработка токенов обновления для связанной службы

При использовании коннектора QuickBooks Online в связанной службе важно правильно управлять токенами обновления OAuth 2.0 в QuickBooks.

Подключённая служба использует токен обновления для получения новых токенов доступа. Однако QuickBooks Online периодически обновляет токен обновления. Это действие делает недействительным предыдущий маркер.

Связанная служба автоматически не обновляет токен обновления в Azure Key Vault, поэтому необходимо самостоятельно обновлять токен обновления, чтобы обеспечить непрерывное подключение. В противном случае после истечения срока действия токена обновления могут возникнуть ошибки аутентификации.

Вы можете вручную обновить маркер обновления в Azure Key Vault на основе политики QuickBooks Online для истечения срока действия маркеров обновления. Другой подход — автоматизировать обновления с помощью запланированной задачи или функции Azure, которая проверяет наличие нового маркера обновления и обновляет его в Azure Key Vault.

Свойства набора данных

Полный список доступных разделов и свойств для определения наборов данных см. в разделе Datasets в Azure Data Factory и Azure Synapse Analytics.

Чтобы скопировать данные из QuickBooks Online, задайте type для свойства набора данных значение QuickBooksObject. Набор данных QuickBooks поддерживает следующие свойства:

Ниже приведен пример:

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

Соединитель версии 2.0 поддерживает следующие таблицы QuickBooks:

• Счет
• Присоединяемый
• Подключаемый_СсылкаНаПодключаемый
• Attachable_AttachableRef_CustomField
• Счет
• Линия_ОплатыСчета
• BillPayment_Line_LinkedTxn
• Bill_Account_Based_Expense_Line
• Строка_расходов_по_пункту_счета
• Bill_LinkedTxn
• Оплата_счетов
• Bill_TxnTaxDetail_TaxLine
• Бюджет
• Детали_бюджета
• Class
• КомпанияВалюта_ПользовательскоеПоле
• CompanyInfo_NameValue
• Компания_Валюта
• Информация_о_компании
• ОплатаКредитнойКартой
• КредитныйМеморандум_ПользовательскоеПоле
• Описание_КредитногоМемо_Строка
• КредитноеИзвещение_Скидка_Строка
• Корректировочный документ_Группа_Индивидуальный элемент_Строка
• CreditMemo_Group_Item_Line
• CreditMemo_Sales_Item_Line
• КредитныйДокумент_ИтоговаяСумма_Строка
• CreditMemo_TxnTaxDetail_НалоговаяЛиния
• Кредитовое_авизо
• Клиент
• Тип клиента
• Отдел
• Депозит
• Депозит_ПользовательскоеПоле
• Строка_Депозита
• Deposit_Line_CustomField
• Подробности_транзакции_связанных_с_депозитом
• Линия транзакции, связанная с депозитом
• Deposit_TxnTaxDetail_TaxLine
• Сотрудник
• Оценка
• Оценка_ПроизвольноеПоле
• Описание_Строки_Оценки
• Оценка_скидки_строка
• Оценка_Группа_Индивидуальный_Элемент_Строка
• Оценка_Группа_Элемент_Строка
• Estimate_LinkedTxn
• Оценка_Продаж_Строка_Товара
• Оценка_Промежуточный_Итог
• Оценка_ДеталиНалогаПоТранзакции_НалоговаяСтрока
• Invoice
• Счет_ПользовательскоеПоле
• Строка_Описание_Счета
• Строка_Скидки_Счета
• Счет_Группа_Индивидуальный_Элемент_Строка
• Основная_Строка_Группового_Элемента_Счета
• Счёт-фактура_Связанная транзакция
• Счёт_Продажа_Позиция_Строка
• Строка промежуточного итога счёта-фактуры
• Invoice_TxnTaxDetail_TaxLine
• Item
• JournalCode_CustomField
• ОписаниеЗаписи_Строка
• JournalEntry_Line
• JournalEntry_TxnTaxDetail_TaxLine
• Код_Журнала
• Запись_Журнала
• Уплата
• Строка_оплаты
• Payment_Line_LinkedTxn
• Способ_Оплаты
• Preferences
• Настройки_ПреференцииФормПродаж_ПользовательскоеПоле
• Preferences_OtherPrefs_NameValue
• Настройки_ПоставщикИПокупки_НастроечноеПолеПО
• Покупка
• Линия расходов на основе учетной записи закупок
• Строка_Затраты_На_Основании_Покупки_Товара
• Purchase_TxnTaxDetail_TaxLine
• Заказ на покупку
• ЗаказНаПоставку_НастраиваемоеПоле
• Заказ_на_покупку_На_основе_учета_Статья_расходов
• Строка_Расходов_По_Покупкам_Товаров
• PurchaseOrder_LinkedTxn
• ЗаказНаПокупку_ДеталиНалогаТранзакции_НалоговаяСтрока
• Повторяющаяся транзакция
• Повторяющиеся строки транзакций
• Квитанция о возврате_Пользовательское поле
• Описание_ВозвратКвитанция_Строка
• КвитанцияВозврата_Скидка_Линия
• ВозвратКвитанция_Группа_Индивидуальный_Предмет_Строка
• ВозвратНакладной_Группа_Элемент_Строка
• КвитанцияОВозврате_Продажи_Элемент_Строка
• ВозвратЧек_Итого_Строка
• Квитанция о возврате (RefundReceipt), Детали налога транзакции (TxnTaxDetail), Налоговая строка (TaxLine)
• Квитанция_о_возврате
• ВозмещениеРасходов
• ВозмещениеРасходов_Строка
• Чек_на_продажу_CustomField
• Описание_Чека_Продаж
• ПродажаЧек_Скидка_Строка
• Строка_Группы_Продажного_Чека_Отдельного_Товара
• Чек_Группа_Позиция_Строка
• ПродажаКвитанция_ПунктТовара_Строка
• SalesReceipt_Subtotal_Line
• SalesReceipt_TxnTaxDetail_TaxLine
• Квитанция_о_продаже
• Классификация налогов
• TaxCode_PurchaseTaxRateList_TaxRateDetail
• TaxCode_СписокСтавокПродажНалоговаяСтавкаДетали
• Налоговое агентство
• Налоговый_кодекс
• Ставка_Налога
• Срок
• Время_Активность
• Передать
• Поставщик
• Кредит поставщика_расходы на основе учета_строка расходов
• VendorCredit_Item_Based_Expense_Line
• Кредит_поставщика

Свойства Copy activity

Полный список разделов и свойств, доступных для определения действий, см. в разделе Pipelines и действия в Azure Data Factory и Azure Synapse Analytics. В этом разделе представлен список свойств, поддерживаемых источником QuickBooks.

QuickBooks в качестве источника

Чтобы скопировать данные из QuickBooks Online, задайте тип источника в действии QuickBooksSourceкопирования. Набор данных QuickBooks поддерживает следующие свойства в разделе действия source копирования:

Ниже приведен пример:

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

Полный список доступных разделов и свойств для определения действий см. в разделе Pipelines и действия в Azure Data Factory и Azure Synapse Analytics.

Копирование данных из QuickBooks Desktop

Операция копирования в службе не может копировать данные непосредственно из QuickBooks Desktop. Чтобы скопировать данные из QuickBooks Desktop, экспортируйте данные QuickBooks в файл с разделим запятыми (CSV-файл), а затем отправьте его в Azure Blob Storage. Оттуда вы сможете использовать службу для копирования данных в приемник по вашему выбору.

Сопоставление типов данных для QuickBooks

При копировании данных из QuickBooks следующие сопоставления применяются из типов данных QuickBooks к внутренним типам данных, которые использует служба. Чтобы узнать, как действие копирования сопоставляет исходную схему и тип данных с приемником, см. в разделе Схема и сопоставление типов данных в действии копирования.

Свойства операции поиска

Дополнительные сведения о свойствах активности подстановки см. в разделе Lookup activity в Azure Data Factory и Azure Synapse Analytics.

Жизненный цикл коннектора QuickBooks и его обновление

В следующей таблице приведены сведения о версиях соединителя QuickBooks:

Обновление соединителя Quickbooks с версии 1.0 до версии 2.0

1. На портале Azure перейдите в рабочую область Azure Data Factory или Azure Synapse.

2. Перейдите на вкладку "Управление ", выберите "Связанные службы" и выберите "Изменить " для связанной службы.

3. На панели "Изменить связанную службу " выберите 2.0 для версии. Дополнительные сведения см. в свойствах связанной службы для версии 2.0 ранее в этой статье.

4. Если вы используете SQL-запрос в источнике задачи копирования или задаче «поиск», которые относятся к связанной службе версии 1.0, необходимо преобразовать его в запрос, совместимый с QuickBooks. Дополнительные сведения о нативном запросе из свойств Copy activity ранее в этой статье и из Операций и синтаксиса Query на сайте разработчика Intuit.

5. Обратите внимание, что версия 2.0 поддерживает определенные таблицы Quickbooks. В списке поддерживаемых таблиц перейдите к свойствам набора данных.

Связанный контент

• Список хранилищ данных, поддерживаемых действием копирования в качестве источников и приемников, см. в разделе "Поддерживаемые хранилища данных и форматы".