How to modify/update task property at sharepoint ?

How to modify task list property at sharepoint directly using code ? Pertanyaan ini pasti akan banyak ditanyakan oleh para pemula yang baru saja “nyemplung” ke dalam sharepoint development khususnya workflow. Seperti yang kita ketahui, bahwa kita dapat saja menambahkan field properties pada task list. Tapi kemudian yang menjadi masalahnya adalah bagaimana cara assign valuenya ke dalam field / property yang baru saja kita tambahkan tersebut saat workflow berjalan.

Ok, sebelum kita masuk kedalam, perlu kita samakan persepsi mengenai 2 hal, yaitu :

  1. WorlflowProperties, yaitu properties yang dimiliki oleh workflow terkait list / dokumen yang membuat workflow tersebut berjalan ( trigger to activate workflow ).
  2. TaskProperties, yaitu properties yang dimiliki oleh workflow, dimana workflow di attach. Perubahan nilai / value pada taskproperties akan memicu workflow berjalan ( onTaskChanged -> dst ).

Ok, sekarang mari kita mulai. Biasanya saat kita develop sebuah workflow, workflow tersebut akan di attach pada sebuah dokumen di sharepoint. Jika sebuah dokumen di create, akan memicu workflow untuk create sebuah “task”. Nah, pada task yang dicreate oleh workflow ini, kita dapat menambahkan informasi sesuai dengan keinginan kita.

So, bagaimana caranya menambahkan informasi pada properties di task ? Ok, cara yang paling konvensional adalah dengan menggunakan extendedproperties.

   1: taskproperties.ExtendedProperties["myfield"]="mynewvalue";

Tapi apakah cara ini dapat berjalan ? Untuk properties yang ada pada taskform, assign properties seperti ini adalah benar. Tapi jika yang kita update adalah field dari task list, maka cara ini tidak akan berjalan. Buktikan deh… 😀

So, bagaimana cara seharusnya ? Hmm…. sebenarnya cara yang dipergunakan adalah sedikit tricky. Jika kita ketikkan taskproperties. , maka akan muncul beberapa properties yang bisa secara langsung di assign, seperti Assignee, Description, dll. Tapi tidak dengan field yang ditambahkan secara langsung pada sharepoint. Ah, kelamaan nih, caranya gimana ?????????. Sabar donk mas…. pelan – pelan….

Ok, karena kita tidak dapat update field pada task list secara langsung, maka kita gunakan trick. Caranya, gunakan properties “Description” sebagai wadah untuk transfer. Caranya, perhatikan kode berikut :

   1: taskProperties.Description = string.Format("{0};{1};{2}",
   2:                 workflowProperties.ListId, workflowProperties.Item.UniqueId,"Test Value");

Kode diatas biasanya terdapat pada prosedur OnTaskCreated, kita gunakan untuk assign value ke properties Description pada task. Kemudian buatlah sebuah handler yang akan kita attach pada list. Perhatikan kode berikut :

   1: using System;
   2: using System.Collections.Generic;
   3: using System.Text;
   4: using System.Web;
   5: using Microsoft.SharePoint;
   6:  
   7: namespace Workflow.TaskHandler
   8: {
   9:     public class TaskEventHandler : SPItemEventReceiver
  10:     {
  11:         public override void ItemAdded(SPItemEventProperties properties)
  12:         {
  13:             base.ItemAdded(properties);
  14:  
  15:             if (properties.ListItem["Description"] != null &&
  16:                 !string.IsNullOrEmpty(properties.ListItem["Description"].ToString()))
  17:             {
  18:                 string[] descriptionItem = properties.ListItem["Description"].ToString().Split(new char[] {';'});
  19:                 if (descriptionItem.Length > 2)
  20:                 {
  21:                     using (SPWeb web = properties.OpenWeb())
  22:                     {
  23:                         bool webAllowUnsafeUpdates = web.AllowUnsafeUpdates;
  24:                         web.AllowUnsafeUpdates = true;
  25:  
  26:                         if (!descriptionItem[2].Equals(string.Empty))
  27:                         {
  28:                             properties.ListItem["Custom Field"] = descriptionItem[2];
  29:                             properties.ListItem.SystemUpdate();
  30:                         }
  31:                         web.AllowUnsafeUpdates = webAllowUnsafeUpdates;
  32:                     }
  33:                 }
  34:             }
  35:         }
  36:     }
  37: }

Kode diatas adalah sebuah handler yang kita modifikasi dari handler asli dari sharepoint. Kegunaannya adalah untuk mengambil value dari field “Description”, dan assign ke field “Custom Field” yang sudah kita buat pada task. Apakah sudah selesai ? Hm… pada dasarnya sudah. Hanya butuh beberapa langkah kecil, yaitu assign handler yang sudah kita buat ke task, agar pada saat task di create/ add di list, handler ini secara otomatis akan berjalan. Tapi benarkah sudah selesai ??.

Tunggu dulu. hehehe. Ada hal yang harus dipahami, yaitu apabila kita mengupdate properties dari sebuah task di task list yang didalamnya attach sebuah workflow, secara otomatis workflow akan execute OnTaskChanged. Hal ini tidak bisa dibiarkan, karena pada dasarnya kita hanya ingin update properties dari task, tanpa ingin workflow jalan ( kecuali memang diinginkan demikian. Tapi dalam kasus yang saya hadapi, tidak ). So, bagaimana solusinya ??  Ternyata cukup mudah. SPItemEventReceiver ternyata memiliki 2 fungsi yang bisa dipergunakan secara langsung, yaitu : DisabledEventFiring() dan EnableEventFiring(). So, setelah kita tambahkan, kode diatas seharusnya berubah menjadi berikut ini :

   1: base.DisableEventFiring();
   2: properties.ListItem["Default Approver"] = string.Empty;
   3: properties.ListItem.SystemUpdate();
   4: base.EnableEventFiring();

Dengan tambahan 2 baris perintah diatas, dijamin, perubahan pada task properties, selama masih dalam scope yang diinginkan oleh code kita, tidak akan membuat workflow berjalan.

Semoga berguna.

Advertisements

All About Infopath Form Development

Hm, development form menggunakan infopath memang gampang-gampang susah. Gampang, karena semuanya tinggal drag and drop, tanpa perlu coding ( jika perlu ). Susah, karena beberapa dokumentasi, baik yang terkait dengan data binding maupun yang lainnya cukup susah untuk di temukan referensinya.

Mengingat hal tersebut, maka saya tuliskan beberapa pengalaman yang pernah didapatkan saat development aplikasi ( workflow ) di sharepoint yang menggunakan infopath form sebagai UInya.

  1. Binding kedatabase, terutama untuk value decimal, selalu gunakan nilai decimal pada initialisasi awalnya. Percaya atau tidak, hal ini sudah saya buktikan. Jika pada awal koneksi ke database kita set nilainya adalah nilai bulat ( bukan decimal ) maka nanti pada saat bind ke data decimal, nilai yang akan disimpan pada file xmlnya adalah nilai bulat ( pembulatan dari nilai decimal yang di assign ke field ) dan bukan nilai asli seperti yang kita inginkan.
  2. Jika sebuah field pada infopath form di bind pada sebuah field didatabase, selalu gunakan nama field atau alias dari field, yang value-nya langsung diambil dari field pada table. Kasus ini sempat membuat saya bingung, kenapa field yang saya query dari database error waktu di execute di infopath. Usut punya usut, ternyata saat initialisasi awal, nilai yang saya assign adalah nilai absolut ( select "test" as myfield from tbl1 ). So, saat query kita modify menjadi ( select myfield from tbl1 ) akan raise error yang sangat tidak informatif alias susah untuk diketahui sebabnya pada infopath.

Demikian dulu yang bisa saya sampaikan. Semoga berguna buat rekan-rekan yang sedang dalam development menggunakan infopath form. Happy programming.

Sharepoint Series : How to Create Data Connection Library

Artikel kali ini akan menjelaskan langkah – langkah membuat data connection library di sharepoint server. Diharapkan, setelah membaca artikel ini, dapat mempermudah dalam proses development form InfoPath, terutama yang banyak menggunakan koneksi kedatabase. Ok, mari kita mulai… 😀

Step 1 :

Buatlah sebuah Library dari menu Site Action –> Create –> Data Connection Library. Isikan semua property yang dibutuhkan. [ Name and Description, Navigation -> pilih No, Version History -> Pilih No ]

Step 2 :

Buatlah sebuah Data Connection Definition dengan format XML, bisa menggunakan sample berikut :

   1: <?xml version="1.0" encoding="UTF-8"?>
   2: <?MicrosoftWindowsSharePointServices ContentTypeID="0x010100B4CBD48E029A4ad8B62CB0E41868F2B0"?>
   3: <udc:DataSource MajorVersion="2" MinorVersion="0" xmlns:udc="http://schemas.microsoft.com/office/infopath/2006/udc">
   4:     <udc:Name>MyDataDefinition</udc:Name>
   5:     <udc:Description>Format: UDC V2; Connection Type: Database; Purpose: ReadOnly;</udc:Description>
   6:     <udc:Type MajorVersion="2" MinorVersion="0" Type="Database">
   7:         <udc:SubType MajorVersion="0" MinorVersion="0" Type=""/>
   8:     </udc:Type>
   9:     <udc:ConnectionInfo Purpose="ReadOnly" AltDataSource="">
  10:         <udc:WsdlUrl/>
  11:         <udc:SelectCommand>
  12:             <udc:ListId/>
  13:             <udc:WebUrl/>
  14:             <udc:ConnectionString>
  15:                 Provider=SQLOLEDB.1;
  16:                 Initial Catalog=MyTestDB;Data Source=myserver;
  17:                 User ID=myuser;Password=mypassword;Persist Security Info=True;Use Procedure for Prepare=1;Auto Translate=True;
  18:                 Packet Size=4096;Workstation ID=mypc;Use Encryption for Data=False;Tag with column collation when possible=False</udc:ConnectionString>
  19:             <udc:ServiceUrl UseFormsServiceProxy="false"/>
  20:             <udc:SoapAction/>
  21:             <udc:Query>
  22:                 select * from mytable where id=null
  23:             </udc:Query>
  24:         </udc:SelectCommand>
  25:         <udc:UpdateCommand>
  26:             <udc:ServiceUrl UseFormsServiceProxy="false"/>
  27:             <udc:SoapAction/>
  28:             <udc:Submit/>
  29:             <udc:FileName>Specify a filename or formula</udc:FileName>
  30:             <udc:FolderName AllowOverwrite=""/>
  31:         </udc:UpdateCommand>
  32:         <!--udc:Authentication><udc:SSO AppId='' CredentialType='' /></udc:Authentication-->
  33:     </udc:ConnectionInfo>
  34: </udc:DataSource>

Save menjadi file dengan extention udcx. Bagian mana saja yang harus anda modifikasi ?

  • <udc:Name></udc:Name>, ini untuk mendefinisikan nama Connection Library kita. Buatlah berbeda dgn yang lainnya
  • <udc:ConnectionString></udc:ConnectionString>, ini bagian dimana kita mendeklarasikan kemana koneksi akan di lakukan. pastikan semua informasi yang dimasukkan benar ( username, password ) agar bisa konek dengan database yang diinginkan. Bagi yang biasa main-main dengan Connection String di .NET, bentuk ini adalah bentuk yang biasa.
  • <udc:Query></udc:Query>, pada bagian ini, dispesifikasikan data yang ingin di ambil. Ini adalah bentuk SQL statement biasa, yang lazim digunakan. Bagaimana jika kita ingin dinamik ? hehehe,, tunggu saja bagian berikutnya.

Step 3:

Langkah selanjutnya adalah upload file udcx yg telah kita buat tadi, ke library yang kita buat pada langkah 1.  Yang harus diperhatikan adalah, file yang kita upload tidak bisa langsung digunakan, karena statusnya masih pending. So, you must approved it first. Letakkan mouse pointer pada nama file yang baru saja di upload, klik edit -> pilih approve/reject. Akan muncul form approval, pilih approve, kemudian pilih ok. Done. Connection Library kita sudah siap untuk digunakan. Congratulation……

Ok, itu saja dulu. Pada bagian selanjutnya, akan dibahas bagaimana menggunakannya pada InfoPath Form. Selamat Belajar

Bagaimana Loop pada repeating table di Infopath 2007 ?

Masalah ini biasanya ditemui oleh para rekan-rekan yang berkecimpung dalam dunia sharepoint, terutama yang menggunakan Infopath sebagai form inputannya.
Berikut adalah cara untuk looping item pada repeating table di infopath :
Misalkan kita punya sebuah struktur repeating table seperti berikut ini :

maka yang harus dilakukan untuk looping ( untuk ambil semua value fieldnya ) cukup dengan code berikut ini :

   1: XPathNavigator domNav = MainDataSource.CreateNavigator();
   2: XPathNodeIterator rows = domNav.Select("/my:myFields/my:table/my:row", NamespaceManager);
   3:
   4: while (rows.MoveNext())
   5: {
   6:     string field1 = rows.Current.SelectSingleNode("my:field1", NamespaceManager).Value;
   7:     string field2 = rows.Current.SelectSingleNode("my:field2", NamespaceManager).Value;
   8:     string field3 = rows.Current.SelectSingleNode("my:field3", NamespaceManager).Value;
   9: }

semoga berguna….

This task is currently locked by a running workflow and cannot be edited. Apa ini ?

Sudah 2 hari ini utak – atik workflow disharepoint. Kepingin buat sebuah workflow yang simple tapi configurable. setelah pikir sana pikir sini, akhirnya dibuat sebuah workflow seperti ini :

SPSeqWorkflowUpdate

Simple, cuma ada satu task. Workflow ini awalnya begini :

  • Load konfigurasi dari Infoparh form saat workflow aktif, simpan di memori
  • Create task berdasarkan konfigurasi yang ada.
  • saat user approve, ganti property AssignedTo pada workflow task, agar task pindah ke user yang lain
  • Jika sudah tidak ada user yg harus approve, workflow selesai / finish.

Tapi apa nyana… ternyata setelah dicoba, muncul error saat update property di task :

This task is currently locked by a running workflow and cannot be edited.

Upps.. apa yang harus dilakukan ? cari-cari solusi dengan om G, masih belum ada jalan keluar. Ada beberapa referensi yang bilang harus update Service Pack, sudah dilakukan tapi masih belum solve. Huh… nampaknya masih harus explore lebih jauh lagi nih..

Tunggu saja kabarnya, gimana cara solvenya… atau kalau ada masukan, please comment here…

Checklist for Creating SharePoint Web Parts

Development webpart di sharepoint merupakan suatu tantangan tersendiri. Hal utama dikarenakan yaitu  tidak ada UI ( WYSIWYG ) yang dapat dilihat. Semua dalam bentuk code. Selain itu, kompatibilitas dengan browser dan beberapa aspek lain sebenarnya harus menjadi perhatian lebih bagi developer.

Microsoft baru-baru ini merilis checklist, hal-hal yang harus dipaerhatikan dalam proses development webpart disharepoint.

hal-hal yang harus diperhatikan dalam ceklist ini adalah :

  1. Verifying Web Part Rendering
  2. Verify that Web Part Renders Appropriately Based On User permissions.
  3. Verify that Static Web Part Renders Appropriately and Does Not Cause Web Part Page to Fail.
  4. Verify that Web Part Appears Appropriately in Search Results.
  5. Verify that Web Part Previews Properly.
  6. Verifying Web Part Functionality
  7. Verify that Web Part Can Be Added to Web Part Zone.
  8. Verify that Web Part Works Correctly Regardless of Web Part Page Location.
  9. Verify that Web Part Caching Works Correctly.
  10. Verify that Changes Made in Personal View Are Not Reflected in Shared View.
  11. Verify that Web Part Can Handle Asynchronous Calls to Other HTTP Sites and Web Services.
  12. Verify that Web Part Works Correctly With Different Combinations of Zone Settings.
  13. Verify that Web Part Can Access Resources in Different Setup Configurations.
  14. Verify that Web Part Can Be Imported and Exported Correctly.
  15. Verifying Web Part Properties
  16. Verify that Web Part Property Attributes Are Correctly Defined.
  17. Verify that Web Part Properties Displayed in Tool Pane Are User-Friendly.
  18. Verify that Web Part Properties Are Not Dependent On Each Other.
  19. Verifying Web Part Error Handling
  20. Verify that Every Public Property Can Handle Incorrect User Input.
  21. Verify that Adding Several Instances of the Same Web Part to a web Part Page (or to the Same Web Part Zone) Works Correctly.
  22. Verify that Web Part Handles All of its Exceptions.

Penjelasan lebih lengkapnya dapat dilihat disini

Semoga berguna.

Silverlight and Sharepoint Integration

Bagi yang gemar bermain sharepoint dan ingin mengintegrasikannya dengan silverlight, tunggu saja. Microsoft sudah announce blueprint untuk hal ini.

berikut petikannya diambil dari sini:

Silverlight Blueprint for SharePoint

The Silverlight Blueprint for SharePoint is source code and guidance for developers describing how to use Microsoft Silverlight and Microsoft SharePoint Products and TePoint Products and Technologies using the modern graphics capability in Silverlight.

Cek saja di : <a title=”httperface elements. This capability enables a fresh look at data exposed through SharePoint Products and Technologies using the modern graphics capability in Silverlight.

Cek saja di : http://www.ssblueprints.net/sharepoint/

So, tidak lama lagi, sharepoint akan semakin funky tampilannya dengan silverlight. Tunggu saja……!!!!