Ýêðàíû íàñòðîéêè
124
Ïðèìåíåíèå.
Öåëüþ ýòîãî ñîîáùåíèÿ ÿâëÿåòñÿ îáåñïå÷åíèå äîïóñòèìîñòè ðàáî÷èõ çàäàíèé, âíîñèìûõ â ñèñòåìó Matrix.
Èíòåðôåéñ ïîäòâåðæäàåò:
•
ðàáî÷åå çàäàíèå ñóùåñòâóåò â èíôîðìàöèîííîé ñèñòåìå;
•
ðàáî÷åå çàäàíèå îòêðûòî;
•
ñîñòîÿíèå ðàáî÷åãî çàäàíèÿ ïîçâîëÿåò äîáàâèòü äîïîëíèòåëüíûå ïëàòåæè/ïðîäóêöèþ.
Èíòåðôåéñ äîëæåí îòâåòèòü íà ñîîáùåíèå ñ çàïðîñîì ïðîâåðêè äîïóñòèìîñòè â Matrix (â êîäå îïðåäåëÿåòñÿ
ýëåìåíòîì «MatrixValidationResponse»). Ñîîáùåíèå «MatrixValidationResponse» ðàçðåøàåò èëè çàïðåùàåò
âûäà÷ó æèäêîñòè ñ ñèñòåìå Matrix.
Ñèñòåìà Matrix îòïðàâèòü ýòî ñîîáùåíèå íà èíòåðôåéñ êàæäûé ðàç ïðè âíåñåíèè ðàáî÷åãî çàäàíèÿ.
Åäèíñòâåííîå èñêëþ÷åíèå ìîæåò ïðîèñõîäèòü, åñëè ðàçðàáîò÷èê èíòåðôåéñà âíåäðèë àïïëåò
«TpAddPartApplet». Ýòî ñîîáùåíèå îòïðàâëÿåòñÿ íåìåäëåííî ïîñëå âíåñåíèÿ ðàáî÷åãî çàäàíèÿ.
Èíòåðôåéñ äîëæåí îòâåòèòü íà ñîîáùåíèå «MatrixValidationResponse» â òå÷åíèè 30 ñåêóíä.
Åñëè â ñëåäóþùèõ âðåìåííûõ ðàìêàõ íå ïîëó÷åí îòâåò, ðàáî÷åå çàäàíèå íå ïðîõîäèò ïðîâåðêó
äîïóñòèìîñòè. Ýòî çíà÷èò, ÷òî ïîëüçîâàòåëü íå ìîæåò âûäàâàòü æèäêîñòü ïî ýòîìó ðàáî÷åìó çàäàíèþ
è äîëæåí ëèáî ïîâòîðíî âíåñòè òî æå ðàáî÷åå çàäàíèå èëè óêàçàòü äðóãîé íîìåð ðàáî÷åãî çàäàíèÿ.
Êàê òîëüêî çàäàíèå ïðîõîäèò ïðîâåðêó äîïóñòèìîñòè, ñèñòåìà Matrix íå îòïðàâèò ýòî ñîîáùåíèå ïîâòîðíî
äëÿ òîãî æå ðàáî÷åãî çàäàíèÿ. Ïîñêîëüêó ñèñòåìà Matrix íå çàïðåùàåò ïîëüçîâàòåëþ âíåñòè îäíî è òî æå
çàäàíèå (è êîä ðàáîòû) íåñêîëüêî ðàç, ñî ñòîðîíû ñåðâåðà èíòåðôåéñà ìîæåò ïîêàçàòüñÿ, ÷òî îäíî è òî
æå çàäàíèå îòïðàâëÿåòñÿ íåñêîëüêî ðàç. Ýòî ñîîáùåíèå òîæå ìîæíî îòïðàâèòü íåñêîëüêî ðàç, åñëè ðàáî÷åå
çàäàíèå èçíà÷àëüíî íå ïðîøëî ïðîâåðêó äîïóñòèìîñòè è ïîëüçîâàòåëü ïîâòîðíî âíîñèò åãî.
Îòâåò ïðîâåðêè äîïóñòèìîñòè â Matrix
Ýòî ñîîáùåíèå îòïðàâëÿåòñÿ ñåðâåðîì èíòåðôåéñà îáðàòíî ñèñòåìå Matrix â îòâåò íà ñîîáùåíèå
«MatrixValidationRequest». Â êîäå îïðåäåëÿåòñÿ ýëåìåíòîì «MatrixValidationResponse».
Ôîðìàò ñîîáùåíèÿ äëÿ ïîëüçîâàòåëåé ñèñòåì Matrix 2 è Matrix 3:
<MatrixValidationResponse>
<ValidationRequestKey/>
<ValidationStatus/>
<ValidationErrorDescription/>
<TpValidationKey/>
<MatrixValidationRequest>
Îïðåäåëåíèå ýëåìåíòîâ.
1.
«ValidationRequestKey» — ýòîò ýëåìåíò ÿâëÿåòñÿ ýõîì ïîëÿ ñ òàêèì æå èìåíåì â ïîëå ñîîáùåíèÿ
«ValidationRequestMessage». Ýòî ïîëå èñïîëüçóåòñÿ ñèñòåìîé Matrix äëÿ ñîîòâåòñòâèÿ îòêëèêà çàïðîñó.
2.
«ValidationStatus» — ñîñòîÿíèå, êîòîðîå îòðàæàåò ðåçóëüòàò çàïðîñà íà ïðîâåðêó äîïóñòèìîñòè. Ïîëå
ìîæåò ïðèíèìàòü ñëåäóþùèå çíà÷åíèÿ: «1» (ðàáî÷åå çàäàíèå ïðîøëî ïðîâåðêó) è «0» (ðàáî÷åå çàäàíèå
íå ïðîøëî ïðîâåðêó äîïóñòèìîñòè). Ëþáîå äðóãîå çíà÷åíèå äëÿ ðàáî÷åãî çàäàíèÿ ïîêàçûâàåò, ÷òî îíî
íå ïðîõîäèëî ïðîâåðêó.
3.
«ValidationErrorDescription» — îïèñàíèå îøèáêè; íå áîëüøå 100 ñèìâîëîâ.  îïèñàíèè óêàçàíû ïðè÷èíà,
ïî êîòîðîé ðàáî÷åå çàäàíèå íå ïðîøëî ïðîâåðêó äîïóñòèìîñòè, åñëè «ValidationStatus» ïðèíèìàåò ëþáîå
çíà÷åíèå êðîìå «1».
4.
«TpValidationKey» — ìîæåò âêëþ÷àòü íå áîëüøå 255 (ASCII) áóêâåííî-öèôðîâûõ ñèìâîëîâ
(ñîîòâåòñòâåííî Charcter.isLetterOrDigit ( ) Java). Ýòî êëþ÷ èäåíòèôèêàöèè, ñîçäàâàåìûé ñåðâåðîì
èíòåðôåéñà è èñïîëüçóåìûé èì äëÿ îïðåäåëåíèÿ âûäà÷è æèäêîñòè ïî óíèêàëüíîìó èäåíòèôèêàòîðó.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
Инструкции и руководства похожие на GRACO Matrix 3 ПО Premier
Другие инструкции и руководства из категории Оборудование
