🙇🏽 🐞 🕦 DBMS Caché में स्थानीयकरण 🎃 👩🏾‍🤝‍👨🏼 👩‍🎤

मान लीजिए कि आपने एक प्रोग्राम लिखा है, जो "हैलो, वर्ल्ड!" को आउटपुट करता है, उदाहरण के लिए:
write "Hello, World!"

आवेदन काम करता है, सब कुछ ठीक है।
लेकिन समय बीत जाता है, आपका एप्लिकेशन विकसित होता है, लोकप्रिय हो जाता है, और अब, आपको इस लाइन को किसी अन्य भाषा में प्रदर्शित करने की आवश्यकता है, और आवश्यक भाषाओं की संख्या और संरचना पहले से ज्ञात नहीं है।
कट के तहत आप सीखेंगे कि कैच में स्थानीयकरण की समस्या कैसे हल होती है।

संक्षिप्त समीक्षा

Caché DBMS एक तैयार-निर्मित तंत्र प्रदान करता है जो कंसोल प्रोग्राम्स, वेब अनुप्रयोगों में इंटरफ़ेस, JavaScipt फ़ाइलों में तार, त्रुटि संदेश, आदि में स्ट्रिंग्स के स्थानीयकरण को सरल बनाता है।

नोट: इस विषय पर पिछले लेखों में से एक में पारित करने पर चर्चा की गई थी।

मान लीजिए कि कई वर्गों, कार्यक्रमों, वेब पेजों, जेएस लिपियों आदि के साथ एक परियोजना है।
स्थानीयकरण तंत्र निम्नानुसार काम करता है:

यहां तक कि परियोजना को संकलित करने के चरण में, स्थानीयकृत की जाने वाली सभी पंक्तियों को "फिश आउट" किया जाता है और एक विशिष्ट प्रारूप में डेटाबेस के अंदर संग्रहीत किया जाता है।
स्वयं लाइनों के बजाय, एक निश्चित कोड को संकलित कोड में ही प्रतिस्थापित किया जाता है, जो निष्पादन की अवस्था में, सत्र की वर्तमान भाषा के आधार पर, स्टोर से एक या किसी अन्य मूल्य को आउटपुट करता है।

संपूर्ण स्थानीयकरण की प्रक्रिया प्रोग्रामर के लिए पूरी तरह से पारदर्शी है।
डेवलपर को मैन्युअल रूप से एक निश्चित स्ट्रिंग स्टोर (डेटाबेस या संसाधन फ़ाइल में एक तालिका), साथ ही इस पूरे बुनियादी ढांचे का प्रबंधन करने के लिए कोड लिखने की आवश्यकता से छुटकारा मिलता है, जैसे कि रनटाइम पर भाषा बदलना, अनुवादक के लिए विभिन्न स्वरूपों में डेटा का निर्यात / आयात करना आदि। घ।

परिणामस्वरूप, हमारे पास:

पठनीय - अतिरिक्त - स्रोत कोड द्वारा अप्रयुक्त;
स्थानीय स्ट्रिंग्स का स्वत: पूर्ण भंडारण
नोट: जब आप रिपॉजिटरी से कोड से लाइनों को हटाते हैं, तो वे हटाए नहीं जाते हैं। ऐसे प्रेत से रिपॉजिटरी को साफ करने के लिए, इसे साफ करना और परियोजना को फिर से जोड़ना आसान है।
वर्तमान भाषा को "मक्खी पर" बदलें। यह वेब एप्लिकेशन और नियमित कार्यक्रम दोनों पर लागू होता है;
किसी दी गई भाषा में एक स्ट्रिंग प्राप्त करने की क्षमता, किसी दिए गए डोमेन से (डोमेन के बारे में थोड़ा कम);
XML में निर्यात / आयात भंडारण के लिए तैयार तरीके।

तो, आइए देखें कि यह कैसे काम करता है, साथ ही साथ सभी प्रकार के स्थानीयकरण उदाहरण भी देखें।

परिचय

निम्नलिखित सामग्री के साथ एक मैक प्रोग्राम बनाएँ:

#Include %occMessages
test () {

write "$$$DefaultLanguage=" , $$$DefaultLanguage ,!
write "$$$SessionLanguage=" , $$$SessionLanguage ,!

set msg1= $$$Text ( ", !" , "asd" )
set msg2= $$$Text ( "@my@, !" , "asd" )
write msg1,!,msg2,!

}

परिणाम:

 USER>d ^test $$$DefaultLanguage=ru $$$SessionLanguage=ru , ! , !

हमें क्या मिला?

सबसे पहले, एक वैश्विक डेटाबेस में दिखाई दिया

 ^CacheMsg("asd") = "ru" ^CacheMsg("asd","ru",2915927081) = ", !" ^CacheMsg("asd","ru","my") = ", !"

दूसरे, यदि आप $ $ $ मैक्रो पर होवर करते हैं, तो आप उस कोड को देख सकते हैं जिसमें यह विस्तारित है।
उपरोक्त उदाहरण के लिए, मध्यवर्ती (विस्तारित) प्रोग्राम कोड (INT-code) निम्नानुसार होगा:

test () {
write "$$$DefaultLanguage=" , $get (^%SYS( "LANGUAGE" , "CURRENT" ), "en" ),!
write "$$$SessionLanguage=" , $get (^||%Language, "en" ),!
set msg1= $get (^CacheMsg( "asd" , $get (^||%Language, "en" ), "2915927081" ), ", !" )
set msg2= $get (^CacheMsg( "asd" , $get (^||%Language, "en" ), "my" ), ", !" )
write msg1,!,msg2,!
}

उपरोक्त उदाहरण के लिए , आपको निम्नलिखित बातों पर ध्यान देना चाहिए:

कार्यक्रम में लाइनें शुरू में उस भाषा में लिखी जानी चाहिए जो वर्तमान लोकेल में (प्रबंधन पोर्टल में कॉन्फ़िगर की गई) Caché DBMS में डिफ़ॉल्ट रूप से पंजीकृत है;
नोट: जब उनके हैश के बजाय स्ट्रिंग पहचानकर्ता का उपयोग करते हैं, तो यह इतना महत्वपूर्ण नहीं है।
प्रत्येक पंक्ति के लिए, मैक्रो अपने CRC32 की गणना करता है, और सभी डेटा - CRC32 या लाइन आइडेंटिफ़ायर, डोमेन, करंट सिस्टम लैंग्वेज - को CacheMsg ग्लोबल में संग्रहीत किया जाता है;
लाइन के बजाय, एक कोड डाला जाता है जो निजी वैश्विक ^ में मूल्य को ध्यान में रखता है ^ ||% भाषा ?
यदि उपयोगकर्ता ऐसी भाषा में स्ट्रिंग का अनुरोध करता है जिसके लिए कोई अनुवाद नहीं है (रिपॉजिटरी में कोई डेटा नहीं है), तो मूल स्ट्रिंग वापस आ जाएगी;
डोमेन तंत्र आपको तार्किक रूप से स्थानीयकृत स्ट्रिंग्स को अलग करने की अनुमति देता है, उदाहरण के लिए, समान स्ट्रिंग्स के लिए अलग-अलग अनुवाद आदि।

यदि किसी कारण से आप मौजूदा $ $ $ टेक्स्ट मैक्रो एल्गोरिथ्म से संतुष्ट नहीं हैं, उदाहरण के लिए, आप डिफ़ॉल्ट भाषा को अलग तरीके से सेट करना चाहते हैं या डेटा को किसी अन्य स्थान पर संग्रहीत करना चाहते हैं या ..., तो आप अपना एनालॉग बना सकते हैं।
और मैक्रोज़ ## एक्सप्रेशन और / या ## फंक्शन आपकी मदद करेंगे।

चलिए अपना उदाहरण जारी रखते हैं।
एक नई भाषा जोड़ते हैं। ऐसा करने के लिए, आपको स्ट्रिंग स्टोर को एक फ़ाइल में अनलोड करने और इसे अनुवादकों को देने की आवश्यकता है, फिर अनुवाद को वापस लोड करें, लेकिन एक अलग भाषा के साथ।
डेटा को विभिन्न तरीकों से और विभिन्न प्रारूपों में डाउनलोड किया जा सकता है।
हम % मेथडबेर वर्ग के मानक तरीकों का उपयोग करेंगे: आयात (), आयातडायर (), निर्यात (), ExportDomainList ():
do ##class ( %MessageDictionary ). Export ( "messages.xml" , "ru" )

हमारे डेटाबेस की निर्देशिका में हमें फ़ाइल " messages_ru.xml " मिलती है। इसे " messages_en.xml " का नाम दें, इसमें भाषा को " en " में बदलें और सामग्री का अनुवाद करें।
अगला, इसे हमारे भंडार में वापस आयात करें:
do ##class ( %MessageDictionary ). Import ( "messages_en.xml" )

वैश्विक निम्नलिखित रूप लेगा:

 ^CacheMsg("asd") = "ru" ^CacheMsg("asd","en",2915927081) = "Hello, World!" ^CacheMsg("asd","en","my") = "Hello, World!" ^CacheMsg("asd","ru",2915927081) = ", !" ^CacheMsg("asd","ru","my") = ", !"

अब हम "मक्खी पर" भाषा को बदल सकते हैं, उदाहरण के लिए:

#Include %occMessages

test ()
{

set $$$SessionLanguageNode = "ru"

set msg1= $$$Text ( ", !" , "asd" )
set msg2= $$$Text ( "@my@, !" , "asd" )
write msg1,!,msg2,!

set $$$SessionLanguageNode = "en"

set msg1= $$$Text ( ", !" , "asd" )
set msg2= $$$Text ( "@my@, !" , "asd" )
write msg1,!,msg2,!

set $$$SessionLanguageNode = "pt-br"

set msg1= $$$Text ( ", !" , "asd" )
set msg2= $$$Text ( "@my@, !" , "asd" )
write msg1,!,msg2,!

}

परिणाम:

 USER>d ^test , ! , ! Hello, World! Hello, World! , ! , !

अंतिम विकल्प पर ध्यान दें।

गैर- वेब अनुप्रयोग स्थानीयकरण उदाहरण (नियमित वर्ग)

वर्ग विधियों का स्थानीयकरण:

Include %occErrors

Class demo.test Extends %Persistent
{

Parameter DOMAIN = "asd" ;

ClassMethod Test()
{
do ##class ( %MessageDictionary ). SetSessionLanguage ( "ru" )

write $$$Text ( ", !" ),!

do ##class ( %MessageDictionary ). SetSessionLanguage ( "en" )

write $$$Text ( ", !" ),!

do ##class ( %MessageDictionary ). SetSessionLanguage ( "pt-br" )

write $$$Text ( ", !" ),!

#dim ex as %Exception.AbstractException

try
{

$$$ThrowStatus ( $$$ERR ( $$$AccessDenied ))

} catch (ex)
{
write $system .Status . GetErrorText (ex. AsStatus (), "ru" ),!
write $system .Status . GetErrorText (ex. AsStatus (), "en" ),!
write $system .Status . GetErrorText (ex. AsStatus (), "pt-br" ),!
}
}

}

नोट: बेशक, आप ऊपर वर्णित मैक्रोज़ का उपयोग कर सकते हैं।

परिणाम:

 USER>d ##class(demo.test).Test() , ! Hello, World! , !  #822:    ERROR #822: Access Denied ERRO #822: Acesso Negado

निम्नलिखित बातों पर ध्यान दें:

अपवादों के संदेश पहले ही कई भाषाओं में अनुवादित किए जा चुके हैं। चूंकि ये सिस्टम संदेश हैं, इसलिए उनके लिए डेटा % qCacheMsg सिस्टम वैश्विक में संग्रहीत है;
हम डोमेन नाम को एक बार सेट करते हैं, क्योंकि डिफ़ॉल्ट रूप से $ $ $ पाठ मैक्रो कक्षाओं में उपयोग के लिए डिज़ाइन किया गया है;
$$$ पाठ मैक्रो, हालांकि वेब अनुप्रयोगों में उपयोग के लिए डिज़ाइन किया गया है, फिर भी ऑफ़लाइन वातावरण के लिए काफी उपयुक्त है।

वेब अनुप्रयोग स्थानीयकरण उदाहरण

निम्नलिखित उदाहरण पर विचार करें:

/// Created using the page template: Default
Class demo.test Extends %ZEN.Component.page
{

/// , .
Parameter APPLICATION;

/// .
Parameter PAGENAME;

/// , .
Parameter DOMAIN = "asd" ;

/// Style CSS .
XData Style
{
< style type = "text/css" >
</ style >
}

/// XML .
XData Contents [ XMLNamespace = "www.intersystems.com/zen" ]
{
< page xmlns = "www.intersystems.com/zen" title = "" >
< checkbox onchange = "zenPage.ChangeLanguage();" />
< button caption = "" onclick = "zenPage.clientTest(2,3);" />
< button caption = "" onclick = "zenAlert(zenPage.ServerTest(1,2));" />
</ page >
}

ClientMethod clientTest(
a ,
b ) [ Language = javascript ]
{
zenAlert(
$$$FormatText($$$Text( "(1)^ %$# @*&' %1=%2" ), '"' ,a + b), '\n' ,
zenText( 'msg3' ,a + b), '\n' ,
$$$Text( " !" )
);
}

ClassMethod ServerTest(
A ,
B ) As %String [ ZenMethod ]
{
&js< zenAlert( #( .. QuoteJS ( $$$FormatText ( $$$Text ( "(2)^ %$# @*&' ""=%1" ),A+B)) )# ); >
quit $$$TextJS ( " Caché!" )
}

Method ChangeLanguage() [ ZenMethod ]
{
#dim %session as %CSP.Session
set %session. Language = $select (%session. Language = "en" : "ru" ,1: "en" )
&js< zenPage.gotoPage( #( .. QuoteJS (.. Link ( $classname ()_ ".cls" )) )# ); >
}

Method %OnGetJSResources( ByRef pResources As %String ) As %Status [ Private ]
{
Set pResources( "msg3" ) = $$$Text ( "(3)^ %$# @*&' ""=%1" )
Quit $$$OK
}

}

नवाचारों में से, निम्नलिखित पर ध्यान दिया जाना चाहिए:

ग्राहक की ओर से संदेशों को स्थानीयकृत करने के दो विकल्प हैं:
- $$$ पाठ विधि का उपयोग करना, जिसे " zenutils.js " फ़ाइल में परिभाषित किया गया है;
- क्लाइंट-साइड zenText () विधि और % OnGetJSResources () सर्वर-साइड पद्धति के संयोजन का उपयोग करना
विवरण के लिए प्रलेखन देखें: क्लाइंट साइड टेक्स्ट के लिए स्थानीयकरण
ZEN घटक की कुछ विशेषताएं पहले से ही स्थानीयकरण का समर्थन करती हैं, उदाहरण के लिए: सभी प्रकार के हेडर, संकेत, आदि।
यदि आवश्यक हो, तो अपने स्वयं के ऑब्जेक्ट-उन्मुख घटक बनाएं - उदाहरण के लिए, jQuery या extJS पर या खरोंच से आधारित - आप उपयोग कर सकते हैं
विशेष डेटा प्रकार % ZEN.Datatype.caption : ज़ेन घटकों के लिए स्थानीयकरण
भाषा बदलने के लिए, आप % सत्र और / या % प्रतिक्रिया वस्तुओं की भाषा संपत्ति का उपयोग कर सकते हैं: ज़ेन विशेष चर

प्रारंभ में, सत्र ब्राउज़र में निर्दिष्ट भाषा का उपयोग करता है:

^{वृद्धि}

अपनी त्रुटि रिपोर्टिंग निर्देशिका बनाना

उपरोक्त उपकरण ऐसा करने के लिए पर्याप्त हैं।
फिर भी, एक अंतर्निहित पद्धति है जो इस प्रक्रिया को थोड़ा स्वचालित करने में मदद करती है।

तो चलिए शुरू करते हैं।

त्रुटि सामग्री के साथ एक फ़ाइल " messages_ru.xml " बनाएँ, निम्न सामग्री:

 <?xml version="1.0" encoding="UTF-8"?> <MsgFile Language="ru"> <MsgDomain Domain="asd"> <Message Id="-1" Name="ErrorName1">    1</Message> <Message Id="-2" Name="ErrorName2">    2 %1 %2</Message> </MsgDomain> </MsgFile>

इसे डेटाबेस में आयात करें:
do ##class ( %MessageDictionary ). Import ( "messages_ru.xml" )

डेटाबेस में दो ग्लोबल्स बनाए गए थे:

^ CacheMsg

 USER>zw ^CacheMsg ^CacheMsg("asd","ru",-2)="    2 %1 %2" ^CacheMsg("asd","ru",-1)="    1"

^ CacheMsgNames

 USER>zw ^CacheMsgNames ^CacheMsgNames("asd",-2)="ErrorName2" ^CacheMsgNames("asd",-1)="ErrorName1"

"CustomErrors" नाम के साथ एक शामिल फ़ाइल बनाएँ:

 USER>Do ##class(%MessageDictionary).GenerateInclude("CustomErrors",,"asd",1) Generating CustomErrors.INC ...

नोट: विवरण के लिए GenerateInclude () विधि के लिए प्रलेखन देखें।

फ़ाइल " CustomErrors.inc ":

#define asdErrorName2 "<asd>-2"
#define asdErrorName1 "<asd>-1"

अब आप प्रोग्राम में त्रुटि कोड और / या छोटे त्रुटि नामों का उपयोग कर सकते हैं, उदाहरण के लिए:

Include CustomErrors

Class demo.test [ Abstract ]
{

ClassMethod test( A As %Integer ) As %Status
{
if A=1 Quit $$$ERROR ( $$$asdErrorName1 )
if A=2 Quit $$$ERROR ( $$$asdErrorName2 , "f" , "6" )
Quit $$$OK
}

}

परिणाम:

 USER>d $system.OBJ.DisplayError(##class(demo.test).test(1))  <asd>-1:     1 USER>d $system.OBJ.DisplayError(##class(demo.test).test(2))  <asd>-2:     2 f 6 USER>w $system.Status.GetErrorText(##class(demo.test).test(1),"en") ERROR <asd>-1: bla-bla-bla 1 USER>w $system.Status.GetErrorText(##class(demo.test).test(2),"en") ERROR <asd>-2: bla-bla-bla 2 f 6

नोट: अंग्रेजी भाषा के लिए संदेश सादृश्य द्वारा बनाए गए थे।

DBMS Caché में स्थानीयकरण

संक्षिप्त समीक्षा

परिचय

गैर- वेब अनुप्रयोग स्थानीयकरण उदाहरण (नियमित वर्ग)

वेब अनुप्रयोग स्थानीयकरण उदाहरण

अपनी त्रुटि रिपोर्टिंग निर्देशिका बनाना

More articles: