Skip to content

Commit 1d9e307

Browse files
updated ServiceTechnician/doc/spec_JA.md
1 parent 4c0560b commit 1d9e307

File tree

1 file changed

+298
-0
lines changed

1 file changed

+298
-0
lines changed

ServiceTechnician/doc/spec_JA.md

Lines changed: 298 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,298 @@
1+
<!-- 10-Header -->
2+
[![Smart Data Models](https://smartdatamodels.org/wp-content/uploads/2022/01/SmartDataModels_logo.png "Logo")](https://smartdatamodels.org)
3+
エンティティサービステクニシャン
4+
================<!-- /10-Header -->
5+
<!-- 15-License -->
6+
[オープン・ライセンス](https://github.com/smart-data-models//dataModel.PredictiveMaintenance/blob/master/ServiceTechnician/LICENSE.md)
7+
[文書が自動的に生成される](https://docs.google.com/presentation/d/e/2PACX-1vTs-Ng5dIAwkg91oTTUdt8ua7woBXhPnwavZ0FxgR8BsAI_Ek3C5q97Nd94HS8KhP-r_quD4H0fgyt3/pub?start=false&loop=false&delayms=3000#slide=id.gb715ace035_0_60)
8+
<!-- /15-License -->
9+
<!-- 20-Description -->
10+
グローバルな説明**サービスを提供するメンテナンス事業者を表す。
11+
バージョン: 0.0.1
12+
<!-- /20-Description -->
13+
<!-- 30-PropertiesList -->
14+
15+
## プロパティのリスト
16+
17+
<sup><sub>[*] 属性に型がない場合は、複数の型があるか、異なるフォーマット/パターンがある可能性があるためです</sub></sup>。
18+
- `calendar[array]`: リストプロパティ予定されている活動のリスト。 - `geographicalArea[string]`: 地域と場所の定義。 - `hasSkill[array]`: リストプロパティ能力と経験の説明 - `historicalService[array]`: リストプロパティ。マネージドサービスのリスト。 - `organization[string]`: 技術者が所属する組織(PRIMA 支店または外部オフィス)。 - `referenceAddress[string]`: スタートポジション(オフィスと自宅)。 - `toolProvided[array]`: リストプロパティ技術設備(すべてのチームに特別な設備が提供されるとは限らない)。 - `type[string]`: エンティティのタイプ(ServiceTechnician)。 <!-- /30-PropertiesList -->
19+
<!-- 35-RequiredProperties -->
20+
必須プロパティ
21+
- `calendar` - `geographicalArea` - `hasSkill` - `historicalService` - `id` - `organization` - `referenceAddress` - `toolProvided` - `type` <!-- /35-RequiredProperties -->
22+
<!-- 40-NotesYaml -->
23+
<!-- /40-NotesYaml -->
24+
<!-- 50-DataModelHeader -->
25+
## プロパティのデータモデル記述
26+
アルファベット順(クリックで詳細表示)
27+
<!-- /50-DataModelHeader -->
28+
<!-- 60-ModelYaml -->
29+
<details><summary><strong>full yaml details</strong></summary>
30+
```yaml
31+
ServiceTechnician:
32+
description: Represent a maintenance operator providing the service
33+
properties:
34+
calendar:
35+
description: ListProperty. List of planned activities.
36+
items:
37+
description: Calendar of activities for the period already planned.
38+
format: date
39+
type: string
40+
x-ngsi:
41+
type: Property
42+
type: array
43+
geographicalArea:
44+
description: Definition of the area and location.
45+
type: string
46+
x-ngsi:
47+
type: Property
48+
hasSkill:
49+
description: ListProperty. Description of capabilities and experiences.
50+
items:
51+
description: Description of capabilities and experiences.
52+
format: uri
53+
type: string
54+
x-ngsi:
55+
type: Relationship
56+
type: array
57+
historicalService:
58+
description: ListProperty. List of managed services.
59+
items:
60+
description: Managed service.
61+
format: date
62+
type: string
63+
x-ngsi:
64+
type: Property
65+
type: array
66+
organization:
67+
description: Organization to which the technician belongs (PRIMA branch or external office).
68+
type: string
69+
x-ngsi:
70+
type: Property
71+
referenceAddress:
72+
description: Starting position (Office and Home).
73+
type: string
74+
x-ngsi:
75+
type: Property
76+
toolProvided:
77+
description: ListProperty. Technical equipment (special equipment not always provided for all teams).
78+
items:
79+
description: Name of the required tool.
80+
type: string
81+
x-ngsi:
82+
type: Property
83+
type: array
84+
type:
85+
description: The type of the entity (ServiceTechnician).
86+
type: string
87+
x-ngsi:
88+
type: Property
89+
required:
90+
- id
91+
- type
92+
- organization
93+
- hasSkill
94+
- toolProvided
95+
- geographicalArea
96+
- referenceAddress
97+
- calendar
98+
- historicalService
99+
type: object
100+
x-derived-from: ''
101+
x-disclaimer: Redistribution and use in source and binary forms, with or without modification, are permitted provided that the license conditions are met. Copyleft (c) 2025 Contributors to Smart Data Models Program
102+
x-license-url: https://github.com/smart-data-models/dataModel.PredictiveMaintenance/blob/master/ServiceTechnician/LICENSE.md
103+
x-model-schema: https://smart-data-models.github.io/dataModel.PredictiveMaintenance/ServiceTechnician/schema.json
104+
x-model-tags: maintenace
105+
x-version: 0.0.1
106+
```
107+
</details>
108+
<!-- /60-ModelYaml -->
109+
<!-- 70-MiddleNotes -->
110+
<!-- /70-MiddleNotes -->
111+
<!-- 80-Examples -->
112+
## ペイロードの例
113+
#### ServiceTechnician NGSI-v2 キー値の例
114+
JSON-LD形式のServiceTechnicianのkey-valuesの例である。これはNGSI-v2と互換性があり、`options=keyValues`を使用すると個々のエンティティのコンテキストデータを返す。
115+
<details><summary><strong>show/hide example</strong></summary>
116+
```json
117+
{
118+
"id": "https://smart-data-models.github.io/dataModel.PredictiveMaintenance/ServiceTechnician/serviceTechnician01",
119+
"type": "ServiceTechnician",
120+
"organization": "PRIMA Branch A",
121+
"hasSkill": [
122+
"MaintenanceSkill:maintenanceSkillID"
123+
],
124+
"toolProvided": [
125+
"Multimeter",
126+
"Screwdriver Set",
127+
"Pliers Set"
128+
],
129+
"geographicalArea": "North Region",
130+
"referenceAddress": "123 Main Street, Anytown, USA",
131+
"calendar": [
132+
"2023-10-01",
133+
"2023-10-05",
134+
"2023-10-10"
135+
],
136+
"historicalService": [
137+
"2023-09-15",
138+
"2023-09-20",
139+
"2023-09-25"
140+
]
141+
}
142+
```
143+
</details>
144+
#### サービス技術者 NGSI-v2 正規化例
145+
以下は、正規化された JSON-LD 形式の ServiceTechnician の例である。これは、オプションを使用しない場合、NGSI-v2と互換性があり、個々のエンティティのコンテキストデータを返します。
146+
<details><summary><strong>show/hide example</strong></summary>
147+
```json
148+
{
149+
"id": "urn:ngsi-ld:dataModel.PredictiveMaintenance:ServiceTechnician:serviceTechnician01",
150+
"type": "ServiceTechnician",
151+
"organization": {
152+
"type": "Text",
153+
"value": "PRIMA Branch A"
154+
},
155+
"hasSkill": {
156+
"type": "ListProperty",
157+
"value": [
158+
{
159+
"type": "Relationship",
160+
"id": "MaintenanceSkill:maintenanceSkill01"
161+
}
162+
]
163+
},
164+
"toolProvided": {
165+
"type": "Text",
166+
"value": [
167+
"Multimeter",
168+
"Screwdriver Set",
169+
"Pliers Set"
170+
]
171+
},
172+
"geographicalArea": {
173+
"type": "Text",
174+
"value": "North Region"
175+
},
176+
"referenceAddress": {
177+
"type": "Text",
178+
"value": "123 Main Street, Anytown, USA"
179+
},
180+
"calendar": {
181+
"type": "Date",
182+
"value": [
183+
"2023-10-01",
184+
"2023-10-05",
185+
"2023-10-10"
186+
]
187+
},
188+
"historicalService": {
189+
"type": "Date",
190+
"value": [
191+
"2023-09-15",
192+
"2023-09-20",
193+
"2023-09-25"
194+
]
195+
}
196+
}
197+
```
198+
</details>
199+
#### サービス技術者 NGSI-LD キー値の例
200+
JSON-LD形式のServiceTechnicianのkey-valuesの例である。これは NGSI-LD と互換性があり、`options=keyValues` を使用すると個々のエンティティのコンテキストデータを返す。
201+
<details><summary><strong>show/hide example</strong></summary>
202+
```json
203+
{
204+
"@context": [
205+
"https://smartdatamodels.org/context.jsonld"
206+
],
207+
"type": "ServiceTechnician",
208+
"id": "https://smart-data-models.github.io/dataModel.PredictiveMaintenance/ServiceTechnician/serviceTechnician01",
209+
"organization": "PRIMA Branch A",
210+
"hasSkill": [
211+
"MaintenanceSkill:maintenanceSkillID"
212+
],
213+
"toolProvided": [
214+
"Multimeter",
215+
"Screwdriver Set",
216+
"Pliers Set"
217+
],
218+
"geographicalArea": "North Region",
219+
"referenceAddress": "123 Main Street, Anytown, USA",
220+
"calendar": [
221+
"2023-10-01",
222+
"2023-10-05",
223+
"2023-10-10"
224+
],
225+
"historicalService": [
226+
"2023-09-15",
227+
"2023-09-20",
228+
"2023-09-25"
229+
]
230+
}
231+
```
232+
</details>
233+
#### サービス技術者 NGSI-LD 正規化例
234+
以下は、正規化されたJSON-LD形式のServiceTechnicianの例である。これは、オプションを使用しない場合はNGSI-LDと互換性があり、個々のエンティティのコンテキストデータを返します。
235+
<details><summary><strong>show/hide example</strong></summary>
236+
```json
237+
{
238+
"@context": [
239+
"https://smartdatamodels.org/context.jsonld"
240+
],
241+
"id": "https://smart-data-models.github.io/dataModel.PredictiveMaintenance/ServiceTechnician/serviceTechnician01",
242+
"type": "ServiceTechnician",
243+
"organization": {
244+
"type": "Property",
245+
"value": "PRIMA Branch A"
246+
},
247+
"hasSkill": {
248+
"type": "ListProperty",
249+
"value": [
250+
{
251+
"type": "Relationship",
252+
"object": "urn:ngsi-ld:dataModel.PredictiveMaintenance:MaintenanceSkill:maintenanceSkill01"
253+
}
254+
]
255+
},
256+
"toolProvided": {
257+
"type": "ListProperty",
258+
"value": [
259+
"Multimeter",
260+
"Screwdriver Set",
261+
"Pliers Set"
262+
]
263+
},
264+
"geographicalArea": {
265+
"type": "Property",
266+
"value": "North Region"
267+
},
268+
"referenceAddress": {
269+
"type": "Property",
270+
"value": "123 Main Street, Anytown, USA"
271+
},
272+
"calendar": {
273+
"type": "Property",
274+
"value": [
275+
"2023-10-01",
276+
"2023-10-05",
277+
"2023-10-10"
278+
]
279+
},
280+
"historicalService": {
281+
"type": "Property",
282+
"value": [
283+
"2023-09-15",
284+
"2023-09-20",
285+
"2023-09-25"
286+
]
287+
}
288+
}
289+
```
290+
</details><!-- /80-Examples -->
291+
<!-- 90-FooterNotes -->
292+
<!-- /90-FooterNotes -->
293+
<!-- 95-Units -->
294+
マグニチュード単位の扱い方については、[FAQ 10](https://smartdatamodels.org/index.php/faqs/)を参照のこと。
295+
<!-- /95-Units -->
296+
<!-- 97-LastFooter -->
297+
---
298+
[Smart Data Models](https://smartdatamodels.org) +++ [Contribution Manual](https://bit.ly/contribution_manual) +++ [About](https://bit.ly/Introduction_SDM)<!-- /97-LastFooter -->

0 commit comments

Comments
 (0)