Προηγούμενο Επόμενο

Κλάση BirtComp

Η κλάση BirtComp παρέχει συναρτήσεις για τη σύγκριση τιμών, για παράδειγμα, για να ελέγξετε αν μια τιμή είναι ίση, μεγαλύτερη ή μικρότερη από μια άλλη τιμή. Όλες οι συναρτήσεις επιστρέφουν λογικές τιμές (true/false). Αυτή η κλάση είναι στατική. Η εφαρμογή δεν μπορεί να δημιουργήσει χρήσεις της κλάσης.

BirtComp.anyOf

Αυτή η συνάρτηση συγκρίνει μία ή περισσότερες τιμές με τα περιεχόμενα ενός πεδίου.

Σύνταξη

boolean BirtComp.anyOf( προέλευση, προορισμός1, ..., προορισμόςN )

Παράμετροι

προέλευση

Ένα πεδίο του οποίου το περιεχόμενο θα χρησιμοποιηθεί για τη σύγκριση.

προορισμός

Η τιμή ή οι τιμές προς εύρεση στην προέλευση.

Επιστρέφει

Λογική τιμή. True αν μια τιμή προορισμού εντοπιστεί στην προέλευση, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Το παρακάτω παράδειγμα ελέγχει αν οι τιμές Canada, Mexico ή USA υπάρχουν στο πεδίο Country. Αν οποιαδήποτε από αυτές τις τιμές υπάρχει στο πεδίο, η συνάρτηση επιστρέφει την τιμή true.

BirtComp.anyOf(dataSetRow["Country"], "Canada", "Mexico", "USA")

Το παρακάτω παράδειγμα ελέγχει αν οι ημερομηνίες 15 ή 31 Ιανουαρίου 2009 υπάρχουν στο πεδίο payDate:

BirtComp.anyOf(dataSetRow["payDate"], "2009-01-15", "2009-01-31")

Το παρακάτω παράδειγμα ελέγχει αν δύο συγκεκριμένοι κωδικοί προϊόντος υπάρχουν στο πεδίο productCode. Αν μία από τις δύο τιμές υπάρχει στο πεδίο εμφανίζεται η λέξη Obsolete, διαφορετικά εμφανίζεται η τιμή του πεδίου productCode.

if (BirtComp.anyOf(dataSetRow["PRODUCTCODE"], "S18_1749", "S18_2248" )){
  displayString = "Obsolete"
}else{
  dataSetRow["PRODUCTCODE"]
}

BirtComp.between

Αυτή η συνάρτηση ελέγχει αν μία τιμή βρίσκεται μεταξύ δύο καθορισμένων τιμών.

Σύνταξη

boolean BirtComp.between( προέλευση, προορισμός1, προορισμός2 )

Παράμετροι

προέλευση

Η τιμή προς έλεγχο.

προορισμός1

Η πρώτη τιμή στο εύρος τιμών προς σύγκριση.

προορισμός2

Η δεύτερη τιμή στο εύρος τιμών προς σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι μεταξύ των τιμών προορισμός1 και προορισμός2, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου βρίσκονται εντός ενός καθορισμένου εύρους τιμών:

BirtComp.between( row["SalesTotal"], 10000, 20000 )
BirtComp.between( row["CustomerName"], "A", "M" )
BirtComp.between( row["OrderDate"], "2009-01-01", "2009-01-31" )

Το ακόλουθο παράδειγμα υπολογίζει ημερομηνίες αποστολής. Αν η τιμή OrderDate βρίσκεται εντός του Δεκεμβρίου 2008 (μεταξύ 1ης και 31ης Δεκεμβρίου), προστίθενται 5 ημέρες στην τιμή OrderDate. Αν η τιμή OrderDate βρίσκεται ανήκει σε έναν άλλο μήνα εκτός από το Δεκέμβριο, προστίθενται 3 ημέρες στην τιμή OrderDate.

if (BirtComp.between(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }

BirtComp.compareString

Αυτή η συνάρτηση ελέγχει αν μια τιμή συμφωνεί με μια άλλη τιμή με βάση καθορισμένα κριτήρια.

Σύνταξη

boolean BirtComp.compareString( προέλευση1, προέλευση2, παράβλεψη_πεζών_κεφαλαίων, περικοπή )

Παράμετροι

προέλευση1

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προέλευση2

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

παράβλεψη_πεζών_κεφαλαίων

Καταχωρήστε την τιμή true ώστε να μη γίνεται διάκριση πεζών-κεφαλαίων. Καταχωρήστε την τιμή false για να γίνει σύγκριση με διάκριση πεζών-κεφαλαίων.

περικοπή

Καταχωρήστε την τιμή true για να αφαιρέσετε τους χαρακτήρες διαστήματος από την αρχή ή το τέλος των τιμών πριν από τη σύγκρισή τους. Οι χαρακτήρες διαστήματος στο μέσο των τιμών δεν αφαιρούνται. Καταχωρήστε την τιμή false αν επιθυμείτε στη σύγκριση να συμπεριλαμβάνονται οι χαρακτήρες διαστήματος στην αρχή ή το τέλος των τιμών.

Επιστρέφει

True αν η τιμή προέλευση1 συμφωνεί με την τιμή προέλευση2, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις συγκρίνουν τιμές χρησιμοποιώντας διαφορετικές συνθήκες:

BirtComp.compareString( "Jackson", "Jackson", false, false ) // επιστρέφει true
BirtComp.compareString( "Jackson", "jackson", false, true ) // επιστρέφει false
BirtComp.compareString( "Jackson", "jackson", true, false ) // επιστρέφει true
BirtComp.compareString( "Jackson ", "jackson", true, false ) // επιστρέφει false
BirtComp.compareString( "Jackson ", "jackson", true, true ) // επιστρέφει true

BirtComp.equalTo

Αυτή η συνάρτηση ελέγχει αν μία τιμή είναι ίση με μια άλλη τιμή.

Σύνταξη

boolean BirtComp.equalTo( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι ίση με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου είναι ίσες με τις καθορισμένες τιμές:

BirtComp.equalTo( row["SalesTotal"], 10000 )
BirtComp.equalTo( row["Country"], "France" )
BirtComp.equalTo( row["OrderDate"], "2009-02-15" )

BirtComp.greaterOrEqual

Αυτή η συνάρτηση ελέγχει αν μία τιμή είναι μεγαλύτερη από ή ίση με μια άλλη τιμή.

Σύνταξη

boolean BirtComp.greaterOrEqual( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι μεγαλύτερη ή ίση με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου είναι μεγαλύτερες ή ίσες με τις καθορισμένες τιμές:

BirtComp.greaterOrEqual( row["SalesTotal"], 10000 )
BirtComp.greaterOrEqual( row["ProductCode"], "S50_4000" )
BirtComp.greaterOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.greaterThan

Αυτή η συνάρτηση ελέγχει αν μία τιμή είναι μεγαλύτερη από μια άλλη τιμή.

Σύνταξη

boolean BirtComp.greaterThan( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι μεγαλύτερη από την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου είναι μεγαλύτερες από τις καθορισμένες τιμές:

BirtComp.greaterThan( row["SalesTotal"], 10000 )
BirtComp.greaterThan( row["CustomerName"], "M" )
BirtComp.greaterThan( row["OrderDate"], "2009-02-15" )

BirtComp.lessOrEqual

Αυτή η συνάρτηση ελέγχει αν μία τιμή είναι μικρότερη από ή ίση με μια άλλη τιμή.

Σύνταξη

boolean BirtComp.lessOrEqual( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι μικρότερη ή ίση με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου είναι μικρότερες ή ίσες με τις καθορισμένες τιμές:

BirtComp.lessOrEqual( row["SalesTotal"], 10000 )
BirtComp.lessOrEqual( row["ProductCode"], "S18_4000" )
BirtComp.lessOrEqual( row["OrderDate"], "2009-02-15" )

BirtComp.lessThan

Αυτή η συνάρτηση ελέγχει αν μία τιμή είναι μικρότερη από μια άλλη τιμή.

Σύνταξη

boolean BirtComp.lessThan( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης είναι μικρότερη από την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου είναι μικρότερες από τις καθορισμένες τιμές:

BirtComp.lessThan( row["SalesTotal"], 10000 )
BirtComp.lessThan( row["CustomerName"], "M" )
BirtComp.lessThan( row["OrderDate"], "2009-02-15" )

BirtComp.like

Αυτή η συνάρτηση ελέγχει αν μια τιμή συμφωνεί με ένα μοτίβο. Το μοτίβο πρέπει να χρησιμοποιεί σύνταξη για μοτίβα SQL.

Σύνταξη

boolean BirtComp.like( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η τιμή προς αποτίμηση.

προορισμός

Το μοτίβο προς σύγκριση. Πρέπει να περικλείσετε το μοτίβο σε διπλά εισαγωγικά (" "). Χρησιμοποιήστε το σωστό συνδυασμό πεζών-κεφαλαίων κατά την πληκτρολόγηση των χαρακτήρων που επιθυμείτε να συγκρίνετε. Μπορείτε να χρησιμοποιήσετε τον ακόλουθο ειδικό χαρακτήρα σε ένα μοτίβο:

*
*

Για να αναζητήσετε τους ίδιους τους χαρακτήρες ποσοστού (%) και υπογραμμής (_), πρέπει να προσθέσετε δύο αντικαθέτους (\\) πριν από αυτούς. Για παράδειγμα, για να αναζητήσετε την τιμή S_10, χρησιμοποιήστε το ακόλουθο μοτίβο:

S\\_10

Για να αναζητήσετε την τιμή 50%, χρησιμοποιήστε το μοτίβο:

50\\%

Επιστρέφει

True αν η τιμή προέλευσης συμφωνεί με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Το παρακάτω παράδειγμα επιστρέφει την τιμή true για τις τιμές του πεδίου productCode που αρχίζουν με S18:

BirtComp.like( row["productCode"], "S18%" )

Το παρακάτω παράδειγμα επιστρέφει την τιμή true για τις τιμές του πεδίου productName που περιέχουν ένα χαρακτήρα και στη συνέχεια τη σειρά χαρακτήρων Ford:

BirtComp.like( row["productName"], "_Ford%" )

BirtComp.match

Αυτή η συνάρτηση ελέγχει αν μια τιμή συμφωνεί με ένα μοτίβο. Το μοτίβο πρέπει να χρησιμοποιεί τη σύνταξη κανονικών εκφράσεων JavaScript.

Σύνταξη

boolean BirtComp.match( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η τιμή προς αποτίμηση.

προορισμός

Το μοτίβο προς σύγκριση. Στη σύνταξη κανονικών εκφράσεων JavaScript, πρέπει να περικλείσετε το μοτίβο ανάμεσα σε καθέτους (/). Μπορείτε να χρησιμοποιήσετε οποιουσδήποτε ειδικούς χαρακτήρες που υποστηρίζονται από τις κανονικές εκφράσεις JavaScript, όπως:

*
*
*
*
*

Για να αναζητήσετε έναν ειδικό χαρακτήρα, πριν από τον ειδικό χαρακτήρα τοποθετήστε μια αντικάθετο (\). Για παράδειγμα, για να αναζητήσετε την τιμή S*10, χρησιμοποιήστε το ακόλουθο μοτίβο:

/S\*10/

Επιστρέφει

True αν η τιμή προέλευσης συμφωνεί με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Το παρακάτω παράδειγμα επιστρέφει την τιμή true για τις τιμές του πεδίου productCode που αρχίζουν με S18:

BirtComp.match( row["productCode"], /^S18/ )

Το παρακάτω παράδειγμα επιστρέφει την τιμή true για τις τιμές του πεδίου productName που περιέχουν τη σειρά χαρακτήρων Ford:

BirtComp.match( row["productName"], /Ford/ )

BirtComp.notBetween

Αυτή η συνάρτηση ελέγχει αν μία τιμή δεν βρίσκεται μεταξύ δύο καθορισμένων τιμών.

Σύνταξη

boolean BirtComp.notBetween( προέλευση, προορισμός1, προορισμός2 )

Παράμετροι

προέλευση

Η τιμή προς έλεγχο.

προορισμός1

Η πρώτη τιμή στο εύρος τιμών προς σύγκριση.

προορισμός2

Η δεύτερη τιμή στο εύρος τιμών προς σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης δεν είναι μεταξύ των τιμών προορισμός1 και προορισμός2, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου βρίσκονται εκτός ενός καθορισμένου εύρους τιμών:

BirtComp.notBetween( row["SalesTotal"], 10000, 20000 )
BirtComp.notBetween( row["CustomerName"], "A", "M" )
BirtComp.notBetween( row["OrderDate"], "2009-01-01", "2009-01-31" )

Το ακόλουθο παράδειγμα υπολογίζει ημερομηνίες αποστολής. Αν η τιμή OrderDate δεν βρίσκεται εντός του Δεκεμβρίου 2008 (μεταξύ 1ης και 31ης Δεκεμβρίου), προστίθενται 3 ημέρες στην τιμή OrderDate. Αν η τιμή OrderDate βρίσκεται εντός του Δεκεμβρίου, προστίθενται 5 ημέρες στην τιμή OrderDate.

if (BirtComp.notBetween(row["OrderDate"], "2008-12-01", "2008-12-31" )){
  shipDate = BirtDateTime.addDay( row["OrderDate"], 3 )
  }
else{
  ShipDate = BirtDateTime.addDay( row["OrderDate"], 5 )
  }

BirtComp.notEqual

Αυτή η συνάρτηση ελέγχει αν μία τιμή δεν είναι ίση με μια άλλη τιμή.

Σύνταξη

boolean BirtComp.notEqual( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η πρώτη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

προορισμός

Η δεύτερη τιμή που θα χρησιμοποιηθεί στη σύγκριση.

Επιστρέφει

True αν η τιμή προέλευσης δεν είναι ίση με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Οι ακόλουθες εκφράσεις ελέγχουν αν οι τιμές του πεδίου δεν είναι ίσες με τις καθορισμένες τιμές:

BirtComp.notEqual( row["SalesTotal"], 10000 )
BirtComp.notEqual( row["Country"], "France" )
BirtComp.notEqual( row["OrderDate"], "2009-02-15" )

BirtComp.notLike

Αυτή η συνάρτηση ελέγχει αν μια τιμή δεν συμφωνεί με ένα μοτίβο. Το μοτίβο πρέπει να χρησιμοποιεί σύνταξη για μοτίβα SQL.

Σύνταξη

boolean BirtComp.notLike( προέλευση, προορισμός )

Παράμετροι

προέλευση

Η τιμή προς αποτίμηση.

προορισμός

Το μοτίβο σειράς χαρακτήρων με το οποίο θα γίνει σύγκριση. Πρέπει να περικλείσετε το μοτίβο σε διπλά εισαγωγικά (" "). Χρησιμοποιήστε το σωστό συνδυασμό πεζών-κεφαλαίων κατά την πληκτρολόγηση των χαρακτήρων που επιθυμείτε να συγκρίνετε. Μπορείτε να χρησιμοποιήσετε τον ακόλουθο ειδικό χαρακτήρα σε ένα μοτίβο:

*
*

Για να αναζητήσετε τους ίδιους τους χαρακτήρες ποσοστού (%) και υπογραμμής (_), πρέπει να προσθέσετε δύο αντικαθέτους (\\) πριν από αυτούς. Για παράδειγμα, για να αναζητήσετε την τιμή S_10, χρησιμοποιήστε το ακόλουθο μοτίβο:

S\\_10

Για να αναζητήσετε την τιμή 50%, χρησιμοποιήστε το μοτίβο:

50\\%

Επιστρέφει

True αν η τιμή προέλευσης δεν είναι ίδια με την τιμή προορισμού, διαφορετικά επιστρέφει την τιμή false.

Παραδείγματα

Το παρακάτω παράδειγμα επιστρέφει την τιμή false για τις τιμές του πεδίου productCode που αρχίζουν με S18:

BirtComp.notLike( row["productCode"], "S18%" )

Το παρακάτω παράδειγμα επιστρέφει την τιμή false για τις τιμές του πεδίου productName που περιέχουν ένα χαρακτήρα και στη συνέχεια τη σειρά χαρακτήρων Ford:

BirtComp.notLike( row["productName"], "_Ford%" )

(c) Copyright Actuate Corporation 2013