Вирішення проблем із масовим передаванням користувачів у форматі CSV | Adobe Admin Console

Стосується корпоративних клієнтів і робочих груп.

Огляд

Функція Додавання користувачів із файлу CSV (доступна на сторінці «Користувачі») дає адміністратору змогу створити кілька облікових записів в Admin Console за допомогою файлу CSV. Стан і хід процесу створення облікового запису користувача відображаються на сторінці Результати масових операцій. Ви можете скасувати обробку створення облікового запису користувача в будь-який час.

Примітка.

Роздільником у файлах CSV, які використовуються в процедурах у цій статті, може виступати кома (,) або крапка з комою (;).

Додаткові відомості про роботу з користувачами в Admin Console див. в статті Керування користувачами.

Вимоги до файлів

Перш ніж передавати файл, адміністратор повинен виконати такі вимоги до обробки:

  • Формат файлу та заголовки
  • Вимоги до даних файлу або рядка

Формат файлу та заголовки

  • Файл має формат значень, розділених комами або крапками з комами, і має суфікс .csv. Кожен запис міститься в окремому рядку, розділеному розривом рядка (CRLF). Наприклад, aaa,bbb,ccc CRLF. Додаткові відомості див. тут: RFC 4180 (специфікація файлу CSV)
  • Заголовок стовпця припустимий. Рядок заголовка є обов’язковим. Додаткові відомості про обов’язкові чи необов’язкові поля та формат файлу див. в таблиці Формат файлу CSV в розділі «Керування користувачами».

Тимчасове рішення

Увага!

Зміни, описані нижче, можуть вплинути на інші програми та електронні таблиці. Отже, внесіть необхідні зміни в CSV, а потім скасуйте ці налаштування. 

Windows 10

  1. Перейдіть у Налаштування Windows.

  2. Перейдіть до розділу Час і мова > Регіон і мова > Додаткові параметри дати, часу, регіону > Змінити формат дати, часу або відображення чисел.

  3. У розкривному списку Формат виберіть Англійська (Сполучене Королівство).

Windows 7

  1. Перейдіть до розділу Панель керування > Усі елементи Панелі керування > Регіон і мова.

  2. У розкривному списку Формат виберіть Англійська (Сполучене Королівство).

Вимоги до даних або рядків

Прослідкуйте за тим, щоб для кожного рядка даних виконувалися такі вимоги:

  • Він складається з припустимої адреси електронної пошти.
  • Профілі продуктів (або конфігурації), якщо вони присутні, мають бути припустимими.
Примітка.

Якщо ви є клієнтом робочих груп, змініть назву стовпця Product Configurations (Конфігурації продукту) на Team Products (Продукти робочої групи). Крім того, для даних у цьому стовпці введіть назву продукту (а не назву профілю продукту).

  • Параметри, якщо вони присутні, мають бути припустимими.
Примітка.

Коди країн мають надаватись у форматі двобуквених кодів ISO 3166 (alpha-2).

Вимоги до розміру файлу

Ваш файл CSV може містити до 25 000 рядків (5000 для оптимальної продуктивності). Якщо файл перевищує 5000 рядків, у вас виникнуть проблеми з продуктивністю під час обробки файлу в Admin Console (див. наступний розділ Обробка файлів). Нарешті, наші системи відхилять будь-який файл CSV, у якому більше 25 000 рядків.

Якщо вам потрібно завантажити понад 25 000 користувачів, рекомендуємо зробити це в один із таких способів:

  1. Розділіть свій файл CSV на кілька файлів щонайбільше по 25 000 рядків.  Для оптимальної продуктивності використовуйте не більше 5000 рядків.
  2. Скористайтесь інструментом синхронізації користувачів Adobe. Це інструмент, що працює в інтерфейсі командного рядка та переміщає інформацію про користувачів і групи з корпоративної системи каталогів вашої організації (наприклад, Active Directory або іншої системи LDAP) до каталогу вашої організації в Adobe Admin Console.
  3. Скористайтеся REST API керування користувачами Adobe. Ви можете інтегрувати цей API в адміністративні програми та процеси вашої організації.
  4. Якщо ви налаштували Federated ID в Admin Console за допомогою федерації Microsoft Azure або Google, використовуйте їхні конектори Admin Console. Див. статтю Налаштування федерації Google для SSO в Adobe або Налаштування SSO за допомогою конектора Azure AD.
  5. Якщо ви не можете скористатися жодним із наведених вище методів для масового передавання користувачів, увійдіть в Admin Console, перейдіть до розділу «Підтримка» та зв’яжіться із Центром обслуговування клієнтів Adobe.

Обробка файлу

Коли файл обробляється на основі конкретного домену, кожен запис обробляється окремо, як описано в наведеній нижче таблиці.

Після завершення всіх операцій адміністратору-ініціатору надсилається електронний лист із підсумками. Якщо операцію імпорту скасовано, обробка припиняється. Проте вже оброблені рядки не відкочуються.

Тип посвідчення

Дія

Винятки

Federated ID

  • Створюється запис користувача з указаним іменем користувача.
  • Обліковий запис додається до зазначених профілів продуктів.
  • Адреса електронної пошти використовуються лише для визначення домену.
  • Якщо ввімкнено налаштування сповіщень про профіль продукту, користувачеві надсилається електронний лист.

  • Ім’я користувача існує
  • Adobe не здійснює комерційну діяльність у країні, якщо вона вказана*
  • Залежно від типу організації або контракту недостатня кількість доступних ліцензій через указаний профіль має один із таких наслідків:
    • Робочі групи. Виникає помилка «Недостатньо ліцензій»
    • VIP. Обліковий запис додається до вказаних профілів продуктів. Однак через перевищення квоти ліцензій продукти недоступні для користувача
    • ETLA. Обліковий запис додається до вказаних профілів продуктів. Користувачі отримують доступ до вказаних продуктів. Під час поновлення з вас стягується плата за коригування

Enterprise ID

  • Створюється обліковий запис із заданою адресою електронної пошти.
  • Обліковий запис додається до зазначених конфігурацій продуктів.
  • Користувачеві надсилається вітальний електронний лист.

  • Уже є запрошення в обробці або обліковий запис із вказаною адресою електронної пошти вже існує
  • Adobe не здійснює комерційну діяльність у країні, якщо вона вказана*
  • Залежно від типу організації або контракту недостатня кількість доступних ліцензій через указаний профіль має один із таких наслідків:
    • Робочі групи. Виникає помилка «Недостатньо ліцензій»
    • VIP. Обліковий запис додається до вказаних профілів продуктів. Однак через перевищення квоти ліцензій продукти недоступні для користувача
    • ETLA. Обліковий запис додається до вказаних профілів продуктів. Користувачі отримують доступ до вказаних продуктів. Під час поновлення з вас стягується плата за коригування

Adobe ID

  • Створюється обліковий запис із заданою адресою електронної пошти.
  • Обліковий запис додається до зазначених конфігурацій продуктів.
  • Якщо ви активували параметр Сповіщати користувачів електронною поштою у вікні Редагування профілю продукту, користувачеві надсилається вітальний електронний лист.

 

  • Уже є запрошення в обробці або обліковий запис із вказаною адресою електронної пошти вже існує.
  • Adobe не здійснює комерційну діяльність у країні, якщо вона вказана*
  • Залежно від типу організації або контракту недостатня кількість доступних ліцензій через указаний профіль має один із таких наслідків:
    • Робочі групи. Виникає помилка «Недостатньо ліцензій»
    • VIP. Обліковий запис додається до вказаних профілів продуктів. Однак через перевищення квоти ліцензій продукти недоступні для користувача
    • ETLA. Обліковий запис додається до вказаних профілів продуктів. Користувачі отримують доступ до вказаних продуктів. Під час поновлення з вас стягується плата за коригування

 

Сповіщення:

Служби та програмне забезпечення Adobe регулюються експортним законодавством США, яке обмежує експорт і використання служб і програмного забезпечення Adobe у певних регіонах, зокрема на Кубі, в Ірані, Північній Кореї, Судані, Сирії та в регіоні Криму в Україні.

Примітка.

Функція «Імпорт користувачів» не підтримує псевдоніми користувачів, які містять спеціальні символи, такі як кома (,) або крапка з комою (;).

Відомості про продуктивність

Щоб уникнути перевантаження, під час обробки застосовується правило максимального навантаження, що дорівнює 66,6%. Якщо під час обробки запис відрізняється від ковзного середнього на понад 10%, застосовується обмеження, при якому обробка запиту використовує лише 2/3 реального часу.

Крім того, швидкість обробки також обмежується правилом регулювання, що розробляється проєктною групою. Якщо правило регулювання задано явно, правило максимального навантаження не застосовується. Для повернення до обмеження на основі правила максимального навантаження існує виклик API.

Він відображає кількість запитів, що обробляються за секунду, щоб забезпечити зворотний зв’язок щодо продуктивності.

Цільова швидкість створення 1000 облікових записів, кожний із яких додається у дві конфігурації продукту, становить 1 обліковий запис на секунду, не враховуючи правило максимального навантаження, яке дорівнює 66,6%; у цьому випадку явна швидкість обробки дорівнюватиме 0,66 облікового запису на секунду або близько 40 облікових записів на хвилину. Для створення 1000 облікових записів на такій швидкості знадобиться 25 хвилин. Для створення 5000 облікових записів на такій швидкості знадобиться дві години та п’ять хвилин.

Усунення неполадок

У розділі Усунення неполадок містяться поради щодо усунення помилкових станів та вирішення інших проблем, які можуть виникати під час використання функції масового імпорту в Adobe Admin Console.

Помилки передавання

Іноді не вдається передати файл, якщо не виконуються певні умови.

Повідомлення про помилку відображається за таких умов:

  • Файл не у форматі CSV.
  • Заголовок обов’язкового стовпця (наприклад, «Електронна пошта») неприпустимий або відсутній.
  • Відсутній обов’язковий стовпець.

Що потрібно робити:

  • Використовуйте лише формат файлу .csv.
  • Перевірте, чи заголовки стовпців припустимі.
  • Перевірте, чи значення стовпців припустимі.

Додаткові відомості про обов’язкові чи необов’язкові поля та формат файлу див. в таблиці Формат файлу CSV в розділі «Керування користувачами».

Щоб вирішити проблеми з форматуванням даних у файлі CSV:

  1. Відкрийте файл CSV в Microsoft Excel.

  2. Виберіть (виділіть) будь-який стовпець, який містить дані на аркуші.

  3. Перейдіть на вкладку Дані та натисніть Текст у стовпці.

  4. У діалоговому вікні, яке відобразиться, продовжуйте натискати Далі, доки кнопка Далі не стане неактивною, а кнопка Готово — активною.

  5. Натисніть «Готово», а потім збережіть і закрийте файл.

  6. Передайте оновлений файл CSV до Admin Console.

Повідомлення про помилку відображається за такої умови:

  • Коли присутні заголовки обов’язкових стовпців (наприклад, «Електронна пошта»), але відсутні відповідні значення рядків.

Перевірте, чи ви ввели відповідні значення для кожного рядка.

Помилки обробки

Помилка обробки виникає, якщо система не може обробити рядки даних у переданому файлі. Щоб переглянути докладні відомості, див. Результати масової операції.

Причина

Помилку INTERNAL_SERVER_ERROR викликає перевищення часу очікування шлюзу. Помилка INTERNAL_SERVER_ERROR відображається в стовпці СТАН на екрані результатів помилок.

Вирішення

Ви можете спробувати ще раз пізніше.

Причина

Якщо ви знову передасте наявних користувачів, не вносячи жодних змін, у стовпці СТАН на екрані результатів помилок відображатиметься помилка Користувача вже додано.

Користувача вже додано

Вирішення

Перевірте, чи ви не передаєте наявних користувачів знову. Видаліть рядки, які містять інформацію про наявних користувачів.

Причина

Ця помилка виникає в каталогах, пов’язаних з Azure Sync або Google Sync. Керування користувачами здійснюється на стороні постачальника посвідчень.

Вирішення

Рекомендуємо вам редагувати синхронізовані дані й керувати ними на порталі постачальника посвідчень і дозволити змінам поширюватися через синхронізацію. Не змінюйте дані вручну в Admin Console без крайньої необхідності.

Причина

Якщо присутні заголовки обов’язкових стовпців (наприклад, «Електронна пошта»), але відсутні відповідні значення рядків, то у стовпці СТАН на екрані результатів відображатиметься повідомлення Помилка розбору даних

Помилка розбору

Вирішення

Перевірте, чи ви ввели відповідні значення для кожного рядка.

Причина

Помилка виникає для користувачів з Enterprise ID або Federated ID, якщо домен не відповідає таким критеріям:

  • Припустиме доменне ім’я в стовпці Домен
  • Ідентифікатор електронної пошти з припустимим доменним іменем
  • Ім’я користувача з припустимим доменним іменем

Повідомлення У вашій організації домен не знайдено, що відображається в стовпці СТАН на екрані результатів.

Примітка.

Помилка виникає, коли ви використовуєте припустиме доменне ім’я, це означає, що ваша організація не заявляє права на домен або не довіряє йому.

Вирішення

Що потрібно робити:

  • Введіть припустиме доменне ім’я в стовпці Домен.
  • Введіть припустимий ідентифікатор електронної пошти відповідно до типу посвідчення.
  • Введіть припустиме ім’я користувача відповідно до типу посвідчення.

Причина

Помилка виникає, якщо ваша організація не володіє доменом, до якого ви хочете додати свого користувача.

Вирішення

Щоб додати користувачів до домену, виконайте одну з таких дій:

Причина

Помилка виникає для користувачів з Enterprise ID або Federated ID, якщо відсутній заголовок «Код країни» та/або значення даних.

У стовпці СТАН на екрані результатів відображається повідомлення Код країни має бути 2-символьним значенням ISO-3166.

Помилка коду країни

Вирішення

Перевірте, чи ви ввели заголовок стовпця Код країни та відповідні припустимі значення рядків.

Причина

Ця помилка виникає, якщо вашу організацію було оновлено до моделі корпоративного сховища, а ви ввели тип посвідчення Adobe ID у файлі CSV.

Вирішення

Ви повинні вибрати один із таких типів користувачів: Enterprise ID або Federated ID.

Причина

Ця помилка зазвичай виникає, коли ім’я користувача у файлі CSV не відповідає жодному користувачеві в Admin Console організації. Вона виникає під час операцій наявних доступних користувачів в Adobe Admin Console.

Користувач не в організації

Вирішення

Адміністратор повинен перевірити, чи надане ім’я користувача в полі CSV вже існує в інформації про користувача, доступній в Adobe Admin Console.

Причина

Ця помилка виникає лише під час зміни посвідчення користувача. У файлі CSV задане ім’я користувача збігається, але адреса електронної пошти не збігається з адресою електронної пошти в каталозі в Admin Console.

Адреса електронної пошти має збігатися

Вирішення

Перевірте, чи адреса електронної пошти відповідає домену, визначеному для каталогу в Admin Console.

Якщо ви все ще стикаєтеся з проблемою масового передавання користувачів, створіть звернення, почніть чат або керуйте наявним зверненням на вкладці Підтримка в Admin Console, якщо ви системний адміністратор або адміністратор підтримки.

Додаткові відомості див. в розділі Створення звернення до служби підтримки

Отримуйте допомогу швидше й простіше

Новий користувач?