cognos.Prompt.getControls әдісі
Осы есепке қатысты барлық басқару элементтерінің көрсеткісін қайтарады.
Синтаксис
(cognos.Prompt.Control[]) getControls()
Параметрлер'>Параметрлер
Ешқайсы.
Қайтарады
{cognos.Prompt.Control[]}
Есепке байланысты басқару элементтерінің көрсеткісі.
Мысал
Бұл мысалы функцияны қолданады, clearAllValues(), ол бет үшін барлық сұрау
басқару элементтерін қалпына келтіреді (таңдауын жояды).
function clearAllValues() {
var oCR = cognos.Report.getReport("_THIS_");
var aControls = oCR.prompt.getControls();
for (var i = 0; i < aControls.length; i++) {
aControls[i].clearValues();
}
}
cognos.Prompt.Control нысаны
Бақылау сұрау бетіндегі көрінетін элемент болып табылады, мәтін сұрауы не мән
сұрауы.
cognos.Prompt.Control.addValues әдісі
Басқару элементіне мәндер көрсеткісін қосыңыз.
Егер басқару элементі бірнеше мәндерге қолдаулы болмаса, тек алғашқы қамтылған
пайдаланылады.
Синтаксис
{void} addValues(aValues)
Параметрлер
{cognos.Value[]} aValues
Осы басқару элементіне пайдаланылатын жаңа мәндер.
Қайтарады
{void}
Мысал
Бұл мысалы сұрауға жасалатын екі мәндер көрсеткісін (пайдалану және көрсету)
қосады.
484
IBM Cognos Analytics - Reporting Нұсқа 11.0: Пайдаланушы нұсқаулығы
var oCR = cognos.Report.getReport(“_THIS_”);
function setPromptValue( promptName, useValue, displayValue ) {
var oP = oCR.prompt. getControlByName( promptName );
var oValue = {'use': useValue, 'display': displayValue };
oP.addValues( [oValues] );
}
setPromptValue ( 'country', 'ca', 'Canada');
cognos.Prompt.Control.clearValues әдісі
Бұл басқару элементі үшін барлық мәндерді тазалау (не белгілеуден алып тастау).
Синтаксис
Мәтін сұрауы үшін, мәтін бос күйіне орнатылған. Мән сұрауы үшін, барлық
таңдаулар жойылады.
{void} clearValues()
Параметрлер
Ешқайсы.
Қайтарады
{void}
Мысал
Бұл мысалы беттегі барлық басқару элементтерін қалпына келтіреді.
function clearAllValues() {
var oCR = cognos.Report.getReport("_THIS_");
var aControls = oCR.prompt.getControls();
for (var i = 0; i < aControls.length; i++) {
aControls[i].clearValues();
}
}
cognos.Prompt.Control.getName әдісі
Басқару элементінің атын қайтарады.
Атау IBM Cognos Analytics - Reporting in the name сипат жинағында басқару үшін
орнатылған.
Синтаксис
{String} getName()
Параметрлер
Ешқайсы.
Қайтарады
{String}
Басқару элементі үшін name сипаттар жиыны арқылы көрсетілген мән.
Қосымша D. API элементін IBM Cognos Analytics үшін шақыру
485
cognos.Prompt.Control.getValues әдісі
Ағымдағы мәнді бақылау үшін қайтарады.
Тіпті, егер тек бір мән таңдалған болса да, бұл әдіс әрқашан көрсеткіні қайтарады.
v
Келесі мәтіндік тақта сұрауының мысалы болып табылады (жеке):
[ {use: "Smith", display: "Smith"} ]
v
Келесі таңдау сұрауының мысалы болып табылады (бірнеше):
[ {use: "CAN", display: "Canada"}, {use: "JPN", display: "Japan"} ]
v
Келесі ауқым сұрауларының мысалдары болып табылады:
start
жәнеend міндетті атаулары бар екі элементтердің көрсеткілері бар. Әрбір
элементтің мәні ертерек мысалдардың тұрақты көрсеткісі ретінде болып табылады.
Ауқым мәндері тең болғанда, бұл әдіс ауқым орнына қалыпты мәнді қайтарады:
[ {use: useValue, display:displayValue} ]
Ауқым мәндері әр түрлі болғанда, әдіс ауқымды қайтарады:
[ start:{use: useValue, display:displayValue}, end:{use: useValue,
display:displayValue} ]
Синтаксис
{cognos.Value[]} getValues(boolean v_allOptions)
Параметрлер
{Boolean} v_allOptions
Бұл қосымша параметрлер тек мән сұраулары үшін қолданылады. Параметр
барлық мәндерді не тек таңдалған мәндерді қайтару керек-жақтығын көрсетеді.
Егер параметр шын күйіне орнатылса, барлық опциялар қайтарылады. Егер
параметр жалған не жоқ болса, тек таңдалған опциялар қайтарылады.
Бұл параметрдің әдепкі мәні - false.
Қайтарады
{cognos.Value[]}
Бақылауға арналған мәндердің көрсеткісі.
Мысал
Бұл мысалы жеке мән не ауқым нәтижесіне негізделе отырып кодты реттеу қажеттігін
көрсетеді.
function isRangeOutOfLimits(datePrompt, rangeLimit) {
var result = false;
var v = datePrompt.getValues();
var rangeValue = v[0];
var rangeDaysDiff = 0;
if (rangeValue.start) {
rangeDaysDiff = 0;
var startDate = rangeValue.start.use;
var endDate = rangeValue.end.use;
rangeDaysDiff = dateUtils.substractDate(endDate,startDate);
}
if (rangeDaysDiff > 0 && rangeDaysDiff <= rangeLimit) {
result = true;
}
return result;
}
486
IBM Cognos Analytics - Reporting Нұсқа 11.0: Пайдаланушы нұсқаулығы
Бұл мысалы v_allOptions параметрінің қолданысын көрсетеді.
var allValues = valueControl.getValues(true);
var selectedValues = valueControl.getValues();
cognos.Prompt.Control.setValidator әдісі
Пайдаланушы анықтаған басқару элементіне арналған әдепкі тексеру функциясын
өзгертеді.
Көрсетілген функция false қайтарылғанда, басқару элементімен қатысты UI
элементі тексеру қатесі орын алғанын анықтайды. Бірнеше басқару элементінде
пайдаланған кезде, Енгізу түймешігі ажыратылады.
Ескерту: Дерек және дерек & уақыты шақыруы басқармасы осы әдісті қолдамайды.
Синтаксис
{void} setValidator(oFct)
Параметрлер
{function} oFct
Параметр сияқты пайдаланушы енгізетін анықталған функция және логикалық
мәнді қайтарады.
Қайтарады
{void}
Мысал
Бұл мысалы A1A 1A1 пішінінде жарамды пошта кодының қамтамасыз етуін қалай
тексеру қажеттігін көрсетеді.
textBox.setValidator(
function (values) {
var result = false;
if (values && values.length > 0) {
var sValue = values[0][’use’];
var rePostalCodeFormat = new RegExp( "[a-z][0-9][a-z] ?[0-9][a-z][0-9]", "gi" );
if ( rePostalCodeFormat.test(sValue ) ) {
result=true;
}
}
return result;
}
);
cognos.Prompt.Control.setValues әдісі
Басқару элементін қалпына келтіреді және басқару элементіне мәндер көрсеткісін
қосады.
Егер басқару элементі бірнеше мәндерге қолдаулы болмаса, тек алғашқы қамтылған
мән пайдаланылады. clearValues() және addValues() үшін кезектес шақырулар
тудыратын қарапайым әдіс болып табылады.
Синтаксис
{cognos.Value[]} aValues
Қосымша D. API элементін IBM Cognos Analytics үшін шақыру
487
Достарыңызбен бөлісу: | 
