Contoh URL untuk item di server laporan - mode SharePoint

Untuk menerbitkan laporan dan item terkait ke pustaka SharePoint, Anda bisa menerbitkan konten dengan menggunakan alat penulisan Reporting Services seperti Perancang Laporan. Anda juga bisa mengunggah konten dengan menggunakan tindakan situs SharePoint.

Situs SharePoint menggunakan alamat Web yang berbeda dari server laporan Reporting Services dalam mode asli. Hierarki Web situs SharePoint menyertakan aplikasi Web SharePoint, situs tingkat atas, subsitus opsional, dan pustaka. Anda harus tahu cara membuat alamat URL yang menentukan server SharePoint dan lokasi dalam hierarki situs SharePoint tempat Anda ingin menerbitkan laporan atau item terkait.

Item yang terkait dengan laporan mencakup sumber data bersama, sublaporan, laporan penelusuran, dan sumber daya seperti file gambar berbasis Web. Laporan yang diterbitkan ke pustaka SharePoint harus menentukan item terkait ini berdasarkan lokasinya di pustaka SharePoint.

Gunakan contoh dalam artikel ini untuk membantu membuat URL untuk melaporkan dan item terkait dalam solusi pelaporan Anda.

Hierarki situs

Saat Anda mengonfigurasi server laporan untuk dijalankan dalam mode terintegrasi SharePoint, hierarki Web SharePoint digunakan untuk mengatasi item yang diproses dan dikelola di server laporan.

Elemen hierarki Web berikut dapat digunakan untuk mengakses dan mengamankan konten server laporan. Objek lain seperti daftar dan halaman tidak digunakan untuk mengakses konten server laporan dan oleh karena itu tidak dijelaskan dalam tabel berikut.

Objek	Deskripsi
Aplikasi Web SharePoint	Aplikasi Web SharePoint dapat diinstal sebagai server yang berdiri sendiri atau di bawah farm yang berisi kumpulan server virtual. Aplikasi Web memiliki URL (misalnya, http:*//servername*) dan dapat berisi beberapa situs.
Site	Situs adalah situs induk untuk aplikasi Web atau subsitus.
Pustaka SharePoint	Pustaka berisi dokumen atau folder. Pustaka atau folder dalam pustaka adalah satu-satunya objek situs yang dapat menyimpan laporan, model laporan, sumber data bersama, dan gambar eksternal.
Item	Melaporkan item server yang dapat Anda referensikan dalam URL menyertakan definisi laporan untuk laporan atau sublaporan, model laporan, sumber data bersama, atau gambar eksternal.

Sintaks dan aturan URL

Anda dapat mengidentifikasi setiap item server laporan di pustaka dengan URL yang sepenuhnya memenuhi syarat. URL mencakup awalan protokol, nama server, situs, pustaka, nama file, dan ekstensi nama file untuk jenis file.

URL untuk server SharePoint

Anda harus menggunakan URL ke server SharePoint saat Menyebarkan server Laporan atau proyek Model Laporan dari SQL Server Data Tools (SSDT) ke server laporan.

Untuk menemukan nama server yang akan digunakan, buka browser dan temukan pustaka SharePoint tempat Anda ingin menerbitkan laporan. Nama server muncul segera setelah awalan protokol, misalnya, http:*//servername*.

Penggunaan titik akhir proksi URL Reporting Services tidak didukung. Titik akhir proksi menyertakan nomor port, misalnya, http:*//servername:8080/reportserver*.

URL untuk situs server SharePoint atau subsitus

Saat Anda menyebarkan laporan atau melaporkan sumber data, Anda harus menggunakan URL ke situs dan subsitus SharePoint, jika ada. Di URL, nama situs muncul segera setelah nama server, misalnya, https://*servername/site* atau https://*servername/site/subsite*.

Pada aplikasi Web Microsoft Office SharePoint Server 2007 atau SharePoint Server 2010, situs dan subsitus sering sesuai dengan tab di situs utama. Untuk menemukan nama situs atau nama subsitus, pilih Beranda, lalu Semua Konten Situs. Gulir ke bawah dan cari Situs dan Ruang Kerja. Daftar situs muncul di bagian ini.

URL untuk pustaka SharePoint

Saat Anda menyebarkan laporan atau item terkait ke pustaka SharePoint, Anda harus menggunakan URL ke pustaka SharePoint. URL yang digunakan untuk pustaka berbeda bergantung pada versi SharePoint yang Anda gunakan.

Pada Layanan Microsoft Windows SharePoint 3.0 atau SharePoint Foundation 2010, pustaka muncul setelah nama server, misalnya, https://*servername/*Shared Documents.

Di Office SharePoint Server 2007 atau SharePoint Server 2010, pustaka muncul setelah situs dan subsitus. Contohnya, https://*servername/site/*Documents.

Untuk menemukan informasi jalur untuk pustaka SharePoint baru atau untuk situs yang tidak dikenal, buka browser dan temukan pustaka SharePoint tempat Anda ingin menerbitkan laporan Anda. Jika pustaka kosong, unggah file apa pun. Klik kanan file dan pilih Properti untuk membuka jendela Properti . Alamat file berisi nilai URL yang Anda butuhkan untuk operasi penerbitan.

URL yang sepenuhnya memenuhi syarat untuk item di situs SharePoint

Item yang disimpan dalam pustaka SharePoint selalu ditangani melalui URL yang sepenuhnya memenuhi syarat yang dimulai dengan aplikasi Web (https://*server*) sebagai simpul akar, dan disimpulkan dengan nama file yang Anda rujuk.

Nama file dalam URL harus menyertakan ekstensi nama file.

Anda tidak dapat menggunakan URL relatif untuk item dependen dalam laporan yang Anda terbitkan ke situs SharePoint. Misalnya, Anda tidak dapat menggunakan URL relatif untuk mereferensikan sumber data bersama, model laporan, atau sublaporan. Anda harus selalu menentukan URL yang sepenuhnya memenuhi syarat ke pustaka SharePoint untuk setiap item. Tidak ada cara untuk memprediksi di mana file dependen mungkin berada. Anda tidak dapat memprediksinya karena tidak ada hierarki yang telah ditentukan sebelumnya ke situs yang dapat Anda gunakan untuk mengurai format URL.

Saat menerbitkan atau mengunggah laporan yang berisi item dependen, Anda harus mengatur referensi ke item dependen setelah laporan diterbitkan. Referensi yang berfungsi dengan benar dalam mode Pratinjau dalam Perancang Laporan tidak dijamin berfungsi setelah laporan diterbitkan. Untuk informasi selengkapnya, lihat Menerbitkan dari Alat Penulisan ke Pustaka SharePoint di artikel ini.

URL untuk gambar eksternal

Definisi laporan dapat menyertakan file gambar yang disimpan sebagai file eksternal. Anda dapat mereferensikan file tersebut dalam definisi laporan dengan mengatur URL yang sepenuhnya memenuhi syarat ke file gambar. Ini dapat disimpan di situs SharePoint atau di komputer jarak jauh.

Penting

Jika URL eksternal adalah untuk gambar di situs SharePoint, ikon gambar yang rusak akan muncul saat Anda mempratinjau laporan di Pembuat Laporan. Saat Anda mengunggah laporan ke situs SharePoint, dan merender laporan dalam mode tersambung, ikon gambar yang rusak akan muncul jika Anda hanya memiliki izin Tampilkan Item .

Terlepas dari mode server laporan, referensi ke file gambar eksternal dalam laporan harus merupakan URL yang sepenuhnya memenuhi syarat. Selain itu, merujuk file gambar eksternal biasanya mengharuskan Anda mengonfigurasi akun pemrosesan laporan tanpa pengawas.

Tentukan sublaporan dan laporan penelusuran

Sublaporan harus berada di folder yang sama dengan laporan utama. Anda tidak dapat menentukan folder relatif.

Untuk menentukan laporan penelusuran, sertakan URL dalam ekspresi. Misalnya, tentukan laporan yang diberi nama SalesDetails sebagai laporan penelusuran. Dalam tindakan untuk kotak teks atau teks tempat penampung, atur ReportName ke ekspresi berikut:

="https://site/subsite/documentlibrary/SalesDetails.rdl"  

Nama yang dicadangkan di situs SharePoint

Jika Anda membuat atau membuat URL ke item yang terletak di situs SharePoint, ketahuilah bahwa kata-kata Pribadi dan Situs adalah nama yang dicadangkan di bawah situs default.

Contoh URL

Saat menerbitkan item ke pustaka SharePoint, Anda harus menentukan URL yang sepenuhnya memenuhi syarat ke pustaka target. URL SharePoint yang sepenuhnya memenuhi syarat mencakup aplikasi Web SharePoint, situs, pustaka, folder (opsional), file, dan ekstensi nama file. Contoh berikut memberikan beberapa ilustrasi sintaks yang harus Anda gunakan.

Target	Contoh URL
Server SharePoint.	https://TestServer
Situs server SharePoint atau subsitus.	https://TestServer/toplevelsite/subsite
Laporan sampel Penjualan Perusahaan di Dokumen Bersama pada penyebaran Layanan Windows SharePoint atau SharePoint Foundation 2010.	https://TestServer/TestSite/Shared%20Documents/Company%20Sales.rdl
Laporan sampel Penjualan Perusahaan di folder Dokumen/Dokumen di Office SharePoint Server atau instans SharePoint Server 2010.	https://TestServer/TestSite/Documents/Doc/Company%20Sales.rdl
Laporan sampel Penjualan Perusahaan di Pusat Laporan pada instans Office SharePoint Server atau SharePoint Server 2010.	https://TestServer/TestSite/Reports/Doc/Company%20Sales.rdl

Menerbitkan dari alat penulisan ke pustaka SharePoint

Saat Anda menggunakan alat penulisan laporan untuk menerbitkan laporan dan file terkait ke pustaka, file akan divalidasi sebelum ditambahkan. Jika Anda mengunggah laporan dan file terkait dengan menggunakan tindakan Unggah pada pustaka SharePoint, tidak ada pemeriksaan validasi yang terjadi. Anda tidak tahu apakah file valid hingga Anda mengakses laporan dengan mengelola, mengedit, atau menjalankannya.

Catatan

Untuk menerbitkan laporan ke situs SharePoint dari SQL Server Data Tools (SSDT), Anda mungkin perlu menambahkan situs SharePoint ke daftar lokasi tepercaya anda di browser Internet Explorer.

Sumber data bersama

Saat Anda menerbitkan sumber data bersama dari alat penulisan laporan, Anda mengatur properti proyek TargetDataSourceFolder. Folder sumber data target harus berupa URL ke pustaka SharePoint. Tidak seperti dalam mode asli Reporting Services, Anda tidak dapat menentukan folder relatif; jalur relatif tidak valid. Jika folder di jalur Pustaka Dokumen tidak ada, folder dibuat.

Saat Anda menerbitkan file sumber data bersama (.rds) ke situs SharePoint, tindakan ini mengubah file sumber data menjadi ekstensi nama file .rsds. File .rsds tidak dapat disimpan secara lokal dari situs SharePoint dan diimpor ke dalam proyek Reporting Services yang ada. Sumber data bersama dengan ekstensi nama file .rds dan .rsds tidak dapat dipertukarkan.

Sumber data bersama dari Perancang Laporan

Jika Anda menerbitkan sumber data bersama dari proyek Perancang Laporan, Anda dapat menggunakan URL yang menentukan pustaka target atau Anda dapat membiarkan properti kosong. Tidak seperti dalam mode asli Reporting Services, Anda tidak dapat menentukan folder relatif; jalur relatif tidak valid. Jika folder di jalur Pustaka Dokumen tidak ada, folder dibuat. Jika Anda membiarkan folder sumber data target kosong, sumber data diterbitkan di folder laporan target.

Nama file

Nama file dalam URL untuk item laporan harus menyertakan ekstensi nama file. Ekstensi nama file menentukan jenis file. Saat Anda menerbitkan item laporan dari alat penulisan laporan, ekstensi nama file disertakan secara otomatis. Jika Anda mengunggah item laporan ke pustaka SharePoint, Anda harus menyertakan ekstensi nama file.

Jika Anda tidak menentukan ekstensi nama file untuk item yang Anda unggah ke situs SharePoint, kesalahan rsInvalidDataSourceReference terjadi. Nama file mungkin tidak menyertakan karakter yang tidak dikenali sebagai karakter nama file yang valid oleh aplikasi SharePoint. Jangan sertakan karakter berikut: # % & * : < > ? / { | }.

Perbedaan antara pengunggahan dan penerbitan

Saat Anda menggunakan Perancang Laporan atau Pembuat Laporan untuk menerbitkan laporan dan file terkait ke pustaka, sistem memvalidasi file sebelum menambahkannya. Jika Anda mengunggah laporan dan file terkait dengan menggunakan tindakan Unggah pada pustaka SharePoint, tidak ada pemeriksaan validasi yang terjadi. Anda tidak tahu apakah file valid hingga Anda mengakses laporan dengan mengelola, mengedit, atau menjalankannya.

Memperbarui item yang diterbitkan

Setelah Anda menerbitkan atau mengunggah item ke pustaka SharePoint, Anda harus memeriksa item keluar dari pustaka sebelum memperbaruinya. Saat laporan dicek keluar kepada Anda, Anda adalah satu-satunya pengguna yang memiliki izin untuk mengubah laporan. Setelah selesai, periksa kembali.

Anda dapat mengunggah atau menerbitkan laporan tanpa memeriksa dokumen terlebih dahulu, misalnya, dengan mengunggah item yang memiliki nama yang sama dengan item yang sudah ada. Jika Anda melakukannya, server laporan memeriksanya untuk Anda, menambahkan laporan yang diperbarui sebagai versi baru dari item yang sudah ada, lalu memeriksa kembali dokumen.

Gambar eksternal sebagai sumber daya

Server laporan yang berjalan dalam mode asli mendukung konsep sumber daya. Konsep sumber daya didefinisikan sebagai file apa pun yang disimpan dan diamankan di server laporan, tetapi server laporan tidak memprosesnya. Dalam mode asli, bisa berupa file apa pun.

Saat server laporan berjalan dalam mode terintegrasi SharePoint, konsep sumber daya memiliki definisi yang lebih sempit. Server laporan mempertahankan konsep sumber daya untuk menyimpan laporan yang mereferensikan gambar eksternal. Konsep ini berlaku jika laporan adalah rekam jepret atau salinan yang disimpan untuk penggunaan internal.

Konten terkait

Menerbitkan laporan ke pustaka SharePoint
Menerbitkan sumber data bersama ke pustaka SharePoint
Kotak dialog Halaman Properti Proyek