---
title: "Business Logic — KKW01027SF01DBean.listKoumokuIds()"
tags: ["business-logic", "DD"]
created: "2026-07-28"
---

# Business Logic — KKW01027SF01DBean.listKoumokuIds() [11 LOC]

| Field | Value |
|-------|-------|
| Fully Qualified Name | `eo.web.webview.KKA15001SF.KKW01027SF01DBean` |
| Layer | Webview / View Data Bean (Web Client Layer) |
| Module | `KKA15001SF` (Package: `eo.web.webview.KKA15001SF`) |

## 1. Role

### KKW01027SF01DBean.listKoumokuIds()

This method acts as a **static factory** that provides the ordered list of field identifiers (item names / koumoku ids) for the **discount service contract registration** data type bean (`KKW01027SF01DBean`). The bean is part of the `KKA15001SF` module, which implements the discount service contract registration screen (`KKW01027SF`) — a business feature that allows operators to register and manage discount-type service contracts within the K-Opticom telecom system. The returned list defines the sequence and set of editable fields presented on the customer contract inheritance list screen, which includes system tracking metadata (SSSID, service contract number), migration/change management data (migration division, reason code, reason memo), and application routing identifiers (application number, application detail number). The method follows a **routing/dispatch pattern** — it is not called directly by screens, but instead is routed through the parent bean `KKW01027SFBean.listKoumokuIds(String key)` when the screen requests the item list for the "Customer Contract Inheritance List" data type bean item. As a shared utility method, it serves multiple similar data type beans across the webview layer (e.g., `FUW00912SF01DBean`, `FUW00926SF01DBean`), providing a reusable contract metadata list.

## 2. Processing Pattern (Detailed Business Logic)

```mermaid
flowchart TD
    START(["listKoumokuIds()"])
    STEP1["Create new ArrayList<String> koumokuList"]
    STEP2["Add SSSID to list"]
    STEP3["Add service contract number to list"]
    STEP4["Add migration division to list"]
    STEP5["Add migration reason code to list"]
    STEP6["Add migration reason memo to list"]
    STEP7["Add application number to list"]
    STEP8["Add application detail number to list"]
    END_NODE["Return koumokuList"]

    START --> STEP1
    STEP1 --> STEP2
    STEP2 --> STEP3
    STEP3 --> STEP4
    STEP4 --> STEP5
    STEP5 --> STEP6
    STEP6 --> STEP7
    STEP7 --> STEP8
    STEP8 --> END_NODE
```

The method has no conditional branches, constants, loops, or method calls beyond ArrayList operations. It follows a linear, sequential construction pattern: instantiate a new `ArrayList`, populate it with exactly 7 field identifiers in domain-defined order, and return. The ordering of items in the returned list determines the column/field order presented on the data type bean-type screen.

## 3. Parameter Analysis

| No | Parameter Name | Type | Business Description |
|----|---------------|------|---------------------|
| - | (none) | - | This is a static method with no parameters. The returned list is hardcoded and applies to all invocations of the `KKW01027SF01DBean` data type bean. |

## 4. CRUD Operations / Called Services

| CRUD | SC / CBS | SC Code | Entity / DB | Operation Description |
|------|----------|---------|-------------|----------------------|
| (No external calls) | - | - | - | This method performs only in-memory ArrayList construction and population. No service components (SC), CBS, or database operations are invoked. |

The only method calls are `ArrayList.add()` operations (Java standard library), which are data structure operations rather than CRUD business operations.

## 5. Dependency Trace

| # | Caller (Screen/Batch) | Call Chain (Full Path to this Method) | Terminal (SC / CRUD / Entity) |
|---|----------------------|--------------------------------------|-------------------------------|
| 1 | Screen:KKW01027SF | `KKW01027SFBean.listKoumokuIds("顧客契約引継リスト")` -> `KKW01027SF01DBean.listKoumokuIds()` | (none — no terminal CRUD) |

**Caller Details:**

The only known caller is `KKW01027SFBean` (the parent/harvester bean for the KKW01027SF discount service contract registration screen) in file `KKA15001SF/KKW01027SFBean.java` at line 2910. The call chain is:

```
Screen:KKW01027SF -> KKW01027SFBean.listKoumokuIds(String key) -> KKW01027SF01DBean.listKoumokuIds()
```

The parent bean routes the call when the `key` parameter equals `"顧客契約引継リスト"` (Customer Contract Inheritance List), which is a data type bean-type screen item ID. The method returns the field list for that specific screen item. No other classes reference `KKW01027SF01DBean.listKoumokuIds()` directly.

## 6. Per-Branch Detail Blocks

> This method has no conditional branches. It follows a single linear execution path.

**Block 1** — [LINEAR] `(no condition)` (L487)

> Create and populate the list of item names for the data type bean screen. The javadoc states: データタイプビーンの項目名のリストを返す。(Returns the list of item names for the data type bean.)

| # | Type | Code | Business Description |
|---|------|------|---------------------|
| 1 | SET | `ArrayList<String> koumokuList = new ArrayList<String>()` | Instantiate a new mutable ArrayList for string values |
| 2 | CALL | `koumokuList.add("SSSID")` | Add system tracking ID field identifier |
| 3 | CALL | `koumokuList.add("サービス契約番号")` | Add service contract number field identifier |
| 4 | CALL | `koumokuList.add("異動区分")` | Add migration division (change category) field identifier |
| 5 | CALL | `koumokuList.add("異動理由コード")` | Add migration reason code field identifier |
| 6 | CALL | `koumokuList.add("異動理由メモ")` | Add migration reason memo field identifier |
| 7 | CALL | `koumokuList.add("申請番号")` | Add application number field identifier |
| 8 | CALL | `koumokuList.add("申請明細番号")` | Add application detail number field identifier |
| 9 | RETURN | `return koumokuList` | Return the completed list of 7 item names |

**Block 2** — [LINEAR] `(no condition)` (L496)

> Method end. The returned `ArrayList` contains 7 strings that define the field order for the data type bean-type screen item "Customer Contract Inheritance List" on the KKW01027SF discount service contract registration screen.

| # | Type | Code | Business Description |
|---|------|------|---------------------|
| 1 | RETURN | `return koumokuList` | Returns the fully populated list to the caller |

## 7. Glossary

| Term | Type | Business Meaning |
|------|------|------------------|
| `SSSID` | Field | System screen identifier — internal tracking ID used by the X33 web framework to identify the screen session |
| `サービス契約番号` | Field | Service contract number — the unique identifier for a telecom service contract in the K-Opticom system |
| `異動区分` | Field | Migration division — categorizes the type of contract change (e.g., addition, modification, cancellation) |
| `異動理由コード` | Field | Migration reason code — a coded value explaining why the contract change was performed |
| `異動理由メモ` | Field | Migration reason memo — free-text comment providing additional context for the contract change |
| `申請番号` | Field | Application number — the unique identifier for a service registration/change application |
| `申請明細番号` | Field | Application detail number — a sub-identifier linking to a specific line item within a broader application |
| KKW01027SF | Screen ID | Discount service contract registration screen — the business screen for registering and managing discount-type telecom service contracts |
| KKA15001SF | Module | Web view module housing the data type beans for the KKW01027SF screen |
| KKW01027SF01DBean | Data Bean | Discount service contract data type bean — implements `X33VDataTypeBeanInterface` and `X33VListedBeanInterface` for the customer contract inheritance list screen item |
| KKW01027SFBean | Parent Bean | Harvester bean that routes `listKoumokuIds(String key)` calls to the appropriate child data type bean based on the key parameter |
| data type bean | Pattern | A design pattern in the X33 framework where a bean implements `X33VDataTypeBeanInterface` to provide metadata (field names, types) for dropdown/list screens |
| X33 | Framework | Fujitsu Futurity X33 web application framework — the underlying MVC framework for K-Opticom's web screens |
| 顧客契約引継リスト | Screen Item | Customer contract inheritance list — the data type bean-type screen item name that triggers the call to `listKoumokuIds()` |