Oracle has recently added 2 fantastic new methods that significantly improve our ability to minimize our scripts and reduce the effort to build and maintain them. The first is a method in the EPMScript class called cscParams. The second is in the cube class named executeEssbaseScript. Read more
Tag Archive for: Cloud
The good news is migrating to the cloud doesn’t change a lot when it comes to backing up your Essbase applications. Conceptually, it is the same. The utilities used are slightly different. Read more
Challenge Accepted
When I asked visitors to try to come up with a situation that Groovy Calculation might be able to solve, this was a good one. One visitor asked if they could require a cell comment if certain parameters were not met. It is actually relatively easy.
The following requirement exist in this example. If any month holds more than 30% of the full year, that cell requires the user to enter a cell comment. If no comment exists, the user won’t be able to save the form.
The User Experience
If any month is more than 30% of the full year, and the user doesn’t add a comment to a cell, the form will not save. The following shows what happens when the above fails, and what happens after the user enters a comment into the cell.
The Code
def backErrColor = 16755370 //Red
def caseTotal = 0
def accountName = ""
// Loop through the months
operation.grid.dataCellIterator('Jan','Feb','Mar','Apr','May','Jun','Jul','Aug','Sep','Oct','Nov','Dec').each {
// Get a total for all 12 months every time the row changes
if(it.getAccountName() != accountName) {
accountName = it.getAccountName();
caseTotal = it.data + it.crossDimCell('Feb').data + it.crossDimCell('Mar').data + it.crossDimCell('Apr').data + it.crossDimCell('May').data + it.crossDimCell('Jun').data + it.crossDimCell('Jul').data + it.crossDimCell('Aug').data + it.crossDimCell('Sep').data + it.crossDimCell('Oct').data + it.crossDimCell('Nov').data + it.crossDimCell('Dec').data
}
// If the value is greater than 30% of the total and the cell does NOT have a cell comment, interrupt the form save
if(it.data > 0 && it.data / caseTotal > 0.3 && !it.hasCellNote() ) {
it.addValidationError(backErrColor, "Cases for a single month can't be more than 30% of the total year without an assumption.", false)
}
}
Conclusion
Challenge accepted. This one goes in the win column for Groovy Calculations!
If you are using PBCS, you may run into some challenges with large files being passed through FDMEE. Whether performance is an issue or you just want to parse a file my month/year, this script might save you some time.
The Challenge
I recently had the need to break apart a file. The source provided one large text file that included 2 years of data that was needed to populate the history of an employee metrics application. The current process loaded files by month and we wanted to be able to piggy back off the existing scripts to load and process data in FDMEE and the monthly Planning data pushes to the ASO reporting cube. Read more
PBCS is about to release a major upgrade (1 of 2 every year scheduled). Oracle released a 29 page document laying out everything that should be expected. Want the abbreviated version?
- Want your users to see the simplified user interface? You will be able to make it the default.
- Welcome to EPBCS. This enhanced version will include modules for Financials, Workforce, Projects, and Capital.
- Users can now create dashboards that include editable forms and ad hoc grids, and include new chart types.
- Forms, task lists, and reports can be viewed in either list view or hierarchical view.
- You can now use an attribute dimension as a dimension, as a filter in forms and reports, and within ad hoc grids. Using attribute dimensions enables administrators and end users to perform tasks such as:
- Filtering data using attribute members, such as by products with a certain color
- Performing cross-dimensional rollups across attribute members
- Reporting and analysis with attribute dimension members using Smart View, or financial reports
- Using attribute dimensions in dynamic user variables Attribute dimensions are optional and are listed separately on the Layout tab of the Form Designer. Drag the Attribute dimension to a Point of View or to a row or column to add it to the form grid.
- Administrators can create aliases for artifacts similar to alias tables where things like forms can be viewed in native languages.
- For new applications, administrators can optionally choose a simplified multicurrency option during application creation. Using simplified currency avoids the use of the Hsp_Rates dimension and adds a Currency dimension with exchange rates stored in the Account dimension
- You can now create smart lists based on dimension hierarchies. This dynamically updates smart list values based on member updates.
- Form grid display can be tied to the start and end period for the respective scenarios on display
- A new action menu in the console allows customers to clear specific areas within both input and reporting cubes
- Users can now drill on shared members to get to the children of the base member.
- Form designers can now prevent the form save confirmation message from being displayed to users by specifying an option in form design.
- The usability and readability of forms is increased with duplicate aliases. Aliases can now contain the same name within an alias table and across alias tables.
- Import Metadata functionality is extended to Microsoft Word.
- You can now quickly add attribute dimensions to an ad hoc grid at any time during the ad hoc session.
- In the Planning Admin Extension, you can now work with attribute dimensions and the Time Period dimension. Just as with regular dimensions, you can use the Planning Admin Extension in the Smart View application to quickly import and edit attribute and time dimension application metadata.
- System Templates are now displayed under New Objects.
- You can now add a warning or an error to a step using validation conditions. Errors prevent the next step. Warnings allow the next step after you click OK on the warning message. You can use a design- time prompt or function on the validation condition. This allows you to use functions on design-time prompts without having to create non-promptable design-time prompts.
- When you are debugging business rules, a Condition Builder is now available to help you build conditions.
- You can use the Member Selector dialog box to create MDX syntax and validation before running a partial clear.
- The following new design-time prompt types are available:
- Percent
- Integer
- StringAsNumber
- DateAsNumber
- Smart List
- UDA
New Design-Time Prompt Functions
- @AVAILDIMCOUNT – Returns the number of available dimensions.
- @DEPENDENCY – “Inclusive” returns member(s) from Input 1 for which Input 2 has member(s) specified from the same dimensions. “Exclusive” returns members from Input 1 for which Input 2 has no specified members in the same dimensions.
- @DIMATTRIBUTE – Returns the attribute name if the specified attribute is associated with a dimension.
- @DIMNAME – Returns the name of a dimension if it is valid for the database.
- @DIMUDA – Returns the UDA name if the specified UDA is valid for the dimension.
- @EVALUATE – Returns the result of an expression.
- @FINDFIRST – Finds the first substring of a string that matches the given regular expression.
- @FINDLAST – Finds the last substring of a string that matches the given regular expression.
- @GETDATA – Returns the value of the slice.
- @INTEGER – Returns an integer.
- @ISDATAMISSING – Returns true if the value of the slice is missing.
- @ISANDBOXED – Determines if the current application is sandboxed.
- @ISVARIABLE – Determines if the argument is a variable.
- @MATCHES – Returns “true” if the first substring of a string matches the given regular expression.
- @MEMBERGENERATION – Returns the generation number of a member.
- @MEMBERLEVEL – Returns the level number of a member.
- @MSGFORMAT – Takes a set of objects, formats them, and then inserts the formatted strings into the pattern at the appropriate places.
- @OPENDIMCOUNT – Returns the number of dimensions for which a member was not specified.
- @VALUEDIMCOUNT – Returns the number of dimensions for which a member was specified.
- @TOMDX – Returns an MDX expression.
New Design Time Prompt Types
- Percent
- Integer
- StringAsNumber
- DateAsNumber
- Smart List
- UDA
New Custom Defined Functions
- @CalcMgrBitAnd – Performs a bitwise AND operation, which compares each bit of the first operand to the corresponding bit of the second operand. If both bits are 1, the corresponding result bit is set to 1; otherwise, the corresponding result bit is set to 0.
- @CalcMgrBitOR – Performs a bitwise OR operation, which compares each bit of the first operand to the corresponding bit of the second operand. If either bit is 1, the corresponding result bit is set to 1; otherwise, the corresponding result bit is set to 0.
- @CalcMgrBitExOR – Performs an exclusive bitwise OR operation, which compares each bit of the first operand to the corresponding bit of the second operand. If either bit is 1, the corresponding result bit is set to 1; otherwise, the corresponding result bit is set to 0.
- @CalcMgrBitExBoolOR – Performs an exclusive boolean bitwise OR operation.
- @CalcMgrBitCompliment – Performs a unary bitwise complement, which reverses each bit.
- @CalcMgrBitShiftLeft – Performs a signed left shift.
- @CalcMgrBitShiftRight – Performs a signed right shift.
- @CalcMgrBitUnsignedShiftRight – Performs an unsigned right shift.
- @CalcMgrCounterClearAll – Removes all keys and values from the counter
- @CalcMgrCounterClearKey – Removes the value from the counter associated with the key
- @CalcMgrCounterDecrement – Decrements the value in the counter based on the key. If the key is not found, a value of zero is set for the key
- @CalcMgrCounterDecrementKey – Decrements the value in the counter based on the key. If the key is not found, a value of zero is set for the key
- @CalcMgrCounterGetKeyNumber – Returns the text found in the counter based on the key. If the key is not found, missing value is returned.
- @CalcMgrCounterGetKeyText – Returns the text found in the counter based on the key. If the key is not found, missing value is returned.
- @CalcMgrCounterGetNumber – Returns the number from the counter specified by the key. If the key is not found or the value is not a number, missing value is returned.
- @CalcMgrCounterGetText – Returns the text found in the counter based on the key. If the key is not found, missing value is returned.
- @CalcMgrCounterIncrement – Increment the value in the counter specified by the key
- @CalcMgrCounterIncrementKey – Increments the value in the counter based on the key. If the key is not found, a value of zero is set for the key.
- @CalcMgrExcelToDate – Converts an Excel date to YYYYMMDD format.
- @CalcMgrExcelToDateTime – Converts an Excel date to YYYYMMDDHHMMSS format.
- @CalcMgrGetStringFormattedDateTime – Converts the date defined by format to date in the YYYYMMddHHmmss format.
- @CalcMgrDateToExcel – Converts a date in YYYYMMDD format to an Excel date
- @CalcMgrDateTimeToExcel – Converts a date in YYYYMMDDHHMMSS format to an Excel date
- @CalcMgrRollDay – Roll the day up or down to the date which is in the YYYYMMDD format
- @CalcMgrRollDate – Adds or subtracts (up or down) a single unit of time on the given date field without changing larger fields.
- Possible values of date_part are: day, month, week and year.
- @CalcMgrRollMonth – Roll the month up or down to the date which is in the YYYYMMDD format.
- @CalcMgrRollYear – Roll the year up or down to the date which is in the YYYYMMDD format.
- @CalcMgrExcelACCRINT – Returns the accrued interest for a security that pays periodic interest
- @CalcMgrExcelACCRINTM – Returns the accrued interest for a security that pays interest at maturity
- @CalcMgrExcelAMORDEGRC – Returns the depreciation for each accounting period by using a depreciation coefficient
- @CalcMgrExcelAMORLINC – Returns the depreciation for each accounting period
- @CalcMgrExcelCOUPDAYBS – Returns the number of days from the beginning of the coupon period to the settlement date @CalcMgrExcelCOUPDAYS – Returns the number of days in the coupon period that contains the settlement date
- @CalcMgrExcelCOUPDAYSNC – Returns the number of days from the settlement date to the next coupon date
- @CalcMgrExcelCOUPNCD – Returns a number that represents the next coupon date after the settlement date
- @CalcMgrExcelCOUPNUM – Returns the number of coupons payable between the settlement date and maturity date, rounded up to the nearest whole coupon
- @CalcMgrExcelCOUPPCD – Returns a number that represents the previous coupon date before the settlement date
- @CalcMgrExcelCUMIPMT – Returns the cumulative interest paid on a loan between start_period and end_period @CalcMgrExcelCUMPRINC – Returns the cumulative principal paid on a loan between the start period and the end period
- @CalcMgrExcelDB – Returns the depreciation of an asset for a specified period using the fixed-declining balance method
- @CalcMgrExcelDDB – Returns the depreciation of an asset for a specified period using the double- declining balance method or some other method you specify
- @CalcMgrExcelDISC – Returns the discount rate for a security
- @CalcMgrExcelDOLLARDE – Converts a dollar price expressed as an integer part and a fraction part, such as 1.02, into a dollar price expressed as a decimal number. Fractional dollar numbers are sometimes used for security prices.
- @CalcMgrExcelDOLLARFR – Converts a dollar price, expressed as a decimal number, into a dollar price, expressed as a fraction @CalcMgrExcelDURATION – Returns the annual duration of a security with periodic interest payments
- @CalcMgrExcelEFFECT – Returns the effective annual interest rate
- @CalcMgrExcelFV – Returns the future value of an investment
- @CalcMgrExcelFVSCHEDULE – Returns the future value of an initial principal after applying a series of compound interest rates
- @CalcMgrExcelINTRATE – Returns the interest rate for a fully invested security @CalcMgrExcelIPMT – Returns the interest payment for a given period for an investment based on periodic, constant payments and a constant interest rate
- @CalcMgrExcelIRR – Returns the internal rate of return for a series of cash flows
- @CalcMgrExcelISPMT – Calculates the interest paid during a specific period of an investment
- @CalcMgrExcelMDURATION – Returns the Macauley modified duration for a security with an assumed par value of $100
- @CalcMgrExcelMIRR – Returns the internal rate of return where positive and negative cash flows are financed at different rates
- @CalcMgrExcelNOMINAL – Returns the annual nominal interest rate
- @CalcMgrExcelNPER – Returns the number of periods for an investment
- @CalcMgrExcelNPV – Returns the net present value of an investment based on a series of periodic cash flows and a discount rate
- @CalcMgrExcelPMT – Returns the periodic payment for an annuity
- @CalcMgrExcelPPMT – Returns the payment on the principal for a given period for an investment based on periodic, constant payments and a constant interest rate
- @CalcMgrExcelPRICE – Returns the price per $100 face value of a security that pays periodic interest
- @CalcMgrExcelPRICEDISC – Returns the price per $100 face value of a discounted security
- @CalcMgrExcelPRICEMAT – Returns the price per $100 face value of a security that pays interest at maturity
- @CalcMgrExcelPV – Returns the present value of an investment @CalcMgrExcelRATE – Returns the interest rate per period of an annuity
- @CalcMgrExcelRECEIVED – Returns the amount received at maturity for a fully invested security
- @CalcMgrExcelSLN – Returns the straight-line depreciation of an asset for one period
- @CalcMgrExcelSYD – Returns the sum-of-years’ digits depreciation of an asset for a specified period
- @CalcMgrExcelTBILLEQ – Returns the bond-equivalent yield for a Treasury bill
- @CalcMgrExcelTBILLPRICE – Returns the price per $100 face value for a Treasury bill
- @CalcMgrExcelTBILLYIELD – Returns the yield for a Treasury bill
- @CalcMgrExcelXIRR – Returns the internal rate of return for a schedule of cash flows that is not necessarily periodic
- @CalcMgrExcelXNPV – Returns the net present value for a schedule of cash flows that is not necessarily periodic
- @CalcMgrExcelYIELD – Returns the yield on a security that pays periodic interest
- @CalcMgrExcelYIELDDISC – Returns the annual yield for a discounted security; for example, a Treasury bill
- @CalcMgrExcelYIELDMAT – Returns the annual yield of a security that pays interest at maturity
- @CalcMgrExcelCEILING – Rounds a number up (away from zero) to the nearest integer or to the nearest multiple of significance
- @CalcMgrExcelCOMBIN – Returns the number of combinations for a given number of objects
- @CalcMgrExcelEVEN – Rounds a number up to the nearest even integer
- @CalcMgrExcelFACT – Returns the factorial of a number
- @CalcMgrExcelFACTDOUBLE – Returns the double factorial of a number
- @CalcMgrExcelFLOOR – Rounds a number down, toward zero
- @CalcMgrExcelGCD – Returns the greatest common divisor
- @CalcMgrExcelLCM – Returns the least common multiple
- @CalcMgrExcelMROUND – Rounds a number to a specified number of digits
- @CalcMgrExcelMULTINOMIAL – Returns the multi-nominal of a set of numbers
- @CalcMgrExcelODD – Rounds a number up to the nearest odd integer
- @CalcMgrExcelPOWER – Returns the result of a number raised to a power
- @CalcMgrExcelPRODUCT – Multiplies its arguments
- @CalcMgrExcelROUNDDOWN – Rounds a number down, towards zero
- @CalcMgrExcelROUNDUP – Rounds a number up, away from zero
- @CalcMgrExcelSQRT – Returns a positive square root
- @CalcMgrExcelSQRTPI – Returns the square root of (number * pi)
- @CalcMgrExcelSUMSQ – Returns the sum of the squares of the arguments
- @CalcMgrExcelSUMPRODUCT – Returns the sum of the products of corresponding array components
- @CalcMgrExcelAVEDEV – Returns the average of the absolute deviations of data points from their mean
- @CalcMgrExcelDEVSQ – Returns the sum of squares of deviations
- @CalcMgrExcelLARGE – Returns the nth highest number
- @CalcMgrExcelMEDIAN – Returns the median of the given numbers
- @CalcMgrExcelSMALL – Returns the nth smallest number
- @CalcMgrExcelSTDEV- Estimates standard deviation based on a sample
- @CalcMgrExcelVAR – Estimates variance based on a sample
- @CalcMgrExcelVARP – Estimates variance based on the entire population
- @CalcMgrFindFirst – Find the first substring of this string that matches the given regular expression.
- @CalcMgrFindLast – Find the last substring of this string that matches the given regular expression.
- @CalcMgrMatches – Returns true, if the first substring of this string that matches the given regular expression. For regular expression, see ”java.util.regex.Pattern” in the Java docs.
- @CalcMgrMessageFormat – Creates a string with the given pattern and uses it to format the given arguments.
- @CalcMgrStartsWith – Tests if this string starts with the specified prefix.
Security
- While the overall access rights granted to a user are controlled by the assigned identity domain role, Service Administrators can use the Access Control feature from the Console to assign additional application-level access by provisioning users and Native Directory groups with application-specific roles. For instance, a Planner in the service can now be assigned the Approvals Administrator role to enable the user to perform approvals-related activities.