menggunakan client side object model (csom) pada ...· step by step menjadi programmer handal dengan

Download Menggunakan Client Side Object Model (CSOM) pada ...· Step By Step Menjadi Programmer Handal Dengan

Post on 24-Mar-2019

215 views

Category:

Documents

0 download

Embed Size (px)

TRANSCRIPT

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Junindar, ST, MCPD, MOS, MCT, MVP .NET junindar@gmail.com

http://junindar.blogspot.com

Abstrak

Menurut wikipedia, SharePoint adalah sebuah platform sistem manajemen dokumen

berbasis web yang diciptakan oleh Microsoft Corporation. SharePoint dapat digunakan

untuk menjalankan situs-situs web yang terdiri atas ruangan kerja (shared workspace) dan

dokumen yang digunakan secara bersama-sama (shared documents), selain tentunya

aplikasi khusus seperti wiki dan blog. Fitur-fitur SharePoint ini bisa diakses oleh sebuah

penjelajah web (meski yang disarankan adalah keluarga Microsoft Internet Explorer).

Terdapat beberapa cara untuk melakukan pengaksesan SharePoint melalui client atau

diluar dari environment SharePoint itu sendiri salah satu nya dengan menggunakan client

side object model atau yang biasa disebut CSOM.

Lisensi Dokumen: Copyright 2003 IlmuKomputer.Com

Seluruh dokumen di IlmuKomputer.Com dapat digunakan, dimodifikasi dan

disebarkan secara bebas untuk tujuan bukan komersial (nonprofit), dengan syarat

tidak menghapus atau merubah atribut penulis dan pernyataan copyright yang

disertakan dalam setiap dokumen. Tidak diperbolehkan melakukan penulisan ulang,

kecuali mendapatkan ijin terlebih dahulu dari IlmuKomputer.Com.

Menggunakan Client Side Object Model (CSOM) pada Sharepoint 2013

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Pendahuluan

Pada artikel terdahulu (http://junindar.blogspot.com/2013/03/crud-pada-sharepoint-list-

menggunakan.html) penulis menjelaskan bagaimana melakukan proses Create, Read,

Update dan Delete (CRUD) pada Sharepoint List dengan menggunakan VB 10. Pada

artikel tersebut penulis menggunakan Web Services yang telah disediakan oleh SharePoint

itu sendiri. Sebenarnya terdapat beberapa cara untuk melakukan hal tersebut, bisa

menggunakan CSOM, JSOM dan REST API (https://msdn.microsoft.com/en-

us/library/office/dn268594.aspx).

Pada artikel ini penulis akan menjelaskan bagaimana menggunakan CSOM untuk membuat

list maupun memanipulasi data yang ada pada SharePoint list. CSOM digunakan untuk

aplikasi yang berjalan di luar dari SharePoint server, seperti windows aplikasi, mobile dan

sebagainya. Sebelum menggunakan CSOM terlebih dahulu kita memerlukan SharePoint

Server 2013 Client Components SDK dimana terdapat beberapa library yang akan

digunakan dalam penulisan kode program (http://www.microsoft.com/en-

my/download/details.aspx?id=35585).

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Isi

Untuk memudahkan memahami isi dari artikel ini, kita akan membuat sebuah project

latihan, dimana kita akan menggunakan CSOM dengan Visual Basic untuk membuat

SharePoint list maupun memanipulasi data-data pada SharePoint list. Ikuti langkah-

langkah dibawah ini.

1. Buat sebuah project dengan nama LatihanCSOM.

2. Ganti properties pada Form1 menjadi seperti berikut.

Name = frmUtama

Text = Menu Utama

StartPosition = CenterScreen

3. Tambahkan Menustrip pada form, lalu tambahkan beberapa menu item seperti berikut.

File > Exit

Tools > Create List

List Item

4. Tambah sebuah form dengan nama frmCreateList.

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

5. Tambahkan beberapa control pada frmCreateList, ganti text form menjadi Create List

- 2 buah Text Box dengan masing-masing properties name sebagai berikut.

txtName dan txtDescription

- 2 buah label dengan masing-masing text List Name dan Description

- 1 buah DataGridView dengan nama DgvList

- 1 buah button dengan nama btnCreate dan text nya Create.

Susun control-control tersebut seperti gambar dibawah.

Selanjutnya adalah menambahkan reference SharePoint.Client dan

SharePoint.Client.Runtime pada project.

Note : Dua dll diatas terdapat pada C:\Program Files\Common Files\Microsoft

Shared\Web Server Extensions\15\ISAPI\

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Sebelum kita lanjutkan menulis kode pada frmCreateList, kita akan membuat sebuah

Module yang digunakan sebagai koneksi terhadap SharePoint 2013.

- Tambahkan sebuah Module pada project, dengan nama module MySPContext

- Import dua namespace seperti berikut.

- Buat sebuah Public Function dengan nama myContext dan ketikkan sintaks seperti

dibawah.

Imports System.Net

Imports Microsoft.SharePoint.Client

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Method ini berfungsi untuk melakukan koneksi terhadap SharePoint yang kita

inginkan. Dan akan digunakan pada form-form lain yang akan dijelaskan dibawah.

Note : Untuk SharePoint yang menggunakan Form Base dapat menggunakan

sintaks dibawah ini

Setelah selesai membuat module, selajutnya kita akan kembali pada frmCreateList.

Buka jendela code pada frmCreateList.

- Import namespace SharePoint.Client

- Selanjutnya adalah membuat sebuah method untuk menambahkan kolom pada

DataGridView

Imports Microsoft.SharePoint.Client

Public Function myContext() As ClientContext Dim context As New ClientContext("SharePointUrl")

Dim credential As NetworkCredential = _ New NetworkCredential("Domain\Username", "Password")

context.Credentials = credential

End Function

context.AuthenticationMode = _ ClientAuthenticationMode.FormsAuthentication

context.FormsAuthenticationLoginInfo = _

New FormsAuthenticationLoginInfo("username", "password")

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Kode diatas selain untuk menambahkan kolom pada DataGridView (DgvList)

digunakan juga untuk mengatur Style pada DgvList. Terdapat tiga kolom yang akan

kita tambahkan. Ketiga kolom tersebut menggunakan control yang berbeda seperti

TextBox, ComboBox dan CheckBox Untuk ColomnType kita gunakan ComboBox

control untuk menampilkan data. Dan terdapat 3 (tiga) pilihan dalam ComboBox

tersebut yaitu Text, Number dan Note. Pilihan ini yang nantinya digunakan sebagi tipe

data kolom pada list yang akan kita buat.

Note : Pada SharePoint 2013 terdapat banyak tipe data yang dapat digunakan.

Sebagai latihan kita hanya akan menggunakan 3 (tiga) tipe data saja.

- Buat sebuah method untuk membuat kolom pada SharePoint seperti dibawah.

Private Sub FormatGridWithBothTableAndColumnStyles()

DgvList.DefaultCellStyle.ForeColor = Color.Navy DgvList.RowsDefaultCellStyle.BackColor = Color.AliceBlue

DgvList.GridColor = Color.Blue

DgvList.BorderStyle = BorderStyle.Fixed3D DgvList.RowHeadersBorderStyle = DirectCast(BorderStyle.Fixed3D,

DataGridViewHeaderBorderStyle)

DgvList.AutoGenerateColumns = False

Dim ColumnName As New DataGridViewTextBoxColumn()

ColumnName.DataPropertyName = "FieldName"

ColumnName.HeaderText = "Field Name" ColumnName.Width = 100

Dim ColumnType As New DataGridViewComboBoxColumn() ColumnType.DataPropertyName = "FieldType"

ColumnType.HeaderText = "Field Type"

ColumnType.Width = 100

ColumnType.Items.AddRange("Text", "Number", "Note")

Dim ColumnView As New DataGridViewCheckBoxColumn() ColumnView.DataPropertyName = "DefaultView"

ColumnView.HeaderText = "Default View"

ColumnView.Width = 100

DgvList.Columns.Add(ColumnName)

DgvList.Columns.Add(ColumnType) DgvList.Columns.Add(ColumnView)

End Sub

Step By Step Menjadi Programmer Handal Dengan VB.Net

Junindar, ST, MCPD, MOS, MCT, MVP VB.NET

Method diatas berfungis untuk membuat kolom pada SharePoint. Kolom dibuat

berdasarkan item yang dimasukkan pada DgvList. Perhatikan sintak diatas terdapat

pengulangan (For Each As DataGridViewRow), dimana pada pengulangan tersebut

kita letakkan kondisi, yang mana dicari hanya baris dengan cell pertama tidak sama

dengan kosong. Dalam hal ini adalah kolom FieldName. Sedangkan bStatus

digunakan untuk kolom DefaultView. Kolom ini berfungsi untuk menjadi indikasi,

apakah kolom tersebut akan ditampilkan pada SharePoint view atau tidak. Yang

terakhir adalah memasukkan informasi-informasi diatas kedalam function

list.Fields.AddFieldsAsXml

- Double click form dan ketikkan sintaks berikut :

Sebagai default pada saat form Create List ini dibuka, maka pada DgvList akan terdapat

3 (tiga) kolom yang telah kita buat pada method

FormatGridWithBothTableAndColumnStyles yaitu kolom FieldName, FieldType

dan DefaultView.

- Double click pada button Create dan ketikkan sintaks dibawah

Private Sub CreateField(list As List)

For Each row As DataGridViewR