{"id":10741,"date":"2015-05-18T09:44:29","date_gmt":"2015-05-18T14:44:29","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=10741"},"modified":"2015-10-21T09:43:08","modified_gmt":"2015-10-21T14:43:08","slug":"sun-idm-xpress-language","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=10741","title":{"rendered":"Sun IDM: XPRESS Language"},"content":{"rendered":"
\n

Contents<\/h2>\n
    \n\t
  1. \n\t\tIntro<\/a>\n\t<\/li>\n\t
  2. \n\t\tExample Usages<\/a>\n\t\t
      \n\t\t\t
    1. \n\t\t\t\tControl Field Visibility<\/a>\n\t\t\t<\/li>\n\t\t\t
    2. \n\t\t\t\tCalculating Default Field Values<\/a>\n\t\t\t<\/li>\n\t\t\t
    3. \n\t\t\t\tDeriving Field Values<\/a>\n\t\t\t<\/li>\n\t\t\t
    4. \n\t\t\t\tGenerating Field Values<\/a>\n\t\t\t<\/li>\n\t\t\t
    5. \n\t\t\t\tWorkflow Transition Conditions<\/a>\n\t\t\t<\/li>\n\t\t\t
    6. \n\t\t\t\tWorkflow Actions<\/a>\n\t\t\t<\/li>\n\t\t\t
    7. \n\t\t\t\tInvoking Java Methods from Workflow Actions<\/a>\n\t\t\t<\/li>\n\t\t\t
    8. \n\t\t\t\tTest Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
    9. \n\t\t\t\tTracing XPRESS Evaluation<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
    10. \n\t\tFunctions<\/a>\n\t\t
        \n\t\t\t
      1. \n\t\t\t\tValue Constructor Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      2. \n\t\t\t\tArithmetic Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      3. \n\t\t\t\tLogical Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      4. \n\t\t\t\tString Manipulation Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      5. \n\t\t\t\tList Manipulation Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      6. \n\t\t\t\tConditional, Iteration, and Block Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      7. \n\t\t\t\tVariables and Function Definition Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      8. \n\t\t\t\tObject Manipulation Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      9. \n\t\t\t\tJava and JavaScript Expressions<\/a>\n\t\t\t<\/li>\n\t\t\t
      10. \n\t\t\t\tDebugging and Testing Expressions<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
      11. \n\t\tData Types<\/a>\n\t<\/li>\n\t
      12. \n\t\tReferences<\/a>\n\t<\/li>\n<\/ol>\n<\/ol>\n<\/div>\n
         <\/div>\n

        Intro<\/h2><\/span>\n

        * A functional language that uses
        \n– syntax based on XML
        \n– prefix notation ( == x 42 vs x == 42 )
        \n* and can
        \n– invoke methods of any Java class
        \n– evaluate JavaScript
        \n* Examples:
        \n– Hello world:<\/p>\n

        \r\nHello World!<\/s><\/print><\/pre>\n
        – Add calculation:<\/p>\n
        \r\n counter<\/ref> 10<\/i> <\/add><\/pre>\n
        * Used in IDM for:
        \n– Customize UIs
        \n– Defined workflow flow control
        \n– Implement workflow actions<\/p>\n
        Example Usages<\/h2><\/span>\n
        Control Field Visibility<\/h3><\/span>\n
        * Hide HomeDirectory if account type is not Solaris:<\/p>\n
        \r\n\r\n   \r\n      \r\n   <\/Display>\r\n   \r\n      \r\n          \r\n            accountInfo.typeNames<\/ref>\r\n            Solaris<\/s>\r\n         <\/contains>\r\n      <\/not>\r\n   <\/Disable>\r\n<\/Field><\/pre>\n
        Calculating Default Field Values<\/h3><\/span>\n
        \r\n\r\n   \r\n      \r\n   <\/Display>\r\n   \r\n\t   \r\n\t\t \r\n\t\t   accounts[AD].firstname<\/ref><\/notnull>\r\n\t\t   accounts[AD].lastname<\/ref><\/notnull>\r\n\t\t <\/and>\r\n\t\t \r\n\t\t   \r\n\t\t\t\taccounts[AD].firstname<\/ref>\r\n\t\t\t\t0<\/i>\r\n\t\t\t\t1<\/i>\r\n\t\t\t<\/substr>\r\n\t\t   accounts[AD].lastname<\/ref>\r\n\t\t <\/concat>\r\n\t   <\/cond>\r\n   <\/Default>\r\n<\/Field><\/pre>\n
        Deriving Field Values<\/h3><\/span>\n
        * Display location based on location code:<\/p>\n
        \r\n\r\n   \r\n      \r\n         \r\n            accounts[Oracle].locCode<\/ref>\r\n            \r\n               AUS<\/s>\r\n               Austin<\/s>\r\n            <\/case>\r\n            \r\n               HOU<\/s>\r\n               Houston<\/s>\r\n            <\/case>\r\n            \r\n               DAL<\/s>\r\n               Dallas<\/s>\r\n            <\/case>\r\n            \r\n               unknown<\/s>\r\n            <\/case>\r\n         <\/switch>\r\n   <\/Derivation>\r\n<\/Field><\/pre>\n
        Generating Field Values<\/h3><\/span>\n
        \r\n\r\n   \r\n      \r\n         location<\/ref>\r\n         \r\n            Austin<\/s>\r\n            AUS<\/s>\r\n         <\/case>\r\n         \r\n            Houston<\/s>\r\n            HOU<\/s>\r\n         <\/case>\r\n         \r\n            Dallas<\/s>\r\n            DAL<\/s>\r\n         <\/case>\r\n      <\/switch>\r\n   <\/Expansion>\r\n<\/Field><\/pre>\n
        Workflow Transition Conditions<\/h3><\/span>\n
        \r\n\r\n   \r\n       ERROR_COUNT<\/ref> 0<\/i> <\/gt>\r\n   <\/Transition>\r\n   \r\n<\/Activity><\/pre>\n
        Workflow Actions<\/h3><\/span>\n
        \r\n\r\n   \r\n      \r\n         \r\n             counter<\/ref> 1<\/i> <\/add>\r\n         <\/set>\r\n      <\/expression>\r\n   <\/Action>\r\n   \r\n<\/Activity><\/pre>\n
        Invoking Java Methods from Workflow Actions<\/h3><\/span>\n
        \r\n\r\n\r\n   \r\n      \r\n         \r\n            accountId<\/ref>\r\n            email<\/ref>\r\n            status<\/ref>\r\n         <\/invoke>\r\n      <\/expression>\r\n   <\/Action>\r\n   \r\n<\/Activity><\/pre>\n
        Test Expressions<\/h3><\/span>\n
        * With lh command:<\/p>\n
        \r\ncd %WSHOME%\\bin\r\nlh xmlparse xpress_file<\/pre>\n
        Tracing XPRESS Evaluation<\/h3><\/span>\n
        * Two tracing levels:
        \n– global
        \n– block level
        \n* Turn on global tracing in Waveset.properties (and don’t forget to reload properties):
        \nxpress.trace=true
        \n* Turn on block level tracing:<\/p>\n
        \r\n\r\n   \r\n<\/block><\/pre>\n
        \r\n\r\n   \r\n      global.accountId<\/ref>\r\n   <\/block>\r\n<\/Default><\/pre>\n
        – invalid block examples:<\/p>\n
        \r\n\r\n   \r\n\u2026\r\n   <\/Field>\r\n<\/block><\/pre>\n
        \r\n\r\n   \r\n      \r\n         global.accounts<\/ref>\r\n      <\/Default>\r\n   <\/block>\r\n<\/Field><\/pre>\n
        Functions<\/h2><\/span>\n
        Value Constructor Expressions<\/h3><\/span>\n
        * array<\/p>\n
        \r\n\r\n   apples<\/s>\r\n   oranges<\/s>\r\n   wiper blades<\/s>\r\n<\/array><\/pre>\n
        * i<\/p>\n
        \r\n42<\/i>\r\n-1234<\/i><\/pre>\n
        * list<\/p>\n
        \r\n\t\r\n   apples<\/s>\r\n   oranges<\/s>\r\n   wiper blades<\/s>\r\n<\/list><\/pre>\n
        * map<\/p>\n
        \r\n\r\n   \r\n   \r\n   \r\n   \r\n<\/map><\/pre>\n
        * null<\/p>\n
        \r\n\r\n<\/null><\/pre>\n
        * s<\/p>\n
        \r\nNow is the time<\/s><\/pre>\n
        Arithmetic Expressions<\/h3><\/span>\n
        * add<\/p>\n
        \r\n 40<\/i> 1<\/i> 1<\/s> <\/add><\/pre>\n
        * div<\/p>\n
        \r\n
         84<\/i> 2<\/i><\/div><\/pre>\n
        * mod<\/p>\n
        \r\n 142<\/i> 100<\/i> <\/mod><\/pre>\n
        * mult<\/p>\n
        \r\n 7<\/i> 3<\/i> 2<\/i> <\/mult><\/pre>\n
        * sub<\/p>\n
        \r\n 50<\/i> 6<\/i> 2<\/i> <\/sub><\/pre>\n
        Logical Expressions<\/h3><\/span>\n
        * and<\/p>\n
        \r\n 42<\/i> cat<\/s> null<\/i> <\/and> # return zero\r\n 42<\/i> cat<\/s> <\/and> # return cat<\/pre>\n
        * cmp<\/p>\n
        \r\n\r\n    20<\/i>\r\n    100<\/i>\r\n <\/cmp> # returns -1\r\n\r\n \r\n    bob<\/s>\r\n    ray<\/s>\r\n <\/cmp> # returns -16 (b is 16 positions behind r)\r\n \r\n    daryl<\/s>\r\n    daryl<\/s>\r\n <\/cmp> # returns true<\/pre>\n
        * eq
        \n0: false
        \n1: true<\/p>\n
        \r\n role<\/ref> engineering<\/s> <\/eq><\/pre>\n
        * gt<\/p>\n
        \r\n\r\n    age<\/ref>\r\n    42<\/i>\r\n <\/gt><\/pre>\n
        * gte<\/p>\n
        \r\n\r\n   10<\/i>\r\n   5<\/i>\r\n<\/gte> # return 1 (true)<\/pre>\n
        * isFalse<\/p>\n
        \r\n0: true\r\n1: false\r\n\r\n   false<\/s>\r\n<\/isFalse> # returns 1 (false)<\/pre>\n
        * isnull
        \n0: not null
        \n1: is null<\/p>\n
        \r\n  <\/isnull> # returns 1 (null)\r\n 0<\/i> <\/isnull> # return 0 (not null)<\/pre>\n
        * isTrue
        \n0: the argument is logically false. The following are considered true: the string true, a Boolean true, and a non-zero integer. (Anything else is considered false.)
        \n1: the argument is logically true.<\/p>\n
        \r\n\r\n   false<\/s>\r\n<\/isTrue> # returns 0<\/pre>\n
        * lt<\/p>\n
        \r\n\r\n   10<\/i>\r\n   5<\/i>\r\n <\/lt><\/pre>\n
        * lte<\/p>\n
        \r\n\r\n    age<\/ref>\r\n    42<\/i>\r\n <\/lte><\/pre>\n
        * ncmp (case insensitive comparison)<\/p>\n
        \r\n\r\n   Daryl<\/s>\r\n   daryl<\/s>\r\n<\/ncmp> # returns 0 (equal)<\/pre>\n
        * neq<\/p>\n
        \r\n\r\n    role<\/ref>\r\n    management<\/s>\r\n <\/neq><\/pre>\n
        * not<\/p>\n
        \r\n   42<\/i> 24<\/i> <\/eq> <\/not> # returns 1<\/pre>\n
        * or<\/p>\n
        \r\n 0<\/i> 0<\/i> <\/or> # returns 0, logical false\r\n 0<\/i> cat<\/s> <\/or> # returns cat, logical true<\/pre>\n
        * notnull<\/p>\n
        \r\n\r\n   firstname<\/ref>\r\n<\/notnull> # returns 1\r\n<\/notnull> # returns 0<\/pre>\n
        String Manipulation Expressions<\/h3><\/span>\n
        * indexOf<\/p>\n
        \r\n\r\n   abcabc<\/s>\r\n   abc<\/s>\r\n   l<\/s>\r\n<\/indexOf> # returns 3<\/pre>\n
        * concat<\/p>\n
        \r\n\r\n   Now <\/s>is <\/s>the <\/s>time<\/s>\r\n<\/concat> # returns Now is the time<\/s><\/pre>\n
        * downcase<\/p>\n
        \r\nABC<\/s><\/downcase> # returns abc<\/s><\/pre>\n
        * length<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n<\/length> # returns 2\r\n\r\n\r\n   Hello world!<\/s>\r\n<\/length> # returns 11<\/pre>\n
        * ltrim<\/p>\n
        \r\n hello<\/s><\/ltrim><\/pre>\n
        * match: deprecated, use contains instead<\/p>\n
        <\/pre>\n
        * message<\/p>\n
        \r\n\r\n   \r\n   \r\n<\/message><\/pre>\n
        * pad<\/p>\n
        \r\n\r\n    email<\/s>\r\n   10<\/i>\r\n<\/pad><\/pre>\n
        * rtrim<\/p>\n
        <\/pre>\n
        * split<\/p>\n
        \r\n\r\n   Austin City Limits<\/s>\r\n    <\/s>\r\n<\/split>\r\n# returns:\r\n\t\r\n   Austin<\/s>\r\n   City<\/s>\r\n   Limits<\/s>\r\n<\/list>\r\n\r\n\r\n   (512)338-1818<\/s>\r\n   ()-<\/s>\r\n<\/split>\r\n# returns:\r\n\t\r\n   512<\/s>\r\n   338<\/s>\r\n   1818<\/s>\r\n<\/list><\/pre>\n
        * substr<\/p>\n
        \r\n\r\n   Now is the time<\/s>\r\n   0<\/i>\r\n   3<\/i>\r\n<\/substr> # returns: Now<\/s>\r\n\r\n\r\n    \r\n        Hello World<\/s> --> Hello World\r\n    <\/substr> --> Hell\r\n<\/block> --> Hell<\/pre>\n
        * trim<\/p>\n
        \r\n hello <\/s><\/trim><\/pre>\n
        * upcase<\/p>\n
        \r\nabc<\/s><\/upcase><\/pre>\n
        * ztrim<\/p>\n
        \r\n\r\n   00000sample<\/s>\r\n<\/ztrim> # returns sample<\/s><\/pre>\n
        List Manipulation Expressions<\/h3><\/span>\n
        * append<\/p>\n
        \r\n\r\n    srclist<\/ref>\r\n    oranges<\/s>\r\n<\/append>\r\n\r\n\r\n   \r\n    We<\/s>\r\n    say<\/s>\r\n  <\/List>\r\n<\/set>\r\n\r\n  Hello<\/s>\r\n  World<\/s>\r\n<\/append>\r\nsomeList<\/ref><\/pre>\n
        * appendAll<\/p>\n
        \r\n\r\n   srclist<\/ref>\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n      peaches<\/s>\r\n   <\/list>\r\n<\/appendAll> # Create a new list by combining srclist and three elements\r\n\r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n      peaches<\/s>\r\n   <\/list>\r\n<\/appendAll> # Add three elements to srclist<\/pre>\n
        * contains<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n   apples<\/s>\r\n<\/contains> # returns 1\r\n\r\n\r\n   foobar<\/s>\r\n   foo<\/s>\r\n<\/contains> # also returns 1<\/pre>\n
        * containsAll<\/p>\n
        <\/pre>\n
        *<\/p>\n
        <\/pre>\n
        *<\/p>\n
        <\/pre>\n
        * containsAny<\/p>\n
        <\/pre>\n
        * filterdup<\/p>\n
        <\/pre>\n
        * filternull<\/p>\n
        <\/pre>\n
        * expand
        \n– Returns the string value of the subexpression with $() variable references expanded.<\/p>\n
        \r\n\r\n\t\r\n\tExpanded: $(str)<\/s><\/expand>\r\n<\/Rule>\r\n\r\n\r\nExpanded: test<\/String>\r\n<\/pre>\n
        * get: Retrieves the value of the nth element in the list. The list indexes starts count from zero (0). Arguments are a list and an integer.<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n   1<\/i>\r\n<\/get> # returns oranges<\/s><\/pre>\n
        * indexOf<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n   oranges<\/s>\r\n<\/indexOf> # returns 1\r\n\r\n\r\n   \tapples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n   oranges<\/s>\r\n2<\/i>\r\n<\/indexOf> # returns 3??<\/pre>\n
        * insert<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n   1<\/i>\r\n   wiper blades<\/s>\r\n<\/insert>\r\n\r\nThis expression returns the following list.\r\n\r\n\t\r\n   apples<\/s>\r\n   wiper blades<\/s>\r\n   oranges<\/s>\r\n<\/list><\/pre>\n
        * length<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n   <\/list>\r\n<\/length> # returns 2<\/pre>\n
        * remove<\/p>\n
        \r\n\r\n    srclist<\/ref>\r\n    oranges<\/s>\r\n<\/remove><\/pre>\n
        * removeAll<\/p>\n
        <\/pre>\n
        * retainAll<\/p>\n
        <\/pre>\n
        * setlist (and overwrites)<\/p>\n
        \r\n\r\n   \t\r\n      apples<\/s>\r\n      oranges<\/s>\r\n      wiper blades<\/s>\r\n   <\/list>\r\n   2<\/i>\r\n   bassoons<\/s>\r\n<\/setlist>\r\n\r\nThis expression results in the following list and returns null.\r\n\r\n\t\r\n   apples<\/s>\r\n   oranges<\/s>\r\n   bassoons<\/s>\r\n<\/list><\/pre>\n
        Conditional, Iteration, and Block Expressions<\/h3><\/span>\n
        * block<\/p>\n
        \r\n\r\n    Hello there!<\/s>\r\n     100<\/i> 2<\/i> <\/add>\r\n    42<\/i>\r\n<\/block> # returns 42<\/pre>\n
        * break<\/p>\n
        \r\n\r\nlist<\/ref>\r\n   el<\/ref>000<\/s><\/eq>\r\n      \r\n         el<\/ref>\r\n      <\/break>\r\n   <\/cond>\r\n\r\n<\/dolist><\/pre>\n
        * cond (if\/else)<\/p>\n
        \r\n\r\n     \r\n      age<\/ref>\r\n       40<\/i>\r\n     <\/gt>\r\n   old<\/s>\r\n   young<\/s>\r\n<\/cond><\/pre>\n
        * dolist
        \nThe following expression creates a list called subset, which contains the subset of elements in srclist <\/em>that exceed 10.<\/p>\n
        \r\n\r\n    \r\n      srclist<\/ref>\r\n      \r\n        \r\n          el<\/ref>\r\n          10<\/i>\r\n        <\/gt>\r\n      <\/cond>\r\n      el<\/ref>\r\n    <\/dolist>\r\n <\/set><\/pre>\n
        * switch<\/p>\n
        \r\n\r\n   A<\/s>\r\n   \r\n      unknown<\/s>\r\n   <\/case>\r\n   \r\n      A<\/s>\r\n      apples<\/s>\r\n   <\/case>\r\n   \r\n      B<\/s>\r\n      oranges<\/s>\r\n   <\/case>\r\n<\/switch><\/pre>\n
        * select: Returns the first non-null (and non-zero) value in a list.<\/p>\n
        \r\n\r\n   first\/ref>\r\n   second<\/ref>\r\n   third<\/ref.\r\n<\/select><\/pre>\n
        * while<\/p>\n
        \r\n\r\n    \r\n       counter<\/ref>\r\n      0<\/i>\r\n    <\/gt>\r\n   \r\n       counter<\/ref>\r\n         1<\/i>\r\n       <\/sub>\r\n   <\/set>\r\n<\/while><\/pre>\n
        Variables and Function Definition Expressions<\/h3><\/span>\n
        * ref: References the value of a variable. The variable can either be an external variable supported by the host application or an internal variable defined with defvar.<\/p>\n
        \r\nwaveset.role<\/ref>\r\n\r\nmilkvalue<\/s><\/defvar>\r\nmilk<\/s><\/defvar>\r\nshake<\/ref> # returns milkshake<\/s><\/pre>\n
        * defvar<\/p>\n
        \r\n\r\n  \t\r\n     apples<\/s>\r\n     oranges<\/s>\r\n  <\/list>\r\n<\/defvar>\r\n\r\n\r\n   0<\/i>\r\n<\/defvar><\/pre>\n
        * defarg: Defines an argument within a function defined with defun. Arguments are similar to variables, but they must be defined in the order in which arguments are passed to the function.<\/p>\n
        \r\n\r\n<\/pre>\n
        * defun: Defines a new function. The defarg function must be used to declare the arguments to a function. Use the call function to execute the function. Functions are typically defined within forms.<\/p>\n
        \r\n\r\n   \r\n    \r\n       input<\/ref>\r\n       100<\/i>\r\n    <\/add>\r\n<\/defun><\/pre>\n
        * call<\/p>\n
        \r\n\r\n   42<\/i>\r\n<\/call><\/pre>\n
        * rule: Calls a rule<\/p>\n
        \r\n\r\n    \r\n<\/rule>\r\n\r\n\r\n   \r\n       username<\/ref>\r\n   <\/argument>\r\n<\/rule><\/pre>\n
        Object Manipulation Expressions<\/h3><\/span>\n
        * get: Retrieves a value from within an object.<\/p>\n
        \r\n\r\n   \r\n   \r\n<\/get><\/pre>\n
        * putmap<\/p>\n
        \r\n\r\n   userView<\/ref>\r\n   waveset.role<\/s>\r\n   engineering<\/s>\r\n<\/putmap><\/pre>\n
        * setlist<\/p>\n
        \r\n\r\n   myList<\/ref>\r\n   s<\/i>\r\n   accounts<\/s>\r\n<\/setlist><\/pre>\n
        * setvar<\/p>\n
        \r\n\r\n   var<\/ref>\r\n   text<\/s>\r\n<\/setvar><\/pre>\n
        * instanceof<\/p>\n
        \r\n\r\n    \r\n<\/instanceof><\/pre>\n
        Java and JavaScript Expressions<\/h3><\/span>\n
        * invoke
        \n– static method<\/p>\n
        \r\n\r\n   \r\n   \r\n<\/invoke><\/pre>\n
        – instance  method<\/p>\n
        \r\n\r\n   \r\n   \r\n   \r\n<\/invoke><\/pre>\n
        * new: Creates an instance of a Java class.<\/p>\n
        \r\n\r\n\r\n\r\n<\/new><\/pre>\n
        * script: Encapsulates a fragment of JavaScript.<\/p>\n
        \r\n