Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Menggunakan Amazon Quick Sight Embedding SDK untuk mengaktifkan tautan yang dapat dibagikan ke tampilan dasbor yang disematkan
<a name="embedded-view-sharing"></a>

Pengembang Amazon Quick Sight dapat menggunakan Amazon Quick Sight Embedding SDK (versi 2.8.0 dan lebih tinggi) untuk memungkinkan pembaca dasbor tertanam menerima dan mendistribusikan tautan yang dapat dibagikan ke tampilan dasbor yang disematkan. Pengembang dapat menggunakan penyematan dasbor atau konsol untuk menghasilkan tautan yang dapat dibagikan ke halaman aplikasi mereka dengan referensi Amazon Quick Sight yang dienkapsulasi menggunakan Amazon Quick Sight Embedding SDK. Amazon Quick Sight Readers kemudian dapat mengirim tautan yang dapat dibagikan ini ke rekan-rekan mereka. Ketika rekan mereka mengakses tautan bersama, mereka dibawa ke halaman pada aplikasi yang berisi dasbor Amazon Quick Sight yang disematkan. Pengembang juga dapat membuat dan menyimpan tautan tampilan dasbor yang dapat dibagikan yang dapat digunakan sebagai bookmark untuk pembaca anonim Amazon Quick Sight saat menggunakan penyematan anonim.

**Prasyarat**

Sebelum memulai, pastikan Anda menggunakan Amazon Quick Sight Embedding SDK versi 2.8.0 atau yang lebih tinggi

**Topics**
+ [

# Mengaktifkan konfigurasi `SharedView` fitur untuk analitik tertanam Amazon Quick Sight
](embedded-view-sharing-set-up.md)
+ [

# Membuat tampilan bersama dengan Amazon Quick Sight `createSharedView` API
](embedded-view-sharing-sdk-create.md)
+ [

# Mengkonsumsi tampilan Quick Sight Amazon bersama
](embedded-view-sharing-sdk-consume.md)

# Mengaktifkan konfigurasi `SharedView` fitur untuk analitik tertanam Amazon Quick Sight
<a name="embedded-view-sharing-set-up"></a>

Saat Anda membuat instance yang disematkan dengan Amazon Quick Sight API, tetapkan nilai `SharedView` `FeatureConfigurations` payload ke`true`, seperti yang ditunjukkan pada contoh di bawah ini. `SharedView`mengganti `StatePersistence` konfigurasi untuk pengguna terdaftar yang mengakses dasbor tertanam. Jika pengguna dasbor telah `StatePersistence` dinonaktifkan dan `SharedView` diaktifkan, statusnya akan tetap ada.

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

# Membuat tampilan bersama dengan Amazon Quick Sight `createSharedView` API
<a name="embedded-view-sharing-sdk-create"></a>

Setelah memperbarui Embedding SDK ke versi 2.8.0 atau yang lebih tinggi, gunakan `createSharedView` API untuk membuat tampilan bersama baru. Catat `sharedViewId` dan `dashboardId` bahwa operasi kembali. Contoh di bawah ini membuat tampilan bersama baru.

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

`createSharedView`hanya dapat dipanggil ketika pengguna melihat dasbor. Untuk pembuatan tampilan bersama khusus konsol, pastikan pengguna berada di halaman dasbor sebelum Anda mengaktifkan tindakan. `createSharedView` Anda dapat melakukan ini dengan `PAGE_NAVIGATION` acara tersebut, yang ditunjukkan pada contoh di bawah ini.

```
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;
            }
        }
    }
};
```

# Mengkonsumsi tampilan Quick Sight Amazon bersama
<a name="embedded-view-sharing-sdk-consume"></a>

Setelah Anda membuat tampilan bersama baru, gunakan Embedding SDK untuk membuat tampilan bersama dapat digunakan untuk pengguna lain. Contoh di bawah ini menyiapkan tampilan bersama yang dapat dikonsumsi untuk dasbor tertanam di Amazon Quick Sight.

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

Tambahkan `sharedViewId` ke URL embed, di bawah` /views/{viewId}`, dan paparkan URL ini ke pengguna Anda. Pengguna dapat menggunakan URL ini untuk menavigasi ke tampilan bersama itu.

```
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 ]

Berikan a `viewId` ke `contentOptions` untuk membuka pengalaman dengan yang diberikan`viewId`.

```
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;
};
```

------