Planning Analytics

 View Only
Expand all | Collapse all

TM1 Model Based Workflow (deprecation of TM1 Applications)

  • 1.  TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Mon July 29, 2024 11:42 PM
    Edited by STUART KING Mon September 09, 2024 10:45 PM

    The deprecation of the rich client tier on Planning Analytics on Cloud and upcoming end of support for Planning Analytics Local 2.0.9 on April 30, 2025, will remove support for TM1 Applications (commonly referred to as TM1 Contributor).  TM1 Applications is not included in the Planning Analytics Local 2.1 release that replaces 2.0.9.  The Plan asset type in Planning Analytics Workspace is the spiritual successor to TM1 Applications.  Like TM1 Applications, Plans layers workflow capabilities on top of existing TM1 models.  The Planning Analytics product team is making significant investment in Workspace Plans to provide workflow capabilities that are familiar to users of TM1 Applications.  These features include assignment of members from an approval or responsibility dimension, locking and unlocking slices of data, and execution of Turbo Integrator processes during submission, approval and rejection of tasks.  


    TM1 Applications has not been universally adopted by Planning Analytics users.  However, it does simplify and accelerate the process of deploying and managing contribution type workflows in Planning Analytics.  Many Planning Analytics customers have implemented custom workflow within the TM1 model, using dimensions and cubes to track the workflow state, and TI processes to update the workflow, set user assignments, manage access to cubes and slices, and add comments.  I've attached a set of TI processes and documentation that demonstrate how workflow can be implemented directly in a the TM1 model without Workspace Plans or TM1 Applications.  This set of processes can be used in both TM1 v11 and v12 models to provide workflow capabilities similar to TM1 Applications.

    I will be happy to respond in this post to questions and feedback regarding these processes. This includes request to implement enhancements and address issues with the TI processes.

    Edit on 9 September 2024.  All Workflow objects and documentation are now available in the following GITHUB repo: https://github.com/StuartStephenKing/PA-Workflow 

    I also want to extend my appreciation to Wim for helping edit the documentation and provide some important feedback.



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 2.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 02:30 AM
    Edited by Sumit Suman Tue July 30, 2024 02:58 AM

    Thanks a lot Stuart for sharing the details, will go through it. We are waiting for the release where Plans will support approval dimension/hierarchy. Will reach out in case I have questions.

    Regards

    Sumit Suman




  • 3.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 06:21 AM

    Thank you very much Stuart.

    One quick question. The TI "}wf_updatenodestate" has:

    ExecuteProcess( '}WF_.LockUnlock', 'pWorkflow', pWorkflow, 'pNode', pNode, 'pLock', pLock );

    I guess the . should be different as well as LockUnlock does not exist as a TI.

    Without going into the details myself, is it }wf_lockunlocknode or }wf_lockunlockworkflow ?

    The text in the Word doc contains:

    The }WF_LockUnlock TI process I called from }WF_UpdateNodeState to adjust the lock state of the nodes

    So I assume it's }wf_lockunlocknode ? The text would need to be slightly adjusted there.

    Will play around more when time permits.

    Best regards,

    Wim



    ------------------------------
    Wim Gielis
    ------------------------------



  • 4.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 07:11 AM

    Hi Wim,

    Thanks for the quick feedback.  You are correct that it should be }WF_LockUnlockNode.  I'll update the processes and replace the attachment. 

    I will also add a few important design details here: 

    1 - The workflow processes do not strongly define node states.  The node state is updated with the }WF_UpdateNodeState process.  When you run this process, presumably from an action button in a PAW book or Websheet, you can use any string you want to update the state.  If you want to emulate TM1 Applications you would use the states listed here (e.g Available, Reserved, Locked, Incomplete, Ready).  As you implement these processes you will need to determine which states should lock or unlock the node.  

    2 - There are two security modes, pSecurityMode parameter in the }WF_CreateWorkflow processs.  The Group security mode uses existing groups in TM1 just like TM1 Applications.  The Client security mode will allow you to name specific users (members in the }Clients dimension) as contributors and reviewers for each node.  When using the Client security the security groups will be created and applied automatically when the }WF_AssignNode process is used to make assignments.

    3 - Locking slices is enforced with the GlobalSecurityOverlay mechanism in TM1, just like TM1 Applications.  However, I have two locking modes, Any and All.  The Any mode means that any user or group that attempts to lock the node when using the }WF_UpdateNodeState process will cause the node to be locked for all contributors assigned to the node.  The All locking mode will prevent the node from being locked until all users or groups assigned to the node have used the }WF_UpdateNodeState process to lock the node.



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 5.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 10:01 AM

    Hi Stuart,

    This is looking good. Were you going to include a sample Websheet? I did not see it embedded in the Word Document or in the zip file.



    ------------------------------
    Walter Coffen
    Technology Manager
    QueBIT Consulting, LLC
    ------------------------------



  • 6.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 10:21 AM

    Likewise:

    The workflow processes can also be pulled into the TM1 database from a GIT repository (zip file containing the repo is included).



    ------------------------------
    Wim Gielis
    ------------------------------



  • 7.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 11:04 AM
    Edited by Sumit Suman Wed July 31, 2024 04:52 AM

    Do we need to run '}tp_admin_delete_all' before utilizing this package. I could not find the websheet in package.



    ------------------------------
    Sumit Suman
    ------------------------------



  • 8.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 12:59 PM

    Hi Sumit,

    These workflow processes are not intended to be used in combination with TM1 Applications.  I suggest testing these workflow processes in a TM1 model without the }tp_ processes.



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 9.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue July 30, 2024 01:08 PM

    Thanks for the reminder.  I will figure out how to add a link to the public GIT repo and sample Websheet soon.

    The Websheet I built mostly focuses on the management of workflows.   This includes creating and deleting the workflows, making assignments, and reviewing errors.



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 10.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Tue September 10, 2024 10:30 AM

    Hi Stuart,

    A demo will be very helpful. Are you planning one? 

    Thanks,

    Luther.



    ------------------------------
    Luther Rapaka
    ------------------------------



  • 11.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Mon August 05, 2024 11:15 AM
    Edited by Jose Luis Señas Cuesta Thu August 08, 2024 03:21 PM

    Hi,

    I am testing the execution of the processes and specifically in }WF_AssignNode, the following error occurs when leaving the pReviewer parameter blank, even though it is optional:

    Regards.



  • 12.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Wed August 14, 2024 03:50 PM

    Hi Jose,

    Appreciate you pointing this out.  I've already made the changes to correct the issue.  I will do a bit more testing and upload a new version of the processes shortly.



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 13.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Sun August 25, 2024 11:31 PM

    Hi, Stuart,

    I was my understanding that the approval hierarchy piece related to TM1 Applications would be included in the 2.0.98 release of Workspace.  I am unable to locate it.  Did this piece not make it into 2.0.98 or is there something that needs to be configured for this to appear?



    ------------------------------
    Jennifer Hoffman
    ------------------------------



  • 14.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Mon August 26, 2024 08:39 AM

    We are targeting the initial set of "Dimension Responsibility" features for the next Planning Analytics Workspace release in October.  



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------



  • 15.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Thu September 05, 2024 01:13 PM

    Hi Stuart,


    First, thank you for sharing the code/websheet and documentation.   We have several customers that are looking at these resources to jump start a transition away from Contributor. 

    I've been working with the code you shared above and have a question.  If we use Group as the Security Mode and a user runs the  }WF_UpdateNodeState TI process, the process errors out because, on line 29, it tries to use the user to update the state but the }WF_workflowname_State cube uses the }Groups dimension not the }Clients dimension (when built from }WF_CreateWorkflow).  I'm wondering if you ran into this and have updated code that you mention in your post? 

    Obviously, we can enhance the TI processes to write to the cube using the }Client or the appropriate }Groups (if the user is a member of that group) but wanted to keep in sync with your shared solution if possible. 

    Thanks,

    Chris Wolfe 

    Converge Technology Solutions



    ------------------------------
    Christopher Wolfe
    ------------------------------



  • 16.  RE: TM1 Model Based Workflow (deprecation of TM1 Applications)

    Posted Mon September 09, 2024 10:31 PM

    Updated TI processes can be found in the following GITHUB repository. 

    https://github.com/StuartStephenKing/PA-Workflow

    I've added a fix for the issue with assigning and removing nodes using existing groups (the Group security mode).



    ------------------------------
    Stuart King
    Product Manager
    IBM Planning Analytics
    ------------------------------