{"id":10553,"date":"2015-05-14T15:12:47","date_gmt":"2015-05-14T20:12:47","guid":{"rendered":"http:\/\/jianmingli.com\/wp\/?p=10553"},"modified":"2015-07-29T16:23:53","modified_gmt":"2015-07-29T21:23:53","slug":"sun-idm-8-1using-the-identity-manager-ide","status":"publish","type":"post","link":"https:\/\/jianmingli.com\/wp\/?p=10553","title":{"rendered":"Sun IDM 8.1:Using the Identity Manager IDE"},"content":{"rendered":"
\n

Contents<\/h2>\n
    \n\t
  1. \n\t\tIntro<\/a>\n\t<\/li>\n\t
  2. \n\t\tDownload and Install IDE<\/a>\n\t<\/li>\n\t
  3. \n\t\tIDM projects<\/a>\n\t\t
      \n\t\t\t
    1. \n\t\t\t\tIdentity Manager Project<\/a>\n\t\t\t\t
        \n\t\t\t\t\t
      1. \n\t\t\t\t\t\tCreate IDM Project<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t\t
      2. \n\t\t\t\t\t\tSet Current CBE Target<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t\t
      3. \n\t\t\t\t\t\tManage Embedded Repository<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t<\/ol>\n\t\t\t
      4. \n\t\t\t\tIdentity Manager Project (Remote)<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
      5. \n\t\tWorking with Repository Objects<\/a>\n\t\t
          \n\t\t\t
        1. \n\t\t\t\tSupported Object Types<\/a>\n\t\t\t<\/li>\n\t\t\t
        2. \n\t\t\t\tGetting objects from repository<\/a>\n\t\t\t\t
            \n\t\t\t\t\t
          1. \n\t\t\t\t\t\tRemoving Object IDs<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t\t
          2. \n\t\t\t\t\t\tAutomatically Upload Objects to Repository<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t\t
          3. \n\t\t\t\t\t\tUsing CBE Pattern Substitution<\/a>\n\t\t\t\t\t<\/li>\n\t\t\t\t<\/ol>\n\t\t\t
          4. \n\t\t\t\tCreate New Objects<\/a>\n\t\t\t<\/li>\n\t\t\t
          5. \n\t\t\t\tEdit Object Properties<\/a>\n\t\t\t<\/li>\n\t\t\t
          6. \n\t\t\t\tDelete Objects<\/a>\n\t\t\t<\/li>\n\t\t\t
          7. \n\t\t\t\tDiff Objects<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
          8. \n\t\tWorking with XML<\/a>\n\t<\/li>\n\t
          9. \n\t\tIDE Debugger<\/a>\n\t\t
              \n\t\t\t
            1. \n\t\t\t\tDebugging Forms<\/a>\n\t\t\t<\/li>\n\t\t\t
            2. \n\t\t\t\tTest Rules<\/a>\n\t\t\t<\/li>\n\t\t\t
            3. \n\t\t\t\tDebugging Workflows<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
            4. \n\t\tTutorial<\/a>\n\t\t
                \n\t\t\t
              1. \n\t\t\t\tImport debugger-tutorial.xml<\/a>\n\t\t\t<\/li>\n\t\t\t
              2. \n\t\t\t\tStart Debugging<\/a>\n\t\t\t<\/li>\n\t\t\t
              3. \n\t\t\t\tExample 1: Debugging a Workflow and a Rule<\/a>\n\t\t\t<\/li>\n\t\t\t
              4. \n\t\t\t\tExample 2: Debugging a Workflow Containing a Manual Action and a Form <\/a>\n\t\t\t<\/li>\n\t\t\t
              5. \n\t\t\t\tExample 3: Debugging the Tabbed User Form and Refresh View<\/a>\n\t\t\t<\/li>\n\t\t\t
              6. \n\t\t\t\tDebugging Java and XPRESS<\/a>\n\t\t\t<\/li>\n\t\t<\/ol>\n\t
              7. \n\t\tReferences<\/a>\n\t<\/li>\n<\/ol>\n<\/ol>\n<\/div>\n
                 <\/div>\n

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

                * IDM IDE is used to:
                \n– CRUD configuration and generic objects, forms, workflows, rules, email templates, and rule libraries
                \n– Download\/upload objects to repository
                \n– Debug forms, rules, and workflows
                \n– Create projects that are associated with specific repositories<\/p>\n

                Download and Install IDE<\/h2><\/span>\n

                * Download IDE from here<\/a>. E.g. IDM 8.1 GA<\/a>
                \n* Install downloaded plugin into Netbeans using Tools > Plugins > Downloaded > Add Plugins…<\/em><\/p>\n

                IDM projects<\/h2><\/span>\n

                * An IDM Project is tied to one and only one specific repository
                \n* Each IDE project is tied to a specific IDM version which is provided in the compatibility bundle<\/p>\n

                Identity Manager Project<\/h3><\/span>\n

                * Fully featured dev environment including:
                \n– a sample CBE (Configuration Build Environment)
                \n– can manage Java code and JSPs
                \n– interact with NetBeans embedded app server so you can deploy idm.war file locally
                \n– integrated Java, JSP, workflow, form and XPRESS debugging
                \n– embedded database repository
                \n* Compatibility bundle is included in idm.war
                \n* Upgrade project to a newer version:
                \n– Shutdown NetBeans
                \n– Manually upgrade all your objects, custom JSPs, and the contents of your project’s idm-staging directory
                \n– replace the existing nbproject\/ide-bundle.zip with that from the version to which you are upgrading.<\/p>\n

                Create IDM Project<\/h4><\/span>\n
                \"idm81_ide_createProj_1\"<\/a><\/h6><\/span>\n
                \"idm81_ide_createProj_2\"<\/a><\/h6><\/span>\n
                \"idm81_ide_createProj_3\"<\/a><\/h6><\/span>\n

                * Create embedded repository: creates an embedded repository for the default sandbox<\/em> CBE target (based on hsql DB Server @ jdbc:hsqldb:hsql:\/\/127.0.0.1:54881\/idm)
                \n– Initialize repository: imports init.xml file from idm.war. Do not<\/strong> enable this if you want to reuse a repository from another project
                \n– Automatically Publish Identity Manager Objects: publish every time you Run or Debug project<\/p>\n

                \"idm81_ide_createProj_4_embeddedRepo\"<\/a><\/h6><\/span>\n

                * Manually setup repository:
                \n– copy jdbc jar file, e.g. mysql-connector-java-5.1.6-bin.jar, into project’s custom\/WEB-INF\/lib<\/em> directory
                \n– right click project name and select IDM > Run LH<\/em> Command
                \n– enter setup<\/strong> into LH Command field and then click OK
                \n* Setup repository, e.g. using MySQL:
                \n– welcome screeen:<\/p>\n

                \"idm81_ide_createProj_6_runLH\"<\/a><\/h6><\/span>\n
                <\/h6><\/span>\n

                – db connection:<\/p>\n

                \"idm81_ide_createProj_6_runLH_mysql\"<\/a><\/h6><\/span>\n

                – setup demo user:<\/p>\n

                \"idm81_ide_createProj_6_runLH_demo\"<\/a><\/h6><\/span>\n

                – smtp setting:<\/p>\n

                \"idm81_ide_createProj_6_runLH_SMTP\"<\/a><\/h6><\/span>\n

                – apply configuration:<\/p>\n

                \"idm81_ide_createProj_6_runLH_execute\"<\/a><\/h6><\/span>\n

                – done:<\/p>\n

                \"idm81_ide_createProj_6_runLH_done\"<\/a><\/h6><\/span>\n
                <\/h6><\/span>\n

                Set Current CBE Target<\/h4><\/span>\n

                * Right click IDM project and select Properties<\/em>
                \n* Set IDM Instance: IDM Properties > IDM Instance > Current CBE Target<\/em><\/p>\n

                \"idm81_ide_setIDMInst_1\"<\/a><\/h6><\/span>\n

                Manage Embedded Repository<\/h4><\/span>\n

                * IdM > Repository > Manage Embedded Repository<\/em><\/p>\n

                \"idm81_ide_mngEmbedRepo_1\"<\/a><\/h6><\/span>\n

                Identity Manager Project (Remote)<\/h3><\/span>\n

                * Used to make small modifications and to perform debugging on an external server
                \n– no build environment
                \n– cannot launch idm.war file
                \n* Compatibility bundle location:
                \nIdentity Manager install root\/sample\/ide-bundle.zip<\/em> <\/p>\n

                Working with Repository Objects<\/h2><\/span>\n

                Supported Object Types<\/h3><\/span>\n

                * Configuration object: a persistent object that contains forms and workflow processes.
                \n* Email templates: templates used to send notification of varioius changes and actions to user and administrators.
                \n* Form: an object associated with a web page that contains rules about how a browser should display user view attributes on that page. Form can contain business logic.
                \n* Generic object: An object typically used to represent views, such as simple collections of name\/value pairs. Generic objects have an Extension of type Object.
                \n* Library: An object used to organize closely related objects, typically rules, into a single object in the repository. Organizing objects into libraries makes it easier for workflow and form designers to identity useful objects.
                \n* MetaView: In Identity Manager, a meta view is a unified view of all resources, providing a common data model in which to view a set of resources and how attributes on these resources flow from one to another.
                \n* Rule: Objects in the Identity Manager repository that contain functions written in the XPRESS, XML Object, or JavaScript languages. Within Identity Manager, rules store frequently used logic or static variables for reuse in forms, workflows, and roles.
                \n* Workflow Process: A workflow is a logical, repeatable process during which documents, information, or tasks are passed from one participant to another. Identity Manager workflows comprise multiple processes that control user accounts, such as account creation, update, enabling, disabling, and deletion.
                \n* Workflow Subprocess: An object used to create a workflow subprocess to be included in a workflow.<\/p>\n

                * Check out view<\/p>\n

                Getting objects from repository<\/h3><\/span>\n

                * Right click Custom Identity Manager Objects, select IDM <\/em>and then appropriate actions:<\/p>\n

                \"idm81_ide_IDM-popupMenu\"<\/a><\/h6><\/span>\n

                – Download Object(s)
                \n– Open object<\/p>\n

                \"idm81_ide_openObject_1\"<\/a><\/h6><\/span>\n

                – Open object reference<\/p>\n

                \"idm81_ide_openObjectReference_1\"<\/a><\/h6><\/span>\n
                \"idm81_ide_openObjectReference_2\"<\/a><\/h6><\/span>\n
                \"idm81_ide_openObjectReference_3\"<\/a><\/h6><\/span>\n

                – Reload object(s)
                \n– Upload object(s)<\/p>\n

                Removing Object IDs<\/h4><\/span>\n

                * Used to move objects from one repository to another
                \n* Identity Manager IDE locates and removes all object IDs and objectRef IDs that conform to a specified expression \u2014 without removing any hard-coded, predefined IDs.<\/p>\n

                Automatically Upload Objects to Repository<\/h4><\/span>\n

                * Only available for embedded repository: IDM > Manage Embedded Repository > Automatically Publish Identity Manager Objects<\/p>\n

                \"idm81_ide_IDM-autoPublish\"<\/a><\/h6><\/span>\n

                Using CBE Pattern Substitution<\/h4><\/span>\n

                * Used when uploading objects to an embedded or external instance
                \n* Enabled by Properties > IDM Properties > Miscellaneous > Apply Pattern Substitution<\/em><\/p>\n

                \"idm81_ide_IDM-patternSub\"<\/a><\/h6><\/span>\n

                * Pattern substitutions are defined in target-name.properties<\/em>, which is defined in build.xml<\/em> and defaults to IDM project root directory.
                \n* For example, sandbox-target.properties:<\/p>\n

                \r\n#Target Properties\r\n#Fri Nov 03 10:00:07 CST 2006\r\n%%IDM_URL%%=http\\:\/\/localhost\\:9191\/idm\r\n%%TARGET_NAME%%=sandbox\r\n%%NOTIFICATION_REDIRECT%%=\r\n%%TABLESPACE%%=abc_sandbox\r\n%%SMTP_HOST%%=mail.xyzcompany.com\r\n%%DEFAULT_FROM_ADDRESS%%=admin@xyzcompany.com\r\n%%LOG_DIR%%=C\\:\/temp\r\n%%CUSTOM_SERVER_REPOSITORY%%=nbproject\/private\/sandbox-ServerRepository.xml\r\n<\/pre>\n
                Create New Objects<\/h3><\/span>\n
                * File > New File… > Sun Identity Manager Objects<\/em><\/p>\n
                \"idm81_ide_IDM-createNewObj_1\"<\/a><\/h6><\/span>\n
                Edit Object Properties<\/h3><\/span>\n
                * Expression builder dialog?
                \n* Add elements to an object<\/p>\n
                Delete Objects<\/h3><\/span>\n
                Diff Objects<\/h3><\/span>\n
                Working with XML<\/h2><\/span>\n
                IDE Debugger<\/h2><\/span>\n
                * Start debugger: Proj > IDM > Attach Identity Manager Debugger<\/em>
                \n* Set breakpoints: click left margin of the source editor, immediately adjacent to the tag where you want to add a breakpoint.
                \n* Using watches
                \n* Step through:
                \n– F7: step into
                \n– F8: step over
                \n– Ctr-F7: step out<\/p>\n
                Debugging Forms<\/h3><\/span>\n
                * Launch form tester: from form xml source, right click form element and select Test Form<\/em>
                \n* To avoid login every time you test a form, Set System Configuration > allowInterAppAuthentication<\/em> to true<\/strong><\/p>\n
                Test Rules<\/h3><\/span>\n
                * Setup Rule Tester input values: from rule xml source, right click rule element and select Test Rule…<\/em> (note the …). Enter input test values:<\/p>\n
                \"idm81_ide_IDM-testRule_1_input\"<\/a><\/h6><\/span>\n
                * Launch Rule Tester: from rule xml source, right click rule element and select Test Rule<\/em>
                \n* Start IDM Debugger: Run > Debug Main Project<\/em>
                \n* Set a breakpoint for the rule
                \n* Launch Rule Tester <\/em>to test together with debugging.<\/p>\n
                Debugging Workflows<\/h3><\/span>\n
                Tutorial<\/h2><\/span>\n
                Import debugger-tutorial.xml<\/h3><\/span>\n
                * Login IDM as configurator<\/em>
                \n* Select Configure > Import Exchange File<\/em>
                \n* Browse to C:\\prog\\apache-tomcat-6.0.41\\webapps\\idm\\sample\\debugger-tutorial.xml<\/em><\/p>\n
                \"idm81_ide_IDM-tutorial_prepare_1\"<\/a><\/h6><\/span>\n
                * Click Import<\/em><\/p>\n
                \"idm81_ide_IDM-tutorial_prepare_2\"<\/a><\/h6><\/span>\n
                Start Debugging<\/h3><\/span>\n
                * From IDE, download objects:
                \n– debugger-tutorial-workflow1
                \n– debugger-tutorial-workflow2
                \n* Restart Tomcat
                \n* Launch IDE Debugger: Run > Debug Main Project<\/em><\/p>\n
                Example 1: Debugging a Workflow and a Rule<\/h3><\/span>\n
                * Open debugger-tutorial-workflow1.xml<\/em> object
                \n* Set breakpoint at the start of the workflow to the right of WFProcess<\/em>
                \n* Login IDM, select Server Tasks > Run Tasks<\/em>
                \n* Click debugger-tutorial-workflow1<\/em><\/p>\n
                Example 2: Debugging a Workflow Containing a Manual Action and a Form <\/h3><\/span>\n
                * Open debugger-tutorial-workflow2.xml<\/em> object
                \n* Set breakpoint at the start of the workflow to the right of WFProcess<\/em>
                \n* Login IDM, select Server Tasks > Run Tasks<\/em>
                \n* Click debugger-tutorial-workflow2<\/em><\/p>\n
                Example 3: Debugging the Tabbed User Form and Refresh View<\/h3><\/span>\n
                * Create a new XPRESS breakpoint:<\/p>\n
                \"idm81_ide_IDM-tutorial_breakpoint_refreshView_1\"<\/a><\/h6><\/span>\n
                * From IDM create a new user: Accounts > New User<\/em>
                \n* Enter first name and last name
                \n* Click a different tab to trigger a refresh view operation<\/p>\n
                Debugging Java and XPRESS<\/h3><\/span>\n
                * Create Java classs:<\/p>\n
                \r\npackage testpackage;\r\n\r\npublic class TestClass {\r\n\r\n    public static String concat(String s1, String s2) {\r\n        return s1 + s2;\r\n    }\r\n}\r\n<\/pre>\n
                * Create TestRule.xml:<\/p>\n
                \r\n\r\n\r\n\r\n    \r\n        \r\n    <\/MemberObjectGroups>\r\n    \r\n        myprefix.<\/s>\r\n        arg2<\/ref>\r\n    <\/invoke> \r\n<\/Rule>\r\n<\/pre>\n
                * Clean, rebuild
                \n* Test Rule<\/p>\n
                References<\/h2><\/span>\n
                * Using the Identity Manager IDE<\/a>
                \n*                 Identity Manager IDE Wiki<\/a>
                \n*                 DENTITYMANAGERIDE Downloads<\/a>
                \n*                 Sun Java[TM] System Identity Manager 7.0 Deployment Tools<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
                Intro * IDM IDE is used to: – CRUD configuration and generic objects, forms, workflows, rules, email templates, and rule libraries – Download\/upload objects to repository – Debug forms, rules, and workflows – Create projects that are associated with specific … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_exactmetrics_skip_tracking":false,"_exactmetrics_sitenote_active":false,"_exactmetrics_sitenote_note":"","_exactmetrics_sitenote_category":0,"jetpack_post_was_ever_published":false,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[530],"tags":[539,651],"class_list":["post-10553","post","type-post","status-publish","format-standard","hentry","category-sunidm","tag-ide-2","tag-sunidm"],"jetpack_publicize_connections":[],"jetpack_featured_media_url":"","jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/p8cRUO-2Kd","_links":{"self":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/10553","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=10553"}],"version-history":[{"count":13,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/10553\/revisions"}],"predecessor-version":[{"id":10841,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=\/wp\/v2\/posts\/10553\/revisions\/10841"}],"wp:attachment":[{"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=10553"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=10553"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/jianmingli.com\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=10553"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}