Приложение для владения: различия между версиями

Материал из Документация Ключ-АСТРОМ
(Создана пустая страница)
 
Строка 1: Строка 1:
'''''Последняя версия Ключ-АСТРОМ'''''


Приложение '''Ownership''' предоставляет действия для построения рабочего процесса, запрашивающего команду владения объекта и связанную контактную информацию. С помощью этих действий вы можете извлекать данные о владении объекта и интегрировать их с другими приложениями, например, для отправки уведомлений Slack или обновлений Jira владением объектов на основе различных триггеров.
Кроме того, приложение '''Ownership''' позволяет импортировать команды из следующих источников с помощью автоматизированных рабочих процессов :
* Группы из [[Полное руководство по мониторингу служб Azure|'''''Microsoft Entra ID''''']]
* Группы из '''''ServiceNow'''''
* Любой источник данных, использующий структуру '''''JSON'''''
Подробности см . в разделе '''''Возможности''''' (ниже).
== Разрешения ==
* Для владения требуются следующие разрешения.
** <code>environment-api:entities:read</code>—Читать объекты.
** <code>settings:objects:read</code>—Читать объекты настроек 2.0.
** <code>settings:schemas:read</code>—Читать схемы настроек 2.0.
* Кроме того, вам потребуются следующие основные разрешения в '''Workflows''' (перейдите в раздел '''Workflows > Настройки > Настройки авторизации''').
** <code>app-engine:apps:run</code>— Позволяет просматривать и запускать приложения; обеспечивает базовый доступ к '''Launcher'''.
** <code>app-engine:functions:run</code>— Позволяет использовать функцию-исполнитель.  В качестве альтернативы вы можете настроить пользователей с помощью пользовательской политики '''AppEngine'''.
== Возможности ==
Основные возможности '''Ownership''' в последней версии Ключ-АСТРОМ содержатся в готовых действиях для '''Workflows'''  . Вы можете комбинировать эти действия с другими задачами и действиями для создания рабочих процессов для импорта команды, уведомлений, назначения задач и других вариантов использования.
=== <code>import_teams</code> ===
Это действие позволяет импортировать команды '''Ownership''' в Ключ-АСТРОМ из разных источников данных. Для всех поддерживаемых источников мы предоставляем [https://github.com/Dynatrace/Dynatrace-workflow-samples/tree/main/samples/Team-Import '''''шаблоны рабочих процессов'''''] которые можно использовать в качестве справочного материала.
* Группы '''Entra ID'''  Действие <code>import_teams</code> берет результаты предопределенного действия <code>get_groups</code>, которое получает данные о группах из [[Полное руководство по мониторингу служб Azure|'''''Microsoft Entra ID''''']], и сохраняет данные как [[Создание и управление владениями|'''''команды владения''''']] в Ключ-АСТРОМ. Таким образом, вы можете использовать информацию о своем Entra ID для назначения команд владения объектами, отслеживаемым Ключ-АСТРОМ, без создания команд с нуля.
*# Убедитесь, что действие <code>get_groups</code> предшествует действию <code>import_teams</code> в том же рабочем процессе. Мы рекомендуем, чтобы действие <code>import_teams</code> следовало сразу за действием <code>get_groups</code>.  Важно для импорта групп '''Entra ID''' в качестве команд владения :
*#* Вам всегда необходимо включать <code>id</code> и <code>displayName</code> в <code>$select</code>; эти поля сопоставляются с ID команды и названием команды импортированной команды владения соответственно.
*#* Мы рекомендуем всегда включать параметр <code>mailNickname</code> в <code>get_groups</code>. Это поле имеет уникальные значения в '''Entra ID''' и задается как уникальный, понятный человеку дополнительный ID для вашей импортированной команды владения в Ключ-АСТРОМ.
*#* ID объекта из '''Entra ID''', импортированный через параметр <code>id</code>, устанавливается как уникальный ID команды , а также как внешний ID импортированной команды владения.
*#* Параметр <code>mail</code> задается как адрес электронной почты импортированной команды владения.
*# Выберите группы Entra ID в качестве источника данных на вкладке '''Вход''' в действии <code>import_teams</code>.
*# Установите данные, содержащие команды для импорта — в этом случае в качестве входных данных для <code><nowiki>{{ result("get_groups") }}</nowiki></code> используется результат <code>get_groupsimport_teams</code>
*# Выберите настройки импорта .  Импорт команды из '''Entra ID''' не может быть отменен. Однако вы можете выборочно импортировать и защищать изменения в ранее импортированной информации, выбрав один из следующих вариантов.
*#* Если вы уже импортировали команды из '''Entra ID''', вы можете выбрать '''Import new teams and skip existing teams''' . Эта опция гарантирует, что импортированные ID команд не перезапишут никакую информацию о командах, уже сохраненную в Ключ-АСТРОМ. Эта опция позволяет обслуживать команды и планировать запуски импорта команд.  Эта опция полезна, когда вы ранее импортировали команды, а затем изменили импортированную информацию в Ключ-АСТРОМ. В таких случаях Ключ-АСТРОМ, а не '''Entra ID''', является источником правды о ваших существующих командах владения, и вы не хотите, чтобы последующие запуски <code>import_teams</code> перезаписывали вашу текущую информацию.
*#* Если вы хотите импортировать команды из '''Entra ID''' с нуля, выберите '''Import new teams and owerwrite existing teams''' . Для импортируемых ID команд эта опция перезаписывает любую информацию о команде, которая уже существует в Ключ-АСТРОМ.
[[Файл:267.png|граница]]

Версия 15:19, 26 августа 2024

Последняя версия Ключ-АСТРОМ

Приложение Ownership предоставляет действия для построения рабочего процесса, запрашивающего команду владения объекта и связанную контактную информацию. С помощью этих действий вы можете извлекать данные о владении объекта и интегрировать их с другими приложениями, например, для отправки уведомлений Slack или обновлений Jira владением объектов на основе различных триггеров.

Кроме того, приложение Ownership позволяет импортировать команды из следующих источников с помощью автоматизированных рабочих процессов :

  • Группы из Microsoft Entra ID
  • Группы из ServiceNow
  • Любой источник данных, использующий структуру JSON

Подробности см . в разделе Возможности (ниже).

Разрешения

  • Для владения требуются следующие разрешения.
    • environment-api:entities:read—Читать объекты.
    • settings:objects:read—Читать объекты настроек 2.0.
    • settings:schemas:read—Читать схемы настроек 2.0.
  • Кроме того, вам потребуются следующие основные разрешения в Workflows (перейдите в раздел Workflows > Настройки > Настройки авторизации).
    • app-engine:apps:run— Позволяет просматривать и запускать приложения; обеспечивает базовый доступ к Launcher.
    • app-engine:functions:run— Позволяет использовать функцию-исполнитель. В качестве альтернативы вы можете настроить пользователей с помощью пользовательской политики AppEngine.

Возможности

Основные возможности Ownership в последней версии Ключ-АСТРОМ содержатся в готовых действиях для Workflows  . Вы можете комбинировать эти действия с другими задачами и действиями для создания рабочих процессов для импорта команды, уведомлений, назначения задач и других вариантов использования.

import_teams

Это действие позволяет импортировать команды Ownership в Ключ-АСТРОМ из разных источников данных. Для всех поддерживаемых источников мы предоставляем шаблоны рабочих процессов которые можно использовать в качестве справочного материала.

  • Группы Entra ID Действие import_teams берет результаты предопределенного действия get_groups, которое получает данные о группах из Microsoft Entra ID, и сохраняет данные как команды владения в Ключ-АСТРОМ. Таким образом, вы можете использовать информацию о своем Entra ID для назначения команд владения объектами, отслеживаемым Ключ-АСТРОМ, без создания команд с нуля.
    1. Убедитесь, что действие get_groups предшествует действию import_teams в том же рабочем процессе. Мы рекомендуем, чтобы действие import_teams следовало сразу за действием get_groups. Важно для импорта групп Entra ID в качестве команд владения :
      • Вам всегда необходимо включать id и displayName в $select; эти поля сопоставляются с ID команды и названием команды импортированной команды владения соответственно.
      • Мы рекомендуем всегда включать параметр mailNickname в get_groups. Это поле имеет уникальные значения в Entra ID и задается как уникальный, понятный человеку дополнительный ID для вашей импортированной команды владения в Ключ-АСТРОМ.
      • ID объекта из Entra ID, импортированный через параметр id, устанавливается как уникальный ID команды , а также как внешний ID импортированной команды владения.
      • Параметр mail задается как адрес электронной почты импортированной команды владения.
    2. Выберите группы Entra ID в качестве источника данных на вкладке Вход в действии import_teams.
    3. Установите данные, содержащие команды для импорта — в этом случае в качестве входных данных для {{ result("get_groups") }} используется результат get_groupsimport_teams
    4. Выберите настройки импорта . Импорт команды из Entra ID не может быть отменен. Однако вы можете выборочно импортировать и защищать изменения в ранее импортированной информации, выбрав один из следующих вариантов.
      • Если вы уже импортировали команды из Entra ID, вы можете выбрать Import new teams and skip existing teams . Эта опция гарантирует, что импортированные ID команд не перезапишут никакую информацию о командах, уже сохраненную в Ключ-АСТРОМ. Эта опция позволяет обслуживать команды и планировать запуски импорта команд. Эта опция полезна, когда вы ранее импортировали команды, а затем изменили импортированную информацию в Ключ-АСТРОМ. В таких случаях Ключ-АСТРОМ, а не Entra ID, является источником правды о ваших существующих командах владения, и вы не хотите, чтобы последующие запуски import_teams перезаписывали вашу текущую информацию.
      • Если вы хотите импортировать команды из Entra ID с нуля, выберите Import new teams and owerwrite existing teams . Для импортируемых ID команд эта опция перезаписывает любую информацию о команде, которая уже существует в Ключ-АСТРОМ.

267.png