Deliverable Templates — Linked.Archi

Process Documentation

A BPMN-based process documentation covering process flows, participant collaborations, and conversation overviews. Suitable for process owners, business analysts, and compliance reviews.

Template: templates/process-documentation.md.hbs

Required Viewpoints: ProcessFlow CollaborationDiagram ConversationDiagram

Target Purposes: Informing, Designing

Available Formats: MarkdownFormat, HTMLFormat

Sections

1 1. Process Flows

Sequence of activities within each business process.

Viewpoint: ProcessFlow Result key: processFlows

SPARQL Query

PREFIX bpmn: <https://meta.linked.archi/bpmn/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?element ?label ?type ?description ?process WHERE {
    ?element a ?type ;
             skos:prefLabel ?label .
    VALUES ?type {
        bpmn:Task bpmn:UserTask bpmn:ServiceTask bpmn:ScriptTask
        bpmn:BusinessRuleTask bpmn:ManualTask bpmn:SendTask bpmn:ReceiveTask
        bpmn:SubProcess bpmn:CallActivity
        bpmn:ExclusiveGateway bpmn:ParallelGateway bpmn:InclusiveGateway
        bpmn:EventBasedGateway bpmn:ComplexGateway
        bpmn:StartEvent bpmn:EndEvent bpmn:IntermediateCatchEvent
        bpmn:IntermediateThrowEvent bpmn:BoundaryEvent
    }
    OPTIONAL { ?element skos:definition ?description }
    OPTIONAL {
        ?proc bpmn:hasFlowElement ?element .
        ?proc a bpmn:Process .
        ?proc skos:prefLabel ?process .
        FILTER(lang(?process) = "en")
    }
    FILTER(lang(?label) = "en")
} ORDER BY ?process ?type ?label

2 2. Participant Collaborations

Interactions between participants via message flows.

Viewpoint: CollaborationDiagram Result key: collaborations

SPARQL Query

PREFIX bpmn: <https://meta.linked.archi/bpmn/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?collaboration ?collabLabel ?participant ?participantLabel ?messageFlow ?messageFlowLabel WHERE {
    ?collaboration a bpmn:Collaboration ;
                   skos:prefLabel ?collabLabel .
    OPTIONAL {
        ?participant a bpmn:Participant ;
                     bpmn:inCollaboration ?collaboration ;
                     skos:prefLabel ?participantLabel .
        FILTER(lang(?participantLabel) = "en")
    }
    OPTIONAL {
        ?messageFlow a bpmn:MessageFlow ;
                     skos:prefLabel ?messageFlowLabel .
        FILTER(lang(?messageFlowLabel) = "en")
    }
    FILTER(lang(?collabLabel) = "en")
} ORDER BY ?collabLabel ?participantLabel

3 3. Conversation Overview

High-level communication topics between participants.

Viewpoint: ConversationDiagram Result key: conversations

SPARQL Query

PREFIX bpmn: <https://meta.linked.archi/bpmn/onto#>
PREFIX skos: <http://www.w3.org/2004/02/skos/core#>

SELECT ?conversation ?conversationLabel ?participant ?participantLabel WHERE {
    ?conversation a bpmn:Conversation ;
                  skos:prefLabel ?conversationLabel .
    OPTIONAL {
        ?participant a bpmn:Participant ;
                     skos:prefLabel ?participantLabel .
        FILTER(lang(?participantLabel) = "en")
    }
    FILTER(lang(?conversationLabel) = "en")
} ORDER BY ?conversationLabel ?participantLabel

📄 Template Preview

---
title: "Process Documentation"
date: "{{meta.date}}"
author: "{{meta.author}}"
status: "{{meta.status}}"
version: "{{meta.version}}"
---

# Process Documentation

{{#if meta.description}}
> {{meta.description}}
{{/if}}

| Property | Value |
|----------|-------|
| Date | {{meta.date}} |
| Author | {{meta.author}} |
| Status | {{meta.status}} |
| Version | {{meta.version}} |
| Metamodel | BPMN 2.0.2 |

---

## 1. Process Flows

Sequence of activities within each business process.

{{#if views.processFlows.diagram}}
![Process Flow Diagram]({{views.processFlows.diagram}})
{{/if}}

### Flow Elements

| Element | Type | Process | Description |
|---------|------|---------|-------------|
{{#each processFlows}}
| {{this.label}} | {{this.type}} | {{this.process}} | {{this.description}} |
{{/each}}

---

## 2. Participant Collaborations

Interactions between participants via message flows.

{{#if views.collaborations.diagram}}
![Collaboration Diagram]({{views.collaborations.diagram}})
{{/if}}

### Collaborations & Participants

| Collaboration | Participant | Message Flow |
|---------------|-------------|-------------|
{{#each collaborations}}
| {{this.collabLabel}} | {{this.participantLabel}} | {{this.messageFlowLabel}} |
{{/each}}

---

## 3. Conversation Overview

High-level communication topics between participants.

{{#if views.conversations.diagram}}
![Conversation Diagram]({{views.conversations.diagram}})
{{/if}}

### Conversations

| Conversation | Participant |
|-------------|-------------|
{{#each conversations}}
| {{this.conversationLabel}} | {{this.participantLabel}} |
{{/each}}