Resume Teknik Dokumentasi Aplikasi (Pertemuan 6)

Dosen: Ayuningtyas, S.Kom.,M.MT.,- MOS 

:::...Illustration...:::

Manfaat ilustrasi

• Membantu pembaca untuk memahami apa yang dituliskan
• Memastikan bahwa data yang tampil bermakna
• Menentukan mekanisme fisik yang digunakan untuk mendapatkan file yang sesuai

 Jenis - jenis ilustrasi

• Tabel : Menyediakan metode pencarian informasi secara cepat yang akan dirujuk oleh pembaca beberapa kali. Informasi yang terdapat dari tabel harus:
• mudah ditemukan
• mudah dipahami
• mudah digunakan

• Railroad diagrams : Cara yang berguna untuk menunjukan bagaimana pengguna mencapai titik tertentu dalam software.

• Grafik : Cara pengungkapan dan perwujudan  dalam bentuk huruf, tanda, dan gambar yang diperbanyak melalui proses percetakan untuk disampaikan kepada pembaca.
•  Bar Graphs: Graphic bar bisa dipakai hampir di seluruh jenis data. Misal, biaya produksi barang dari tahun ke tahun (yang ini bisa juga pakai line chart), persentase media-media informasi yang digunakan mahasiswa (TV berapa persen, radio berapa persen, dll), dan sebagainya. Antar bar nggak mesti membahas hal yang sama (bisa biaya produksi di bar satu, biaya pemasaran di baru dua, misalnya).
  
• Line graphs:
  Line chart digunakan ketika kita mau membandingkan perkembangan suatu hal dari waktu ke waktu (biasanya sumbu x itu waktu). Misalnya, harga mobil dari bulan Januari sampe bulan Desember. Dari line chart kita bisa tahu kenaikan atau penurunan yang terjadi pada harga mobil selama bulan-bulan tersebut.
  Line chart tidak bisa digunakan ketika membandingkan hal yang berbeda (misalnya konsumsi beberapa bahan pangan yang berbeda). Lebih tepat jika data semacam ini pakai graphic bar.

 
•  Pie charts : Pie chart dipakai ketika mau menggambarkan dari keseluruhan 100% berapa % yang (misal) makan nasi, berapa persen yang makan mie, berapa persen yang makan kentang, dst. Pie chart tidak bisa digunakan ketika orang yang makan nasi juga makan mie (kecuali dikasih golongan tersendiri, nasi dan mie). Intinya, total pie chart harus 100%, tidak kurang tidak lebih…
  

•  Flow Chart : Bentuk / gambar yang mempunyai aliran satu atau dua sekuensial. Kegunaan flow Chart:
•  Untuk Mendesain program
•  Untuk merepresentasikan program

  

• Alpha Key Diagram : Digunakan ketika ingin menunjukan dan memberikan label pada beberapa bagian dari gambar.

Resume Teknik Dokumentasi Aplikasi (Pertemuan 5)

Dosen: Ayuningtyas, S.Kom.,M.MT.,- MOS 

:::...Teknik  Penulisan Aplikasi...:::  

Menggunakan kalimat yang baku

1. Menggunakan kalimat aktif
2. Menggunakan kalimat pasif

Panjang kalimat

• Mudah di pahami oleh pembaca 
• Menggunakan kalimat yang sederhana
• Mencoba untuk membuat antara 13-21 kata setiap kalimat
• Hapus kata yang tidak perlu di gunakan

Logat dan istilah teknik

• Menyediakan kamus di istilah - istilah didalam kata
• Menyediakan glosarium istilah , biasanya terletak diakhir user manual
• mengekspresikan ide-ide dalam kata-kata lain

Pengguanan number 

1.  Nomor dalam text
2.  Bab, bagian, halaman dan bagian nomor
3.  Desimal
4.  Angka terkait dengan unit
5.  Tanggal
6.  Waktu
7.  Nomor telepon

Mengedit Tulisan

• Selesaikan Draf Awal tulisan, apapun bentuknya, jangan ditunda-tunda
• Endapkan tulisan awal selama beberapa waktu, lalu cari inspirasi/kesibukan, namun tetap perhatikan deadline/batas tenggat
• Tinjau ulang Draf Awal dan periksa dari segi substansi, struktur argumentai atau gaya penulisannya
• Lakukan koreksi mulai dari yang mudah: standar bahasa, validitas data/referensi hingga yang sulit keandalan argumentasi

Ada beberapa alasan tulisan jarang di baca oleh pembaca: 

• SERIUS dan PANJANG: orang mengganggap tulisan rubrik opini terlampau serius dan berat. Para penulis sendiri juga sering terjebak pada pandangan keliru bahwa makin sulit tulisan dibaca (makin teknis, makin panjang dan makin banyak jargon, khususnya jargon bahasa Inggris) makin tinggi nilainya, bahkan makin bergengsi. Keliru! Tulisan seperti itu takkan dibaca orang banyak.
• KERING: banyak tulisan dalam rubrik opini cenderung kering, tidak “berjiwa”, karena penulis lagi-lagi punya pandangan keliru bahwa tulisan analisis haruslah bersifat dingin: obyektif, berjarak, anti-humor dan tanpa bumbu.
• MENGGURUI: banyak tulisan opini terlalu menggurui (berpidato, berceramah, berkhotbah), sepertinya penulis adalah dewa yang paling tahu.
• SEMPIT: tema spesifik umumnya ditulis oleh penulis yang ahli dalam bidangnya (mungkin seorang doktor dalam bidang yang bersangkutan). Tapi, seberapa pun pintarnya, seringkali para penulis ahli ini terlalu asik dengan bidangnya, terlalu banyak menggunakan istilah teknis, sehingga tidak mampu menarik pembaca lebih luas untuk menikmatinya.

Resume Pemrograman Basis Data II (Pertemuan 1)

Dosen : Hendro Poerbo P, S.T, M.MT.

:::...Declarasi Variabel...:::

Mendeklarasikan Variabel

Merupakan pengembangan bahasa procedural sql, bahasa standard untuk mengakses data pada database relational dari oracle coorperation.

Penggunaan Variabel

Variabel dalam PL/SQL dapat digunakan untuk :

• Penyimpanan data sementara
• Manipulasi nilai yang sudah tersimpan : Varibel dapat digunakan untuk proses manipulasi nilai yang sudahtersimpan dalam database Oracle.
• Reusability : Variabel dapat digunakan kembali dengan melakukan referensi daristatement yang lain
• Memudahkan maintenance : Pada penggunaan %TYPE dan %ROWTYPE, deklarasi variable dibuatberdasarkan definisi dari kolom database -> in the next session

Aturan Penamaan Variabel

 Variabel diberi nama sesuai dengan aturan, misal v_namemerepresentasikan suatu variable, jadi nama dari variable selalu diawali denganv diikuti dengan underscore (_) lalu nama variabelnya.

DECLARE
v_job                VARCHAR2(9);
v_count             BINARY_INTEGER := 0;
v_total_sal         NUMBER(9,2) := 0;
v_orderdate       DATE := SYSDATE + 7;
c_tax_rate         CONSTANT NUMBER(3,2) := 8.25;
v_valid               BOOLEAN NOT NULL := TRUE;

Tipe Block

• Anonymous

[DECLARE]
BEGIN
--statements
[EXCEPTION]
END;

• Procedure

 PROCEDURE name
IS
BEGIN
--statements
[EXCEPTION]
END;

• function

FUNCTION name
RETURN datatype
IS
BEGIN
--statements
RETURN value;
[EXCEPTION]
END;

Tipe Variabel

• Tipe Data Scalar, menyimpan nilai tunggal seperti : VARCHAR2(maximum_length), NUMBER[(presicion, scale)], DATE,CHAR[(maximum_length)], LONG, LONG RAW, BOOLEAN, BINARY_INTEGER, PLS_INTEGER
• Tipe Data Composite, seperti record.
• Tipe data Reference, menyimpan nilai yang disebut pointer.
• Tipe Data LOB, menyimpan nilai yang disebut Locators.

Atribut %TYPE

Atribut %TYPE digunakan untuk mendeklarasikan variable yang memilikitipe data yang sama dengan definisi kolom database.

Syntax::

identifier Table.column_name%TYPE;

Examples:

 ...
v_name               employees.last_name%TYPE;
v_balance           NUMBER(7,2);
v_min_balance   v_balance%TYPE := 10;
...

DBMS_OUTPUT.PUTLINE
Bind variable selain ditampilkan dengan PRINT, juga dapat ditampilkandalam blok PL/SQL , dengan menggunakan fungsi standart yang disediakan olehOracle yaitu DBMS_OUTPUT.PUT_LINE. Untuk menggunakan fungsi ini,SERVEROUTPUT harus diset ON.

SET SERVEROUTPUT ON
DEFINE p_annual_sal = 60000

DECLARE
v_sal NUMBER(9,2) := &p_annual_sal;
BEGIN
v_sal := v_sal/12;
DBMS_OUTPUT.PUT_LINE ('The monthly salary is ' || TO_CHAR(v_sal));
END;
/

Sumber :
Link 1
Link 2

Resume Teknik Dokumentasi Aplikasi (Pertemuan 4)

Dosen: Ayuningtyas, S.Kom.,M.MT.,- MOS 

:::... Menulis Draft Pertama ...:::

Peraturan 

1. Selalu menjaga hubungan dengan editor
2. Tinjau secara terus menerus
3. Belajar dari kesalahan

Dalam sebuah penulisan terdapat 10 aturan yang harus diperhatikan

1. Identifikasi target/pembaca : Dengan mengetahui taget pembaca, maka penulis akan lebih mudah membuat suatu tulisan.
2. Bicara dengan menggunakan bahasa pembaca : Dalam membuat suatu tulisan, penulis harus menggunakan bahasa yang umum digunakan oleh pembaca, sehingga tulisan yang dibuat dapat dimengerti oleh pembaca dari kalangan mana saja.
3. Hindari istilah-istilah yang susah dimengerti : Jangan menggunakan istilah-istilah yang sulit dimengerti oleh pembaca. Gunakan istilah yang mudah dipahami oleh kaum awam dan pemula, sehingga para pembaca tidak merasa binggung dengan istilah yang kita gunakan.
4. Hindari menggunakan kalimat panjang dan berbelit-belit : Kebanyakan pembaca tidak suka dengan kalimat yang terlalu panjang, karena kalimat yang panjang akan mengakibatkan para pembaca cepat merasa bosan dan kebingungan.
5. Gunakan kalimat singkat dan sederhana : Tidak perlu menggunakan kalimat yang berbelit-belit padahal maksudnya singkat.
6. langsung pada pokok pembahasan :Aturan ini sangat penting untuk meningkatkan konversi. Sering kali kita menginginkan pembaca melakukan sesuatu, kemudian memberikan cetita atau dorongan berupa keuntungan,tujuan dan manfaat dari apa yang kita minta terhadap pembaca.
7. Jelaskan pada pembaca tentang keuntungan bagi mereka : dengan cara mengutarakan keuntungan yang akan mereka dapatkan maka pembaca akan lebih tertarik untuk mambacanya.
8. berikan sentuhan kreatifitas pada tulisan
9. Review ulang tulisan : Untuk mengoreksi kesalahan agar penulisan kita akan menjadi lebih baik.
10. maksimalkan segala informasi : Akan lebih baik jika anda melakukan riset, mengumpulkan data secara maksimal dari buku, internet, ebook, forum apa yang anda sediakan benar-benar lengkap dan tidak salah.

Bab (Chapter)

• Bagian informasi utama dalam buku
• Memudahkan pembaca mengenai apa yang mereka cari
• Materi apa saja yang terkait

Bagian dan subbagian

• Bagian dari bab yang yang digunakan untuk memecah bagian menjadi beberapa yang lebih mudah dimengerti
• Bagian harus mencakup satu kegiatan

Paragraf

• Kumpulan dari kalimat - kalimat yang membentuk suatu ide utama
• Jangan menggunakan banyak paragraf kecil (beberapa kalimat saja)
• Jangan membagi paragraf pada halaman terpisah
• Selalu menempatkan line kosong (spasi) antar paragraf

Syarat sebuah paragraf

• Kalimat Pokok : Biasanya diletakkan pada awal paragraf, tetapi bisa juga diletakkan pada bagian tengah maupun akhir paragraf. Kalimat pokok adalah kalimat yang inti dari ide atau gagasan dari sebuah paragraf. Biasanya berisi suatu pernyataan yang nantinya akan dijelaskan lebih lanjut oleh kalimat lainnya dalam bentuk kalimat penjelas.
• Kalimat Penjelas : Kalimat penjelas adalah kalimat yang memberikan penjelasan tambahan atau detail rincian dari kalimat pokok suatu paragraf.

Lampiran

• Menyediakan informasi yang berhubungan dengan buku
• Menggunakan standar dan struktur yang sama dengan bab

Judul (Headings)

• Digunakan pembaca untuk mendapat ide apa yang akan mereka dapatkan
• Hanya diperbolehkan 3 tingkatan (Bab, Bagian, dan Subbagian)
• Harus relevan dengan isinya
• Jangan menulis judul lebih dari satu baris 
• Selalu menempatkan beberapa tulisan antara judul bagian dengan subbagian pertama.
• Konsisten dalam pemilihan kata

Cautions : Untuk memperingatkan pembaca untuk setiap prosedur atau operasi yang dapat menyebabkan kerusakan peralatan atau kehilangan data.

Warnings : Dimana prosedur dapat menyebabkan cedera fisik.

Contoh (Example) : Memberikan pengguna suatu hal yang sama secara jelas.

Catatan (notes) : Menginformasikan pembaca informasi penting atau tambahan untuk subjek yang dijelaskan.

Resume Teknik Dokumentasi Aplikasi (Pertemuan 3)

Dosen: Ayuningtyas, S.Kom.,M.MT.,- MOS 

:::...The Types Of Books...::: 

"Semakin baik kualitas buku akan lebih bermanfaat bagi pembaca"

::..Keuntungan dalam tenis dokumentasi..::         

• Harus mempunyai nilai tambah
• Informasi yang diberikan akan mudah diakses
• Pembaca akan lebih cepat belajar dari buku tersebut
• Training lebih rendah karena pembaca sudah lebih dahulu mempelajari buku tersebut
• Akan memberikan pengetahuan bagi orang yang jarang membaca.
• Dibutuhkan bagi bermacam - macam komunitas
• Mengurangi biaya dukungan pelanggan
• Mengurangi biaya pemeliharaan
• Meningkatkan penjaulan produk.

Bimbingan teknis dalam bidang publikasi dimaksudkan untuk:

• meningkatkan kapasitas dan kualitas SDM dibidang publikasi
• konsep komunikasi visual 
• dan dapat mewujudkannya melalui peralatan teknologi informasi.

::.. 6 langkah dalam proses penulisan ..::

1. Analisa pembaca : Agar buku yang kita buat tepat sasaran maka kita perlu menganalisa dan mengetahui terlebih dahulu siapa siapa yang akan membaca buku kita.
2. membuat ringkasan : Agar pembaca  mengetahui definisi awal atau ringkasan dari buku , maka perlu ditambahkan ringkasan untuk menarik minat para pembaca.
3. Membuat rincian : Setelah ringkasan dapat membuat tertarik para pembaca, selanjutnya harus dibuat suatu pendefinisian secara rinci mengenai materi yang dibawakan.
4. Memilih gaya format yang akan digunakan : Gaya dan format penulisan perlu diperhatikan agar tidak membuat pembaca merasa bosan dengan isi buku dan pembaca tertarik untuk membaca buku.
5. Menulis buku manual : setelah semua sudah disiapkan, maka sekarang waktunya untuk menulis buku berdasarkan konsep- konsep diatas.
6. Mencoba buku manual : Setelah buku  selesai di buat ,langkaah terakhir adalah melakukan percobaan kepada para pembaaca.

::.. 4 model buku manual yang biasa dibuat..::

1. Pengantar panduan : Digunakan sebagai gambaran awal atau pengantar dari software / aplikasi yang dimaksud, mendeskripsikan  fitur-fitur dari produk, dan menjelaskan keuntungan bila memakai produk tersebut.
2. Panduan pelatihan : untuk membantu apa yang harus pengguna lakukan, menjelaskan bahwa apa yang mereka lakukan itu sudah benar dan memberikan rasa percaya diri dalam menjalankan produk tersebut.
3. User Manual : Mengenalkan seluruh kemampuan dari sistem yang dibuat, mengetahui bagaimana cara menggunakan produk ini seperti apa yang mereka inginkan dan menunjukan bagaimana mencapai hasil dengan menggunakan produk ini.
4. Panduan Referensi : Memberikan pengetahuan lebih dari produk yang sudah dibuat dan tambahan informasi jika pengguna ingin belajar lebih jauh dari produk ini.

Resume Teknik Dokumentasi Aplikasi (Pertemuan 2)

Dosen: Ayuningtyas, S.Kom.,M.MT.,- MOS 

:::...Pengembangan Dokumentasi Aplikasi...:::  

Dokumentasi perencanaan proyek     

• Pengantar : berisi tentang deskripsi masalah , deskripsi lingkungan masalah, tujuan clien, organisasi dan system, solusi dan ruang lingkupnya. 
• Proposal : dalam proposal yang diberikan pada solusi yang di ajukan, strategi umum, peran user atau pengguna serta keuntungan dan kerugian yang ditimbulkan dari solusi tersebut.
• Keterbatasan sistem : dalam keterbatasan sistem ini terdapat prasayrat kendala, prasyarat kinerja, prioritas customer, profil pengguna, usia pengharapan produk, solusi alternatif, solusi feasible dan ketersediaan pada lingkungan pengguna.
• Estimasi : estimasi merupakan perkiraan yang akan digunakan untuk merealisasikan suatu proyek. proyek dilakukan melalui beberapa tahapan yang membutuhkan waktu tertentu sehingga estimasi sangat dibutuhkan. Dalam perkiraan terdapat : 
• jadwal
• staf dan organisasi
• budget
• analisis cost
• analisis resiko
• dokumen yang diberikan 
• perangkat linak yang dibutuhkan
• fasilitas dan perangkat keras yang dibutuhkan

•  Prosedur : model dan metodologi harus diperhatikan dengan kendali produk agar standarisasi dan kualitas tetap terjamin.
• References : dokumentasi yang digunakan dalam pengembangan ini meliputi dokumen-dokumen pokok,  dokumen kontrak, kamus istilah dan lain-lain 

Tujuan perencanaan

1. standar pengawasan, yaitu mencocokan pelaksanaan dengan perencanaanya.
2. mengetahui kapan pelaksanaan dan selesainya suatu kegiatan
3. mengetahui siapa saja yang terlibat(struktur organisasinya), baik kualifikasinya maupun kualitasnya.
4. mendapatkan kegiatan yang sistematis termasuk biaya dan kualitas pekerjaan.
5. meminimalkan kegiatan- kegiatan yang tidak produktif dan menghemat biaya, tenaga, dan waktu.
6. memberikan gambaran yang menyeluruh mengenai kegiatan pekerjaan.
7. menyerasikan dan memadukan beberapa subkegiatan.
8. mendeteksi hambatan yang akan ditemui.
9. mengarahkan pada pencapaian tujuan.

Manfaat perencanaan

1. standar pengawasan dan pelaksanaan.
2. pemilihan sebagai alternatif terbaik.
3. penyusunan skala prioritas, baik sasaran maupun kegiatan.
4. menghemat pemanfaatan sumberdaya organisasi
5. membantu manajer menyesuaikan diri dengan perubahan lingkungan
6. alat memudahkan dalam berkoordinasi dengan pihak terkait
7. alat meminimalkan pekerjaan yang tidak pasti.

Dokumentasi spesifikasi desain

Spesifikasi sangat penting karena :

• Menulis spesifikasi memaksa engineer untuk mengeluarkan seluruh pemahamannya. Ketika membuat spesifikasi, engineer dipaksa berfikir fitur-fitur software yang akan dibuatnya. Dengan membuat spesifikasi, engineer akan menuliskan hasil analisis dan disainnya secara rinci.
• Spesifikasi adalah solusi ketika lupa. Hasil analisa dan disain merupakan komponen yang sangat berharga dalam pengembangan software. Akan sangat disayangkan jika komponen yang sangat berharga ini hilang karena lupa. Maka spesifikasi sangat penting untuk menangani masalah ini.
• Spesifikasi sistem adalah sumber pengetahuan penting yang dibutuhkan oleh orang lain. Spesifikasi juga adalah sumber pengetahuan untuk orang lain yang ingin memahami sistem. Orang lain yang butuh memahami sistem biasanya adalah tim yang bertugas untuk melakukan maintenance.

Resume Pemrograman Web (Pertemuan 2)

 Dosen: Kurniawan Jatmika, S.KOM

:::...WEB FORM...:::

Web Form adlah halaman web yang memungkinkan User untuk memasukkan data yang dikirimkan ke server untuk di proses. Umumnya pengolahan form dilakukan pada server dengan menggunakan skrip yang bersifat server-side. Web form berfungsi sebagai template untuk informasi baru.
Dalam form dikenal beberapa perintah yang sangat penting dan selalu digunakan  saat membangun suatu webside. Diantranya adalah :

• Method=Get. Yaitu suatu cara bagaimana program di server membaca komponen form yang diterima. Method ini akan mengolah input yang dikirim dengan teknik tertetu. Dalam hal ini yang digunakan adalah membaca parameter dari sebuah fungsi.
• Method=Post. Yaitu digunakan untuk mengolah input dari suatu client dengan teknik program yang membaca standart input. Yang menjadi acuan adalah bahasa program seperti ASP/CGI, sehingga seolah-olah program tersebut membaca input dari papan ketik keyboard.
• Method=Action. yaitu suatu aksi yang menunjukan pada program CGI/ASP. Dalam hal ini adalah nama program yang berakhiran ASP. Dalam penulisan HTML khususnya yang berhubungan dengan form ada beberapa komponen input yang sering digunakan. komponen-komponen tersebut diantaranya yaitu Text, Radio Button, Check Box, Button, password, select dan option.

 :::...MASTER PAGE...:::

Master Page adalah fitur yang digunakan untuk menentukan struktur umum dan elemen antarmuka markup untuk situs web termasuk header, footer,dan bar navigasi. Master page dapat dibagi oleh salah satu halaman situs web yang disebut dengan content page, dan menghilangkan kebutuhan untuk menduplikasi kode dalam situs web.

:::...TABLE...::: 

Table berfungsi untuk mengatur elemen halaman web spasial atau untuk membuat struktur data yang terbaik dalam bentuk tabular seperti daftar atau spesifikasi.
Sebuah table dibagi menjadi baris (dengan tag<tr>), dan setiap baris dibagi kedalam sel data.Sebuah tag dapat berisi teks, link, gambar, formulir, tabel dan lain-lain.

:::...HIPERLINK...::: 

Hiperlink merupakan suatu gambar atau bagian teks yang ketika diklik oleh pengguna untuk membuka halaman web lain atau melompat browser bagian yang berbeda dari halaman saat ini.
Setiap Link memiliki 2 sisi yaitu, sumber dan arah. Dimana sumber merupakan link itu sendiri, dan khusus untuk link yang berupa text, ada istilah anchor text. Anchor text ini merupakan tulisan dari link itu sendiri. Misalnya ada tulisan “Download” dimana tulisan tsb merupakan suatu link. Nah, kata “Download” itulah yang dinamakan dengan anchor text.
Sedangkan sisi lain dari suatu link yaitu arah, merupakan tujuan dari anchor text yang berupa elemen web (bisa text, gambar, video, document, halaman web, dll).


:::...FONT...::::

Font adalah salah satu elemen terpenting dalam desain grafis karena huruf merupakan sebuah bentuk yang universal untuk menghantarkan bentuk visual menjadi sebuah bentuk bahasa.

• Font Family : untuk merubah font dalam web sesuai dengan keinginan user
• Font Size : untuk merubah ukuran size sesuai dengan keinginan user.
• font Color : untuk merubah warna font agar sesuai dengan backgrond yang digunakan

 :::...IMAGE...:::

•  Image Background : gambar yang dibuat untuk latar belakang tampilan user.
• Image Control : digunakan untuk menampilkan gambar yang diinginkan.   

Referensi

•  http://en.wikipedia.org/wiki/form(web)
• Kurniawan, Yahya . 2001. Aplikasi Web database dengan ASP . PT Elex Media Komputindo. Jakarta.
• http:// www.w3shools.com 
• http://www.ahmad-edy.web.ugm.ac.id/materi3.htm