Udostępnij za pośrednictwem

Osadzanie pulpitu nawigacyjnego

  • Artykuł

W tym artykule wyjaśniono, jak osadzić pulpit nawigacyjny sztucznej inteligencji/analizy biznesowej w zewnętrznej witrynie internetowej lub aplikacji. Przed osadzeniem pulpitów nawigacyjnych administrator obszaru roboczego musi zdefiniować potencjalne powierzchnie osadzania. Aby uzyskać szczegółowe informacje na temat konfigurowania obszaru roboczego Zarządzanie osadzaniem pulpitu nawigacyjnego.

Użytkownicy z co najmniej uprawnieniem CAN EDIT mogą generować kod elementu iframe dla pulpitu nawigacyjnego w oknie dialogowym Udostępnianie . Wszystkie ustawienia udostępniania opublikowanego pulpitu nawigacyjnego pozostają w mocy. Tylko użytkownicy, którym udzielono jawnego dostępu, mogą wyświetlać osadzone pulpity nawigacyjne. Zobacz Udostępnianie pulpitu nawigacyjnego , aby dowiedzieć się więcej na temat udostępniania pulpitów nawigacyjnych. Osadzone pulpity nawigacyjne są zgodne z tą samą pamięcią podręczną i cyklem odświeżania co wszystkie inne pulpity nawigacyjne. Zobacz Buforowanie i świeżość danych.

Generowanie kodu osadzania

Aby osadzić pulpit nawigacyjny, wykonaj następujące kroki:

  1. Otwórz opublikowany pulpit nawigacyjny, który chcesz osadzić. Zobacz Wyświetlanie i organizowanie pulpitów nawigacyjnych , aby dowiedzieć się, jak wyświetlać pulpity nawigacyjne i uzyskiwać do ich dostępu w obszarze roboczym.

  2. Kliknij pozycję Udostępnij w prawym górnym rogu.

  3. Kliknij pozycję Osadź pulpit nawigacyjny w oknie dialogowym Udostępnianie .

  4. Zostanie otwarte okno dialogowe Kopiowanie kodu osadzania. Jeśli istnieje lista dozwolonych domen osadzania, zostaną wyświetlone domeny. Kliknij Ikona Kopiuj przycisk kopiowania, aby skopiować fragment kodu.

    Okno dialogowe Kopiowanie kodu osadzania pokazuje wygenerowany kod iframe i domeny, w których można osadzać opublikowane pulpity nawigacyjne.

  5. Wstaw kod osadzania do dowolnej platformy lub aplikacji, która obsługuje osadzanie HTML oraz renderowanie zawartości iframe. Zobacz Przykłady.

Uwaga

Jeśli okno dialogowe Kopiowanie kodu osadzania zawiera listę dozwolonych domen, które nie zawierają domeny docelowej, administrator obszaru roboczego może go dodać. Zobacz Zarządzanie osadzaniem pulpitu nawigacyjnego.

Przykłady

Poniższe przykłady obejmują szczegółowe wskazówki dotyczące osadzania pulpitów nawigacyjnych w aplikacji. Każdy zestaw instrukcji zakłada, że kod osadzania został już skopiowany w poprzedniej sekcji.

Osadzanie w aplikacji Confluence

Wygenerowany kod osadzania wymaga niewielkiego dostosowania w celu spełnienia wymagań platformy Confluence. Aby osadzić pulpit nawigacyjny na stronie Confluence, wykonaj następujące kroki:

  1. Edytuj kod osadzania, aby uwzględnić tylko wygenerowany adres URL, a nie tagi elementu iframe lub dodatkowe wartości znaczników.

    Przed rozpoczęciem edycji kod osadzania zawiera tag HTML elementu iframe, link do pulpitu nawigacyjnego, aby użyć źródła w elemecie iframe oraz dodatkowe specyfikacje dotyczące wysokości, szerokości i obramowania, jak pokazano w poniższym fragmencie kodu. W przypadku pulpitu nawigacyjnego przykładowe symbole <databricks-instance-name> zastępcze i <dashboard-and-workspace-ID> zawierają rzeczywiste wartości skojarzone z obszarem roboczym i pulpitem nawigacyjnym. Są one następujące:

    • Jest <databricks-instance-name> to pierwsza część adresu URL podczas logowania się do obszaru roboczego. Zobacz Pobieranie identyfikatorów dla obiektów obszaru roboczego.
    • Jest <dashboard-and-workspace-ID> to ostatnia część adresu URL, która wskazuje pulpit nawigacyjny. Wygląda to następująco: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.
    <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>

    Edytuj ciąg, tak aby zawierał tylko tekst łącza, jak pokazano w poniższym przykładzie.

    https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>

  2. Wstaw element elementu iframe do strony. Aby dowiedzieć się, jak wstawić element iframe do strony, zobacz dokumentację platformy Confluence.

  3. Wklej edytowany adres URL osadzania w polu tekstowym adresu URL i ustaw szerokość na 100%.

  4. Dostosuj inne ustawienia zgodnie z preferencjami.

Pulpit nawigacyjny osadzony w wersji roboczej strony Confluence.

Osadzanie w usłudze Salesforce Knowledge

Aby osadzić pulpit nawigacyjny na stronie wiedzy usługi Salesforce, wykonaj następujące kroki:

  1. Utwórz stronę usługi Visualforce. Aby uzyskać instrukcje, zobacz dokumentację usługi Salesforce.

  2. Na ekranie Edycja strony przenieś kursor do edytora znaczników visualforce.

  3. Wklej kod osadzania skopiowany między dwoma tagami <apex:page></apex:page>.

  4. Dodaj dwa tagi akapitu (<p></p>) wokół kodu osadzania.

    W poniższym przykładzie użyto symbolu zastępczego <dashboard-embed-code> , aby zademonstrować wygląd znaczników usługi Visualforce. Twoje wystąpienie powinno zawierać skopiowany pełny kod osadzania.

    <apex:page >
<p><dashboard-embed-code></p>
</apex:page>

  5. Kliknij przycisk Zapisz, aby zapisać zmiany.

  6. Kliknij pozycję Podgląd i potwierdź, że pulpit nawigacyjny jest renderowany.

  7. Skopiuj adres URL podglądu składnika i utwórz nowy składnik elementu iframe. Powinien on wyglądać podobnie do poniższego fragmentu kodu. Symbol zastępczy <your-salesforce-domain> powinien zostać zastąpiony domeną usługi Salesforce.

    <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>

  8. Przejdź do strony Wiedza, na której chcesz osadzić pulpit nawigacyjny.

  9. Kliknij pozycję Edytuj>dodaj składnik multimedialny.

  10. Wklej kod elementu iframe z poprzedniego kroku w polu Tekst osadzania .

Osadzanie w programie SharePoint

Aby osadzić pulpit nawigacyjny w programie SharePoint, może być konieczne dodanie adresu URL usługi Azure Databricks do listy dozwolonych witryn dla osadzonej zawartości w programie SharePoint. Zobacz dokumentację firmy [Microsoft], aby dowiedzieć się, jak zezwalać na osadzanie zawartości na stronach programu SharePoint. Następnie wykonaj następujące kroki:

  1. Przejdź do strony programu SharePoint, na której chcesz hostować osadzony pulpit nawigacyjny.
  2. Dodaj element Embed do strony.
  3. Wklej pełny kod osadzania w polu Adres witryny internetowej lub kod osadzania po prawej stronie ekranu.
  4. Kliknij, aby potwierdzić.

Pulpit nawigacyjny osadzony na roboczej stronie programu SharePoint

Osadzanie pojedynczego widżetu

Aby osadzić pojedynczy widżet z pulpitu nawigacyjnego, potrzebny jest kod osadzania pulpitu nawigacyjnego i unikatowy identyfikator widżetu, który chcesz wyświetlić.

Aby znaleźć identyfikator widżetu:

  1. Otwórz opublikowany pulpit nawigacyjny w obszarze roboczym usługi Azure Databricks.

  2. Kliknij menu Kebab menu kebab dla widżetu, który chcesz osadzić.

  3. Kliknij Wyświetl w trybie pełnoekranowym. Nowy adres URL zawiera identyfikator widżetu.

  4. Skopiuj identyfikator widżetu z adresu URL. Jest wyświetlany po widgets%2F.

    Poniższy przykład przedstawia ostatnią część adresu URL dla widżetu pełnoekranowego:

    widgets%2F01ef9213e9d51cdab682d58754c03f51

    W takim przypadku identyfikator widżetu jest 01ef9213e9d51cdab682d58754c03f51

dostosuj wygenerowany kod osadzania:

  1. Aby znaleźć kroki do wygenerowania kodu osadzania dashboardu, zobacz Generowanie kodu osadzania.
  2. Dodaj &fullscreenWidget={ID} do adresu URL osadzania, zastępując ID identyfikatorem widżetu.

Jeśli na przykład podstawowy adres URL osadzania jest następujący:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget={ID}"

Zaktualizowany adres URL osadzania z identyfikatorem widżetu powinien wyglądać następująco:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget={01ef9213e9d51cdab682d58754c03f51}"

Wyświetlanie osadzonego pulpitu nawigacyjnego

Osadzone pulpity nawigacyjne oferują bezpieczny sposób uzyskiwania dostępu do danych pulpitu nawigacyjnego poza usługą Azure Databricks. Wszystkie istniejące ustawienia udostępniania mają zastosowanie. Osoby przeglądające muszą mieć dostęp do pulpitu nawigacyjnego. Zobacz Kto może uzyskać dostęp do pulpitu nawigacyjnego?.

Aby wyświetlić osadzony pulpit nawigacyjny:

  • Przejdź do strony, na której został osadzony pulpit nawigacyjny.
  • W razie potrzeby zaloguj się przy użyciu poświadczeń usługi Azure Databricks.

Uwaga

Jeśli zarejestrowany użytkownik, któremu nie udzielono dostępu do pulpitu nawigacyjnego, spróbuje go wyświetlić, zostanie wyświetlony błąd informujący, że pulpit nawigacyjny jest niedostępny. Zobacz Udostępnianie opublikowanego pulpitu nawigacyjnego , aby dowiedzieć się, jak dostosować ustawienia udostępniania.

Odświeżanie osadzonego pulpitu nawigacyjnego

Wszyscy użytkownicy osadzonego pulpitu nawigacyjnego mogą ręcznie odświeżać pulpity nawigacyjne na żądanie. Możesz również okresowo konfigurować harmonogram odświeżania pulpitów nawigacyjnych.

Zobacz Zarządzanie zaplanowanymi aktualizacjami pulpitu nawigacyjnego i subskrypcjami.

Rozwiązywanie problemów z osadzonymi pulpitami nawigacyjnymi

W tej sekcji wymieniono typowe problemy, które mogą wystąpić, i oferuje sugerowane rozwiązanie:

Osadzony element iframe jest pusty

Jeśli osadzony element iframe nie wyświetla danych, może to być spowodowane wyłączeniem plików cookie innych firm. Włączenie plików cookie innych firm jest często niezbędne do umożliwienia prawidłowego działania zawartości zewnętrznej, takiej jak osadzone pulpity nawigacyjne, na innej stronie internetowej.

Możesz dostosować ustawienia przeglądarki, aby umożliwić lub odblokować pliki cookie innych firm, aby rozwiązać ten problem. Jeśli nie chcesz zezwalać na wszystkie pliki cookie innych firm, wiele przeglądarek umożliwia dodawanie wyjątków dla określonych witryn, w których powinny być dozwolone pliki cookie innych firm. Zapoznaj się z dokumentacją pomocy przeglądarki, aby uzyskać szczegółowe instrukcje dotyczące zarządzania plikami cookie.