Widget "Einbetten"

Mit dem Widget "Einbetten" können Sie Inhalt über eine URL oder mittels Code in Websites einbetten, sodass zusätzliche benutzerdefinierte Funktionen zur Verfügung stehen.

Beispiele

Verwenden Sie dieses Widget, um zum Beispiel die folgenden Anforderungen an das App-Design zu unterstützen:

• Es besteht die Anforderung, zusätzliche Informationen aus einer Website basierend auf der Auswahl von Features bereitzustellen. Der Feature-Layer enthält ein Feld mit URLs zu Websites, die Sie einbetten möchten, wenn ein Benutzer ein Feature auf der Karte auswählt oder auf eine Schaltfläche klickt, um weitere Informationen für dieses Feature anzuzeigen.
• Sie möchten ein Dashboard in Ihre App einbetten und Benutzern das Anhängen eines URL-Parameters an das Ende der Web Experience-URL ermöglichen, um die aktuelle Ansicht des Dashboards zu ändern (z. B. zum Anzeigen von Daten für eine bestimmte Region).
• Sie möchten mit HTML-Code Inhalt einbetten (zum Beispiel eine Website) oder den Code aus einem Beispiel kopieren (zum Beispiel Punkt-Cluster-Bildung).

Verwendungshinweise

Zum Erstellen einer dynamischen URL mithilfe von URL-Parametern speichern Sie die App mit dem zu verwendenden URL-Parameter, und laden Sie sie neu, damit Sie im Fenster URL-Informationen einen entsprechenden Schlüssel auswählen können. Zur Laufzeit findet das Widget "Einbetten" den Namen der angegebenen URL-Informationen, gleicht ihn mit den URL-Parametern ab, die der URL der Host-App hinzugefügt wurden, und löst die URL mit dem entsprechenden Wert auf, um die eingebettete App anzuzeigen.

Hinweis:

Wenn Sie festlegen, dass eine PDF-Datei direkt im Widget "Einbetten" angezeigt wird, ist in bestimmten Browsern die Anzeige aus Sicherheitsgründen nicht möglich.

Einstellungen

Das Widget "Einbetten" verfügt über folgende Einstellungen:

• Einbetten mit: Legen Sie fest, ob der Inhalt per URL oder Code eingebettet wird.
  • URL: Betten Sie eine Website mit einer statischen URL ein, oder verwenden Sie die folgenden Optionen, um eine dynamische URL zu bilden:

    Hinweis:

    Es werden nur HTTPS-URLs unterstützt. Aus Sicherheitsgründen wird die eingebettete App durch die Same-Origin-Policy eingeschränkt. Für Domänen außer *.arcgis.com und *.esri.com wird das sandbox-Attribut automatisch hinzugefügt.

    • Mit Daten verbinden: Wählen Sie einen (aus Webkarten, Webszenen, direkten Layern oder über eine URL hinzugefügten) Layer als Datenquelle aus, und klicken Sie auf die Schaltfläche Daten, um ein Attribut auszuwählen, das URLs enthält, oder eine vorhandene URL als Parameter hinzuzufügen. Verwenden Sie das Feld Beschriftung zum Anzeigen einer Beschreibung im Widget, wenn das Feld nicht mit dem Inhalt einer URL in den Daten gefüllt ist.
    • URL-Informationen: Rufen Sie URL-Parameter ab, die Sie im Builder als Suffix zu Ihrer App-URL hinzufügen. Konfigurieren Sie eine dynamische URL, um URL-Parameter aus dem Widget "Einbetten" der eingebetteten App zu übergeben, damit Benutzer zur Laufzeit URL-Parameter zur Web-Experience-URL hinzufügen können, um zu steuern, was in der eingebetteten App angezeigt wird.

      Hinweis:

      Weitere Informationen zu von der eingebetteten App unterstützten URL-Parametern finden Sie in der jeweiligen Dokumentation, beispielsweise für ArcGIS Dashboards und ArcGIS Web AppBuilder.

  • Code: Fügen Sie eigenen benutzerdefinierten HTML-Code zum Einbetten von Drittanbieterelementen in Ihrer Experience ein.

    Um Compliance-Anforderungen zu erfüllen, werden in diesem Widget die Inhalte, die Sie mittels Code einbetten können, beschränkt. Derzeit unterstützt das Widget URL-Inhalte in HTML-iframes, Code, der über einige der beliebtesten Social-Media-Websites geteilt wird, und eine Teilmenge an HTML-Tags und -Attributen. Im Folgenden finden Sie eine Liste der unterstützten HTML-Formate:

    Formatieren	Beispiel
    Standard-HTML-iframe mit URL-Inhalt	<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	Beispiel für eine Twitter-Timeline: <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>
    Andere	Weitere Informationen zu unterstützten HTML-Formaten

    Vorsicht:

    Aus Gründen der Performance gilt eine Größenbeschränkung von 8 KB (8192 Zeichen).

    Hinweis:

    Aus Sicherheitsgründen müssen Sie mit einem ArcGIS-Organisationskonto angemeldet sein, um HTML-Code einzubetten.

    Tipp:

    Wenn Sie eine komplexe HTML-Seite, die das Größenlimit überschreitet oder nicht aus den unterstützten Quellen stammt, einbetten möchten, müssen Sie die Seite auf Ihrem eigenen Server bereitstellen und mithilfe der URL einbetten.

• Automatisch aktualisieren: Legen Sie ein benutzerdefiniertes Zeitintervall in Minuten fest, in dem der eingebettete Inhalt im Widget "Einbetten" automatisch aktualisiert wird. Der Minimalwert beträgt 0,2 Minuten (12 Sekunden).

Konfigurieren einer dynamischen URL

Gehen Sie wie folgt vor, um aus Ihrer Web Experience URL-Parameter abzurufen, die Sie einer eingebetteten App übergeben können:

1. Fügen Sie ein Einbetten-Widget hinzu, und speichern Sie.
2. Fügen Sie in der Adressleiste des Browser-Fensters den URL-Parameter Ihrer Web-Experience-URL hinzu, und drücken Sie die EINGABETASTE, um die Seite neu zu laden.

   Tipp:

   Da der Builder bereits den App-ID-Parameter enthält, fügen Sie den URL-Parameter mit einem kaufmännischen Und-Zeichen (&state=) anstatt mit einem Fragezeichen hinzu.

   Wenn der Builder mit dem URL-Parameter neu geladen wird, kann mit der Schaltfläche URL-Informationen der zugehörige Schlüssel zum Erstellen einer dynamischen URL angezeigt werden.

3. Fügen Sie im URL-Eingabefeld Einbetten mit die URL für die einzubettende App ein.
4. Geben Sie am Ende der URL für die Einbettung den URL-Parameter ein (beispielsweise ?state=).
5. Klicken Sie auf die Schaltfläche URL-Informationen, und wählen Sie den entsprechenden Schlüssel aus, um die dynamische URL zu vervollständigen.

   Das folgende Beispiel zeigt eine dynamische URL für ein eingebettetes Dashboard:

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

Verwenden derselben Authentifizierung

Bei einigen Webanwendungen werden Benutzer aufgefordert, sich mit einem ArcGIS-Konto anzumelden. Dafür, dass sich Benutzer bei einer App möglicherweise anmelden müssen, gibt es verschiedene Gründe wie etwa die Freigabeeinstellungen der App oder weil die App Widgets enthält, in denen Premium-Inhalte verwendet werden.

Wenn Sie in Ihre Experience Builder-App eine ArcGIS-Web-App einbetten möchten und Benutzer sich bei beiden Apps anmelden müssen, können Sie die URL-Parameter arcgis-auth-origin und arcgis-auth-portal hinzufügen, sodass für beide Apps dieselbe Authentifizierung verwendet wird und Benutzer sich nur einmal anmelden müssen.

Wenn Sie eine private Experience Builder-App in eine andere Experience Builder-App einbetten möchten, verwenden Sie ?arcgis-auth-origin=, um die URL der Host-App-Domäne für die Authentifizierung festzulegen. Beispiel:

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

Wenn Sie eine JavaScript-API-basierte App, wie etwa eine Web AppBuilder-App, einbetten möchten, verwenden Sie ?arcgis-auth-origin= für die Authentifizierung der Host-App-Domäne und ?arcgis-auth-portal= für das ArcGIS-Portal, über das die JavaScript-API-basierte App authentifiziert werden muss. Nachfolgend finden Sie einige Beispiele:

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