Archive: Process Manager Knowledge Articles

TopicHow to link a Decision Link to an Activity rather than a Process. InstructionsTo link to an activity instead of a Process, select Activity from the drop down menu for the decision.  

TopicHow to change a Process Owner or Expert for a Process InstructionsUpdate the Process directly:Navigate to the Edit tab of the Process Change to the Summary section Update the Process Owner or Expert Save & Publish the ProcessUse the User panel global replace:Navigate to Admin > Users Edit the existing Process Owner or Expert Select the Transfer option in the Ownerships and Rights section Tick the Processes you wish to transfer Select the user to transfer this Ownership to Select Transfer Additional InformationNOTE: There is a little triangle next to the process that states There are unpublished changes which will be published if the ownership is transferred.

TopicCan I export a CSV of the configuration settings for my Process Manager tenant? InstructionsThis can only be done via contacting Nintex Support.  

IssueUser cannot locate the Process Tabs ( Map, Procedure, Checklists, Edit) ResolutionCheck if the Summary Tab has been fully expanded and is covering the Tabs.   

IssueImage in .gif file type is not displayed when the process is printed. This is most likely due to a pixel format that does not convert to a PDF as expected. Error CodeThe image in the printed process will look like the example below instead of the image itself.ResolutionConvert images to .png or .jepg and add the new file to the process. Additional Information  Related Links  

IssueTodos that are included in a Process that is archived may not be removed from the My Todos dashboard. ResolutionRestore the Process from the archives Remove the @todos from the Process Save & Publish the Process Select Archive from the cog wheel menu 

IssueSingle Sign On authentication fails with the following error in the error logs: 2019-04-15 18:31:24.2538 [46] [ERROR] [phsa] [] [] [Promapp.Controllers.SamlController] Saml Authentication failed System.NullReferenceException: Object reference not set to an instance of an object.at Promapp.Common.Saml.SamlResponse.get_NameId()at Promapp.Controllers.SamlController.Authenticate(String samlResponse, String relayState) ResolutionEnsure that the LDAP claim attributes have been chosen from the dropdown list rather than typed into the boxes.They should look as per the below screen capture, including the hyphens.    Additional InformationThis affects clients using ADFS as their Identity Provider.Section 3 of this help article covers the claim mapping. https://help.promapp.com/help/Process/Minimode/Permalink/GdXHH8hQ2AHupsoFNdXUPw 

IssueThe following error message is displayed even though the Browser is IE 11:Unsupported Browser Detected: Internet Explorer 7  ResolutionEnsure that promapp.com is not included in the compatibility view settings.  For On Premise clients ensure the Display intranet sites in compatibility mode option is unticked.    Additional InformationThese settings may be controlled by a group policy.  You may need to contact your IT team to adjust this setting. 

IssueProcess Owner or Expert may not be able to see all the Processes they are the Owner or Expert of. ResolutionPublish the Process for the Owner or Expert to change. Additional InformationProcess Owner or Expert changes will not show in the "Processes I Own" list and the new Owner or Expert will not have rights to edit the Process until the Process has been published.  

IssueA user may appear to be showing in the incorrect role in a swimlane in the Map View. ResolutionWhere more than one role is included in a Process Map swimlane.  The users included in all the roles are merged in the pop up users list.  

IssueThe On Premise Nintex Promapp upgrade for a client fails with errors when running the SQL migration scripts.  ResolutionCheck if their SQL server meets the minimum specifications included in their upgrade package (Currently SQL Server 2017).  If this is correct, ask them to run the following commands on their Nintex Promapp Daabase: SELECT compatibility_levelFROM sys.databases WHERE name = ‘Promapp_database_name_here’; If you see anything less than 130 in the output, the following should be run:ALTER DATABASE [Promapp_database_name_here] SET COMPATIBILITY_LEVEL = 130 At this point the compatibility level should be right. They can then retry the scripts that are failing.  

IssueFilters that have been applied are not sticking when navigating to a different part of a Nintex Promapp site and then returning again. ResolutionEnsure that your Browser session has not expired.Filters should stick if you leave one part of theNintex  Promapp site (e.g. Improvements add on) and then return to it within the same Browser session the same filters should be selected.  Shutting your Browser down or logging out of Nintex Promapp the filters will be removed.   

IssueWhen Document Approval is turned off Documents that were Awaiting Approval remain in this state, and cannot be approved.   ResolutionIf uploading, download or obtain a copy of the Document, If linking obtain the correct link for the Document Edit the Document that has Awaiting Approval state in the Document library Select the Approval Required Menu Select the Replace Pending option Chose the file you downloaded or enter the link 

IssueTasks in activities are showing out of order. For example: A,B,C,D,F,GCorrect Order: A,B,C,D,E,F,G  ResolutionThe resolution for this is to go to the process > Edit the process from the edit tab > Find the missing activity which is displayed underneath the previous activity and just click at the bottom of the shown activity. This will then reveal the missing activity which can then be edited.   

IssueA Customer would like information contained in two different reports to be shown in one report ResolutionThe best way to do this is to export the two reports to Excel, then use a Vlookup or other excel tools to compare the data in the two reports.   

IssueNintex Promapp Viewing Permissions on a Group may not be applied immediately.   ResolutionThere is a background job that runs every time viewing permissions are set up.  This job goes through and sets up the permissions for each user.  If there is a backlog of background jobs, or you have a high number of users, this may affect how long it takes for this to run.  Please contact support@nintex.com if it seems to take too long, and we will investigate further.  

IssueThe follow error may occur when attempting to save a Nintex Promapp Process:Oops.  An unspecified error has occurred ResolutionTry the following:Clear Browser cache & History Try another browser Ask another user to try and saveIf these options fail, make a copy of the Process and archive the Process that gives the error. 

IssueClients may write in with Nintex Promapp methodology questions.Examples:Why can't I loop to another activity in the Process from a decision? Go to a activity further in the process from a decision Wants to add many activities following a decision ResolutionFor basic questions, we can answer to the best of our ability.  It pays to point them towards this Process Writing help page https://help.promapp.com/help/Process/Minimode/Permalink/HffVjHfduAQwtkWzeu153aLearn.nintex module that covers this aspect #3 Capture exceptions and variations.   https://learn.nintex.com/promapp-for-process-authors-engaging-process-writing-techniques/278186/scorm/1rsde730x626cAny more complex queries should be directed to their CSM.Decision Loop support:Nintex Promapp does not support decision flows that loop back to another activity in the process.  This is a deliberate restriction in Nintex Promapp as we believe that this type of flow makes the process difficult to understand.  We recommend breaking com

IssueChecklist has been enabled but the functionality is not available ResolutionIt can take some time to sync a large tenants’ data to the Checklist Service. The UI will not appear until the Checklist service confirms it has processed all initial sync data.Check Promapp Hangfire jobs ChecklistUserInfoSyncTrigger and SyncCompleteMessageAcknowledgedTrigger have not failed or are stuck in a queue.Check Promapp and Checklist CloudWatch logs for message handling exceptions, particularly those with the topics: ChecklistService-TenantModuleToggled, ChecklistService-TenantModuleSyncCompleteAcknowledged.All message processing performed by Checklist is idempotent so you are safe to enable and disable the Checklist module if you need to trigger a resync of user/role data 

IssueWhen printing a report from Nintex Promapp the last column of the report is truncated.  ResolutionUncheck the fit to page option or download the PDF version and use the PDF reader scaling options to ensure all columns are visible on the page. Additional InformationThis occurs for users that use Letter size paper. 

IssueThere is no option to reset the password either through the users profile or from the Admin > Manage Users page ResolutionWhen Single Sign on is set to 'required' there is no option to reset the password as this is the responsibility of your Identity Provider.   

IssueProcesses that are linked in a Decision link are showing on the Process map and in the Procedure view as Unassigned ResolutionEdit the Decision link and assign a role to the Process in the Decision Link 

IssueCan’t create checklists or Checklists can’t be listed ResolutionUser not authenticated with ChecklistService, receives 401 error responseYou can verify the 401 response by checking the Network tab of the browser dev toolsHas their Promapp session expired? If so, the client application will not have a valid access token.  Request the user to login to Promapp again.Has the user data not been synced correctly?  If the user data has not synced correctly between Promapp and Checklist then authentication issues will arise.Toggle the checklist service off then on, this should resync all user data 

IssueSome Processes may be missing from the Process Hits report ResolutionWhere a date filter has been set, the Processes with no hits during the set time period will not be included in the report.   

IssueA user may receive the following error when trying to create variations for a Process in Nintex Promapp:Your request couldn't be created at this time.  Please contact your Promaster. ResolutionPublish the Process you wish to create Variations for.  This may need to happen even if the Process is currently Published.   Attempt to create the Variations again.