001: /*
002: * SalomeTMF is a Test Management Framework
003: * Copyright (C) 2005 France Telecom R&D
004: *
005: * This library is free software; you can redistribute it and/or
006: * modify it under the terms of the GNU Lesser General Public
007: * License as published by the Free Software Foundation; either
008: * version 2 of the License, or (at your option) any later version.
009: *
010: * This library is distributed in the hope that it will be useful,
011: * but WITHOUT ANY WARRANTY; without even the implied warranty of
012: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
013: * Lesser General Public License for more details.
014: *
015: * You should have received a copy of the GNU Lesser General Public
016: * License along with this library; if not, write to the Free Software
017: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
018: *
019: * @author Fayçal SOUGRATI
020: *
021: * Contact: mikael.marche@rd.francetelecom.com
022: */
023:
024: package org.objectweb.salome_tmf.api.api2ihm.campTest;
025:
026: import java.io.File;
027: import java.sql.Date;
028: import java.sql.Time;
029: import java.util.Vector;
030:
031: import org.objectweb.salome_tmf.api.wrapper.CampaignWrapper;
032: import org.objectweb.salome_tmf.api.wrapper.ScriptWrapper;
033: import org.objectweb.salome_tmf.api.wrapper.TestCampWrapper;
034:
035: //import org.objectweb.salome_tmf.data.Script;
036:
037: /**
038: * Fonctions de sélection relatives à l'aire fonctionnelle "campagnes de test"
039: * @author Fayçal SOUGRATI
040: */
041: public interface CampTestSelect {
042: /**
043: * Fonction qui fixe le projet SalomeTMF dans lequel l'utilisateur travaille
044: * @param projectName
045: */
046: public void setProject(String projectName);
047:
048: /**
049: * Selection des noms de toutes les campagnes de test appartenant a un projet
050: * Retourne un "Vector" (tableau dynamique) d'elements de type "String"
051: * @return
052: */
053: public Vector getProjectCampaigns();
054:
055: /**
056: * Selection de la date de creation d'une campagne de test
057: * @param campaignName
058: * @return
059: */
060: public Date getCampaignCreationDate(String campaignName);
061:
062: /**
063: * Selection de l'heure de creation d'une campagne de test
064: * @param campaignName
065: * @return
066: */
067: public Time getCampaignCreationTime(String campaignName);
068:
069: /**
070: * Selection du nom complet (nom+prenom) du createur d'une campagne de test
071: * @param campaignName
072: * @return
073: */
074: public String getCampaignDesignerCompleteName(String campaignName);
075:
076: /**
077: * Selection de la description d'une campagne de test
078: * @param campaignName
079: * @return
080: */
081: public String getCampaignDescription(String campaignName);
082:
083: /**
084: * Selection des tests appartenant a une campagne de test.
085: * IMPORTANT: LA FONCTION RETOURNE UN VECTOR D'OBJETS DE TYPE "TestSuiteFamily"
086: * @param campaignName
087: * @return
088: */
089: public Vector getCampaignTests(String campaignName);
090:
091: /**
092: * Selection des noms de toutes les executions liees a une campagne de test
093: * @param campaignName
094: * @return
095: */
096: public Vector getCampaignExecutionsName(String campaignName);
097:
098: /**
099: * Selection des dates de creation de toutes les executions liees a une campagne de test
100: * @param campaignName
101: * @return
102: */
103: public Vector getCampaignExecutionsDate(String campaignName);
104:
105: /**
106: * Selection des descriptions de toutes les executions liees a une campagne de test
107: * @param campaignName
108: * @return
109: */
110: public Vector getCampaignExecutionsDesc(String campaignName);
111:
112: /**
113: * Selection de l'environnement lié à une execution de campagne (renvoie "null" si pas d'env.)
114: * @param campName
115: * @param execName
116: * @return
117: */
118: public String getExecutionEnv(String campName, String execName);
119:
120: /**
121: * Selection du jeu de données lié à une execution de campagne (renvoie "null" si pas de jeu de données)
122: * @param campName
123: * @param execName
124: * @return
125: */
126: public String getExecutionJeuDonnees(String campName,
127: String execName);
128:
129: /**
130: * Selection des noms de tous les resultats d'une execution de campagne de test
131: * @param campName
132: * @param execCampName
133: * @return
134: */
135: public Vector getExecutionResultsName(String campName,
136: String execCampName);
137:
138: /**
139: * Selection des dates d'execution de tous les resultats d'une execution de campagne de test
140: * @param campName
141: * @param execCampName
142: * @return
143: */
144: public Vector getExecutionResultsDate(String campName,
145: String execCampName);
146:
147: /**
148: * Selection des heures d'execution de tous les resultats d'une execution de campagne de test
149: * @param campName
150: * @param execCampName
151: * @return
152: */
153: public Vector getExecutionResultsTime(String campName,
154: String execCampName);
155:
156: /**
157: * Selection des heures d'execution de tous les resultats d'une execution de campagne de test
158: * @param execCampId
159: * @return
160: */
161: public Vector getExecutionResultsTimeUsingID(int execCampId);
162:
163: /**
164: * Selection des noms des testeurs de tous les resultats d'une execution de campagne de test
165: * @param campName
166: * @param execCampName
167: * @return
168: */
169: public Vector getExecutionResultsTester(String campName,
170: String execCampName);
171:
172: /**
173: * Selection de tous les resultats des lansements d'une execution de campagne de test
174: * Le resultat est 'INCOMPLETE', 'STOPPEE' ou 'TERMINEE'
175: * @param campName
176: * @param execCampName
177: * @return
178: */
179: public Vector getExecutionResultsRes(String campName,
180: String execCampName);
181:
182: /**
183: * Selection des dates de dernière exécution
184: * @param campName un nom de campagne
185: * @param execCampName nom de l'exécution
186: * @return un vecteur de dates
187: */
188: public Date getExecutionLastDate(String campName,
189: String execCampName);
190:
191: /**
192: * Calcul du nombre de tests en succès d'un resultat d'execution de campagne de test
193: * @param campName
194: * @param execCampName
195: * @param resExecCampName
196: * @return
197: */
198: public int getNbResExecCampPassedTests(String campName,
199: String execCampName, String resExecCampName);
200:
201: /**
202: * Calcul du nombre de tests en échec d'un resultat d'execution de campagne de test
203: * @param campName
204: * @param execCampName
205: * @param resExecCampName
206: * @return
207: */
208: public int getNbResExecCampFailedTests(String campName,
209: String execCampName, String resExecCampName);
210:
211: /**
212: * Calcul du nombre de tests en inconclusif d'un resultat d'execution de campagne de test
213: * @param campName
214: * @param execCampName
215: * @param resExecCampName
216: * @return
217: */
218: public int getNbResExecCampInconclusiveTests(String campName,
219: String execCampName, String resExecCampName);
220:
221: /**
222: * Selection des statistiques de tous les resultats d'une execution de campagne de test
223: * Les statistiques sont sous la forme : "[x S, y E, z I] sur n test(s)" où x, y, z et n sont des nombres
224: * @param campName
225: * @param execCampName
226: * @return
227: */
228: public Vector getExecutionResultsStatistics(String campName,
229: String execCampName);
230:
231: /**
232: * Fonction qui donne le resultat de l'execution d'un test inclu dans un resultat d'execution d'une
233: * campagne de test
234: * @param campName
235: * @param execCampName
236: * @param resExecCampName
237: * @param familyName
238: * @param suiteName
239: * @param testName
240: * @return
241: */
242: public String getResExecTest(String campName, String execCampName,
243: String resExecCampName, String familyName,
244: String suiteName, String testName);
245:
246: /**
247: * Fonction qui donne le resultat de l'execution d'une action de test inclue dans un resultat d'execution
248: * d'un test
249: * @param campName
250: * @param execCampName
251: * @param resExecCampName
252: * @param familyName
253: * @param suiteName
254: * @param testName
255: * @param actionName
256: * @return
257: */
258: public String getResExecAction(String campName,
259: String execCampName, String resExecCampName,
260: String familyName, String suiteName, String testName,
261: String actionName);
262:
263: /**
264: * Selection des noms des jeux de données liés à une campagne de test
265: * @param campName
266: * @return
267: */
268: public Vector getCampJeuxDonneesName(String campName);
269:
270: /**
271: * Selection des descriptions des jeux de données liés à une campagne de test
272: * @param campName
273: * @return
274: */
275: public Vector getCampJeuxDonneesDesc(String campName);
276:
277: /**
278: * Selection des noms des parametres valués dans un jeu de données
279: * @param campName
280: * @param jeuDonneesName
281: * @return
282: */
283: public Vector getJeuDonneesParamsName(String campName,
284: String jeuDonneesName);
285:
286: /**
287: * Selection des valeurs des parametres valués dans un jeu de données
288: * @param campName
289: * @param jeuDonneesName
290: * @return
291: */
292: public Vector getJeuDonneesParamsValue(String campName,
293: String jeuDonneesName);
294:
295: /**
296: * Selection des descriptions des parametres valués dans un jeu de données
297: * @param campName
298: * @param jeuDonneesName
299: * @return
300: */
301: public Vector getJeuDonneesParamsDesc(String campName,
302: String jeuDonneesName);
303:
304: /**
305: * Selection de la valeur associée à un parametre de test dans un jeu de données
306: * @param campName
307: * @param jeuDonneesName
308: * @param paramName
309: * @return
310: */
311: public String getParamValueInJeuDonnees(String campName,
312: String jeuDonneesName, String paramName);
313:
314: /**
315: * Selection d'un fichier attaché à une campagne
316: * @param campaignName
317: * @param fileName
318: * @return
319: */
320: public File getCampaignAttachFile(String campaignName,
321: String fileName);
322:
323: /**
324: * Selection d'un fichier attaché à un environnement sous test
325: * @param envName
326: * @param fileName
327: * @return
328: */
329: public File getEnvironmentAttachFile(String envName, String fileName);
330:
331: /**
332: * Selection des fichiers attachés à une campagne
333: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
334: * @param campaignName
335: * @return
336: */
337: public Vector getCampaignAttachFiles(String campaignName);
338:
339: /**
340: * Selection des fichiers attachés à un environnement
341: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
342: * @param envName
343: * @return
344: */
345: public Vector getEnvAttachFiles(String envName);
346:
347: /**
348: * Selection des fichiers attachés à un environnement
349: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
350: * @param envId
351: * @return
352: */
353: public Vector getEnvAttachFiles(int envId);
354:
355: /**
356: * Selection des URL attachées à un environnement
357: * Retourne un vecteur (tableau dynamique) d'objets de type "String"
358: * @param envName
359: * @return
360: */
361: public Vector getEnvAttachUrls(String envName);
362:
363: /**
364: * Selection des URL attachées à un environnement
365: * Retourne un vecteur (tableau dynamique) d'objets de type "String"
366: * @param envId
367: * @return
368: */
369: public Vector getEnvAttachUrls(int envId);
370:
371: /**
372: * Selection des noms de fichiers attachés à un environnement
373: * Retourne un vecteur (tableau dynamique) d'objets de type "String"
374: * @param campaignName
375: * @return
376: */
377: public Vector getEnvAttachFileNames(String envName);
378:
379: /**
380: * Selection des noms de fichiers attachés à une campagne
381: * Retourne un vecteur (tableau dynamique) d'objets de type "String"
382: * @param campaignName
383: * @return
384: */
385: public Vector getCampaignAttachFileNames(String campaignName);
386:
387: /**
388: * Selection des URL attachés à une campagne
389: * @param campaignName
390: * @return Retourne un vecteur (tableau dynamique) d'objets de type "String"
391: */
392: public Vector getCampaignAttachUrls(String campaignName);
393:
394: /**
395: * Selection d'un fichier attaché à une exécution
396: * @param campaignName
397: * @param execName
398: * @param fileName
399: * @return
400: */
401: public File getExecAttachFile(String campaignName, String execName,
402: String fileName);
403:
404: /**
405: * Selection des fichiers attachés à une exécution
406: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
407: * @param campaignName
408: * @param execName
409: * @return
410: */
411: public Vector getExecAttachFiles(String campaignName,
412: String execName);
413:
414: /**
415: * Selection des noms de fichiers attachés à une exécution
416: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
417: * @param campaignName
418: * @param execName
419: * @return
420: */
421: public Vector getExecAttachFileNames(String campaignName,
422: String execName);
423:
424: /**
425: * Selection des URL attachés à une exécution
426: * @param campaignName
427: * @param execName
428: * @return Retourne un vecteur (tableau dynamique) d'objets de type "String"
429: */
430: public Vector getExecAttachUrls(String campaignName, String execName);
431:
432: /**
433: * Fonction qui donne le resultat de l'execution d'une action de test inclue dans un resultat d'execution
434: * d'un test
435: * @param campName
436: * @param execCampName
437: * @param resExecCampName
438: * @param familyName
439: * @param suiteName
440: * @param testName
441: * @param actionName
442: * @return
443: */
444: public String[] getResExecActionEffetivResult(String campName,
445: String execCampName, String resExecCampName,
446: String familyName, String suiteName, String testName,
447: String actionName);
448:
449: /**
450: * Selection d'un fichier attaché à un résultat d'exécution
451: * @param campaignName
452: * @param execName
453: * @param executionResultName
454: * @param fileName
455: * @return
456: */
457: public File getExecResultAttachFile(String campaignName,
458: String execName, String executionResultName, String fileName);
459:
460: /**
461: * Selection des fichiers attachés à un résultat d'exécution
462: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
463: * @param campaignName
464: * @param execName
465: * @param executionResultName
466: * @return
467: */
468: public Vector getExecResultAttachFiles(String campaignName,
469: String execName, String executionResultName);
470:
471: /**
472: * Selection des noms de fichiers attachés à un résultat d'exécution
473: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
474: * @param campaignName
475: * @param execName
476: * @param executionResultName
477: * @return
478: */
479: public Vector getExecResultAttachFileNames(String campaignName,
480: String execName, String executionResultName);
481:
482: /**
483: * Selection des URL attachés à un résultat d'exécution
484: * @param campaignName
485: * @param execName
486: * @param executionResultName
487: * @return Retourne un vecteur (tableau dynamique) d'objets de type "String"
488: */
489: public Vector getExecResultAttachUrls(String campaignName,
490: String execName, String executionResultName);
491:
492: /**
493: * Sélection d'un fichier attaché à un résultat d'exécution de test
494: * @param familyName
495: * @param suiteName
496: * @param testName
497: * @param campaignName
498: * @param execName
499: * @param executionResultName
500: * @param fileName
501: * @return
502: */
503: public File getExecTestResultAttachFile(String familyName,
504: String suiteName, String testName, String campaignName,
505: String execName, String executionResultName, String fileName);
506:
507: /**
508: * Selection des fichiers attachés à un résultat d'exécution de test
509: * @param familyName
510: * @param suiteName
511: * @param testName
512: * @param campaignName
513: * @param execName
514: * @param executionResultName
515: * @return
516: */
517: public Vector getExecTestResultAttachFiles(String familyName,
518: String suiteName, String testName, String campaignName,
519: String execName, String executionResultName);
520:
521: /**
522: * Selection des noms de fichiers attachés à un résultat d'exécution de test
523: * Retourne un vecteur (tableau dynamique) d'objets de type "File"
524: * @param familyName
525: * @param suiteName
526: * @param testName
527: * @param campaignName
528: * @param execName
529: * @param executionResultName
530: * @return
531: */
532: public Vector getExecTestResultAttachFileNames(String familyName,
533: String suiteName, String testName, String campaignName,
534: String execName, String executionResultName);
535:
536: /**
537: * Selection des URL attachés à un résultat d'exécution de test
538: * @param familyName
539: * @param suiteName
540: * @param testName
541: * @param campaignName
542: * @param execName
543: * @param executionResultName
544: * @return
545: */
546: public Vector getExecTestResultAttachUrls(String familyName,
547: String suiteName, String testName, String campaignName,
548: String execName, String executionResultName);
549:
550: /**
551: *
552: * @param campaignName
553: * @param execName
554: * @param scriptName
555: * @param type
556: * @return
557: */
558: public File getScriptOfExecution(String campaignName,
559: String execName, String scriptName, String type);
560:
561: /**
562: *
563: * @param execId
564: * @param scriptName
565: * @param type
566: * @return
567: */
568: public File getScriptOfExecutionUsingID(int execId,
569: String scriptName, String type);
570:
571: /**
572: *
573: * @param campaignName
574: * @param execName
575: * @param scriptName
576: * @param type
577: * @param pathName
578: * @return
579: */
580: public File getScriptOfExecution(String campaignName,
581: String execName, String scriptName, String type, String path);
582:
583: /**
584: *
585: * @param campaignName
586: * @param execName
587: * @param type
588: * @return
589: */
590: public String getExecutionScriptName(String campaignName,
591: String execName, String type);
592:
593: /**
594: *
595: * @param campaignName
596: * @param execName
597: * @param scriptName
598: * @return
599: */
600: public String getExecutionScriptClassPath(String campaignName,
601: String execName, String scriptName, String type);
602:
603: /**
604: *
605: * @param campaignName
606: * @param execName
607: * @param scriptName
608: * @return
609: */
610: public String getExecutionScriptPlugArg(String campaignName,
611: String execName, String scriptName, String type);
612:
613: /**
614: *
615: * @param envName
616: * @param scriptName
617: * @return
618: */
619: public File getScriptOfEnvironment(String envName, String scriptName);
620:
621: /**
622: *
623: * @param envId
624: * @param scriptName
625: * @return
626: */
627: public File getScriptOfEnvironmentUsingID(int envId,
628: String scriptName);
629:
630: /**
631: *
632: * @param envName
633: * @param scriptName
634: * @param pathName
635: * @return
636: */
637: public File getScriptOfEnvironment(String envName,
638: String scriptName, String pathName);
639:
640: /**
641: *
642: * @param envName
643: * @param scriptName
644: * @return
645: */
646: public String getEnvironmentScriptClassPath(String envName,
647: String scriptName);
648:
649: /**
650: *
651: * @param envName
652: * @param scriptName
653: * @return
654: */
655: public String getEnvironmentScriptPlugArg(String envName,
656: String scriptName);
657:
658: /**
659: *
660: * @param envName
661: * @param scriptName
662: * @return
663: */
664: public String getEnvironmentScriptType(String envName,
665: String scriptName);
666:
667: /**
668: *
669: * @param envName
670: * @return
671: */
672: public String getEnvironmentScriptName(String envName);
673:
674: /**
675: * Retourne l'identifiant dans la base d'une campagne dont le nom est passé
676: * en paramètre. S'il n'existe pas, une exception est stockée dans le vecteur
677: * d'exception.
678: * @param campaignName un nom de campagne
679: * @return
680: */
681: public int getCampaignId(String campaignName);
682:
683: /**
684: * Retourne l'identifiant dans la base d'une exécution dont le nom est passé
685: * en paramètre. S'il n'existe pas, une exception est stockée dans le vecteur
686: * d'exception.
687: * @param executionName un nom d'exécution
688: * @param campaignName un nom de campagne
689: * @return
690: */
691: public int getExecutionId(String executionName, String campaignName);
692:
693: /**
694: * Retourne l'identifiant dans la base d'un environment dont le nom est passé
695: * en paramètre. S'il n'existe pas, une exception est stockée dans le vecteur
696: * d'exception.
697: * @param environmentName un nom d'environment
698: * @return
699: */
700: public int getEnvironmentId(String environmentName);
701:
702: /**
703: * Retourne l'identifiant dans la base d'un jeu de données dont le nom est passé
704: * en paramètre. S'il n'existe pas, une exception est stockée dans le vecteur
705: * d'exception.
706: * @param dataSetName un nom de jeu de données
707: * @param campaignName un nom de campagne
708: * @return
709: */
710: public int getDataSetId(String dataSetName, String campaignName);
711:
712: public int getResExcId(String campName, String execCampName,
713: String resExecCampName);
714:
715: public int getIdParam(String nameParam);
716:
717: public ScriptWrapper getEnvironmentScript(int id);
718:
719: public Vector getAllProjectCampaigns();
720:
721: public Vector getCampJeuxDonnees(int campId);
722:
723: public Vector getCampaignExecutions(int campId);
724:
725: public ScriptWrapper[] getExecutionScript(int execId);
726:
727: public Vector getExecutionResults(int execId);
728:
729: public String getResExecTest(int testId, int resExecCamId);
730:
731: public String getResExecAction(int resExecCamId, int testId,
732: int actionId);
733:
734: public String[] getResExecActionEffetivResult(int resExecCamId,
735: int testId, int actionId);
736:
737: public String[] getResExecActionResult(int resExecCamId,
738: int testId, int actionId);
739:
740: public Vector getExecTestResultAttachFiles(int resExecCamId,
741: int testId);
742:
743: public Vector getExecTestResultAttachUrls(int resExecCamId,
744: int testId);
745:
746: public Vector getExecResultAttachFiles(int execResultId);
747:
748: public Vector getExecResultAttachUrls(int execResultId);
749:
750: public Vector getExecAttachFiles(int execID);
751:
752: public Vector getExecAttachUrls(int execID);
753:
754: public Vector getCampaignAttachFiles(int campId);
755:
756: public Vector getCampaignAttachUrls(int campId);
757:
758: public int getLastAttachID();
759:
760: public int getLastScriptID();
761:
762: /**
763: * Récupérer l'identifiant de l'URL aatché à l'environnemnt
764: * @param idEnv identifiant de l'environnemnt
765: * @param url
766: * @return identifiant de l'url
767: */
768: public int getEnvAttachUrlId(int idEnv, String url);
769:
770: /**
771: * Récupérer l'identifiant du fichier attaché à l'environnemnt
772: * @param idEnv identifiant de l'environnemnt
773: * @param fileName
774: * @return identifiant du fichier
775: */
776: public int getEnvAttachFileId(int idEnv, String fileName);
777:
778: /**
779: * Récupérer l'identifiant du script d'un environnement
780: * @param idEnv identifiant de l'environnement
781: * @param scriptName, nom du script
782: * @return l'identifiant du script
783: */
784: public int getIdScriptOfEnvironment(int idEnv, String scriptName);
785:
786: public int getNumberOfCampaign();
787:
788: public CampaignWrapper getCampaignByOrder(int order_camp);
789:
790: public CampaignWrapper getCampaignUsingID(int IdCampaign);
791:
792: public int getNumberOfTestInCampaign(int idCamp);
793:
794: public TestCampWrapper getTestCampByOrder(int idCampaign,
795: int order_test_camp);
796:
797: public TestCampWrapper getTestCampUsingID(int idCampaign, int idTest);
798:
799: public TestCampWrapper getInCampaignLastTestCampInSuite(
800: int idCampaign, int idSuite);
801:
802: public TestCampWrapper getInCampaignFirstTestCampInSuite(
803: int idCampaign, int idSuite);
804:
805: public TestCampWrapper getInCampaignLastTestCampInFamily(
806: int idCampaign, int idFamily);
807:
808: public TestCampWrapper getInCampaignFirstTestCampInFamily(
809: int idCampaign, int idFamily);
810:
811: public int getSizeOfSuiteInCampaign(int idCampaign, int idSuite);
812:
813: public int getSizeOfFamilyInCampaign(int idCampaign, int idFamily);
814:
815: }
|