Panduan Sintaks Diagram ArchiMate PlantUML

Apa itu Diagram ArchiMate?

Sebuah Diagram ArchiMateadalah visualisasi pemodelan arsitektur perusahaan tingkat tinggi yang melacak strategi, proses bisnis, aplikasi perangkat lunak, dan infrastruktur data fisik di seluruh organisasi. Berbeda dengan peta UML tradisional yang menelusuri secara mendalam rutinitas eksekusi perangkat lunak, ArchiMate membantu analis bisnis, arsitek solusi, dan CTO memetakan bagaimana tujuan perusahaan tingkat tinggi bergantung pada sistem TI yang mendasarinya.

Meskipun PlantUML dasar berisi primitif bawaan, tata letak perusahaan tingkat produksi membutuhkan ekstensi perpustakaan standar resmi Archimate-PlantUML ekstensi perpustakaan standar. Dengan memanfaatkan makro deklaratif dan pita warna yang distandarkan, memungkinkan Anda mempertahankan model yang konsisten dan sesuai TOGAF. Dengan VPasCode, Anda dapat mendefinisikan blok arsitektur dan benang relasional Anda sepenuhnya dalam teks, memungkinkan mesin menangani skema warna kotak dan penjajaran secara dinamis.

Panduan Sintaks Inti: Elemen dan Konstruksi

Untuk menggunakan ekstensi ArchiMate resmi secara aman di PlantUML, Anda harus menyertakan file perpustakaan standar, menerapkan makro kategori dengan benar, menangani blok bersarang, dan menerapkan hubungan struktural secara eksplisit.

1. Menginisialisasi Perpustakaan Standar ArchiMate

Untuk membuka makro resmi, palet warna, dan stereotip struktural, blok skrip Anda harus mengimpor file perpustakaan standar tepat di bawah tag awal Anda. Anda dapat secara opsional menerapkan salah satu tema resmi untuk memastikan visibilitas kontras tinggi:

@startuml
!include <archimate/Archimate>
!theme archimate-standard from <archimate/themes>

2. Deklarasi Elemen Menggunakan Makro Kategori

Perpustakaan standar menyederhanakan pembuatan elemen dengan membungkus bentuk bawaan di dalam makro dengan awalan kategori. Elemen mengikuti aturan ketat Kategori_NamaElemen(ID, "Label")konvensi penamaan. Awalan menentukan lapisan struktural dan secara otomatis menyisipkan token warna yang benar:

  • Strategi & Motivasi (Ungu): Motivasi_PemegangKepentingan(), Strategi_Kemampuan()
  • Lapisan Bisnis (Kuning): Bisnis_Aktor(), Bisnis_Proses(), Bisnis_Layanan()
  • Lapisan Aplikasi (Biru): Application_Component(), Application_Service()
  • Lapisan Teknologi (Hijau): Technology_Node(), Technology_SystemSoftware()
!include <archimate/Archimate>
Motivation_Stakeholder(CEO, "Chief Executive Officer")
Application_Component(CRM, "Sistem CRM Salesforce")

3. Menentukan Batas Kelompok dan Penanaman Struktural

Peta perusahaan sangat bergantung pada konten visual untuk mewakili kepemilikan atau isolasi runtime. Anda dapat membuat folder pembatas menggunakan Group() atau Grouping()makro, atau menempatkan elemen di dalam satu sama lain menggunakan kurung kurawal:

!include <archimate/Archimate>
Grouping(AppSubsystem, "Suite Manajemen Pelanggan") {
    Application_Component(AuthMod, "Modul Token OAuth")
    Application_Service(UserReg, "API Pendaftaran Pengguna")
}

4. Memetakan Hubungan Perusahaan yang Diserialkan

ArchiMate mewajibkan penggunaan kosakata ketat untuk koneksi. Alih-alih panah mentah, perpustakaan standar menawarkan makro hubungan khusus yang diformat sebagaiRel_RelationType(ID_Dari, ID_Kepada, "Label"). Untuk memaksa penyesuaian orientasi manual, Anda dapat menambahkan petunjuk arah spasial (seperti_Atas, _Bawah, _Kiri, atau _Right):

!include <archimate/Archimate>

Motivasi_Pemegang_Kepentingan(CEO, "Chief Executive Officer")
Komponen_Aplikasi(CRM, "Sistem CRM Salesforce")

Kelompokkan(AppSubsystem, "Suite Manajemen Pelanggan") {
    Komponen_Aplikasi(AuthMod, "Modul Token OAuth")
    Layanan_Aplikasi(UserReg, "API Pendaftaran Pengguna")
}

' Contoh hubungan struktural & perilaku
Rel_Realisasi(UserReg, AuthMod, "Mengimplementasikan keamanan")
Rel_Melayani_Kanan(CRM, CEO, "Menyediakan dashboard")

Praktik Terbaik untuk Diagram Arsitektur Berlapis

  • Isolasi Lapisan yang Berbeda:Susun skrip Anda secara berurutan dari atas ke bawah (Motivasi > Bisnis > Aplikasi > Teknologi) agar tata letak arsitektur Anda mudah dipahami oleh pemangku kepentingan.
  • Manfaatkan ID Komponen Pendek: Pertahankan string pelacakan makro internal Anda tetap singkat (misalnya, gunakan AP_01 atau Srv_Auth), sementara menyisihkan teks deskriptif yang ditujukan untuk pelanggan pada parameter label yang diapit tanda kutip ganda.
  • Pastikan Arah yang Jelas pada Kabel Antar-Lapisan: Jalur tata letak dapat berubah secara tak terduga saat melewati batas struktural. Gunakan makro berarah seperti Rel_Akses_Bawah() memastikan aliran data Anda bergerak lancar ke bawah melintasi pemisahan lapisan.

Contoh Nyata PlantUML ArchiMate

Contoh 1: Pemetaan Kemampuan Strategis Klasik (Tingkat Motivasi & Strategi)

Rancangan fungsional ini mendokumentasikan lapisan strategis suatu organisasi, menggambarkan bagaimana pemegang kepentingan korporat selaras dengan kemampuan bisnis dan hasil teknis yang telah terwujud.

@startuml
!include <archimate/Archimate>
!theme archimate-standard from <archimate/themes>

title Peta Penyesuaian Perusahaan Strategis

Motivasi_Pemegang_Kepentingan(CFO, "Chief Financial Officer")
Pendorong_Motivasi(CostEfficiency, "Pengurangan Biaya Operasional")
Kemampuan_Strategi(AutomatedBilling, "Otomasi Penagihan Perusahaan")
Proses_Bisnis(InvoiceRun, "Rekonsiliasi Buku Besar Akhir Bulan")

' Kaitkan ketergantungan strategis
Rel_Assosiasi(CFO, CostEfficiency, "Berupaya untuk meningkatkan")
Rel_Pengaruh(AutomatedBilling, CostEfficiency, "Berdampak positif")
Rel_Realisasi(InvoiceRun, AutomatedBilling, "Memenuhi kemampuan")
@enduml

Analisis Sintaks: Dengan mengeksekusi makro strategis berwarna ungu, mesin memetakan elemen-elemen secara bersih. Makro relasional yang jelas menghubungkan pemegang kepentingan manusia turun melalui motivasi organisasi, menyesuaikan strategi korporat secara bersih dengan perilaku pelaksanaan yang mendasarinya.

Contoh 2: Sistem Perusahaan Tiga Lapisan Akhir ke Akhir (Jaringan Antar-Lapisan)

Rancangan lanjutan ini menunjukkan topologi arsitektur lintas lapisan yang komprehensif. Ini memetakan proses bisnis operasional turun melalui mikroservis aplikasi pendukung hingga host infrastruktur awan yang mendasarinya.

@startuml
!include <archimate/Archimate>
!theme archimate-standard from <archimate/themes>

title Penyelarasan Arsitektur Aplikasi Multi-Tier

Grouping(BizLayer, "Operasi Bisnis") {
    Business_Actor(Agent, "Agen Dukungan Layanan Pelanggan")
    Business_Process(Ticketing, "Proses Tiket Dukungan Perusahaan")
}

Grouping(AppLayer, "Ekosistem Aplikasi") {
    Application_Service(TicketSvc, "API Integrasi Zendesk")
    Application_Component(DataRouter, "Mesin Pemrosesan Event")
}

Grouping(TechLayer, "Lapisan Infrastruktur") {
    Technology_SystemSoftware(K8sCluster, "Klaster Orkestrasi Kubernetes")
    Technology_Node(CloudVM, "Target Komputasi AWS EC2 m6i.xlarge")
}

' Membuat pemetaan lintas lapisan secara mulus menggunakan petunjuk arah
Rel_Assignment(Agent, Ticketing, "Melaksanakan setiap hari")
Rel_Serving_Down(TicketSvc, Ticketing, "Menghidupkan antarmuka web desk")

Rel_Composition(DataRouter, TicketSvc, "Menerima webhook dari")
Rel_Realization_Down(K8sCluster, DataRouter, "Menyediakan container aplikasi")

Rel_Composition_Down(CloudVM, K8sCluster, "Menyediakan hypervisor inti bare-metal")
@enduml

Analisis Sintaks: Peta ini menyoroti kekuatan dari struktur Grouping komponen. Elemen secara otomatis menerima warna khusus lapisan (Kuning, Biru, Hijau) berdasarkan keluarga makro mereka. Ovverride hubungan berarah seperti Rel_Serving_Down dan Rel_Realization_Down memaksa ketergantungan untuk mengalir secara elegan turun ke seluruh jaringan perusahaan.

Scroll to Top