トップへ戻る

埋め込みウィジェット

このトピックの内容

  1. 例
  2. 使用上の注意
  3. 設定
  4. 動的 URL の構成
  5. 認証の共有

埋め込みウィジェットを使用すると、カスタム機能を追加するための URL またはコードを使用して Web サイト コンテンツを埋め込むことができます。

例

このウィジェットを使用して、次のようなアプリの設計要件をサポートします。

  • フィーチャの選択に基づいて Web サイトから追加情報を提供するという要件があるとします。 フィーチャ レイヤーには、埋め込みたい Web サイトへの URL を含んでいるフィールドが含まれ、ユーザーがマップ上のフィーチャを選択するかボタンをクリックすると、そのフィーチャについての詳細情報を確認できます。
  • アプリにダッシュボードを埋め込み、ユーザーが Web エクスペリエンス URL の末尾に URL パラメーターを追加できるよう許可することで、ダッシュボードの現在の表示 (特定の領域のデータを表示するなど) を変更できます。
  • HTML コードを使用してコンテンツ (Web サイトなど) を埋め込むか、サンプル (ポイントのクラスタリングなど) からコードをコピーします。

使用上の注意

URL パラメーターを使用して動的 URL を作成するには、使用したい URL パラメーターでアプリを保存および再読み込みしてから、[URL 情報] ウィンドウで対応するキーを選択します。 埋め込みウィジェットは、実行時に、指定した URL 情報の名前を検索し、ホスト アプリの URL に追加された URL パラメーターと一致させ、対応する値を使用して URL を解決して、埋め込みアプリを表示します。

注意:

埋め込みウィジェットで直接 PDF を表示する場合、セキュリティ上の理由から一部のブラウザーでは表示できないことがあります。

設定

埋め込みウィジェットには以下の設定が含まれます。

  • [埋め込み方法] - URL またはコードで埋め込むかどうかを選択します。
    • [URL] - Web サイトを静的 URL で埋め込むか、または次のオプションを使用して動的 URL を作成します。
      注意:

      HTTPS URL のみがサポートされています。 セキュリティ上の理由から、埋め込みアプリは同一オリジン ポリシーの制限を受けます。 *.arcgis.com と *.esri.com 以外のドメインでは、sandbox 属性が自動的に追加されます。

      • [データ接続] - レイヤーをデータ ソースとして選択し (Web マップ、Web シーン、直接レイヤーまたは URL から追加)、[データ] ボタンをクリックして、URL を含む属性を選択するか、既存の URL にパラメーターとして追加します。 [ラベル] フィールドを使用すると、URL のコンテンツによってデータに入力されない場合に、ウィジェットに説明を表示できます。
      • [URL 情報] - ビルダーのアプリ URL に接尾辞として追加する URL パラメーターを取得します。 動的 URL を構成すると、埋め込みウィジェットから埋め込みアプリに URL パラメーターを渡せるので、ユーザーは実行時に URL パラメーターを Web エクスペリエンス URL に追加することができます。これにより、埋め込みアプリに表示されるものを制御できます。
        注意:

        埋め込みアプリでサポートされる URL パラメーターの詳細については、ArcGIS Dashboards や ArcGIS Web AppBuilder のドキュメントをご参照ください。

    • [コード] - エクスペリエンスにサード パーティのエレメントを埋め込むための独自のカスタム HTML コードを追加します。

      コンプライアンスの要件を満たすために、このウィジェットは、コードで埋め込むことができるコンテンツを制限します。 現在、このウィジェットは、人気の高いソーシャル メディア サイトから共有されている HTML の iframe とコード内の URL コンテンツ、および HTML タグと属性のサブセットをサポートしています。 以下に、サポートされている HTML 形式のリストを示します。

      フォーマット例

      URL コンテンツを含む標準の HTML の iframe

      
<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 KB (8192 文字) のサイズ制限が課せられています。

      ヒント:

      パフォーマンス上の理由から課されたサイズの上限を超過する、またはサポートされているソースから取得していない複雑な HTML ページを埋め込む場合は、そのページを独自のサーバーに配置して、代わりに URL で埋め込みます。

  • [自動更新] - カスタムの時間間隔 (分単位) を設定して、埋め込みウィジェットに埋め込まれたコンテンツを自動的に更新します。 設定できる最小値は 0.2 分 (12 秒) です。

動的 URL の構成

Web エクスペリエンスから埋め込みアプリに渡す URL パラメーターを取得するには、次の手順を実行します。

  1. 埋め込みウィジェットを追加し、保存します。
  2. ブラウザー ウィンドウのアドレス バーに、Web エクスペリエンス URL の URL パラメーターを追加し、Enter キーを押してページを再読み込みします。
    ヒント:

    ビルダーにはアプリの ID パラメーターがすでに含まれているため、疑問符ではなくアンパサンド (&state= など) を使用して URL パラメーターを追加します。

    ビルダーが URL パラメーターで再読み込みされると、[URL 情報] ボタンが動的 URL を構築するためのキーを表示します。

  3. [埋め込み方法] URL 入力ボックスに、埋め込みたいアプリの URL を貼り付けます。
  4. 埋め込み URL の末尾に、URL パラメーターを入力します (?state= など)。
  5. [URL 情報] ボタンをクリックし、対応するキーを選択して動的 URL を完成させます。

    埋め込みダッシュボードの動的 URL の例を以下に示します。

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

認証の共有

Web アプリケーションの中には、ArcGIS アカウントを使用してサイン インするよう求めるものがあります。 共有設定のため、プレミアム コンテンツを使用するウィジェットがアプリに含まれるため、その他の理由により、アプリによってはログインが必要な場合があります。

ArcGIS Web アプリを Experience Builder に埋め込み、両アプリがログインを必要とする場合、arcgis-auth-origin パラメーターと arcgis-auth-portal URL パラメーターを追加して両アプリで認証を共有すると、一度サイン インするだけで済みます。

プライベートの Experience Builder アプリを別の Experience Builder アプリを埋め込むには、?arcgis-auth-origin= を使用して、認証用のホスト アプリ ドメインの URL を定義します。 例を以下に示します。

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

JavaScript API ベースのアプリ (Web AppBuilder アプリなど) を埋め込むには、ホスト アプリ ドメイン認証用に ?arcgis-auth-origin=、JavaScript API ベースのアプリのドメイン認証用に ?arcgis-auth-portal= を使用します。 例を以下に示します。

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

このトピックへのフィードバック

このトピックの内容
  1. 例
  2. 使用上の注意
  3. 設定
  4. 動的 URL の構成
  5. 認証の共有