open-grid 1.3.1 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +28 -0
- package/README.ja.md +462 -0
- package/README.md +52 -18
- package/README.zh.md +455 -0
- package/dist/{OpenGrid-B7m7ei7f.cjs → OpenGrid-BOtTt5aI.cjs} +2 -2
- package/dist/{OpenGrid-CeUdO_fM.js → OpenGrid-sI_vdHQw.js} +2 -2
- package/dist/Registry-CPJYOqCn.js +74 -0
- package/dist/Registry-D74ZmdDz.cjs +71 -0
- package/dist/index-B3fKi43v.js +481 -0
- package/dist/{index-JjfWY3Bt.cjs → index-D1l3XFCM.cjs} +92 -160
- package/dist/open-grid-react.cjs +1 -1
- package/dist/open-grid-react.js +1 -1
- package/dist/open-grid-vue.cjs +1 -1
- package/dist/open-grid-vue.js +1 -1
- package/dist/open-grid.cjs +31 -31
- package/dist/open-grid.js +86 -82
- package/dist/types/core/FilterSelect.d.ts +269 -33
- package/dist/types/core/GridShuttle.d.ts +160 -24
- package/dist/types/core/IconRegistry.d.ts +241 -33
- package/dist/types/core/OpenGrid.d.ts +2589 -327
- package/dist/types/core/OrgChart.d.ts +249 -32
- package/dist/types/core/SkinRegistry.d.ts +295 -60
- package/dist/types/core/XmlConverter.d.ts +388 -47
- package/dist/types/core/chart/types.d.ts +1008 -126
- package/dist/types/core/extension/Registry.d.ts +389 -51
- package/dist/types/core/extension/reserved.d.ts +34 -5
- package/dist/types/core/i18n/LocaleRegistry.d.ts +271 -54
- package/dist/types/core/i18n/types.d.ts +636 -85
- package/dist/types/core/types.d.ts +3576 -426
- package/dist/types/index.d.ts +226 -17
- package/package.json +3 -1
- package/dist/index-DrCPRuYi.js +0 -548
|
@@ -1,71 +1,282 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* XmlConverter — XML ↔ 그리드 데이터 양방향 변환 유틸리티.
|
|
3
|
-
*
|
|
3
|
+
*
|
|
4
|
+
* XmlConverter — bidirectional XML ↔ grid-data conversion utility.
|
|
5
|
+
*
|
|
6
|
+
* XmlConverter — XML ↔ グリッドデータの双方向変換ユーティリティ。
|
|
7
|
+
*
|
|
8
|
+
* XmlConverter — XML ↔ 表格数据的双向转换工具。
|
|
4
9
|
*
|
|
5
10
|
* SAP·레거시 백엔드처럼 JSON이 아니라 XML로 응답을 주는 시스템과 그리드를 연결할 때 쓴다.
|
|
6
11
|
* 데이터가 흐르는 방향은 두 가지다: **입력**(서버가 준 XML 문자열) → **변환**(태그/속성을
|
|
7
12
|
* 파싱해 행 객체 배열로 정규화) → **출력**(그리드가 바로 `setData()`에 넣을 수 있는
|
|
8
13
|
* `Record<string, any>[]`). 반대 방향(그리드에서 편집한 데이터 → XML)도 동일한 변환기로 처리한다.
|
|
9
|
-
*
|
|
14
|
+
*
|
|
15
|
+
* Use this to bridge the grid with systems that answer in XML instead of JSON — SAP and other
|
|
10
16
|
* legacy backends being the common case. Data flows in two directions: **input** (the XML string
|
|
11
17
|
* a server returned) → **transform** (tags/attributes parsed and normalized into row objects) →
|
|
12
18
|
* **output** (a `Record<string, any>[]` the grid can pass straight to `setData()`). The reverse
|
|
13
19
|
* direction (grid-edited data → XML) goes through the same converter.
|
|
14
20
|
*
|
|
15
|
-
*
|
|
21
|
+
* SAP やレガシーバックエンドのように、JSON ではなく XML でレスポンスを返すシステムとグリッドを
|
|
22
|
+
* つなぐときに使います。データが流れる方向は 2 つです: **入力**(サーバーが返した XML 文字列) →
|
|
23
|
+
* **変換**(タグ/属性をパースして行オブジェクトの配列に正規化) → **出力**(グリッドがそのまま
|
|
24
|
+
* `setData()` に渡せる `Record<string, any>[]`)。逆方向(グリッドで編集したデータ → XML)も
|
|
25
|
+
* 同じ変換器で処理します。
|
|
26
|
+
*
|
|
27
|
+
* 用于把表格接入 SAP 等以 XML 而非 JSON 返回响应的系统,遗留后端是常见场景。数据有两个流向:
|
|
28
|
+
* **输入**(服务器返回的 XML 字符串)→ **转换**(解析标签/属性,归一化为行对象数组)→ **输出**
|
|
29
|
+
* (表格可直接传给 `setData()` 的 `Record<string, any>[]`)。反方向(表格中编辑的数据 → XML)
|
|
30
|
+
* 由同一个转换器处理。
|
|
31
|
+
*
|
|
32
|
+
* 지원 포맷:
|
|
33
|
+
*
|
|
34
|
+
* Supported formats:
|
|
35
|
+
*
|
|
36
|
+
* 対応フォーマット:
|
|
37
|
+
*
|
|
38
|
+
* 支持的格式:
|
|
39
|
+
*
|
|
16
40
|
* A. Element 방식 <row><name>홍길동</name></row>
|
|
17
41
|
* B. Attribute 방식 <row name="홍길동" />
|
|
18
42
|
* C. SAP BAPI XML 응답 <RETURN><TYPE>S</TYPE><BELNR>...</BELNR></RETURN>
|
|
19
43
|
* D. SAP IDoc XML <IDOC><E1HEADER SEGMENT="1"><BUKRS>1000</BUKRS></IDOC>
|
|
20
44
|
*
|
|
21
45
|
* 외부 의존성 없음 — 브라우저 내장 DOMParser 사용.
|
|
22
|
-
*
|
|
46
|
+
*
|
|
47
|
+
* No external dependency — uses the browser's built-in DOMParser.
|
|
48
|
+
*
|
|
49
|
+
* 外部依存なし — ブラウザ内蔵の DOMParser を使用。
|
|
50
|
+
*
|
|
51
|
+
* 无外部依赖 — 使用浏览器内置的 DOMParser。
|
|
52
|
+
*/
|
|
53
|
+
/**
|
|
54
|
+
* XML → 데이터 파싱 옵션.
|
|
55
|
+
*
|
|
56
|
+
* Options for parsing XML into data.
|
|
57
|
+
*
|
|
58
|
+
* XML → データのパースオプション。
|
|
59
|
+
*
|
|
60
|
+
* XML → 数据的解析选项。
|
|
23
61
|
*/
|
|
24
|
-
/** XML → 데이터 파싱 옵션. / Options for parsing XML into data. */
|
|
25
62
|
export interface XmlParseOptions {
|
|
26
|
-
/**
|
|
63
|
+
/**
|
|
64
|
+
* 루트 엘리먼트 태그명. 생략 시 문서 루트 자동 사용.
|
|
65
|
+
*
|
|
66
|
+
* Root element tag name; falls back to the document root when omitted.
|
|
67
|
+
*
|
|
68
|
+
* ルート要素のタグ名。省略時は文書ルートを自動で使用。
|
|
69
|
+
*
|
|
70
|
+
* 根元素的标签名;省略时回退到文档根元素。
|
|
71
|
+
*/
|
|
27
72
|
rootTag?: string;
|
|
28
|
-
/**
|
|
73
|
+
/**
|
|
74
|
+
* 행 엘리먼트 태그명. 생략 시 루트의 첫 번째 자식 자동 감지.
|
|
75
|
+
*
|
|
76
|
+
* Row element tag name; auto-detected from the root's first child when omitted.
|
|
77
|
+
*
|
|
78
|
+
* 行要素のタグ名。省略時はルートの最初の子要素から自動検出。
|
|
79
|
+
*
|
|
80
|
+
* 行元素的标签名;省略时从根元素的第一个子元素自动检测。
|
|
81
|
+
*/
|
|
29
82
|
rowTag?: string;
|
|
30
|
-
/**
|
|
83
|
+
/**
|
|
84
|
+
* 값 추출 방식: 'element' | 'attribute' | 'auto'(기본).
|
|
85
|
+
*
|
|
86
|
+
* Value extraction mode: 'element' | 'attribute' | 'auto' (default).
|
|
87
|
+
*
|
|
88
|
+
* 値の抽出方式: 'element' | 'attribute' | 'auto'(既定)。
|
|
89
|
+
*
|
|
90
|
+
* 值的提取方式: 'element' | 'attribute' | 'auto'(默认)。
|
|
91
|
+
*
|
|
92
|
+
* @defaultValue 'auto'
|
|
93
|
+
*/
|
|
31
94
|
mode?: 'element' | 'attribute' | 'auto';
|
|
32
|
-
/**
|
|
95
|
+
/**
|
|
96
|
+
* XML 태그명 → 그리드 field명 매핑. 생략 시 태그명 그대로 사용.
|
|
97
|
+
*
|
|
98
|
+
* XML tag name → grid field name map; tag names are used as-is when omitted.
|
|
99
|
+
*
|
|
100
|
+
* XML タグ名 → グリッド field 名のマッピング。省略時はタグ名をそのまま使用。
|
|
101
|
+
*
|
|
102
|
+
* XML 标签名 → 表格 field 名的映射;省略时直接使用标签名。
|
|
103
|
+
*/
|
|
33
104
|
fieldMap?: Record<string, string>;
|
|
34
|
-
/**
|
|
105
|
+
/**
|
|
106
|
+
* 텍스트 값 앞뒤 공백 제거. 기본 true.
|
|
107
|
+
*
|
|
108
|
+
* Trim whitespace around text values. Default true.
|
|
109
|
+
*
|
|
110
|
+
* テキスト値の前後の空白を除去。既定は true。
|
|
111
|
+
*
|
|
112
|
+
* 去除文本值前后的空白。默认为 true。
|
|
113
|
+
*
|
|
114
|
+
* @defaultValue true
|
|
115
|
+
*/
|
|
35
116
|
trim?: boolean;
|
|
36
117
|
}
|
|
37
|
-
/**
|
|
118
|
+
/**
|
|
119
|
+
* 데이터 → XML 직렬화 옵션.
|
|
120
|
+
*
|
|
121
|
+
* Options for serializing data into XML.
|
|
122
|
+
*
|
|
123
|
+
* データ → XML のシリアライズオプション。
|
|
124
|
+
*
|
|
125
|
+
* 数据 → XML 的序列化选项。
|
|
126
|
+
*/
|
|
38
127
|
export interface XmlStringifyOptions {
|
|
39
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* 루트 태그명. 기본 'rows'.
|
|
130
|
+
*
|
|
131
|
+
* Root tag name. Default 'rows'.
|
|
132
|
+
*
|
|
133
|
+
* ルートタグ名。既定は 'rows'。
|
|
134
|
+
*
|
|
135
|
+
* 根标签名。默认为 'rows'。
|
|
136
|
+
*
|
|
137
|
+
* @defaultValue 'rows'
|
|
138
|
+
*/
|
|
40
139
|
rootTag?: string;
|
|
41
|
-
/**
|
|
140
|
+
/**
|
|
141
|
+
* 행 태그명. 기본 'row'.
|
|
142
|
+
*
|
|
143
|
+
* Row tag name. Default 'row'.
|
|
144
|
+
*
|
|
145
|
+
* 行タグ名。既定は 'row'。
|
|
146
|
+
*
|
|
147
|
+
* 行标签名。默认为 'row'。
|
|
148
|
+
*
|
|
149
|
+
* @defaultValue 'row'
|
|
150
|
+
*/
|
|
42
151
|
rowTag?: string;
|
|
43
|
-
/**
|
|
152
|
+
/**
|
|
153
|
+
* 출력 방식: 'element'(기본) | 'attribute'.
|
|
154
|
+
*
|
|
155
|
+
* Output mode: 'element' (default) | 'attribute'.
|
|
156
|
+
*
|
|
157
|
+
* 出力方式: 'element'(既定) | 'attribute'。
|
|
158
|
+
*
|
|
159
|
+
* 输出方式: 'element'(默认) | 'attribute'。
|
|
160
|
+
*
|
|
161
|
+
* @defaultValue 'element'
|
|
162
|
+
*/
|
|
44
163
|
mode?: 'element' | 'attribute';
|
|
45
|
-
/**
|
|
164
|
+
/**
|
|
165
|
+
* 그리드 field명 → XML 태그명 매핑.
|
|
166
|
+
*
|
|
167
|
+
* Grid field name → XML tag name map.
|
|
168
|
+
*
|
|
169
|
+
* グリッド field 名 → XML タグ名のマッピング。
|
|
170
|
+
*
|
|
171
|
+
* 表格 field 名 → XML 标签名的映射。
|
|
172
|
+
*/
|
|
46
173
|
fieldMap?: Record<string, string>;
|
|
47
|
-
/**
|
|
174
|
+
/**
|
|
175
|
+
* XML 선언부 포함 여부. 기본 true.
|
|
176
|
+
*
|
|
177
|
+
* Whether to include the XML declaration. Default true.
|
|
178
|
+
*
|
|
179
|
+
* XML 宣言部を含めるかどうか。既定は true。
|
|
180
|
+
*
|
|
181
|
+
* 是否包含 XML 声明部分。默认为 true。
|
|
182
|
+
*
|
|
183
|
+
* @defaultValue true
|
|
184
|
+
*/
|
|
48
185
|
declaration?: boolean;
|
|
49
|
-
/**
|
|
186
|
+
/**
|
|
187
|
+
* 들여쓰기 공백 수. 기본 2.
|
|
188
|
+
*
|
|
189
|
+
* Indentation space count. Default 2.
|
|
190
|
+
*
|
|
191
|
+
* インデントの空白数。既定は 2。
|
|
192
|
+
*
|
|
193
|
+
* 缩进的空格数。默认为 2。
|
|
194
|
+
*
|
|
195
|
+
* @defaultValue 2
|
|
196
|
+
*/
|
|
50
197
|
indent?: number;
|
|
51
|
-
/**
|
|
198
|
+
/**
|
|
199
|
+
* null/undefined 처리 문자열. 기본 ''.
|
|
200
|
+
*
|
|
201
|
+
* String used for null/undefined values. Default ''.
|
|
202
|
+
*
|
|
203
|
+
* null/undefined を処理する文字列。既定は ''。
|
|
204
|
+
*
|
|
205
|
+
* 处理 null/undefined 的字符串。默认为 ''。
|
|
206
|
+
*
|
|
207
|
+
* @defaultValue ''
|
|
208
|
+
*/
|
|
52
209
|
nullAs?: string;
|
|
53
|
-
/**
|
|
210
|
+
/**
|
|
211
|
+
* 출력에서 제외할 필드 목록.
|
|
212
|
+
*
|
|
213
|
+
* Field names to exclude from the output.
|
|
214
|
+
*
|
|
215
|
+
* 出力から除外するフィールドの一覧。
|
|
216
|
+
*
|
|
217
|
+
* 从输出中排除的字段列表。
|
|
218
|
+
*/
|
|
54
219
|
excludeFields?: string[];
|
|
55
220
|
}
|
|
56
|
-
/**
|
|
221
|
+
/**
|
|
222
|
+
* SAP XML 파싱 결과 구조.
|
|
223
|
+
*
|
|
224
|
+
* Result structure of SAP XML parsing.
|
|
225
|
+
*
|
|
226
|
+
* SAP XML パース結果の構造。
|
|
227
|
+
*
|
|
228
|
+
* SAP XML 解析结果的结构。
|
|
229
|
+
*/
|
|
57
230
|
export interface SapParseResult {
|
|
58
|
-
/**
|
|
231
|
+
/**
|
|
232
|
+
* 문서 헤더(DOCUMENTHEADER) 필드 맵.
|
|
233
|
+
*
|
|
234
|
+
* Document header (DOCUMENTHEADER) field map.
|
|
235
|
+
*
|
|
236
|
+
* 文書ヘッダー(DOCUMENTHEADER)のフィールドマップ。
|
|
237
|
+
*
|
|
238
|
+
* 文档头(DOCUMENTHEADER)的字段映射。
|
|
239
|
+
*/
|
|
59
240
|
header: Record<string, string>;
|
|
60
|
-
/**
|
|
241
|
+
/**
|
|
242
|
+
* 라인 아이템 행 배열.
|
|
243
|
+
*
|
|
244
|
+
* Line-item row array.
|
|
245
|
+
*
|
|
246
|
+
* 明細アイテムの行配列。
|
|
247
|
+
*
|
|
248
|
+
* 行项目的行数组。
|
|
249
|
+
*/
|
|
61
250
|
items: Record<string, string>[];
|
|
62
|
-
/**
|
|
251
|
+
/**
|
|
252
|
+
* RETURN 메시지 행 배열(복수).
|
|
253
|
+
*
|
|
254
|
+
* RETURN message rows (may be multiple).
|
|
255
|
+
*
|
|
256
|
+
* RETURN メッセージの行配列(複数)。
|
|
257
|
+
*
|
|
258
|
+
* RETURN 消息的行数组(可能有多条)。
|
|
259
|
+
*/
|
|
63
260
|
returns: Record<string, string>[];
|
|
64
|
-
/**
|
|
261
|
+
/**
|
|
262
|
+
* 파싱에 사용한 원본 Document(선택).
|
|
263
|
+
*
|
|
264
|
+
* The source Document used for parsing (optional).
|
|
265
|
+
*
|
|
266
|
+
* パースに使用した元の Document(任意)。
|
|
267
|
+
*
|
|
268
|
+
* 解析所用的原始 Document(可选)。
|
|
269
|
+
*/
|
|
65
270
|
raw?: Document;
|
|
66
271
|
}
|
|
67
272
|
/**
|
|
68
|
-
* XML ↔ 그리드 데이터 변환기(정적 메서드 모음).
|
|
273
|
+
* XML ↔ 그리드 데이터 변환기(정적 메서드 모음).
|
|
274
|
+
*
|
|
275
|
+
* XML ↔ grid-data converter (static methods).
|
|
276
|
+
*
|
|
277
|
+
* XML ↔ グリッドデータの変換器(静的メソッド集)。
|
|
278
|
+
*
|
|
279
|
+
* XML ↔ 表格数据的转换器(静态方法集)。
|
|
69
280
|
*
|
|
70
281
|
* @example
|
|
71
282
|
* const rows = XmlConverter.parse('<rows><row><name>Kim</name></row></rows>');
|
|
@@ -74,12 +285,41 @@ export interface SapParseResult {
|
|
|
74
285
|
export declare class XmlConverter {
|
|
75
286
|
/**
|
|
76
287
|
* XML 문자열을 파싱하여 그리드 데이터 배열로 변환. Element / Attribute 방식 자동 감지.
|
|
77
|
-
* / Parse an XML string into a grid-data array. Auto-detects element vs. attribute style.
|
|
78
288
|
*
|
|
79
|
-
*
|
|
80
|
-
*
|
|
81
|
-
*
|
|
82
|
-
*
|
|
289
|
+
* Parse an XML string into a grid-data array. Auto-detects element vs. attribute style.
|
|
290
|
+
*
|
|
291
|
+
* XML 文字列をパースしてグリッドデータの配列に変換。Element / Attribute 方式を自動検出。
|
|
292
|
+
*
|
|
293
|
+
* 解析 XML 字符串并转换为表格数据数组。自动检测 Element / Attribute 方式。
|
|
294
|
+
*
|
|
295
|
+
* @param xml - 파싱할 XML 문자열
|
|
296
|
+
*
|
|
297
|
+
* XML string to parse
|
|
298
|
+
*
|
|
299
|
+
* パースする XML 文字列
|
|
300
|
+
*
|
|
301
|
+
* 要解析的 XML 字符串
|
|
302
|
+
* @param options - 파싱 옵션
|
|
303
|
+
*
|
|
304
|
+
* Parse options
|
|
305
|
+
*
|
|
306
|
+
* パースオプション
|
|
307
|
+
*
|
|
308
|
+
* 解析选项
|
|
309
|
+
* @returns 행 객체 배열
|
|
310
|
+
*
|
|
311
|
+
* Array of row objects
|
|
312
|
+
*
|
|
313
|
+
* 行オブジェクトの配列
|
|
314
|
+
*
|
|
315
|
+
* 行对象数组
|
|
316
|
+
* @throws XML 파싱 오류 시 Error 발생
|
|
317
|
+
*
|
|
318
|
+
* Throws an Error on XML parse failure
|
|
319
|
+
*
|
|
320
|
+
* XML パースエラー時に Error が発生します
|
|
321
|
+
*
|
|
322
|
+
* XML 解析出错时抛出 Error
|
|
83
323
|
* @example
|
|
84
324
|
* // <rows><row><name>Kim</name><dept>Sales</dept></row></rows>
|
|
85
325
|
* const rows = XmlConverter.parse(xmlText);
|
|
@@ -87,36 +327,95 @@ export declare class XmlConverter {
|
|
|
87
327
|
*/
|
|
88
328
|
static parse(xml: string, options?: XmlParseOptions): Record<string, any>[];
|
|
89
329
|
/**
|
|
90
|
-
* 그리드 데이터 배열을 XML 문자열로 직렬화.
|
|
330
|
+
* 그리드 데이터 배열을 XML 문자열로 직렬화.
|
|
331
|
+
*
|
|
332
|
+
* Serialize a grid-data array into an XML string.
|
|
333
|
+
*
|
|
334
|
+
* グリッドデータの配列を XML 文字列にシリアライズ。
|
|
91
335
|
*
|
|
92
|
-
*
|
|
93
|
-
*
|
|
94
|
-
* @
|
|
336
|
+
* 将表格数据数组序列化为 XML 字符串。
|
|
337
|
+
*
|
|
338
|
+
* @param data - 직렬화할 행 배열
|
|
339
|
+
*
|
|
340
|
+
* Row array to serialize
|
|
341
|
+
*
|
|
342
|
+
* シリアライズする行の配列
|
|
343
|
+
*
|
|
344
|
+
* 要序列化的行数组
|
|
345
|
+
* @param options - 직렬화 옵션
|
|
346
|
+
*
|
|
347
|
+
* Serialize options
|
|
348
|
+
*
|
|
349
|
+
* シリアライズオプション
|
|
350
|
+
*
|
|
351
|
+
* 序列化选项
|
|
352
|
+
* @returns XML 문자열
|
|
353
|
+
*
|
|
354
|
+
* XML string
|
|
355
|
+
*
|
|
356
|
+
* XML 文字列
|
|
357
|
+
*
|
|
358
|
+
* XML 字符串
|
|
95
359
|
* @example
|
|
96
|
-
* //
|
|
360
|
+
* // Sending grid-edited rows back to a server
|
|
97
361
|
* const xml = XmlConverter.stringify(grid.getEditedRows(), { mode: 'attribute' });
|
|
98
362
|
*/
|
|
99
363
|
static stringify(data: Record<string, any>[], options?: XmlStringifyOptions): string;
|
|
100
364
|
/**
|
|
101
365
|
* SAP BAPI XML 응답을 파싱하여 { header, items, returns } 구조로 반환.
|
|
102
|
-
*
|
|
366
|
+
*
|
|
367
|
+
* Parse a SAP BAPI XML response into a { header, items, returns } structure.
|
|
368
|
+
*
|
|
369
|
+
* SAP BAPI XML レスポンスをパースして { header, items, returns } 構造で返す。
|
|
370
|
+
*
|
|
371
|
+
* 解析 SAP BAPI XML 响应,返回 { header, items, returns } 结构。
|
|
103
372
|
*
|
|
104
373
|
* SAP BAPI 응답은 "행이 죽 나열된" 단순 목록이 아니라 문서 헤더(DOCUMENTHEADER)·라인
|
|
105
374
|
* 아이템(ACCOUNTGL 등)·처리 결과 메시지(RETURN)가 뒤섞여 한 응답 안에 들어온다. 그래서 범용
|
|
106
375
|
* `parse()`(단일 rowTag 기준)로는 못 풀고, 이 메서드가 세 부분을 각각 알아서 찾아 분리해 준다.
|
|
107
376
|
* 라인 아이템은 그리드에 그대로 `setData()`할 수 있는 배열로 나온다.
|
|
108
|
-
*
|
|
377
|
+
*
|
|
378
|
+
* A SAP BAPI response isn't a flat list of rows — a document header (DOCUMENTHEADER), line
|
|
109
379
|
* items (e.g. ACCOUNTGL), and result messages (RETURN) are all mixed into one response. The
|
|
110
380
|
* generic `parse()` (which assumes a single rowTag) can't untangle that, so this method locates
|
|
111
381
|
* and splits all three parts for you. `items` comes out ready to hand to the grid's `setData()`.
|
|
112
382
|
*
|
|
113
|
-
*
|
|
383
|
+
* SAP BAPI レスポンスは「行がずらりと並んだ」単純なリストではなく、文書ヘッダー
|
|
384
|
+
* (DOCUMENTHEADER)・明細アイテム(ACCOUNTGL など)・処理結果メッセージ(RETURN)が入り混じって
|
|
385
|
+
* 1 つのレスポンスに入ってきます。そのため汎用の `parse()`(単一 rowTag 前提)では解けず、この
|
|
386
|
+
* メソッドが 3 つの部分をそれぞれ自動で見つけて分離します。明細アイテムは、グリッドにそのまま
|
|
387
|
+
* `setData()` できる配列として出てきます。
|
|
388
|
+
*
|
|
389
|
+
* SAP BAPI 响应不是「行依次排开」的简单列表 —— 文档头(DOCUMENTHEADER)、行项目(如 ACCOUNTGL)、
|
|
390
|
+
* 处理结果消息(RETURN)混在一个响应里。通用的 `parse()`(以单一 rowTag 为前提)解不开,
|
|
391
|
+
* 因此本方法自动找出这三部分并分离。行项目直接以数组形式返回,可交给表格的 `setData()`。
|
|
392
|
+
*
|
|
393
|
+
* 지원 패턴:
|
|
394
|
+
*
|
|
395
|
+
* Supported patterns:
|
|
396
|
+
*
|
|
397
|
+
* 対応パターン:
|
|
398
|
+
*
|
|
399
|
+
* 支持的模式:
|
|
400
|
+
*
|
|
114
401
|
* <DOCUMENTHEADER>...</DOCUMENTHEADER>
|
|
115
402
|
* <ACCOUNTGL><ITEM>...</ITEM></ACCOUNTGL>
|
|
116
403
|
* <RETURN><TYPE>S</TYPE><MESSAGE>...</MESSAGE></RETURN>
|
|
117
404
|
*
|
|
118
|
-
* @param xml - SAP BAPI XML 응답 문자열
|
|
119
|
-
*
|
|
405
|
+
* @param xml - SAP BAPI XML 응답 문자열
|
|
406
|
+
*
|
|
407
|
+
* SAP BAPI XML response string
|
|
408
|
+
*
|
|
409
|
+
* SAP BAPI XML レスポンス文字列
|
|
410
|
+
*
|
|
411
|
+
* SAP BAPI XML 响应字符串
|
|
412
|
+
* @returns 파싱 결과 구조
|
|
413
|
+
*
|
|
414
|
+
* Parsed result structure
|
|
415
|
+
*
|
|
416
|
+
* パース結果の構造
|
|
417
|
+
*
|
|
418
|
+
* 解析结果的结构
|
|
120
419
|
* @example
|
|
121
420
|
* const { header, items, returns } = XmlConverter.parseSap(sapResponseXml);
|
|
122
421
|
* grid.setData(items);
|
|
@@ -125,14 +424,39 @@ export declare class XmlConverter {
|
|
|
125
424
|
static parseSap(xml: string): SapParseResult;
|
|
126
425
|
/**
|
|
127
426
|
* BAPI 페이로드 객체를 SAP XML 형식으로 직렬화. sapGenPayload() 결과 또는 단일 document 객체를 받음.
|
|
128
|
-
*
|
|
427
|
+
*
|
|
428
|
+
* Serialize a BAPI payload object into SAP XML. Accepts a sapGenPayload() result or a single document object.
|
|
429
|
+
*
|
|
430
|
+
* BAPI ペイロードオブジェクトを SAP XML 形式にシリアライズ。sapGenPayload() の結果、または単一の
|
|
431
|
+
* document オブジェクトを受け取る。
|
|
432
|
+
*
|
|
433
|
+
* 将 BAPI 载荷对象序列化为 SAP XML 格式。接受 sapGenPayload() 的结果,或单个 document 对象。
|
|
129
434
|
*
|
|
130
435
|
* `parseSap()`의 반대 방향 — 그리드에서 만든/편집한 전표 데이터를 SAP가 받을 수 있는
|
|
131
|
-
* BAPI 호출용 XML로 만들 때 쓴다.
|
|
436
|
+
* BAPI 호출용 XML로 만들 때 쓴다.
|
|
437
|
+
*
|
|
438
|
+
* The reverse of `parseSap()` — use this to turn
|
|
132
439
|
* grid-built/edited document data into the BAPI-call XML that SAP expects.
|
|
133
440
|
*
|
|
134
|
-
*
|
|
135
|
-
*
|
|
441
|
+
* `parseSap()` の逆方向 — グリッドで作成/編集した伝票データを、SAP が受け取れる
|
|
442
|
+
* BAPI 呼び出し用の XML にするときに使います。
|
|
443
|
+
*
|
|
444
|
+
* `parseSap()` 的反方向 —— 用于把表格中创建/编辑的凭证数据,转换成 BAPI 调用 XML 供 SAP 接收。
|
|
445
|
+
*
|
|
446
|
+
* @param payload - BAPI 페이로드 객체
|
|
447
|
+
*
|
|
448
|
+
* BAPI payload object
|
|
449
|
+
*
|
|
450
|
+
* BAPI ペイロードオブジェクト
|
|
451
|
+
*
|
|
452
|
+
* BAPI 载荷对象
|
|
453
|
+
* @returns SAP XML 문자열
|
|
454
|
+
*
|
|
455
|
+
* SAP XML string
|
|
456
|
+
*
|
|
457
|
+
* SAP XML 文字列
|
|
458
|
+
*
|
|
459
|
+
* SAP XML 字符串
|
|
136
460
|
* @example
|
|
137
461
|
* const xml = XmlConverter.stringifySap({
|
|
138
462
|
* BAPI_FUNCTION: 'BAPI_ACC_DOCUMENT_POST',
|
|
@@ -148,10 +472,27 @@ export declare class XmlConverter {
|
|
|
148
472
|
}): string;
|
|
149
473
|
/**
|
|
150
474
|
* sapGenPayload() 의 { totalDocuments, documents[] } 결과를 다건 BAPI XML 로 직렬화.
|
|
151
|
-
* / Serialize a sapGenPayload() { totalDocuments, documents[] } result into a multi-document BAPI XML.
|
|
152
475
|
*
|
|
153
|
-
*
|
|
154
|
-
*
|
|
476
|
+
* Serialize a sapGenPayload() { totalDocuments, documents[] } result into a multi-document BAPI XML.
|
|
477
|
+
*
|
|
478
|
+
* sapGenPayload() の { totalDocuments, documents[] } 結果を複数件の BAPI XML にシリアライズ。
|
|
479
|
+
*
|
|
480
|
+
* 将 sapGenPayload() 的 { totalDocuments, documents[] } 结果序列化为多凭证的 BAPI XML。
|
|
481
|
+
*
|
|
482
|
+
* @param payload - documents 배열을 담은 페이로드
|
|
483
|
+
*
|
|
484
|
+
* Payload holding the documents array
|
|
485
|
+
*
|
|
486
|
+
* documents 配列を格納したペイロード
|
|
487
|
+
*
|
|
488
|
+
* 存放 documents 数组的载荷
|
|
489
|
+
* @returns 다건 BAPI XML 문자열
|
|
490
|
+
*
|
|
491
|
+
* Multi-document BAPI XML string
|
|
492
|
+
*
|
|
493
|
+
* 複数件の BAPI XML 文字列
|
|
494
|
+
*
|
|
495
|
+
* 多凭证的 BAPI XML 字符串
|
|
155
496
|
*/
|
|
156
497
|
static stringifySapBatch(payload: {
|
|
157
498
|
documents: any[];
|