2 Обзор импорта данных на основе файлов

В этой главе содержится следующее:

  • О документации по импорту на основе файлов

  • Параметры импорта данных

  • Как работает импорт данных на основе файлов

  • Как задачи импорта данных на основе файлов работают вместе

О файловом импорте Документация

В этом разделе представлен обзор типов справки, доступных для импорта устаревших и других данных в службы продаж и B2B с помощью импорта данных на основе файлов.

Основными источниками информации для импорта являются:

  • Документация по продажам CX и службе B2B в облачном справочном центре (https ://docs.oracle.com/en/cloud/saas/index.html).

    • Изучите последний важный справочный контент, поддерживающий продажи и услуги B2B.

    • Загрузите версии руководств в формате PDF, найдите ссылки на справочные материалы и официальные документы и выполните поиск по конкретным темам.

    • Просмотрите разделы данных импорта на вкладке «Администрирование», которые предоставляют ключевую информацию об импорте данных на основе файлов.

  • Щелкните значок справки в разделе «Продажи и услуги B2B» и просмотрите общие темы по импорту или поиску по отдельным объектам импорта для примеров , атрибуты и другая информация.

  • Руководство по импорту данных на основе файлов для продаж CX и обслуживания B2B доступно в Справочном центре (https://docs.oracle.com/en/cloud/ saas/index.html)

    • Найдите справочные файлы с подробной информацией об отдельных атрибутах.

Чтобы понять, какие атрибуты доступны для импорта для каждого объекта, выполните следующие действия:

  1. Начните с поиска в справке, используя ключевое слово importing и имя объекта, который вы импортируете.

    Например, чтобы получить помощь по импорту контактов, введите импорт контактов.

    В зависимости от сложности импорта ваш поиск возвращает один или несколько из следующих типов тем справки:

    Заголовок раздела справки Описание

    Импорт

    Тема этого типа информирует пользователя о том, как структурирован каждый бизнес-объект, и объясняет его связь с объектом импорта.

    Объекты импорта: как они работают вместе

    Этот тип темы перечисляет целевые объекты импорта, связанные с каждым объектом импорта, и предоставляет имена справочных файлов, которые описывают атрибуты этих целевых объектов. Целевые объекты — это объекты, из которых вы выбираете атрибуты при создании сопоставления операций импорта.

    Как вы импортируете

    Этот тип темы содержит список атрибутов, которые необходимо или условно необходимо включить в файл импорта при импорте записей для объекта..

    Импорт : концептуальный пример

    Этот тип темы предоставляет пример того, как импортировать объект без подробных шагов.

    Импорт : рабочий пример

    В этом типе темы вы шаг за шагом рассмотрите пример.

  2. См. справочные файлы, перечисленные в разделах Импорт объектов: как они работают вместе, которые связаны в разделе Импорт данных на основе файлов для CX Sales и B2B Service руководство, доступное в Справочном центре (https://docs.oracle.com/en/cloud/saas/index.html). Справочные файлы содержат подробные описания атрибутов и разрешенных значений.

Параметры импорта данных

Вы можете импортировать данные из внешнего приложения в приложения Oracle. Облако несколькими способами, в том числе с помощью общедоступных веб-сервисов. Какой метод импорта вы используете, зависит от типа импортируемых данных, объема данных и технических требований. Если вы интегрируете одну облачную службу с другими облачными службами, вам необходимо использовать дополнительные методы импорта, как описано в соответствующих руководствах.

Когда вы импортируете данные для определенного объекта, вы должны убедиться, что все необходимые объекты уже существуют в приложении. Например, если вы импортируете контакты для учетной записи, она должна уже существовать в приложении. Если одно задание импорта зависит от содержимого другого задания импорта, завершите предварительное задание перед запуском зависимого задания. Например, если вы импортируете и учетные записи, и возможности, импортируйте учетные записи перед импортом возможностей.

В следующей таблице перечислены методы импорта и ссылки на дополнительную информацию.

Метод импорта Описание Когда использовать Как получить доступ Для получения дополнительной информации

Макросы быстрого импорта Excel

Вы можете использовать макросы импорта, чтобы ускорить и упростить импорт до 5000 записей за раз для некоторых объектов. Они проверяют ваши записи данных, предоставляют список значений и автоматически подставляют постоянные значения.

Макросы создают файлы данных, которые автоматически импортируются с помощью управления импортом.

Вы можете импортировать следующие объекты с помощью макросов импорта:

  • Sales Users

  • Продукты и группы продуктов

  • Учетные записи

  • Контакты

  • Иерархия аккаунтов

  • Лиды

  • Возможности

Лучше всего импортировать данные при первоначальном развертывании..

Макросы предназначены для простого доказательства концепции использования автоматизации продаж, описанного в главе «Импорт пользователей продаж» руководства «Начало работы с продажами». Например, макросы импорта предполагают, что вы импортируете записи учетных записей, контактов и интересов для одной страны за раз.

Макросы создают файлы журналов с информацией о задании импорта файлов, и эти файлы журналов также могут служить в качестве обучающего инструмента для более сложного импорта.

Вы можете загрузить макросы Excel и любые необходимые файлы сопоставления из статьи «Начало работы с вашей реализацией: макросы быстрого импорта (идентификатор документа 2229503.1)» на сайте My Oracle Support. .

В главах руководства «Начало работы с продажами» приведены подробные инструкции и видеоуроки по использованию макросов.

Инструкции по добавлению собственных полей в макросы см. в разделе. Как настроить макрос быстрого импорта для импорта ресурсов сотрудников (идентификатор документа 2364229.1), статья в My Oracle Support.

Управление импортом

Улучшено управление импортом определение, обработка ошибок и производительность для импорта плоских файлов (.CSV). Например, Управление импортом имеет возможности сопоставления перетаскиванием и проверяет первые десять записей в файле данных перед импортом, чтобы гарантировать, что данные соответствуют ограничениям импорта различных атрибутов. Вы можете использовать Управление импортом для импорта файлов данных, содержащих до 50 000 записей каждый..

Управление импортом доступно для импорта данных для следующих объектов приложения:

  • Учетная запись

  • Действие

  • План действий

  • Мероприятие

  • Адрес

  • Актив

  • Приложение

  • Бизнес-план

  • Кампания

  • Классификация

  • Потребитель

  • Контакт

  • Регистрация сделки

  • Иерархия

  • Член иерархии

  • Семья

  • Входящий Сообщение

  • Взаимодействие

  • Бюджет MDF

  • Требование MDF

  • Запрос MDF

  • Сообщение

  • Примечание

  • Возможность

  • Партнер

  • Партнерская программа

  • Продукт

  • Группа продуктов

  • Регистрация в программе

  • Продвижение

  • Связь

  • Ресурс

  • Объем ресурсов

  • Руководитель продаж

  • Цель продаж

  • Заказ на продажу

  • Территория продаж

  • Роль самообслуживания

  • Запрос на обслуживание

  • Стандартный текст

  • Стандартная текстовая папка

  • Стандартная текстовая пользовательская переменная

  • Подписка

  • Шаблон

  • Любые дополнительные объекты, которые вы создаете

Используйте Управление импортом для импорта, выходящего за рамки руководства «Приступая к работе с вашей реализацией» (это руководство).

Oracle планирует прекратить поддержку импорта файлов с обновлением 20D.

Щелкните Управление импортом в навигаторе.

См. руководство «Общие сведения об управлении импортом и экспортом» для получения инструкций по использованию импорта.

Импорт файлов

Поддержка импорта файлов импорт файлов данных, содержащих до 100 000 записей в каждом для самого широкого диапазона объектов, включая настраиваемые объекты.

Используйте импорт файлов только для любых объектов, еще не охваченных Управлением импортом.

Oracle планирует прекратить поддержку импорта файлов с обновлением 20D.

Вы можете получить доступ к задачам импорта файлов, перейдя к следующему в рабочей области установки и обслуживания:

  • Предложение: продажи

  • Функциональная область: импорт и экспорт данных

Вы можете узнать, как импортировать, в руководстве Общие сведения об импорте и экспорте данных на основе файлов.

Руководство по импорту данных на основе файлов для продаж CX и B2B Service предоставляет информацию об атрибутах импорта, включая допустимые значения и проверки.

Клиент внешнего загрузчика данных

Команда -строчный инструмент, который используется для импорта больших объемов файлов с плоскими исходными данными в CX Sales и B2B Service. Этот инструмент разбивает большой файл данных на несколько файлов меньшего размера в соответствии с ограничениями объема импорта и позволяет отслеживать статус импорта.

Клиент поддерживает те же объекты, что и Управление импортом.

Используйте этот метод импорта для импорта очень больших файлов данных для объектов поддерживается Управлением импортом.

Вы можете загрузить клиент из документа поддержки Oracle 2325249.1 (клиент внешнего загрузчика данных) на сайте My Oracle Support.

Инструкции по использованию клиента доступны в документе и в самом клиенте.

Документацию по REST API см. в руководстве по REST API для CX Sales и B2B Service.

Веб-службы

Веб-службы доступен для внешних клиентских приложений для запуска и отслеживания заданий импорта. Вы можете управлять заданиями управления импортом с помощью веб-служб REST и заданиями импорта файлов с помощью веб-служб SOAP.

Используйте веб-службы для управления заданиями импорта для импорта непосредственно из внешнего приложения.

Общедоступные API доступны как для служб управления импортом/REST, так и для служб импорта файлов/SOAP.

Для импорта доступны следующие REST API:

  • Импорт действий

  • Импорт карт действий

  • Импорт метаданных объектов экспорта

Служба SOAP называется службой активности импорта файлов.

Документацию по REST API см. в руководстве по REST API для CX Sales и B2B Service.

Документацию по SOAP API см. в руководстве по веб-службам SOAP для продаж CX и службам B2B.

Импорт большого объема

режим массового импорта предназначен для одновременного импорта миллионов записей. В этом режиме не запускается никакая пользовательская логика, настроенная через композитор приложения. Список поддерживаемых объектов см. В теме Импорт данных в разделе связанных тем.

Используйте этот режим импорта для импорта очень большого количества записей для поддерживаемых объектов.

Вы можете получить доступ к крупномасштабному импорту либо с помощью служб REST, либо с помощью клиента внешнего загрузчика данных.

При импорте с использованием REST установите атрибут «High-volume», чтобы включить этот режим импорта.

При импорте с использованием клиента загрузчика внешних данных установите параметр командной строки «-high-volume», чтобы включить этот режим импорта.

Документацию по REST API см. в руководстве по REST API для CX Sales и B2B Service..

В главе «Импорт данных с помощью клиента внешнего загрузчика данных» руководства «Импорт данных на основе файлов для CX Sales и B2B Service» представлена ​​информация об использовании клиента внешнего загрузчика данных.

На следующем рисунке представлен архитектурный обзор различных методов импорта:

  • File Import использует архитектуру SOA для импорта данных в Oracle CX Sales.

  • Быстрый импорт использует веб-службы REST для импорта данных в Oracle CX Sales. Когда вы импортируете данные с помощью макросов быстрого импорта Excel, вы создаете операцию импорта в Управлении импортом с помощью веб-служб REST. При импорте макроса создается такое же действие импорта и используется то же сопоставление, что и при запуске импорта из приложения. Вы можете отслеживать каждый импорт в макросе или в самом приложении.

  • И Управление импортом, и клиент загрузчика внешних данных используют одни и те же запланированные процессы для импорта. Когда вы импортируете очень большие файлы с помощью клиента, API-интерфейсы REST создают несколько процессов для соблюдения ограничения размера файла управления импортом.

  • Для импорта из внешнего приложения используйте веб-службы SOAP и REST напрямую.

  • Общие сведения о файле -Руководство по импорту и экспорту данных

  • Руководство по управлению импортом и экспортом

  • REST Руководство по API для продаж CX и B2B Service

  • Руководство по веб-службам SOAP для продаж CX и B2B

  • Импорт данных

Как работает импорт данных на основе файлов

Определение Группа задач «Импорт файлов» основана на интеграции с различными компонентами архитектуры, такими как интерфейсные таблицы и базовые таблицы приложения. В этом разделе представлен обзор этих компонентов, который поможет вам понять процесс импорта и различные статусы операций импорта.

На следующем рисунке представлен обзор основных компонентов приложения, используемых при импорте данных из файла. Эти компоненты включают:

  • Импортировать объект

  • Импортировать отображение

  • Импорт активности

  • Репозиторий файлов

  • Application Composer

  • Интерфейсные таблицы

  • Базовые таблицы

Вы выбираете объект импорта во время установки. Сопоставление импорта используется на этапе сопоставления импорта. Загружаемый вами файл импорта хранится в репозитории файлов. Дополнительные атрибуты, которые вы создаете в Application Composer, хранятся в отдельном репозитории расширений и доступны для импорта и в сопоставлении импорта.

Примечание. Если вы измените переменные среды NLS_LANG и DATE_FORMAT, необходимо перезапустить приложения Oracle Fusion.

Импортировать объекты, Импортировать сопоставления и Операция импорта

При создании операции импорта выбранные вами объекты импорта предоставляются Oracle. Вы можете управлять этими объектами импорта с помощью задачи «Управление объектами импорта файлов».

Примечание. Избегайте одновременной отправки заданий импорта файлов для одного и того же объекта импорта. Одновременная отправка нескольких заданий импорта с одинаковым содержанием приводит к созданию повторяющихся записей объектов.

При создании действия импорта вы должны укажите сопоставление полей в вашем файле с атрибутами объекта импорта. Сопоставление можно создать при создании операции импорта или отдельно с помощью задачи «Управление сопоставлениями импорта файлов». Сопоставление хранится и управляется как отдельный объект.

Репозиторий файлов

Текстовый файл или файл данных XML, который вы загружаете при импорте сохраняется в файловом хранилище. Если вы загружаете какие-либо вложения, они также хранятся в том же репозитории.

Расширения Application Composer

Когда вы создаете дополнительные атрибуты для импорта данных с помощью Application Composer, расширения сохраняются в отдельном репозиторий и доступны для импорта и экспорта.

Таблицы интерфейса

Операция импорта заполняет таблицы интерфейса приложения вашими данными.

Базовые таблицы

Действие импорта загружает ваши данные в базовые таблицы для завершения импорта.

  • Статусы операций импорта файлов

  • Импорт данных из файла

Как работают вместе задачи импорта данных на основе файлов

Вы импортируете данные из текста или XML-файлы с использованием задач из группы задач «Определить импорт файла», доступной в рабочей области «Настройка и обслуживание». В этом разделе представлена ​​информация о каждой задаче во время импорта данных.

На этом изображении представлен обзор группы задач импорта данных на основе файлов и их взаимосвязей. Каждая задача объясняется в следующих разделах.

Управление действиями по импорту файлов

Используйте эту задачу для импорта данных путем создания операций импорта и отслеживания их выполнения. Чтобы создать операцию импорта, выполните следующие действия:

  1. Настройте параметры импорта.

    Вы выбираете объект, который вы ‘ повторного импорта, укажите формат файла и различные параметры импорта и загрузите файл с вашими данными. Доступные параметры зависят от импортируемого объекта. Например, некоторые объекты импорта позволяют загружать файл ZIP или Java-архива (JAR) с вложениями, которые будут прикреплены к записям в приложении после завершения импорта файла данных..

    Есть три уровня сложности для загрузки данных:

    • Нет зависимых загрузок — поскольку нет никаких зависимостей данных между импортируемых объектов, вы можете импортировать несколько объектов одновременно. Например, загрузка географии, отраслевой классификации, информации об единицах измерения и т. Д.

    • Простая загрузка зависимостей — вы используете первичный ключ для ссылки на родительский объект. Вы загружаете родительские объекты перед загрузкой дочерних объектов. Например, для загрузки заметок, действий, вложений и т. Д. Необходимо импортировать родительские объекты перед импортом заметок, действий, вложений и т. Д.

    • Загрузка сложных зависимостей. Перед импортом необходимого объекта необходимо импортировать несколько связанных объектов. Например, возможность загрузки требует, чтобы перед загрузкой возможностей вам нужно было импортировать несколько объектов. Перед импортом возможностей вы должны импортировать продукты, связанные с каждой строкой дохода, счетами и контактами.

  2. Сопоставьте поля.

    Вы создаете сопоставление данных в своем файле и атрибуты в приложении. Вы также можете повторно использовать сопоставление, созданное в прошлых операциях импорта, или использовать задачу «Управление сопоставлениями импорта файлов». Любое сопоставление, которое вы создаете в действии, автоматически сохраняется и может быть повторно использовано при последующем импорте и управляться с помощью задачи «Управление сопоставлениями импорта файлов».

  3. Запланировать импорт.

    Вы можете запланировать запуск импорта в указанное вами время или запустить его немедленно.

  4. Просмотрите и активируйте действие импорта.

    Вы активируете действие импорта, щелкнув Активировать. Сценарии и рабочие процессы Groovy запускаются только во время операций импорта в объекте регистрации сделки.

Управление сопоставлениями импорта файлов

Эта задача позволяет вам делать следующее:

  • Управляйте существующими сопоставлениями между данными в вашем файле импорта и атрибутами приложения. Например, вы можете заблокировать сопоставление, чтобы его нельзя было изменить, или отредактировать сопоставление, чтобы пропустить атрибуты во время импорта.

  • Создание сопоставлений без файла данных.

    Создание сопоставления с помощью задачи «Управление сопоставлениями импорта файлов» эквивалентно его созданию в действия по импорту, но вы должны ввести имена столбцов файла импорта вручную. Когда вы создаете сопоставление как часть операции импорта, вы загружаете файл, и заголовки столбцов в вашем файле заполняются автоматически.

Управление объектами импорта файлов

Эта задача позволяет просматривать все объекты импорта, которые имеют был создан. Поскольку все объекты, которые вы можете импортировать, уже созданы, вам не нужно создавать дополнительные объекты импорта. Чтобы создавать объекты, нужно быть программистом.



Общие сведения об импорте файлов API

Следуйте

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

В этой статье вы найдете информацию о:

  • Что Служба импорта файлов находится в Agillic
  • Включить API службы импорта файлов
  • Учетные данные API службы импорта файлов
  • Управление учетными данными обратного вызова
  • API службы импорта файлов пользователей

Что такое импорт файлов API в Agillic

Служба импорта файлов — это функция в Agillic для импорта файлы. Вы можете использовать службу для автоматической передачи файлов с личными данными, данными «один ко многим» и данными для таблицы глобальных данных. С помощью этого http-запроса к Agillic вы можете применить службу обратного вызова, которая позволит вашей системе мониторинга зарегистрироваться, если файл импорта импортирован правильно.

Параметры импорта файлов API находятся в разделе «Параметры системы» в модуль настроек. Эти же учетные данные можно использовать для параметра импорта SFTP.

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

Включить импорт файлов API

Если этот параметр включен, вы можете использовать API импорта файлов для импорта данные. При отключении все учетные данные для API импорта файлов удаляются безвозвратно. Поэтому, если вы повторно активируете API импорта файлов, эти учетные данные изменятся.

Учетные данные API импорта файлов

Здесь вы можете увидеть учетные данные BasicAuth, которые вы вам нужно будет использовать File Import API. Эти учетные данные различны для сред Agillic Staging и Production. Вы можете раскрыть секретный ключ, щелкнув по нему.

Управление учетными данными обратного вызова

Если вы хотите использовать обратные вызовы для импорта файлов, вы можете управлять учетными данными на уровне домена для служб, получающих эти обратные вызовы. У вас есть возможность добавить новый домен с учетными данными, а также изменить или удалить учетные данные для доменного имени, которое уже есть в списке. Если здесь не зарегистрированы домен и действительные учетные данные, их нельзя использовать для обратных вызовов.

Использовать API службы импорта файлов

Здесь вы можете увидеть конечную точку информация для API импорта файлов. Если вы введете URL-адрес обратного вызова, вы увидите URL-адрес конечной точки, который содержит информацию об URL-адресе обратного вызова. Когда вы вызываете API с запросом, содержащим параметр URL-адреса обратного вызова, обратный вызов будет выполнен после завершения процесса импорта. Однако это происходит только в том случае, если URL-адрес домена обратного вызова зарегистрирован в разделе «Управление учетными данными обратного вызова».

Например, если URL-адрес обратного вызова — www.thisisit.com/endpoint/no1 или www. это оно. com/endpoint/no2, служба будет искать учетные данные обратного вызова, зарегистрированные для www.thisisit.com. Если он найден, URL-адрес обратного вызова будет вызываться с использованием зарегистрированных учетных данных.

Раздел настроек службы импорта файлов API

Предлагаемые дальнейшие действия

  • Рекомендации по импорту данных в Agillic
  • Общие сведения об импорте/экспорте данных
Оцените статью
clickpad.ru
Добавить комментарий