Populate Web Part Melalui Share Point 2007

Setalah pada artikel sebelumnya telah dibahas tentang bagaimana langkah – langkah konfigurasi yang diperlukan untuk membuat web part dengan visual studio 2005 dan share point 2007, maka pada artikel ini akan dibahas tentang langkah – langkah yang diperlukan untuk menyiapkan web part yang telah dibuat agar dapat ditempatkan pada suatu halaman web ASP.NET.
Untuk dapat men-deploy / mem-populate web part, kita harus melakukan login sebagai administrator. Selanjutnya ketikkan alamat server pada browser, masukkan user name sehingga akan memunculkan halaman dengan menu Site Actions pada bagian kanan atas.

Untuk mem-populate suatu web part, klik bagian Site Actions > Site Settings > Modify All Settings. Hal ini ditunjukkan pada gambar berikut:

Setelah itu akan muncul halaman Site Settings sebagai berikut:

Pada halaman Site Settings tersebut pilih Galleries → Web Parts (ditunjukkan oleh anak panah pada gambar diatas).

Setelah link Web Parts tersebut kita pilih maka selanjutnya kita akan memasuki halaman Web Part Gallery. Pada halaman tersebut akan terlihat beberapa web part yang telah dibuat, untuk membuat web part baru dari kode program yang kita tulis, klik tombol New seperti ditunjukkan pada gambar berikut ini:

Setelah tombol New di-klik, selanjutnya kita akan memasuki halaman Web Part Gallery: New Web Parts. Pada halaman ini kita dapat menambahkan web part baru yang selanjutnya web part yang ditambahkan tersebut akan ditampilkan pada halaman Web Part Gallery.

Untuk menambahkan satu atau lebih web part baru beri check list pada check box yang tersedia pada samping kiri dari web part yang akan ditambahkan selanjutnya klik tombol Populate Gallery. Hal ini dicontohkan pada gambar berikut ini:

 

Setelah tombol Populate Gallery di-klik maka proses populate web part telah selesai.

Note: web part yang terdapat pada halaman Web Part Gallery: New Web Parts akan bertambah setiap kali kita melakukan build melalui Visual Studio yang output path-nya telah diarahkan ke lokasi drive server. Selanjutnya web part yang kita buat akan diberi nama dengan nama yang terdapat pada text box File Name, secara default web part akan diberi nama sama dengan nama kelas yang kita buat. Ganti nama default yang diberikan jika kita menginginkan nama yang lain. Untuk mengganti (meng-override) web part yang pernah kita populate sebelumnya beri check list pada check box Overwrite if file already exists?

 

Pembuatan Web Part Menggunakan Visual Studio 2005 Dan Share Point 2007

Pembuatan dan Konfigurasi Web Part

Untuk membuat web part pada share point 2007 menggunakan Visual Studio 2005 diperlukan beberapa langkah konfigurasi sederhana. Pertama kali buat project baru pada Visual Studio 2005, pilih Create Project, selanjutnya pada Visual Studio installed templates pilih Class Library. Berikut ini langkah – langkah yang harus dilakukan untuk men-deploy web part melalui Visual Studio 2005:

1. Pada file AssemblyInfo.cs, tambahkan code berikut:

[assembly:AllowPartiallyTrustedCallers()]

Assembly ini terletak di namespace System.Security, jadi pada bagian deklarasi namespace file AssemblyInfo.cs tambahkan namespace tersebut seperti contoh berikut:

using System.Reflection;

using System.Runtime.CompilerServices;

using System.Runtime.InteropServices;

using System.Security;

2. Pada bagian ‘Solution Explorer’ Visual Studio klik kanan Properties > Open, sehingga akan muncul jendela properties. Pada bagian Build pilih output path dengan mengarahkannya pada drive server, hal ini ditunjukkan pada gambar berikut ini:

Dengan mengarahkan build pada output path tersebut berarti setiap kali build atau compile untuk program yang kita buat maka proses build tersebut akan dilakukan di-drive yang disebukan pada output path tersebut (output path pada gambar diatas adalah drive tempat dimana share point 2007 berada).

3. Masih pada jendela Properties, pada tab Signing pilih checkbox untuk membuat suatu key assembly dan beri nama key tersebut, hal ini dicontohkan gambar berikut:

4. Langkah selanjutnya adalah mendaftarkan assembly yang kita buat pada file web.config. File ini terletak pada virtual directory server (dalam contoh ini file web.config terletak pada drive: Z:\Inetpub\wwwroot\wss \VirtualDirectories\80). Pada web.config tambahkan beberapa informasi mengenai assembly yang dihasilkan dari kode yang telah kita tulis. Informasi – informasi tersebut meliputi: nama assembly, PublicKeyToken, namespace, dll.

 

Note: untuk memperoleh informasi mengenai assembly yang dihasilkan oleh program (meliputi nama assembly, versi, serta PublicKeyToken) gunakan suatu tools, misalnya Lutz Roeder’s .NET Reflector. Hal ini dicontohkan melalui gambar berikut ini:

 

Jika langkah – langkah konfigurasi diatas telah dilakukan dengan benar, maka selanjutnya kita dapat men-deploy web part yang kita buat pada halaman web ASP.NET.

Note: kesalahan mengubah web.config dapat mengakibatkan keseluruhan aplikasi tidak berjalan, jadi selalu siapkan back-up web.config & selalu hati – hati dalam mengubah web.config.

Berikut ini contoh elemen yang harus ditambahkan dalam web.config untuk men-deploy suatu web part:

<SafeControls>

<SafeControl Assembly=”KebijakanProgramDanKegiatanDepkeu, Version=1.0.0.0, Culture=neutral, PublicKeyToken=f1a7843868cd0ddf” Namespace=”KebijakanProgramDanKegiatanDepkeu” TypeName=”*” Safe=”True” AllowRemoteDesigner=”True” />

</SafeControls>

 

Jadi intinya perlu dilakukan penambahan tag <SafeControls /> yang berisikan beberapa informasi mengenai assembly yang akan di-deploy sebagai web part.

Pada bagian selanjutnya -Insya Allah- akan dilakukan pembahasan mengenai bagaimana mem-populate suatu web part pada halaman ASP.NET. Sampai jumpa lagi.

 

 

 

 

 

Pengenalan Web Part

Ini adalah pengalaman yang saya peroleh baru – baru ini, berkaitan dengan dengan penempatan saya di proyek departemen keuangan. Sebelumnya saya ucapkan terima kasih kepada temen – temen se-tim atas bantuannya selama ini (mas Aan, mas Reno, Anthony-kalau ada yg keliru tolong koreksi ya.-).

Web part merupakan suatu library (file dengan ekstensi *.dll), yang dapat dipasang/ ditempatkan pada halaman web ASP.NET. Jadi suatu webpart akan menempati wilayah atau bagian tertentu dari halaman web ASP.NET. Konsekuensi dari hal ini adalah penggunaan web part dapat meningkatkan reusability, misalnya web part A dapat dipasang pada halaman web_A dan halaman web_B dan juga halaman web_A dapat terdiri lebih dari satu web part misalnya halaman web_A terdiri dari web part A dan web part B.

Dalam .NET, untuk bisa menjadi suatu web part maka suatu kelas harus mewarisi dari kelas yang bernama WebPart(kelas ini terdapat dalam namespace System.Web.UI.WebControls.WebParts). Listing sederhananya dapat kita lihat dalam cuplikan kode berikut ini:

public class FirstWebPart : System.Web.UI.WebControls.WebParts.WebPart

Sedangkan berikut ini syntaks yang diperlukan untuk membuat suatu program ‘hello world’ dari suatu web part:

using System;
using System.Web;
using System.Web.UI.WebControls.WebParts;

namespace TestWebPart
{
    public class FirstWebPart : System.Web.UI.WebControls.WebParts.WebPart
    {

    // mengganti implementasi method Render dari kelas WebPart
       protected override void Render(HtmlTextWriter writer)
       {
           writer.Write("Hello, World...!!!");
       }
    }
}

Tapi yang harus diperhatikan karena kelas ini dimaksudkan sebagai library maka dia tidak dapat dijalankan secara langsung, harus ada suatu halaman web yang menggunakannya dan halaman web tersebut dipanggil lewat browser barulah kita akan melihat hasilnya.
Masih banyak hal yang harus diperhatikan dalam kaitannya dengan penggunaan web part, diantaranya bagaimana menggunakannya melalui halaman web dan juga konfigurasi yang diperlukan. Sampai jumpa lagi

Taqaballahu Minna Wa Minkum, Selamat Hari Raya Idul Fitri

Tidak selamanya perilaku ini benar, terkadang ada tindakan yang salah atau menyakitkan. Melalui blog ini saya meminta maaf yang secara ikhlas kepada semua orang yang pernah berinteraksi dengan saya.

Mohon dimaafkan kalau selama ini ada perilaku yang salah, ucapan yang menyakitkan hati, ataupun prasangka yang keliru kepada anda semua.

Taqaballahu minna wa minkum, semoga Allah Azza Wa Jalla menerima ibadah kita, dan semoga diampuni oleh-Nya segala kesalahan kita. Amin.