'Restricted by Access Control' Error in Agent Mobile Applets

Laukik Udpikar
Tera Expert

Hello Experts,

Need your urgent help!!

I'm seeing the error in my multiple mobile applets. Not able to find the source of it. 

 

find_real_file.png

 

This applet was part of a custom application and not the baseline ITSM app provided from plugin. The platform does not show any ACL restrictions on the tables, this issue is only for Mobile Screens.

Please Help ASAP! 

Thanks.

1 ACCEPTED SOLUTION

Laukik Udpikar
Tera Expert

Hello All,

 

I've solved the above issue, in my case the issue occurred after upgrading the instance from Madrid to Quebec.

The Mobile App Structure has been updated after New York.

Mobile hierarchy - Check out this page for detailed structural changes.

Mobile migration from Madrid to New York and later releases - This page will help you understand the updated structure.

 

I'll share my experience in brief, if you have any questions feel free to reach out here.

Let's take the above applet, 'Users'. In Madrid when the app was developed the 'Users' applet was part of 'Folder [sys_sg_folder]' table, and was available on the home screen.

The Folder [sys_sg_folder] table has been deprecated with New York and later. 

find_real_file.png

 

To migrate the apps to the latest version *I've just finished this for Quebec*, you have to navigate to Studio > Open your Application > click on any of the Applet Launcher/Applet record, in my case that'll be Users > You'll see a prompt as below :

find_real_file.png

 

When you click on migrate the system migrates/updates the application to match the new structure. You can check the updates in 'sys_update_xml' table, *capture it in an update set just in case you need to review it later [ single applet will have around 89-100 updates, so better capture different applets it in different update sets just in dev *Optional] It'll hardly take a min or two.

Now when you check your Agent App, the Users folder which was on the home screen will be added to the navigation tab below as an applet launcher. This will be a new record with a new sysid not relating to folder record.

You might or might not see the applets you had created inside this new screen, you'll have to open the studio and create a UI Section and add your applets to it.

find_real_file.png

 

This will surely solve your issue for 'Restricted by access control' error. 

 

Now coming to the important part; It'll be really difficult to move this records from instance to instance, as the migrate buttons runs a script to update the structure in the background, and just moving the records from dev to later won't actually correct the structure *You can test and share your experience*.

I went with this solution instead :

I migrated the applications separately in my Prod and Sub-Prod Instances.

Once Migrated the sysid of newly created records will not match in each instance, so you'll need to export the prod xml and move it to your sub-prod instances *I'll suppose 2 instances for now Dev and Test*

Dev - Migrated manually

Test - Migrated manually

Prod - Migrated manually

*Needs admin access*

I'll share the table names which I moved from prod for reference, but make sure you take all the tables the mapping structure is really large.

1. Navigation Tabs

2. Navigation Tab Maps

3. Applet Launchers

4. Item Stream Segment

5. Item Stream

6. Form Screen/Embeded Screen

7. List Screen

8. Applet Launcher Section 

9. Icon Section

10. Applets

 

Note : When you migrate 'Item Stream Segment' and 'Item Stream' they won't directly map, You'll need to add it manually.

Tip : Before moving the prod XMLs rename your test and dev records as the display names will be same, and it'll confusing for you while mapping those with same name, anyways you won't be using the dev and test records anywhere.

In some reference field while mapping the records you may need to update the list layouts to identify the correct records, keep these changes out of your update sets 

 

View solution in original post

6 REPLIES 6

Krunal2
Tera Contributor

We are facing the same issue for Now mobile app with respect to Knowledge Articles. 

@Antony Jeberson / @Antony Jeberson : FYI ...

Did anyone figure out a fix for this? Having the same issue after upgrading to Quebec...

Hi Steve, from what version did you migrated to Quebec?

Laukik Udpikar
Tera Expert

Hello All,

 

I've solved the above issue, in my case the issue occurred after upgrading the instance from Madrid to Quebec.

The Mobile App Structure has been updated after New York.

Mobile hierarchy - Check out this page for detailed structural changes.

Mobile migration from Madrid to New York and later releases - This page will help you understand the updated structure.

 

I'll share my experience in brief, if you have any questions feel free to reach out here.

Let's take the above applet, 'Users'. In Madrid when the app was developed the 'Users' applet was part of 'Folder [sys_sg_folder]' table, and was available on the home screen.

The Folder [sys_sg_folder] table has been deprecated with New York and later. 

find_real_file.png

 

To migrate the apps to the latest version *I've just finished this for Quebec*, you have to navigate to Studio > Open your Application > click on any of the Applet Launcher/Applet record, in my case that'll be Users > You'll see a prompt as below :

find_real_file.png

 

When you click on migrate the system migrates/updates the application to match the new structure. You can check the updates in 'sys_update_xml' table, *capture it in an update set just in case you need to review it later [ single applet will have around 89-100 updates, so better capture different applets it in different update sets just in dev *Optional] It'll hardly take a min or two.

Now when you check your Agent App, the Users folder which was on the home screen will be added to the navigation tab below as an applet launcher. This will be a new record with a new sysid not relating to folder record.

You might or might not see the applets you had created inside this new screen, you'll have to open the studio and create a UI Section and add your applets to it.

find_real_file.png

 

This will surely solve your issue for 'Restricted by access control' error. 

 

Now coming to the important part; It'll be really difficult to move this records from instance to instance, as the migrate buttons runs a script to update the structure in the background, and just moving the records from dev to later won't actually correct the structure *You can test and share your experience*.

I went with this solution instead :

I migrated the applications separately in my Prod and Sub-Prod Instances.

Once Migrated the sysid of newly created records will not match in each instance, so you'll need to export the prod xml and move it to your sub-prod instances *I'll suppose 2 instances for now Dev and Test*

Dev - Migrated manually

Test - Migrated manually

Prod - Migrated manually

*Needs admin access*

I'll share the table names which I moved from prod for reference, but make sure you take all the tables the mapping structure is really large.

1. Navigation Tabs

2. Navigation Tab Maps

3. Applet Launchers

4. Item Stream Segment

5. Item Stream

6. Form Screen/Embeded Screen

7. List Screen

8. Applet Launcher Section 

9. Icon Section

10. Applets

 

Note : When you migrate 'Item Stream Segment' and 'Item Stream' they won't directly map, You'll need to add it manually.

Tip : Before moving the prod XMLs rename your test and dev records as the display names will be same, and it'll confusing for you while mapping those with same name, anyways you won't be using the dev and test records anywhere.

In some reference field while mapping the records you may need to update the list layouts to identify the correct records, keep these changes out of your update sets