Agunahwan's Blog

Automation Jira saat semua Task Done, Story atau Bugs yang berelasi Menjadi Done

Di malam Jum’at yang sunyi ini, waktunya kita berbagi ilmu kembali. Hmmm… Ternyata sudah lama & jarang pula saya menulis. Nasib kerja di Startup.

Sebelum masuk ke pembahasan, saya ingin menjelaskan dahulu mengapa kali ini kita membahas automation yang ada di jira. Yuph, kalian tidak salah, jira yang dimaksud adalah Jira dari Attlasian yang digunakan sebagai tools management project. Di dalamnya banyak sekali fitur yang bisa kita gunakan untuk mempermudah kita dalam tentunya me-manage sebuah project.

Jadi, di sebuah project, saat seluruh tim sudah beraktifitas dengan pekerjaannya masing-masing, terkadang sering sekali saat report pada daily standup, Story yang seharusnya sudah dalam posisi siap testing, masih belum tergeser alias lupa untuk diubah statusnya. Nah, dalam flow kerja yang ada di kantor saya, ini agak berbeda dan mungkin tidak sesuai dengan best practise-nya. Sebelum kita bahas dalam proses alur kerjanya, adapun kerangka card (dalam Jira, teman-teman akan memahaminya sebagai Issue) yang digunakan di jira kantor kira-kira berikut :

Jadi, yg digunakan di kantor saya seperti berikut :

Epic : fitur dari sebuah aplikasi
Story : card untuk requirement terkait fitur baru atau enhancement terhadap project. Story ini akan memiliki sebuah Epic sebagai parent-nya.
Bug : card untuk bug/hotfix sebuah aplikasi. Biasanya bug tidak saya kaitkan dengan sebuah Epic, namun tidak menutup kemungkinan memiliki Epic sebagai parent-nya.
Task : card untuk detail pekerjaan masing-masing tim, baik itu developer, maupun QA. Task akan berelasi terhadap sebuah Story atau sebuah Bug.
Issue : card yang dibuat oleh QA saat menemukan bug ketika testing. Issue ini akan berelasi dengan sebuah Story
Sub Task : untuk sub task ini, di project yang saya manage tidak digunakan. Hal ini dikarenakan kebijakan management dalam pengelolaan project di kantor.

Card-card yg saya sebutkan di ataslah yang saya gunakan dalam management project kantor. Nah, dari card-card tersebut, kita memiliki flow proses masing-masing. Saya tidak akan menyebutkan satu persatu flow proses yang saya gunakan dalam setiap card, namun saya akan berfokus bagaimana sebuat card Task akan berubah. Saat seorang developer memulai pekerjaannya, ia akan segera mengubah status card Task miliknya dari To Do menjadi In Progress. Dan bila card Task itu selesai, maka ia akan mengubah statusnya dari In Progress menjadi Done. Nah, di penjelasan kali ini, saya akan memfokuskan bagaimana kita membuat sebuah automation jira yang secara otomatis akan mengubah status card Story yang berelasi dengan card Task, dimana saat semua card Task yang berelasi dengannya sudah ber-status Done, maka Story itu pun akan otomatis berubah status menjadi Done.

Adapun ide flownya yang akan saya buat adalah sebagai berikut :

Buat sebuah trigger yang akan dijalankan bila “Adanya perubahan status Task dari In Progress menjadi Done“
Cari Story yang berelasi dengan Task tersebut
Cari semua Task yang ada dalam Story tersebut
Simpan total semua Task yang ada dalam Story tersebut dalam sebuah variabel (kita namakan : totalAllTasks)
Cari semua Task yang berstatus Done yang ada dalam Story tersebut
Simpan total semua Task yang berstatus Done yang ada dalam Story tersebut dalam sebuah variabel (kita namakan : totalAllDoneTasks)
Kita cek apakah variabel totalAllTasks = totalAllDoneTasks. Jika sama, maka akan lanjut ke proses. Jika berbeda, maka automation akan berhenti
Terapkan pada semua Story yang berelasi pada Task yang menjadi trigger-nya
Ubah status Story tersebut menjadi Done

Oke, setelah kita mendapatkan rancangan proses/algoritma dari automation yang akan kita buat, maka langkah selanjutnya kita coba implement proses tersebut dalam jira. Sebelumnya, saya sudah menyiapkan sebuah project untuk penerapannya. Adapun langkah-langkah yang bisa kita buat sebagai berikut :

Pada Project Settings, klik Automation. Kemudian klik Create rule

Pada Rule Detail, kita bisa menamakan rule tersebut sesuai dengan apa yang dikerjakan oleh Automation yang akan kita buat. Dalam hal ini, kita akan menamakannya “When all tasks are completed → then change story to completed“. Description bisa dikosongkan, namun direkomendasikan untuk dijelaskan perihal apa yang akan dikerjakan oleh Rule yang akan kita buat.

Pada bagian Trigger, kita pilih Issue transitioned. Isi field From Status dengan In Progress dan field To Status dengan Done. Kemudian kita klik Save.

Karena kita hanya menyeleksi bahwa trigger ini hanya boleh dijalankan oleh Task, maka kita tambahkan Condition dengan tipe Issue fields condition. Isi Field dengan Issue Type, Condition dengan Equals, dan Value dengan Task. Kemudian klik Save.

Karena syarat trigger sudah kita buat, selanjutnya kita pilih Action dengan tipe Lookup issues. Isi field JQL dengan query berikut :

issue in linkedIssues({{issue}}) AND issuetype = story

Dimana maksud query tersebut adalah : “kita mencari issue yang berelasi dengan issue yang menjadi trigger dan tipe issue tersebut adalah Story“. Kemudian klik Save.

Tambahkan sebuah Action dengan tipe Create variable. Isi Variable name dengan relatedStory dan Smart value dengan {{lookupIssues}}. Dalam hal ini, kita akan menyimpan story yang sudah didapatkan pada proses Lookup sebelumnya ke variable relatedStory. Kemudian klik Save.

Tambahkan Action dengan tipe Lookup issues. Isi field JQL dengan query berikut :

issue in linkedIssues({{relatedStory}}) AND issuetype = task

Dimana maksud query tersebut adalah : “kita mencari issue yang berelasi dengan story di variable relatedStory dan tipe issue tersebut adalah Task“. Kemudian klik Save.

Tambahkan sebuah Action dengan tipe Create variable. Isi Variable name dengan totalAllTasks dan Smart value dengan {{lookupIssues.size}}. Dalam hal ini, kita akan menyimpan total seluruh task yang sudah didapatkan pada proses Lookup sebelumnya ke variable totalAllTasks. Kemudian klik Save.

Tambahkan Action dengan tipe Lookup issues. Isi field JQL dengan query berikut :

issue in linkedIssues({{relatedStory}}) AND issuetype = task and status = done

Dimana maksud query tersebut adalah : “kita mencari issue yang berelasi dengan story di variable relatedStory dan tipe issue tersebut adalah Task dan ber-status Done“. Kemudian klik Save.

Tambahkan sebuah Action dengan tipe Create variable. Isi Variable name dengan totalAllDoneTasks dan Smart value dengan {{lookupIssues.size}}. Dalam hal ini, kita akan menyimpan total seluruh task yang sudah didapatkan pada proses Lookup sebelumnya ke variable totalAllDoneTasks. Kemudian klik Save.

Tambahkan sebuah Condition dengan tipe Advanced compare condition. Isi First value dengan {{totalAllTasks}}, Condition dengan equals, dan Second value dengan {{totalAllDoneTasks}}. Dalam hal ini, kita akan membandingkan apakah variable totalAllTasks bernilai sama dengan variable totalAllDoneTasks. Kemudian klik Save.

Tambahkan sebuah For Each dengan tipe Branch rule / related issues. Isi Type of related issues dengan Linked issues dan Link types dengan relates to. Dalam hal ini, kita akan mencari semua Issue yang berelasi dengan Task yang menjadi Trigger. Step ini akan dikerjakan bila value pada Condition sebelumnya sudah memenuhi syarat, dalam artian bernilai true dalam perbandingannya. Kemudian klik Save.

Untuk memastikan kita hanya akan mengubah status Story, maka kita tambahkan Condition dengan tipe Issue fields condition. Isi Field dengan Issue Type, Condition dengan Equals, dan Value dengan Story. Kemudian klik Save.

Kita tambahkan step terakhir, yuph perubahan story tersebut ke status Done dengan menambahkan Action dengan tipe Transition issue. Isi Destination status dengan Done. Kemudian klik Save.

Kemudian kita hidupkan Automation tersebut dengan klik Turn it on.

Oke, kali ini kita selesai membuat automation dengan rule yang sudah kita buat. Selanjutnya bila teman-teman kembali ke list Rule Automation, maka teman-teman akan melihat rule yang barusan dibuat sudah aktif.

Selanjutnya, kita akan mencoba apakah rule tersebut berjalan dengan sukses. Kita buat sebuah card Story dengan 2 buah card Task yang berelasi dengan card Story tersebut. Kira-kira kita buat seperti berikut :

Kemudian kita coba ubah TJ-39, TJ-40, TJ-41 menjadi In Progress. Kira-kira seperti berikut :

Kemudian kita coba ubah status TJ-40 dan TJ-41 menjadi Done, maka apa yang akan terjadi? Yuph, TJ-39 akan secara otomatis berubah menjadi Done. Pada notifikasi pun, teman-teman akan melihat bahwa Automation berjalan.

Mungkin itulah sedikit informasi yang mudah-mudahan bermanfaat untuk teman-teman, khususnya yang saat ini berkecimpung di Jira dalam me-manage project-nya.

Mungkin cukup sekian dari saya, selamat malam dan terima kasih.

Category: Development | LEAVE A COMMENT

Maret 8

Menjalankan php di luar htdocs

Malam yang tepat untuk berbagi, dan kali ini, kita akan coba membahas hal kecil yang mungkin sangat bermanfaat dalam pekerjaan.

Sebelum kita masuk ke cerita, mungkin sebagai perkenalan, di kantor yang sekarang, posisi saya merupakan Squad Supervisor, dimana tugas saya lebih ke arah solving problem teknikal & manajemen project, dan tidak turun dalam development, dalam artian ikut dalam ngoding.

Nah, ceritanya, di kantor kita sedang mengejar target development fitur untuk kuartal pertama. Dengan jumlah developer yang terbatas, sementara project yang menantang (menantang maut mungkin, hehe… Just kidding) baik dalam jumlah maupun pengerjaannya, kita dituntut untuk mengerjakan development tersebut secepat mungkin. Dengan perumpamaan yang selalu saya ucapkan terhadap tim, dimana proses development itu seperti sebuah balon. Yuph, seperti balon, bila suatu titik kita tekan, maka akan membesar di titik lawannya. Seperti halnya development, bila kita menekan waktu development (dalam artian mempercepat proses development), maka berimbas dengan jumlah developer yang membengkak. Namun bila kita menekan pula jumlah developernya, maka akan membengkak pula bugs yang akan dihasilkan. Yuph, dikarenakan kita tidak mau mengurangi waktu maupun kualitas, tentu titik lawannya, yakni jumlah developer yang mesti membengkak. Singkat cerita, tentu tidak dapat menembah developer dalam waktu singkat, sehingga strategi lain yang dilakukan adalah dengan mengalihkan developer di project lain ke dalam project yang sedang kita kerjakan. Dan akhirnya, karena masih kekuranganannya developer kembali (inget menekan titik waktu & kualitas, menyebabkan titik jumlah developer menjadi 2x lipat) menyebabkan saya pun ikut dalam development tersebut.

Di kantor sendiri, project yang sedang kita kerjakan menggunakan bahasa pemrograman php. Yuph, bisa dibilang bahasa sejuta umat. Biasanya, saya selalu merapikan source code dari project dalam sebuah folder, dan tentunya saya simpan di drive data, tentunya tidak di dalam folder server seperti htdocs pada php dan inetpub pada dotnet. Di kantor sendiri umumnya project menggunakan framework yii, dimana untuk menjalankan project tersebut dapat menggunakan perintah berikut walaupun folder project di luat htdocs :

php yii serve

Nah, di satu project ini, kebetulan kita tidak menggunakan framework, alias menggunakan php native. Lalu, bagaimana caranya untuk menjalankan file php tersebut di luar folder htdocs. Yuk kita langsung praktikan. Kita buat sebuah file php, simpan dengan nama index.php. Isi file php berikut dengan code berikut :

<?php
echo "Hello World!";
?>

Untuk saya sendiri, menyimpan di alamat : D:\Data\Data Agun\Blog\Run Php

Buka command prompt dan pindahkan posisi folder ke alamat folder php kita seperti berikut :

Lalu ketik perintah berikut :

php -S localhost:45

Dimana kita dapat mengganti port yang ingin dijalankan, dalam contoh di atas, kita dapat mengganti port tersebut dengan port lainnya sesuai kebutuhan. Bila berhasil, maka saat kita akses browser dengan alamat http://localhost:45, akan tampil seperti berikut :

Dan di Command Prompt akan terlihat seperti berikut :

Mungkin sekian secuil ilmu yang kita bahas di malam sunyi ini. Semoga sekecil apapun ilmu yang dibagikan dapat bermanfaat bagi teman-teman semua di dalam pekerjaan.

Akhir kata, selamat malam dan selamat beristirahat. 😁

Category: Programming, Tentang Komputer | LEAVE A COMMENT

November 9

Publishing dan Konfigurasi Web Deploy pada IIS

Malam yang indah untuk melanjutkan pekerjaan keseharian, apalagi kalau bukan ngoding. 😅

Sudah lama juga tidak menulis, yah dikarenakan pekerjaan yang lumayan padat juga sih. Untuk malam ini, sebenarnya tulisan ini sekedar mengingat bila di lain waktu melakukan hal yang sama. Tidak perlu berlama-lama lagi, langsung aja.

Jadi, ceritanya hari ini hampir seharian setting server untuk kebutuhan publishing website. Kebutuhan ini untuk dipresentasikan pada keesokan harinya. Sebenarnya ini bukan kali pertama setting server untuk keperluan publishing/deployment. Perlu diingat, ini berfokus pada teknologi nya Microsoft, apalagi kalau bukan Windows Server & Dot Net. Adapun langkah-langkahnya akan dibagi dua, dimana kita akan setting dari sisi server terlebih dahulu, baru kemudian setting dari sisi project untuk deploymentnya. Di sini saya akan menggunakan Web Deploy untuk sarana deploymentnya. Berikut langkah-langkahnya :

Install Internet Information Services (IIS) Manager :
- Pada Server Manager, pilih menu Manage > Add Roles and Features.
- Pada langkah Before You Begin langsung klik Next.
- Pada bagian Installation Type, pilih Role-based or feature-based installation,kemudian klik Next.
- Pada bagian Server Selection, pilih Select a server from the server pool, kemudian klik Next.
- Pada bagian Server Roles, pilih Web Server (IIS), lalu klik Next.
- Pada bagian Features, pastikan .NET Framework 3.5 dan .NET Framework 4.6 terpilih dan langsung klik Next.
- Pada bagian Confirmation, kemudian klik Install.
- Tunggu hingga proses instalasi selesai, dan Internet Information Services (IIS) Manager pun telah terinstal pada Server
Setting Web Deploy pada Server :
- Download dan Install Hosting Bundle sesuai dengan versi .Net yang digunakan. Di sini saya menggunakan versi .Net Core 3.1.30
- Restart sistem dengan menggunakan perintah berikut pada Command Line :

net stop was /y
net start w3svc

- Buka Web Platform Installer, search kata kunci Web Deploy. Add Web Deploy (dalam hal ini saya memilih Web Deploy 3.6), kemudian klik Install.
- Tunggu hingga proses Instalasi selesai. Kemudian buka IIS Manager, lalu pilih IIS Manager Permissions.
- Klik Allow User, kemudian pilih user yang akan digunakan untuk mengakses server melalui Web Deploy pada Projects nanti. Kemudian klik OK.
- Konfigurasi pada server hingga tahap ini selesai.
Create Publish Profile pada Project :
- Klik kanan pada Project, kemudian klik Publish.
- Pilih Web Server (IIS), kemudian klik Next.
- Pilih Web Deploy, kemudian klik Next.
- Isi data Server dengan format : {alamat_server}/MSDeployAgentService, Site name diisi dengan nama website yang kita buat pada IIS Server, Destination Url dengan Alamat dari Server, Username dengan User yang kita beri Permission pada IIS Server, Password yang digunakan untuk mengakses Server menggunakan Username yang disetting. Setelah semua selesai, kita dapat mengecek apakah konfigurasi yang kita berikan sesuai dengan klik Validate Connection. Bila sudah sesuai, maka akan tampil centang hijau seperti gambar di bawah. Kemudian klik Finish.
- Untuk deployment, kita cukup melakukan Publish dan Visual Studio akan otomatis melakukan Build dan Deployment langsung ke Server.

Mungkin hanya itu langkah-langkah untuk setting Deployment ke Server menggunakan Web Deploy. Untuk setiap kali akan melakukan Deployment/Publish, teman-teman hanya cukup melakukan Publish menggunakan konfigurasi yang telah kita setting, dan hasil build dari aplikasi pun akan langsung terdeploy ke Server.

Mungkin itu saja tulisan kali ini, semoga bermanfaat untuk teman-teman yang mengalami kesulitan dalam hal Deployment, khususnya pada ekosistem milik Microsoft. Dan Selamat Malam. 😁

Category: Programming, Server | LEAVE A COMMENT

Agustus 18

Mengatasi masalah CredSSP saat melakukan remote desktop

Siang ini saya harus melakukan pengecekan pada server DB untuk melihat CPU sistem yang katanya sedang high banget. Saya coba melakukan remote, kemudian terjadilah error seperti ini : “An authentication error has occured.” Kemudian di bawahnya ada error : “This could be due to CredSSP encryption oracle remediation.”. Kira-kira seperti ini capturenya :

Lalu, bagaimana cara mengatasinya? Sebenernya untuk mengatasinya sendiri, Microsoft sudah menjelaskannya pada halaman dokumentasinya :

https://docs.microsoft.com/id-id/troubleshoot/azure/virtual-machines/credssp-encryption-oracle-remediation

Hal ini kalau dilihat dari penjelasannya diketahui terjadi karena akses terhadap server tersebut menggunakan sambungan yg tidak aman. Bisa jadi karena versi server lokal kita berbeda dengan versi server (server memiliki versi lebih rendah dari versi lokal). Dari dokumen tersebut jg dijelaskan salah satu (karena masih ada cara lain jg, cuma karena menurut saya ini cara paling mudah :D) cara mengatasinya :

Buka command prompt (saya coba dengan “Run As Administrator”)
Ketik perintah berikut “REG ADD HKLM\Software\Microsoft\Windows\CurrentVersion\Policies\System\CredSSP\Parameters\ /v AllowEncryptionOracle /t REG_DWORD /d 2”. Kemudian enter

Setelah melakukan itu, coba teman2 melakukan remote kembali, untuk kasus saya berhasil.

Demikian sedikit info dari saya, semoga teman-teman yang mengalami hal yg sama dapat terpecahkan.

Selamat sore dan selamat bekerja… 😀

Category: Lain-Lain, Tentang Komputer | LEAVE A COMMENT

Juli 7

Query untuk melihat structure table

Setelah melewati 3 hari yang melelahkan, ingin kembali menulis kembali. Yuph, 2 hari akhir pekan merenovasi rumah di bogor, dan sehari ke rumah sakit seharian untuk imunisasi anak. Tak habis bahan untuk saya ulas, kali ini saya ingin membagikan query untuk melihat bagaimana struktur sebuah tabel maupun tabel-tabel dalam database.

Langsung aja ke inti utama yang akan saya sharing. Jadi, ceritanya saya ingin membuat dokumentasi berupa Data Dictionary untuk semua database yang dipakai. Task ini saya berikan kepada developer saya saat ia sedang tidak terlalu berat task. Setiap point merupakan sebuah penjelasan untuk semua tabel yang ada dalam setiap database dimana di dalamnya terdapat penjelasan mana yang merupakan tabel PK, FK, apakah nullable, apa tipe data dan berapa lengthnya, dan apakah ia unik. Yuph, kira2 semacam itu, dan teman-teman dapat menggunakan query ini untuk mendapatkan data lainnya dari tabel-tabel tersebut tentunya.

Pada contoh kali ini, saya menggunakan database pada contoh-contoh saya sebelumnya yakni database Akademik. Untuk query database, teman-teman dapat mendownload query database pada contoh kali ini pada link berikut :

https://drive.google.com/file/d/1KYiT2H_uPhfzMDJ8ZZclxBy685uXUFs1/view?usp=sharing

Atau teman-teman dapat me-restore-nya dengan menggunakan file bak pada link berikut :

https://drive.google.com/file/d/1dm7TsHlJqpG1YaQHBnq7r2g0lAJCrLLd/view?usp=sharing

Saya asumsikan teman-teman sudah memiliki databasenya. Teman-teman akan melihat secara singkat struktur key seperti berikut :

Ada dua kasus yang akan saya gunakan saat ini :

Saya ingin melihat semua struktur pada tabel Siswa, maka query yang dapat digunakan sebagai berikut :

WITH foreign_data
AS (
    SELECT DISTINCT f.parent_object_id
        ,fc.parent_column_id
        ,OBJECT_NAME(f.parent_object_id) TableName
        ,COL_NAME(fc.parent_object_id, fc.parent_column_id) ColName
        ,OBJECT_NAME(f.referenced_object_id) ReferencedTableName
    FROM sys.foreign_keys AS f
    INNER JOIN sys.foreign_key_columns AS fc ON f.OBJECT_ID = fc.constraint_object_id
    INNER JOIN sys.tables ta ON ta.OBJECT_ID = fc.referenced_object_id
    )
SELECT tbl.name 'Table Name'
    ,c.NAME 'Column Name'
    ,t.NAME 'Data type'
    ,c.max_length 'Max Length'
    ,c.precision 'Precision'
    ,c.scale 'Scale'
    ,c.is_nullable 'Is Nullable'
    ,c.is_identity 'Is Identity'
    ,ISNULL(i.is_unique, 0) 'Is Unique'
    ,ISNULL(i.is_primary_key, 0) 'Primary Key'
    ,CASE 
        WHEN fk.ColName IS NULL
            THEN 0
        ELSE 1
        END 'Foreign Key'
FROM sys.tables tbl
INNER JOIN sys.columns c ON c.object_id = tbl.object_id
INNER JOIN sys.types t ON c.user_type_id = t.user_type_id
LEFT OUTER JOIN sys.index_columns ic ON ic.object_id = c.object_id
    AND ic.column_id = c.column_id
LEFT OUTER JOIN sys.indexes i ON ic.object_id = i.object_id
    AND ic.index_id = i.index_id
LEFT OUTER JOIN foreign_data fk ON fk.parent_column_id = c.column_id
    AND fk.parent_object_id = c.object_id
WHERE c.object_id = OBJECT_ID('Siswa')

Maka hasilnya akan seperti berikut :

Saya ingin melihat semua struktur dari semua tabel yang ada pada database Akademik, maka query yang dapat digunakan sebagai berikut :

WITH foreign_data
AS (
    SELECT DISTINCT f.parent_object_id
        ,fc.parent_column_id
        ,OBJECT_NAME(f.parent_object_id) TableName
        ,COL_NAME(fc.parent_object_id, fc.parent_column_id) ColName
        ,OBJECT_NAME(f.referenced_object_id) ReferencedTableName
    FROM sys.foreign_keys AS f
    INNER JOIN sys.foreign_key_columns AS fc ON f.OBJECT_ID = fc.constraint_object_id
    INNER JOIN sys.tables ta ON ta.OBJECT_ID = fc.referenced_object_id
    )
SELECT tbl.name 'Table Name'
    ,c.NAME 'Column Name'
    ,t.NAME 'Data type'
    ,c.max_length 'Max Length'
    ,c.precision 'Precision'
    ,c.scale 'Scale'
    ,c.is_nullable 'Is Nullable'
    ,c.is_identity 'Is Identity'
    ,ISNULL(i.is_unique, 0) 'Is Unique'
    ,ISNULL(i.is_primary_key, 0) 'Primary Key'
    ,CASE 
        WHEN fk.ColName IS NULL
            THEN 0
        ELSE 1
        END 'Foreign Key'
FROM sys.tables tbl
INNER JOIN sys.columns c ON c.object_id = tbl.object_id
INNER JOIN sys.types t ON c.user_type_id = t.user_type_id
LEFT OUTER JOIN sys.index_columns ic ON ic.object_id = c.object_id
    AND ic.column_id = c.column_id
LEFT OUTER JOIN sys.indexes i ON ic.object_id = i.object_id
    AND ic.index_id = i.index_id
LEFT OUTER JOIN foreign_data fk ON fk.parent_column_id = c.column_id
    AND fk.parent_object_id = c.object_id
ORDER BY tbl.name

Maka hasilnya akan seperti berikut :

Demikian sharing sedikit dari saya untuk mendapatkan semua struktur tabel yang ada. Mudah-mudahan bermanfaat buat teman-teman semua untuk mempermudah dalam mendapatkan informasi dari sebuah database terutama bagi yang sering berhubungan dengan database.

Sekian dari saya, terima kasih dan selamat beristirahat… 😀

Category: Database, Programming, Tentang Komputer | LEAVE A COMMENT

Juni 30

Menggunakan SQL Search untuk mencari kata di database

Halo semua, pada malam ini saya ingin membagikan sebuah software yang berguna banget buat saya pribadi saat saya kesulitan dalam pekerjaan untuk mencari sebuah tabel dalam sekumpulan stored procedure, function, maupun view.

Jadi, ceritanya begini, dulu saya pernah mengerjakan sebuah project dimana kalau dikategorikan termasuk project maintenance. Dan sudah bisa ditebak, yuph, dalam project itu aplikasi sudah ada dengan berbagai flow di dalamnya termasuk berbagai macam SP, function, dan view. Aplikasinya pun terikat/terhubung dengan beberapa aplikasi lainnya dan pastinya terdapat beberapa database di dalamnya (satu aplikasi satu database saat itu). Dalam task maintenance tersebut, terkadang saya mendapatkan task dimana saya diharuskan untuk menambahkan sebuah kolom dalam beberapa tabel. Dan sialnya, banyak stored procedure melakukan script insert tanpa menyebutkan detail kolom-kolom yang akan diinsert. Dalam kasus saya, insert yang dipakai biar ada gambaran contohnya yaitu insert into table1 select * from table2. Tahukan apa yang akan terjadi saat terjadi penambahan kolom pada table2 tapi tidak terjadi penambahan kolom yang sama pada table1? Yuph, akan terjadi error.

Nah, untuk mempermudah saya mencari query apa aja yang terhubung dengan table yang akan saya ubah (dalam kasus td table2), saya menggunakan tools ini untuk mencarinya. Tools tersebut adalah SQL Search dari RedGate. Eits… jangan khawatir, tools tersebut free kok, namun teman-teman mesti submit data dahulu saat mengunduhnya. Tools tersebut sebagai plugin pada aplikasi Ms SQL Server Management Studio. Berikut link untuk mengunduh toolsnya :

https://www.red-gate.com/products/sql-development/sql-search/installer/

Adapun setelah teman-teman melakukan instalasi, maka menu akan tampil pada toolbar SSMS. Kira-kira akan seperti ini tampilannya :

Dan cara penggunaannya pun terbilang mudah, teman-teman hanya perlu melakukan klik pada menunya seperti yang saya tandai pada gambar di atas. Maka tampilan akan seperti gambar di atas. Kemudian pilih database yang akan dilakukan pencarian, kemudian masukkan kata/kolom/tabel/apapun itu yang akan dicari pada kotak pencarian. Maka list hasil akan terlihat. Teman-teman pun dapat melakukan penyaringan tipe object apa aja yang akan dicari. Dalam contoh saya, saya ingin mencari semua yang berhubungan dengan kata name, baik itu kolom maupun tabel. Maka tampilan di laptop saya, hasil akan seperti berikut :

Dalam hasil pencarian tersebut akan terlihat semua kata yang terkait dengan kata “name”, baik itu sebagai kolom dalam sebuah tabel, maupun parameter & isi dari sebuah stored procedure.

Nah, untuk kasus awal saya sebelumnya, saya menggunakan kata kunci “SELECT * FROM table2” untuk pencarian sehingga saya mengetahui semua stored procedure dan fungsi, bahkan trigger yang melakukan insert dari table2 menggunakan query select * from.

Demikian sedikit info untuk sebuah tools yang sering saya pakai untuk pencarian kata terkait database SQL Server. Mudah-mudahan bermanfaat untuk teman-teman yang mengalami masalah yang sama dan tools tersebut menjadi solusi jitu untuk permasalahan teman-teman juga.

Terima kasih dan selamat malam… 😀

Category: Software, Tentang Komputer | LEAVE A COMMENT

Juni 27

Membuat Connection String dengan memanfaatkan file UDL

Halo semua. Pada malam ini saya ingin membagikan sebuah trik bagaimana caranya kita membuat sebuah koneksi ke database (tentunya pada contoh saya ke database SQL Server) dengan mudah dengan memanfaatkan sebuah file berfotmat udl. UDL sendiri merupakan sebuah tipe file yang menyimpan informasi koneksi database yang biasanya digunakan untuk melakukan testing terhadap sebuah koneksi tanpa harus melakukan coding terlebih dahulu. Langsung saya bagaimana caranya? Berikut langkah-langkah yang perlu dilakukan :

Buat sebuah file dan ubah tipe file tersebut menjadi berformat .udl

Double click file tersebut sehingga tampil tools Data Link Properties

Masukkan koneksi yang diinginkan (di sini kita jg dapat memilih provider lain bila diinginkan pada tab Provider). Lakukan Test Connection hingga koneksi berhasil. Klik OK

Buka file udl tersebut dengan notepad dan dapat kita connection string sudah berhasil dibuat dapat kita manfaatkan untuk connection string database pada aplikasi kita

Sekian trik singkat dari saya dan semoga bermanfaat dalam mempermudah kita untuk melakukan development sebuah aplikasi. Terima kasih dan selamat beristirahat… 😀

Category: Programming, Tentang Komputer | LEAVE A COMMENT

Juni 24

Query untuk mencari kolom berdasarkan value

Malam yang dingin, diiringi kopi hangat, suasana yang sangat cocok untuk berbagi. Hari ini saya mendapatkan sebuah request untuk mencari tahu mengapa permasalahan beberapa data yang diminta oleh client. Namun, saya bukan ingin membahas permasalahan apa yang terjadi, tapi dalam pencarian permasalahan tersebut saya dihadapkan pada sebuah permasalahan lain. Apakah itu? Jreng…jreng…hehe…

Yuph, data yang saya dapat ini berada pada tabel apa sih? Kalaupun dapat tabelnya, di kolom apa? Saya pun berinisiatif untuk membuat sebuah Stored Procedure untuk memecahkan masalah saya itu. Nah, pada tulisan saya kali ini, saya ingin membagikan Stored Procedure yang telah saya buat tersebut. Mungkin bisa jadi teman-teman mengalami permasalahan yang sama. Berikut query full Stored Procedure saya :

/*********************************************************
Author      : Agunahwan Absin
Create Date : 24/06/2020
Description : Stored Procedure for get column in table by value of row
Example     : EXEC dbo.sp_SearchColumnByValue 'Akademik','Agun'
**********************************************************/
CREATE PROCEDURE dbo.sp_SearchColumnByValue @DatabaseName VARCHAR(128) = ''
    ,@Value VARCHAR(MAX) = ''
    ,@TableName VARCHAR(128) = NULL
    ,@TableSchemaName VARCHAR(128) = 'dbo'<br />
AS
BEGIN
    DECLARE @CountTable INT = 1
        ,@IncTable INT = 1
        ,@Query VARCHAR(MAX) = ''

<pre><code>-- Validation if @DatabaseName is empty
IF (@DatabaseName = '')
BEGIN
    RAISERROR (
            15600
            ,- 1
            ,- 1
            ,'Database name must be filled'
            );
END

-- Preventive steps for handling error if ##TempResult is exists
IF OBJECT_ID('tempdb..##TempResult') IS NOT NULL
BEGIN
    DROP TABLE ##TempResult
END

-- Create table ##TempResult with empty data
SET @Query = 'SELECT t.TABLE_NAME
            ,COLUMN_NAME
            ,CONVERT(INT, 1) AS TOTAL_DATA
        INTO ##TempResult
        FROM ' + @DatabaseName + '.INFORMATION_SCHEMA.TABLES t
        JOIN ' + @DatabaseName + '.INFORMATION_SCHEMA.COLUMNS c ON t.TABLE_NAME = c.TABLE_NAME
        WHERE 1 = 2'

EXEC (@Query)

-- Preventive steps for handling error if ##TempTables is exists
IF OBJECT_ID('tempdb..##TempTables') IS NOT NULL
BEGIN
    DROP TABLE ##TempTables
END

-- Create table ##TempTables with empty data
SET @Query = 'SELECT IDENTITY(INT, 1, 1) AS ID
            ,TABLE_NAME
        INTO ##TempTables
        FROM ' + @DatabaseName + '.INFORMATION_SCHEMA.TABLES
        WHERE TABLE_TYPE = ''BASE TABLE''
            AND TABLE_NAME <> ''sysdiagrams''
            AND TABLE_SCHEMA = ''' + @TableSchemaName + ''''

IF (@TableName IS NOT NULL)
BEGIN
    SET @Query = @Query + ' AND TABLE_NAME = ''' + @TableName + ''''
END

EXEC (@Query)

-- Set delimiter loop
SELECT @IncTable = 1
    ,@CountTable = Count(1)
FROM ##TempTables

-- Looping for executing all tables to search table name
WHILE (@IncTable <= @CountTable)
BEGIN
    DECLARE @CountColumn INT
        ,@IncColumn INT

    -- Get table name for searching in this table & for retrieving all columns in that table
    SELECT @TableName = TABLE_NAME
    FROM ##TempTables
    WHERE ID = @IncTable

    -- Preventive steps for handling error if ##TempColumns is exists
    IF OBJECT_ID('tempdb..##TempColumns') IS NOT NULL
    BEGIN
        DROP TABLE ##TempColumns
    END

    -- Generate query for getting all columns in the table
    SET @Query = 'SELECT IDENTITY(INT, 1, 1) AS ID
                ,c.name AS COLUMN_NAME
                ,type_name(c.user_type_id) AS DATA_TYPE
            INTO ##TempColumns
            FROM ' + @DatabaseName + '.INFORMATION_SCHEMA.TABLES it
            JOIN ' + @DatabaseName + '.sys.tables t ON it.TABLE_NAME = t.NAME
            JOIN ' + @DatabaseName + '.sys.columns c ON t.object_id = c.object_id
            WHERE it.TABLE_SCHEMA = ''' + @TableSchemaName + ''' 
                AND type_name(c.user_type_id) <> ''TEXT'' 
                AND it.TABLE_NAME = ''' + @TableName + '''
                AND c.max_length >= ' + CONVERT(VARCHAR, LEN(@Value))

    EXEC (@Query)

    -- Set delimiter loop
    SELECT @IncColumn = 1
        ,@CountColumn = Count(1)
    FROM ##TempColumns

    -- Looping for executing all columns to search column name
    WHILE (@IncColumn <= @CountColumn)
    BEGIN
        DECLARE @ColumnName VARCHAR(128)
            ,@DataType VARCHAR(8000)

        -- Get column name & the data type for searching in the column
        SELECT @ColumnName = COLUMN_NAME
            ,@DataType = DATA_TYPE
        FROM ##TempColumns
        WHERE ID = @IncColumn

        -- Generate query for checking if the value exists in that table & column
        SET @Query = 'INSERT INTO ##TempResult (TABLE_NAME, COLUMN_NAME, TOTAL_DATA) 
                SELECT ''' + @TableName + ''' AS TABLE_NAME
                    ,''' + @ColumnName + ''' AS COLUMN_NAME
                    ,COUNT(1) AS TOTAL_DATA
                FROM ' + @DatabaseName + '.' + @TableSchemaName + '.' + @TableName

        -- If the data type is varchar, nvarchar, xml, or nchar then use try_cast for comparing value
        IF (
                @DataType IN (
                    'VARCHAR'
                    ,'NVARCHAR'
                    ,'XML'
                    ,'NCHAR'
                    ,'CHAR'
                    ,'TEXT'
                    )
                )
        BEGIN
            SET @Query = @Query + ' WHERE ' + @ColumnName + ' = TRY_CAST(''' + @Value + ''' AS ' + @DataType + ') '
        END
        ELSE IF (@DataType IN ('UNIQUEIDENTIFIER')) -- If the data type is UNIQUEIDENTIFIER then use try_convert for comparing value
        BEGIN
            SET @Query = @Query + ' WHERE ' + @ColumnName + ' = TRY_CONVERT(' + @DataType + ',''' + @Value + ''') '
        END
        ELSE -- and use try_parse for else
        BEGIN
            SET @Query = @Query + ' WHERE ' + @ColumnName + ' = TRY_PARSE(''' + @Value + ''' AS ' + @DataType + ') '
        END

        SET @Query = @Query + 'GROUP BY ' + @ColumnName

        EXEC (@Query)

        SET @IncColumn = @IncColumn + 1
    END

    DROP TABLE ##TempColumns

    SET @IncTable = @IncTable + 1
END

-- Show all data that have the value
SELECT *
FROM ##TempResult
WHERE TOTAL_DATA > 0

DROP TABLE ##TempTables

DROP TABLE ##TempResult
</code></pre>
<p>END<br />
GO

Di sini coba saya jelaskan beberapa parameter yang digunakan dalam Stored Procedure tersebut :

DatabaseName : Parameter ini sifatnya mandatory. Teman-teman harus mengisi pencarian data tersebut akan dilakukan pada database apa.
Value : Parameter ini bersifat optional dengan default value nya string kosong. Parameter ini diisi dengan value yang akan dicari.
TableName : Parameter ini bersifat optional dengan default value nya null. Parameter ini diisi dengan nama tabel tempat akan dilakukan pencarian. Bila teman-teman tidak menggunakan parameter ini, maka secara default pencarian dilakukan pada semua tabel yang ada pada database yang teman-teman isi.
TableSchemaName : Parameter ini bersifat optional dengan default value nya dbo. Parameter ini diisi dengan nama skema tabel tempat akan dilakukan pencarian.

Untuk contoh cara penggunaannya saya akan membagi dengan beberapa case berikut :

Kita ingin mencari data dengan value ‘Pusporenggo’ di database Akademik berada pada kolom dan tabel apa. Pencarian dilakukan pada semua tabel dengan schema default yakni dbo, sehingga kita dapat mengetahui semua table beserta kolomnya yang memiliki value tersebut. Maka perintahnya akan menjadi berikut :
```
EXEC dbo.sp_SearchColumnByValue 'Akademik','Pusporenggo'
```
Dan hasilnya akan seperti berikut :

Maka jika kita lakukan perintah SELECT dengan filter pada kolom tersebut di tabel tersebut, maka hasilnya akan seperti berikut :
Kita ingin mencari data dengan value ‘Pusporenggo’ di database Akademik berada pada kolom apa. Pencarian dilakukan pada tabel siswa dengan schema default yakni dbo, sehingga kita dapat mengetahui semua kolom yang memiliki value tersebut. Maka perintahnya akan menjadi berikut :
```
EXEC dbo.sp_SearchColumnByValue 'Akademik','Pusporenggo','Siswa'
```
Dan hasilnya akan seperti berikut :

Maka jika kita lakukan perintah SELECT dengan filter pada kolom tersebut di tabel tersebut, maka hasilnya akan seperti berikut :

Bila teman-teman kesulitan untuk menyalin query Stored Procedure saya, teman-teman juga dapat melakukan download querynya pada link berikut :

https://drive.google.com/file/d/1ZydC2zpmp1wSlAyh0ZIfOCuEHCNUJHWo/view?usp=sharing

Akhir kata, semoga tulisan saya dapat bermanfaat khususnya bagi yang mengalami permasalahan yang sama. Terima kasih dan selamat beristirahat…. 😀

Category: Programming, Tentang Komputer | LEAVE A COMMENT

Juni 24

Menggunakan API Helper Swagger pada .Net Framework

Di malam yang sunyi ini, aku sendiri. Eh, ini mau menulis lirik lagukah? Tidaakkk…..

Maafkan ketidakjelasan saya, maklum malam ini saya sedang sendiri di rumah. Istri dan anak saya sedang menginap di rumah mertua.

Lanjut ke inti tulisan aja. Jadi, malam ini saya ingin membagikan ilmu, bagaimana cara menggunakan Swagger sebagai API Helper untuk project API kita. Untuk yang ingin mengetahui lebih lanjut apa itu Swagger, bisa buka link berikut :

https://swagger.io/

Selanjutnya, saya akan menjelaskan langkah-langkah yang perlu dilakukan untuk menggunakan Swagger ini. Sebelumnya perlu diingat, di sini saya coba mempraktekkan penggunaan Swagger untuk project API versi .Net Framework dan saya sendiri menggunakan .Net Framework 4.6.1 untuk tulisan ini. Berikut langkah-langkahnya :

Buat sebuah Project API, create nama project “API” dan tunggu hingga proses selesai seperti berikut :

Buka Package Manager Console dan pastikan project yang terpilih adalah project API yang akan dipasang Swagger. Lalu ketikkan perintah Install-Package Swashbuckle kemudian tekan enter. Tunggu hingga proses instalasi paket selesai :

Pastikan SwaggerConfig sudah ada pada Folder App_Start seperti berikut :

Buka property Project. Kemudian pilih Build. Aktifkan XML Documentation file dengan memberi tanda centang :

Proses pemasangan sudah berhasil sampai di sini. Selanjutnya kita dapat melakukan testing dengan menjalankan API kita. Dan saat sudah berjalan, kita tambahkan swagger pada path (untuk kasus saya, path menjadi berikut : http://localhost:57897/swagger) sehingga Swagger UI dapat terpanggil seperti berikut :

Jika kita klik pada List Operations, kita akan melihat semua endpoint/fungsi pada API kita dan melakukan testing pada setiap endpoint yang ingin kita tes.

Demikian tutorial singkat saya pada malam ini. Harap dimaklum karena saya juga sepertinya sudah mulai mengantuk (maklum, ternyata sudah berganti hari, hehe…). Semoga tulisan ini bermanfaat khususnya bagi yang sedang mengerjakan project API namun bingung untuk menyiapkan sebuah UI untuk keperluan testing maupun sebagai dokumentasi project.

Nantikan artikel selanjutnya dan terima kasih… 😀

Category: Programming, Tentang Komputer | LEAVE A COMMENT

Juni 23

Function SQL untuk generate random date

Sore menjelang malam ini waktunya untuk menulis kembali. Kali ini saya ingin membagikan sebuah function yang saya buat untuk generate random date. Kok bisa ada keinginan untuk buat function ini? Jadi ada sejarahnya nih kenapa buat. Jadi gini, beberapa hari yang lalu, saya ada sebuah task untuk mengupdate beberapa data (kolom bertipe date) menjadi berisi bermacam-macam tanggal dalam 1 bulan. Data ada kisaran 1.500 jumlahnya (gile aja kan klo update satu2). Langsung aja, ini function yang saya buat untuk generate random date :

/*********************************************************
Author : Agunahwan Absin
Create Date : 22/06/2020
Description : Function for get random value for date
Example : SELECT dbo.fc_GetRandomDate('2010-01-01','2020-06-22')
**********************************************************/
CREATE FUNCTION [dbo].[fc_GetRandomDate] (
	@StartDate DATETIME = NULL
	,@EndDate DATETIME = NULL
	)
RETURNS DATETIME
AS
BEGIN
	DECLARE @Result DATETIME
		,@StartTotalDay INT
		,@EndTotalDay INT

	-- Set default value @StartDate
	IF (@StartDate IS NULL)
	BEGIN
		SET @StartDate = CAST(0 AS DATETIME)
	END

	-- Set default value @EndDate
	IF (@EndDate IS NULL)
	BEGIN
		SET @EndDate = GETDATE()
	END

	SET @StartTotalDay = DATEDIFF(DAY, 0, @StartDate)
	SET @EndTotalDay = DATEDIFF(DAY, 0, @EndDate) - @StartTotalDay
	-- Generate random date
	SET @Result = DATEADD(day, (
				ABS(CHECKSUM((
							SELECT new_id
							FROM vw_GetNewID
							))) % @EndTotalDay
				), @StartTotalDay)

	RETURN @Result
END
GO

Namun, sebelum dapat menggunakan fungsi tersebut, teman-teman harus membuat sebuah view untuk melakukan generate GUID. Berikut view yang saya buat :

/*********************************************************
Author		: Agunahwan Absin
Create Date	: 22/06/2020
Description	: View for get New ID
Example		: SELECT * FROM dbo.vw_GetNewID
**********************************************************/
CREATE VIEW [dbo].[vw_GetNewID]
AS
SELECT NEWID() AS new_id
GO

Nah, untuk penggunaanya gimana nih? Jadi teman-teman bisa bervariasi menggunakannya :