{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":34700,"path":"mobile/config-chart-nav.md","title":"Create a navigation function to a chart screen","bundle":null,"doc_type":null,"release":"australia","body":"\n# Create a navigation function to a chart screen\n\nConfigure a navigation function to direct your users to your chart screen.\n\n## Before you begin\n\nRole required: admin or delegated developer\n\n## Procedure\n\n1. Navigate to **All** > **System Mobile** > **Mobile App Builder**.\n\n The Mobile App Builder opens in a new browser tab and displays the application scope selection screen.\n\n2. Search for the application scope you're working in and then select the name of the application scope.\n\n The Mobile App Builder categories home screen displays.\n\n3. Select the **Functions** category, and then select **New**.\n\n4. Complete the following fields as needed.\n\n\n
\n\nField\n\n\n\nDescription\n\n
\n\n**Properties**\n\n
\n\nName\n\n\n\nName of your navigation function.\n\n
\n\nDescription\n\n\n\nAdditional information about the navigation function.\n\n
\n\nType\n\n\n\nThe type of the function. Since you're creating a navigation to a chart screen, select **Navigation**.\n\n
\n\nContext\n\n\n\nWhether the function uses the global or record context. For this example, select **Global**.\n\n Use record context navigation functions in situations where the navigation depends on information from a record. For example, you want to navigate from the **Assigned to** field in an incident record to the assignee's user record. Use global context navigation functions in a situation where the navigation doesn’t depend on information from a record.\n\n
\n\nAvailable offline\n\n\n\nThis option isn't available for data visualizations.\n\n
\n\nDestination type\n\n\n\nThe type of record your navigation function brings users to. Since you're creating a navigation to a chart screen, select **Screen**.\n\n
\n\nAuto-populate screen parameters\n\n\n\nAutomatically populates parameters in the destination screen.\n\n
\n\nDestination screen\n\n\n\nThe screen or screen launcher to use for your navigation function’s destination. Either select an existing chart screen or select **New** to create a new chart screen.\n\n
\n\nTable\n\n\n\nTable that the function uses.\n\n This field is only visible when the **Context** field is set to **Record**.\n\n
\n\n**Conditions**\n\n
\n\nCondition Type\n\n\n\nThe conditions applied to the chart screen.\n\n - **Declarative**: Adds a condition builder to the form. For more information, see [Condition builder](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/platform-user-interface/c_ConditionBuilder.md).\n- **Script**: Adds a script condition field to the form.\n This field is only visible when the **Context** field is set to **Record**.\n\n
\n\nCondition Definition\n\n\n\nThis is a condition that must be met for the function to be visible in the app for the user to select. For example, if you don’t want to let someone navigate to a screen of tasks until after they've clocked in for the day.This field is only visible when the **Context** field is set to **Record**.\n\n
\n\nCondition\n\n\n\nThis is a condition that must be met for the function to be visible in the app for the user to select. For example, if you don’t want to let someone navigate to a screen of tasks until after they've clocked in for the day.\n\n
\n\nRedirection destination fields\n\n\n\nAllows you to connect the function to a screen that uses a parameterized data item.\n\n
\n\nButton attributes\n\n\n\nSpecifies an additional attribute for a button. Select **New** to configure this option. You can select from the following button attributes:\n\n - **alerts\\_require\\_dismissal:** The button attribute when set to true enables the banner messages to persist until the user dismisses it. By default, banner messages are automatically dismissed.\n- **used\\_for\\_deeplink:** The button attribute when set to true determines that the button is used for deep linking. For more information, see [Deep linking for mobile](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/deep-link-mobile.md).\n- **trigger\\_offline\\_cache\\_download:** The button attribute when set to `true` triggers offline cache generation. After the cache is successfully generated, a download of it is triggered.\n- **check\\_acl\\_on\\_url\\_parameter\\_field:** When this button attribute is selected and set to `true`, any field in the URL string is checked against the ACL \\(access control list\\). For example, a string like `{{meeting_id}}`. If a field doesn't pass this check, the field value isn't included in the URL. By default, the URL parameter field isn't checked against the ACL for backward compatibility.\n\n\n
\n\nRole access\n\n\n\nDetermine which user roles can access this screen. If you have selected no roles, users with any role will have access to the screen.\n\n
5. Select Navigation from the **Type** field.\n\n6. Select Global from the **Context** field.\n\n7. Select Screen from the **Destination type** field.\n\n8. From the Destination screen field, select the chart screen you created in the topic [Create a chart screen for a data visualization](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/config-single-score-applet.md).\n\n9. Select **Save**.\n\n\n## What to do next\n\nAfter you create a navigation link to the chart screen, you must associate this navigation function to the analytics preview. For details on this process, see [Add a navigation function to an analytics preview](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/config-chart-nav-2.md).\n\n- **[Add a navigation function to an analytics preview](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/mobile/config-chart-nav-2.md)** \nConfigure your analytics preview to use a navigation function. This function directs your users to your chart screen from the analytics preview on your screen launcher.\n\n"}}