Виджет Встроить

Виджет Встроить позволяет встроить содержание веб-сайта, используя URL или код, для получения дополнительной функциональности.

Примеры

Используйте этот виджет для поддержки требований к разработке приложений, таких как:

• Вам необходимо ввести дополнительную информацию с веб-сайта, в зависимости от выбранного объекта. Слой объектов содержит поле с URL-адресами веб-сайтов, которые можно встроить, чтобы пользователь, щелкая объект или кнопку, мог получить дополнительные сведения об этом объекте.
• Вы хотите встроить операционную панель в ваше приложение и разрешить пользователям добавлять URL-параметр в конец URL веб-интерфейса, чтобы изменить текущий вид операционной панели (например, чтобы отобразить данные для определенного региона).
• Вы хотите встроить ресурсы, используя код HTML (например, веб-сайт) или скопировать код из примера (например, кластеризацию точек).

Примечания по использованию

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

Примечание:

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

Настройки

Виджет Встроить имеет следующие настройки:

• Встроить по - выберите встраивание по URL или коду.
  • URL-адрес - встроить веб-сайт по статическому URL-адресу или использовать следующие опции для формирования динамического URL-адреса:

    Примечание:

    Поддерживаются только URL-адреса в формате HTTPS. Для обеспечения безопасности встроенное приложение ограничено такой же исходной политикой. Для доменов, отличающихся от *.arcgis.com и *.esri.com, автоматически добавляется атрибут sandbox.

    • Подключиться к данным - выберите слой в качестве источника данных (добавленные из веба карты, веб-сцены, непосредственно слои либо через URL-адрес) и щелкните кнопку Данные, чтобы выбрать атрибут, который содержит URL-адреса или чтобы добавить существующий URL-адрес как параметры. Используйте поле Надпись для отображения описания в виджете, когда он не заполнен содержанием URL-адреса в данных.
    • Информация об URL-адресе - получите параметры URL-адреса, которые вы добавили в URL-адрес вашего приложения в конструкторе. Настроить динамический URL-адрес, чтобы передать параметры URL-адреса из виджета Встроить во встроенное приложение, так чтобы пользователи могли добавить параметры URL-адреса в веб-интерфейс URL-адреса во время запуска, чтобы управлять тем, что отображается во встроенном приложении.

      Примечание:

      Более подробную информацию об URL-параметрах, поддерживаемых встроенным приложением, смотрите в соответствующей документации, например, ArcGIS Dashboards и ArcGIS Web AppBuilder.

  • Код — добавление собственного кода HTML к встроенным элементам сторонних разработчиков.

    Для соблюдения нормативных требований виджет ограничивает, какие именно ресурсы можно встраивать через код. В настоящий момент виджет поддерживает ресурсы URL в HTML iframe, код, доступный из выборки веб-сайтов популярных социальных сетей, и поднабор тегов и атрибутов HTML. Ниже приведен список поддерживаемых форматов HTML:

    Формат	Пример
    Стандартный HTML iframe с ресурсами URL	<iframe width="100%" height="600px" frameborder="0" scrolling="yes" marginheight="" marginwidth="" src="https://developers.arcgis.com/"></iframe>
    YouTube	<iframe width="560" height="315" src="https://www.youtube.com/embed/pNrsd5naN7U" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
    Twitter	Пример ленты Twitter: <a class="twitter-timeline" href="https://twitter.com/ArcGISApps?ref_src=twsrc%5Etfw">Tweets by ArcGISApps</a> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>
    Facebook	<iframe src="https://www.facebook.com/plugins/post.php?href=https%3A%2F%2Fwww.facebook.com%2Fesrigis%2Fphotos%2Fa.433181450280%2F10160256145415281%2F&show_text=true&width=500" width="500" height="417" style="border:none;overflow:hidden" scrolling="no" frameborder="0" allowfullscreen="true" allow="autoplay; clipboard-write; encrypted-media; picture-in-picture; web-share"></iframe>
    Instagram	<blockquote class="instagram-media" data-instgrm-permalink="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" data-instgrm-version="14" style=" background:#FFF; border:0; border-radius:3px; box-shadow:0 0 1px 0 rgba(0,0,0,0.5),0 1px 10px 0 rgba(0,0,0,0.15); margin: 1px; max-width:540px; min-width:326px; padding:0; width:99.375%; width:-webkit-calc(100% - 2px); width:calc(100% - 2px);"><div style="padding:16px;"> <a href="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" style=" background:#FFFFFF; line-height:0; padding:0 0; text-align:center; text-decoration:none; width:100%;" target="_blank"> <div style=" display: flex; flex-direction: row; align-items: center;"> <div style="background-color: #F4F4F4; border-radius: 50%; flex-grow: 0; height: 40px; margin-right: 14px; width: 40px;"></div> <div style="display: flex; flex-direction: column; flex-grow: 1; justify-content: center;"> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; margin-bottom: 6px; width: 100px;"></div> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; width: 60px;"></div></div></div><div style="padding: 19% 0;"></div> <div style="display:block; height:50px; margin:0 auto 12px; width:50px;"><svg width="50px" height="50px" viewBox="0 0 60 60" version="1.1" xmlns="https://www.w3.org/2000/svg" xmlns:xlink="https://www.w3.org/1999/xlink"><g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd"><g transform="translate(-511.000000, -20.000000)" fill="#000000"><g><path d="M556.869,30.41 C554.814,30.41 553.148,32.076 553.148,34.131 C553.148,36.186 554.814,37.852 556.869,37.852 C558.924,37.852 560.59,36.186 560.59,34.131 C560.59,32.076 558.924,30.41 556.869,30.41 M541,60.657 C535.114,60.657 530.342,55.887 530.342,50 C530.342,44.114 535.114,39.342 541,39.342 C546.887,39.342 551.658,44.114 551.658,50 C551.658,55.887 546.887,60.657 541,60.657 M541,33.886 C532.1,33.886 524.886,41.1 524.886,50 C524.886,58.899 532.1,66.113 541,66.113 C549.9,66.113 557.115,58.899 557.115,50 C557.115,41.1 549.9,33.886 541,33.886 M565.378,62.101 C565.244,65.022 564.756,66.606 564.346,67.663 C563.803,69.06 563.154,70.057 562.106,71.106 C561.058,72.155 560.06,72.803 558.662,73.347 C557.607,73.757 556.021,74.244 553.102,74.378 C549.944,74.521 548.997,74.552 541,74.552 C533.003,74.552 532.056,74.521 528.898,74.378 C525.979,74.244 524.393,73.757 523.338,73.347 C521.94,72.803 520.942,72.155 519.894,71.106 C518.846,70.057 518.197,69.06 517.654,67.663 C517.244,66.606 516.755,65.022 516.623,62.101 C516.479,58.943 516.448,57.996 516.448,50 C516.448,42.003 516.479,41.056 516.623,37.899 C516.755,34.978 517.244,33.391 517.654,32.338 C518.197,30.938 518.846,29.942 519.894,28.894 C520.942,27.846 521.94,27.196 523.338,26.654 C524.393,26.244 525.979,25.756 528.898,25.623 C532.057,25.479 533.004,25.448 541,25.448 C548.997,25.448 549.943,25.479 553.102,25.623 C556.021,25.756 557.607,26.244 558.662,26.654 C560.06,27.196 561.058,27.846 562.106,28.894 C563.154,29.942 563.803,30.938 564.346,32.338 C564.756,33.391 565.244,34.978 565.378,37.899 C565.522,41.056 565.552,42.003 565.552,50 C565.552,57.996 565.522,58.943 565.378,62.101 M570.82,37.631 C570.674,34.438 570.167,32.258 569.425,30.349 C568.659,28.377 567.633,26.702 565.965,25.035 C564.297,23.368 562.623,22.342 560.652,21.575 C558.743,20.834 556.562,20.326 553.369,20.18 C550.169,20.033 549.148,20 541,20 C532.853,20 531.831,20.033 528.631,20.18 C525.438,20.326 523.257,20.834 521.349,21.575 C519.376,22.342 517.703,23.368 516.035,25.035 C514.368,26.702 513.342,28.377 512.574,30.349 C511.834,32.258 511.326,34.438 511.181,37.631 C511.035,40.831 511,41.851 511,50 C511,58.147 511.035,59.17 511.181,62.369 C511.326,65.562 511.834,67.743 512.574,69.651 C513.342,71.625 514.368,73.296 516.035,74.965 C517.703,76.634 519.376,77.658 521.349,78.425 C523.257,79.167 525.438,79.673 528.631,79.82 C531.831,79.965 532.853,80.001 541,80.001 C549.148,80.001 550.169,79.965 553.369,79.82 C556.562,79.673 558.743,79.167 560.652,78.425 C562.623,77.658 564.297,76.634 565.965,74.965 C567.633,73.296 568.659,71.625 569.425,69.651 C570.167,67.743 570.674,65.562 570.82,62.369 C570.966,59.17 571,58.147 571,50 C571,41.851 570.966,40.831 570.82,37.631"></path></g></g></g></svg></div><div style="padding-top: 8px;"> <div style=" color:#3897f0; font-family:Arial,sans-serif; font-size:14px; font-style:normal; font-weight:550; line-height:18px;">View this post on Instagram</div></div><div style="padding: 12.5% 0;"></div> <div style="display: flex; flex-direction: row; margin-bottom: 14px; align-items: center;"><div> <div style="background-color: #F4F4F4; border-radius: 50%; height: 12.5px; width: 12.5px; transform: translateX(0px) translateY(7px);"></div> <div style="background-color: #F4F4F4; height: 12.5px; transform: rotate(-45deg) translateX(3px) translateY(1px); width: 12.5px; flex-grow: 0; margin-right: 14px; margin-left: 2px;"></div> <div style="background-color: #F4F4F4; border-radius: 50%; height: 12.5px; width: 12.5px; transform: translateX(9px) translateY(-18px);"></div></div><div style="margin-left: 8px;"> <div style=" background-color: #F4F4F4; border-radius: 50%; flex-grow: 0; height: 20px; width: 20px;"></div> <div style=" width: 0; height: 0; border-top: 2px solid transparent; border-left: 6px solid #f4f4f4; border-bottom: 2px solid transparent; transform: translateX(16px) translateY(-4px) rotate(30deg)"></div></div><div style="margin-left: auto;"> <div style=" width: 0px; border-top: 8px solid #F4F4F4; border-right: 8px solid transparent; transform: translateY(16px);"></div> <div style=" background-color: #F4F4F4; flex-grow: 0; height: 12px; width: 16px; transform: translateY(-4px);"></div> <div style=" width: 0; height: 0; border-top: 8px solid #F4F4F4; border-left: 8px solid transparent; transform: translateY(-4px) translateX(8px);"></div></div></div> <div style="display: flex; flex-direction: column; flex-grow: 1; justify-content: center; margin-bottom: 24px;"> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; margin-bottom: 6px; width: 224px;"></div> <div style=" background-color: #F4F4F4; border-radius: 4px; flex-grow: 0; height: 14px; width: 144px;"></div></div></a><p style=" color:#c9c8cd; font-family:Arial,sans-serif; font-size:14px; line-height:17px; margin-bottom:0; margin-top:8px; overflow:hidden; padding:8px 0 7px; text-align:center; text-overflow:ellipsis; white-space:nowrap;"><a href="https://www.instagram.com/reel/CmZQDMJtMvc/?utm_source=ig_embed&amp;utm_campaign=loading" style=" color:#c9c8cd; font-family:Arial,sans-serif; font-size:14px; font-style:normal; font-weight:normal; line-height:17px; text-decoration:none;" target="_blank">A post shared by Esri (@esrigram)</a></p></div></blockquote> <script async src="//www.instagram.com/embed.js"></script>
    Vimeo	<iframe src="https://player.vimeo.com/video/344310270?h=f8c418505e" width="640" height="360" frameborder="0" allow="autoplay; fullscreen; picture-in-picture" allowfullscreen></iframe> <p><a href="https://vimeo.com/344310270">The Science of Where - ESRI</a> from <a href="https://vimeo.com/south422">422 South</a> on <a href="https://vimeo.com">Vimeo</a>.</p>
    Прочее	Более подробно о поддерживаемых HTML.

    Внимание:

    По соображениям производительности установлено ограничение на размер 8 КБ (8192 символа).

    Подсказка:

    Если вы хотите встроить сложную HTML-страницу, размер которой превышает ограничение размера или не исходит ни из одного из поддерживаемых источников, разверните страницу на своем собственном сервере и встраивайте по URL.

• Автообновление - задайте интервал (в минутах) для автоматического обновления встроенных ресурсов в виджете Встроить. Минимальное значение составляет 0,2 минуты (12 секунд).

Настройка динамического URL-адреса

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

1. Добавьте виджет Встроить и сохраните.
2. В строке адреса окна браузере добавьте параметр URL-адреса в URL-адрес вашего веб-интерфейса и нажмите Ввод, чтобы перезагрузить страницу.

   Подсказка:

   Так как конструктор уже включает параметр ID приложения, добавьте параметр URL-адрес с использованием амперсанда (например, &state=) вместо вопросительного знака.

   Когда конструктор перезагружается с параметрами URL-адреса, кнопка Информация об URL-адреса отображает ключи для создания динамического URL-адреса.

3. Во входном поле Встроить по вставьте URL-адрес для приложения, которое вы хотите встроить.
4. В конце URL-адреса для встраивания наберите параметр URL-адреса (например, ?state=)
5. Щелкните кнопку Информация об URL-адресе и выберите соответствующий ключ для заполнения динамического URL-адреса.

   Далее приведен пример динамического URL-адреса для встроенной операционной панели:

   https://<your portal url>/apps/dashboards/index.html#/<id>?state={appURL.search.state}

Общий доступ к аутентификации

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

Если вы хотите встроить веб-приложение ArcGIS в свое приложение Experience Builder, и оба требуют входа в систему, вы можете добавить параметры URL arcgis-auth-origin и arcgis-auth-portal, чтобы совместно использовать аутентификацию между обоими приложениями, чтобы пользователям нужно было войти только один раз.

Чтобы встроить частное приложение Experience Builder в другое приложение Experience Builder, используйте ?arcgis-auth-origin= для определения URL-адреса домена хост-приложения для аутентификации. Ниже приведен пример:

https://<orgdomain>/experience/<AppID>/?arcgis-auth-origin=<your host app domain, such as https://localhost:3001>

Чтобы внедрить приложение на основе API JavaScript, например приложение Web AppBuilder, используйте ?arcgis-auth-origin= для аутентификации домена хост-приложения и ?arcgis-auth-portal= для проверки подлинности домена приложения на основе API JavaScript. Ниже приведен пример:

https://<orgdomain>/apps/webappviewer/index.html?id=<appID>&arcgis-auth-origin=<your host app domain, such as https://localhost:3001>&arcgis-auth-portal=<orgA URL>

https://www.arcgis.com/apps/dashboards/index.html#/<appID>?arcgis-auth-origin=https://experience.arcgis.com&arcgis-auth-portal=https://<myorg>.maps.arcgis.com