Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden des Amazon Quick Sight Embedding SDK, um gemeinsam nutzbare Links zu eingebetteten Dashboard-Ansichten zu aktivieren
<a name="embedded-view-sharing"></a>

Amazon Quick Sight-Entwickler können das Amazon Quick Sight Embedding SDK (Version 2.8.0 und höher) verwenden, um es Lesern eingebetteter Dashboards zu ermöglichen, gemeinsam nutzbare Links zu ihrer Ansicht eines eingebetteten Dashboards zu empfangen und zu verteilen. Entwickler können die Dashboard- oder Konsoleneinbettung verwenden, um einen gemeinsam nutzbaren Link zu ihrer Anwendungsseite zu generieren, wobei die Referenz von Amazon Quick Sight mithilfe des Amazon Quick Sight Embedding SDK gekapselt ist. Amazon Quick Sight-Leser können diesen gemeinsam nutzbaren Link dann an ihre Kollegen senden. Wenn ihr Peer auf den geteilten Link zugreift, wird er auf die Seite in der Anwendung weitergeleitet, die das eingebettete Amazon Quick Sight-Dashboard enthält. Entwickler können auch gemeinsam nutzbare Links von Dashboard-Ansichten generieren und speichern, die bei anonymer Einbettung als Lesezeichen für anonyme Leser von Amazon Quick Sight verwendet werden können.

**Voraussetzungen**

Bevor Sie beginnen, stellen Sie sicher, dass Sie das Amazon Quick Sight Embedding SDK Version 2.8.0 oder höher verwenden

**Topics**
+ [

# Aktivierung der `SharedView` Funktionskonfiguration für Amazon Quick Sight Embedded Analytics
](embedded-view-sharing-set-up.md)
+ [

# Eine gemeinsame Ansicht mit der Amazon Quick Sight `createSharedView` API erstellen
](embedded-view-sharing-sdk-create.md)
+ [

# Nutzung einer gemeinsamen Amazon Quick Sight-Ansicht
](embedded-view-sharing-sdk-consume.md)

# Aktivierung der `SharedView` Funktionskonfiguration für Amazon Quick Sight Embedded Analytics
<a name="embedded-view-sharing-set-up"></a>

Wenn Sie eine eingebettete Instance mit der Amazon Quick Sight-API erstellen, setzen Sie den Wert von `SharedView` in der `FeatureConfigurations` Payload auf`true`, wie im Beispiel unten gezeigt. `SharedView`überschreibt die `StatePersistence` Konfigurationen für registrierte Benutzer, die auf eingebettete Dashboards zugreifen. Wenn ein Dashboard-Benutzer `StatePersistence` deaktiviert und `SharedView` aktiviert hat, bleibt sein Status bestehen.

```
const generateNewEmbedUrl = async () => {
    const generateUrlPayload = {
        experienceConfiguration: {
            QuickSightConsole: {
            FeatureConfigurations: {
                "SharedView": { 
                    "Enabled": true
                 },
            },
        },
    }
    const result: GenerateEmbedUrlResult = await generateEmbedUrlForRegisteredUser(generateUrlPayload);
    return result.url;
};
```

# Eine gemeinsame Ansicht mit der Amazon Quick Sight `createSharedView` API erstellen
<a name="embedded-view-sharing-sdk-create"></a>

Nachdem Sie das Embedding SDK auf Version 2.8.0 oder höher aktualisiert haben, verwenden Sie die `createSharedView` API, um eine neue gemeinsame Ansicht zu erstellen. Notieren Sie die `sharedViewId` und die `dashboardId`, die der Vorgang zurückgibt. Im folgende Beispiel wird eine neue gemeinsame Ansicht erstellt.

```
const response = await embeddingFrame.createSharedView();
const sharedViewId = response.message.sharedViewId;
const dashboardId = response.message.dashboardId;
```

`createSharedView` kann nur aufgerufen werden, wenn ein Benutzer ein Dashboard aufruft. Stellen Sie bei der konsolenspezifischen Erstellung gemeinsam genutzter Ansichten sicher, dass sich die Benutzer auf der Dashboard-Seite befinden, bevor Sie die Aktion `createSharedView` aktivieren. Sie können dies mit dem Ereignis `PAGE_NAVIGATION` tun, das im Beispiel unten gezeigt wird.

```
const contentOptions = {
    onMessage: async (messageEvent, metadata) => {
    switch (messageEvent.eventName) {
            case 'CONTENT_LOADED': {
                console.log("Do something when the embedded experience is fully loaded.");
                break;
            }
            case 'ERROR_OCCURRED': {
                console.log("Do something when the embedded experience fails loading.");
                break;
            }
            case 'PAGE_NAVIGATION': {
                setPageType(messageEvent.message.pageType); 
                if (messageEvent.message.pageType === 'DASHBOARD') {
                    setShareEnabled(true);
                    } else {
                    setShareEnabled(false);
                }
                break;
            }
        }
    }
};
```

# Nutzung einer gemeinsamen Amazon Quick Sight-Ansicht
<a name="embedded-view-sharing-sdk-consume"></a>

Nachdem Sie eine neue gemeinsame Ansicht erstellt haben, verwenden Sie das Embedding SDK, um die gemeinsame Ansicht für andere Benutzer nutzbar zu machen. In den folgenden Beispielen wird eine gemeinsame Ansicht für verbrauchbare Inhalte für ein eingebettetes Dashboard in Amazon Quick Sight eingerichtet.

------
#### [ With an appended URL ]

Hängen Sie die `sharedViewId` an die Einbettungs-URL unter ` /views/{viewId}` an und machen Sie diese URL Ihren Benutzern zugänglich. Benutzer können diese URL verwenden, um zu dieser gemeinsamen Ansicht zu navigieren.

```
const response = await dashboardFrame.createSharedView();
const newEmbedUrl = await generateNewEmbedUrl();
const formattedUrl = new URL(newEmbedUrl);
formattedUrl.pathname = formattedUrl.pathname.concat('/views/' + response.message.sharedViewId);
const baseUrl = formattedUrl.href;
alert("Click to view this QuickSight shared view", baseUrl);
```

------
#### [ With the contentOptions SDK ]

Übergeben Sie eine `viewId` an die `contentOptions`, um das Erlebnis mit der angegebenen `viewId` zu öffnen.

```
const contentOptions = {
    toolbarOptions: {
        ...
    },
    viewId: sharedViewId,
};

const embeddedDashboard = await embeddingContext.embedDashboard(
    {container: containerRef.current},
    contentOptions
);
```

------
#### [ With the InitialPath property ]

```
const shareView = async() => {
    const returnValue = await consoleFrame.createSharedView();
    const {dashboardId, sharedViewId} = returnValue.message;
    const newEmbedUrl = await generateNewEmbedUrl(`/dashboards/${dashboardId}/views/${sharedViewId}`);
    setShareUrl(newEmbedUrl);
};

const generateNewEmbedUrl = async (initialPath) => {
    const generateUrlPayload = {
        experienceConfiguration: {
            QuickSightConsole: {
            InitialPath: initialPath,
            FeatureConfigurations: {
                "SharedView": { 
                    "Enabled": true
                 },
            },
        },
    }
    const result: GenerateEmbedUrlResult = await generateEmbedUrlForRegisteredUser(generateUrlPayload);
    return result.url;
};
```

------