Представленный в ArcGIS Enterprise11.0, ArcGIS Notebook Server позволяет просматривать и вставлять в блокнот предварительно написанные фрагменты повторно используемого кода, известные как фрагменты кода.
Создание фрагмента кода
Вы можете создать фрагмент кода из своего блокнота. Создаваемые фрагменты можно использовать в том же или другом блокноте. Созданные фрагменты кода можно сохранить в элементах библиотеки фрагментов кода блокнота; эти элементы служат для упорядочивания фрагментов, и к ним может быть предоставлен общий доступ.
Чтобы создать фрагмент кода, вы должны сначала создать библиотеку фрагментов кода блокнота, в которой будут храниться ваши фрагменты. Библиотека фрагментов кода может содержать не более 100 фрагментов.
Создание библиотеки фрагментов кода блокнота
Чтобы создать библиотеку фрагментов кода, выполните следующие действия:
- Вверху ленты редактора блокнота щелкните Фрагменты кода.
- Нажмите кнопку Добавить и выберите Создать элемент библиотеки.
- Введите заголовок и краткую информацию о своей библиотеке и, при желании, добавьте теги, описывающие фрагменты кода, хранящиеся в библиотеке.
- При необходимости выберите папку в Мои ресурсы, в которой будет сохранена ваша библиотека фрагментов кода.
- Нажмите Создать.
Когда вы создадите библиотеку фрагментов кода, она будет храниться в вашей организации, как и любой другой элемент. Управлять своими библиотеками фрагментов кода вы можете, нажав кнопку Дополнительные опции на панели Фрагменты кода и выбрав пункт Управление элементами библиотеки. В окне Управление элементами библиотеки фрагментов кода вы можете создать новую библиотеку фрагментов кода, и для каждой библиотеки фрагментов кода вы можете выполнять следующие действия: предоставлять общий доступ, редактировать, просматривать страницу сведений об элементе, помечать библиотеку как устаревшую.
Добавление фрагмента кода
После создания библиотеки вы можете добавлять в нее фрагменты кода. Чтобы добавить фрагмент кода, сделайте следующее:
- Вверху ленты редактора блокнота щелкните Фрагменты кода.
- Нажмите кнопку Добавить и выберите Добавить фрагмент кода.
- Введите заголовок фрагмента кода, выберите библиотеку, в которую хотите его добавить, и введите описание.
В ниспадающем списке Выберите элемент библиотеки фрагментов кода отображаются библиотеки, в которые вы можете добавить свой фрагмент кода. В списке также указано количество фрагментов в этой библиотеке.
- Добавьте код для фрагмента, выполнив одно из следующих действий:
- Если блокнот использует среду выполнения версии 8.0 или более новой, выберите ячейку, которую вы хотите добавить в качестве фрагмента кода, и щелкните Копировать из активной ячейки.
- Если блокнот использует среду выполнения версии 7.0 или более ранней, введите код для фрагмента кода.
Примечание:
Скопируйте и вставьте код из ячейки блокнота вместо прямого ввода кода, чтобы избежать отступов или других синтаксических ошибок.
- Щелкните Сохранить.
Вы можете внести изменения в свои фрагменты кода, нажав кнопку Дополнительные опции для фрагмента. Ниспадающее меню Дополнительные опции предоставляет опции для редактирования, отмены использования и удаления фрагмента.
Вставка фрагментов кода
Используя панель Фрагменты кода, выполните следующие действия, чтобы вставить фрагмент кода:
- Вверху ленты редактора блокнота щелкните Фрагменты кода.
- Перейдите к библиотеке фрагментов кода, содержащей фрагмент, который вы хотите вставить.
- Нажмите Просмотреть подробности для фрагмента, чтобы увидеть предварительный просмотр кода.
- Когда вы найдете фрагмент кода, который хотите вставить, нажмите кнопку Добавить на панели фрагментов кода или щелкните Вставить в блокнот на панели предварительного просмотра кода, чтобы вставить фрагмент кода в блокнот в виде новой ячейки.
Ниже приведен пример фрагмента кода, добавляемого в блокнот:
# curated code snippet inserted from the Code snippets pane
from arcgis.gis import GIS
def check_org_credits_agol(gis: GIS):
if "admin" in gis.__dict__:
credits = gis.admin.credits.credits
print(f"This ArcGIS Online organization has {credits} credits.")
else:
print("Please connect to the ArcGIS Online organization as an administrator to check credits.")
# create a GIS instance to pass to the code snippet function
gis_agol = GIS("https://www.arcgis.com/", "<admin_username>")
# call the code snippet function with your GIS instance
check_org_credits_agol(gis_agol)
Фрагменты кода Esri
Все доступные фрагменты кода курируются Esri. Эти специально подобранные фрагменты кода позволяют реализовать стандартные рабочие процессы ГИС в ваших блокнотах. Фрагменты кода написаны в виде функций Python, которые можно вставить в блокнот и вызывать в нем. Фрагмент кода также можно редактировать после добавления в блокнот.
Примечание:
В версии 11.0 названия и описания подобранных фрагментов кода доступны только на английском языке.
Ниже приведены доступные фрагменты кода, которые можно вставить в блокнот:
- Администрирование ГИС — фрагменты кода, выполняющие стандартные задачи администрирования ГИС.
Примечание:
Многие из этих фрагментов кода требуют подключения администратора.
- Проверить оставшиеся кредиты (только ArcGIS Online).
- Проверить кредиты определенного пользователя (только ArcGIS Online).
- Получить базовый URL-адрес сервиса элемента слоя
- Запрос задач блокнота не удался
- Запросить журналы портала и сохранить их как CSV (только ArcGIS Enterprise)
- Вход на портал для ArcPy
- Управление ресурсами — фрагменты кода, помогающие управлять ресурсами вашей ГИС и файлами в каталоге рабочей области блокнота.
- Копировать базу геоданных в директорию рабочей области
- Создать файловую базу геоданных с пустым классом пространственных объектов.
- Создать папку в директории рабочей области
- Загрузить элемент файла с портала в директорию рабочей области
- Список наборов данных
- Список файлов
- Удалить файловую базу геоданных из директории рабочей области
- Удалить папку в директории рабочей области
- Распаковать архивный файл в директорию рабочей области
- Наука о данных и анализ - фрагменты кода, которые можно реализовать в рабочих процессах обработки и анализа данных с помощью ArcGIS API for Python, ArcPy и других библиотек Python.
Примечание:
Используйте расширенную среду выполнения блокнота для запуска фрагментов кода, требующих ArcPy. Дополнительные сведения о среде выполнения блокнота см. в Задание среды выполнения блокнота.
- Конвертировать класс пространственных объектов в векторный слой
- Конвертировать класс пространственных объектов в Spatially Enabled DataFrame
- Конвертировать векторный слой в Spatially Enabled DataFrame
- Конвертировать Spatially Enabled DataFrame в класс пространственных объектов
- Отобразить изображение по URL
- Отобразить изображение из директории рабочей области
- Заполнить пропущенные значения
- Список полей в классе пространственных объектов
- Список полей слоя
- Список слоев в элементе
- Построить Spatially Enable DataFrame (быстрый старт)
- Построить Spatially Enable DataFrame с помощью метода отображения по границам классов
- Построить Spatially Enable DataFrame с помощью простого метода отображения
- Построить Spatially Enable DataFrame с помощью метода отображения уникальные значения
- Опубликовать Spatially Enabled DataFrame как векторный слой