Understanding the basics

Jigx Concepts

13min
{{jigx}} uses concepts, terminology, and elements you might not be familiar with below is an explanation of the main core concepts to help you understand and use {{jigx}} better jigx solutions {{jigx}} refers to a native mobile app as a solution with {{jigx}} you can build and publish more than one solution to your {{jigx}} mobile app you can switch between the solutions by tapping the profile icon in the navigation bar and selecting the switch button to go to the solution you want the currently active solution in the app is displayed to the left of the switch button home hub the home hub is the first screen you see when you open and sign into the jigx mobile app the {{homehub}} can display navigational menu blocks called grid items, containing images , widgets, or custom controls once you tap on a grid item, you are directed to a {{jig}} , which is a screen used to display various forms of content the index jigx file is the place to configure the bottom navigation bar in addition to grid items, you can style the {{homehub}} by adding a video player docid\ h7boxn9mnb f5xpbfzpkr or carousel docid\ g75 zhiiss3axc7uqriwv at the top of the {{homehub}} for more information, see home hub docid 4flxgln9c4 r1xr3uodi4 and creating a home hub docid\ qz5pfkecffefci5wldirm jigx builder native mobile solutions are built in microsoft visual studio code, a development environment installed on many platforms, including windows and mac {{jigx}} extends {{vscode}} with the jigx builder (code editor) docid\ b7lnrbsddipho31jxwdha , which is an extension that allows you to build, test, and publish {{jigx}} mobile app solutions the {{jigxbuilder}} extension uses yaml, sql, json, and jsonata a yaml editor is provided that includes intellisense, which allows for code completion by simultaneously pressing the control and spacebar (ctrl+space) keys only valid options in the current cursor context are displayed in the code popup there is built in debugging docid\ psqdlve46kfecb4fzb6tb functionality to assist with troubleshooting your development predefined code snippets are provided in the jigx files to help make development easier and faster the {{jigxbuilder}} loads with a editor docid 5zrvshwiixwud2fbzsybv to categorize the various files needed to build app solutions these folders are actions, assets, databases, datasources, functions, jigs, and translations index jigx file the index jigx file is located at the root of the {{jigx}} solution project in the {{jigxbuilder}} in the index jigx file, you configure what must be displayed on the home screen ( {{homehub}} ) of your solution on the jigx mobile app the file opens with a pre populated code snippet to help you configure the {{homehub}} for more information, see index settings docid\ t7tbqmt1cpfsjkub2ubio , and creating a home hub docid\ qz5pfkecffefci5wldirm widgets widgets are navigational menu blocks set up on {{jig}} s, allowing them to be utilized in various parts of the solution, including the {{homehub}} and multiple {{jig}} s (screens) these widgets are configurable to display various ui elements, such as locations, images, charts, and more for more information, see content widget components docid 2yo2t59fyesszbbxawbgl jig a {{jig}} is a container used to configure content a {{jig}} can be configured as a calendar, a form to capture or view data, a pdf or html document, a list of data, or even a combination of any one of these usually, tapping on a widget in the home hub docid 4flxgln9c4 r1xr3uodi4 opens a {{jig}} for more information, see jigs (screens) docid\ vigjcny6nozg oaevzce7 and jig types docid\ bt1u hapuotqlnd9kcblx sections in this guide components components are elements that can be used when creating a {{jigx}} solution in the {{jigxbuilder}} these elements provide an incredible amount of functionality components include interactive images, video players, expanders, and charts for more information, see components (controls) docid\ aawo0l3 juuug9 cnwufb and components docid\ uu0nisptjmp60lbphwqln example topics in this guide actions actions allow you to do something, for example, go back to a previous screen, open a url, or submit a form for more information on the available actions as well as code samples for each one, see the actions docid 0scdcfjz1i4pipkl 51hi and actions docid\ gu ono2fthxflcl2fidup sections of this guide functions functions enable integration with other platforms through data providers creating a new function using one of the provided template options adds the skeleton code to the function definition, making it easier to configure with their authentication requirements for more information, see rest functions docid\ ozuk ogm5yr4cxqa4zwyl , soap functions docid\ dt6pd 4av91yd6kjkavks , and sql functions docid\ ztgsd1mwywsz ajhddyk0 expressions expressions allow you to structure data before binding them to the ui components expressions are jsonata language based jsonata is a lightweight query and transformation language for json data jsonata is a rich complement of built in operators and functions providing options to manipulate and combine data learn more about jsonata and try out your expressions in their jsonata exerciser the root element of expressions in jigx files starts with "@ctx" vs "$ " in jsonata exerciser (e g @ctx data vs $ data) jigx supports shorthand $ expressions for jsonata for more information, see expressions docid 381lsriefhbm5 26p9ogs , expressions cheatsheet docid fdz7xilknixybvpgtye and expressions docid\ jb86xnpr4ubjas7pyw8ky datasources datasources docid\ ddg nus2 7g lb9idn4pe are sets of data that are available throughout your whole solution (global) or only inside a {{jig}} (local) datasources can be static or dynamic jigx dynamic data is a built in database that can be used to create, read, update, and delete data in an app the underlying data store for {{dynamicdata}} is a nosql store this means that each record can have its own field structure, and you can add or remove any fields on a per record basis only the id column is a system column and cannot be changed or removed from the record jigx {{dynamicdata}} is managed in {{jigxmanagement}} for more information, see dynamic data docid\ kul3jbwhwliqudagdjgxc and dynamic data docid\ n5pifch8amav3yff2xua9 database a data providers docid 3xir m as0cunvmxayrgn is a service that accepts data inputs and returns data outputs {{jigx}} data providers include dynamic, local, rest, salesforce, soap and sql for more information see data providers docid 3xir m as0cunvmxayrgn and data providers docid\ bpvjnsbhaqeahebc4od1o entities entities are tables in {{jigx}} dynamic data or other databases where your data gets saved, created, updated, and deleted use an action such as execute entity to work with the data {{jigx}} data is managed in the data docid 5w2tlpzbxlebboq83bzb menu option in {{jigxmanagement}} other databases are managed using the connections https //docs jigx com/connections , sql functions docid\ ztgsd1mwywsz ajhddyk0 , rest functions docid\ ozuk ogm5yr4cxqa4zwyl , and soap functions docid\ dt6pd 4av91yd6kjkavks in {{jigxmanagement}} for more information, see execute entity docid\ jgwlsfzaop6u6mph6u5to jigx management {{jigxmanagement}} exposes the {{jigx}} cloud functionality in a browser based portal allowing you to manage users and solutions, set up send and push notifications, set up data, and view usage metrics of your organization for more information, see management overview docid 9fi8lwqnp477my3tpa56m jigx app the {{jigx}} app is available on ios and android and works on any device download the {{jigx}} ios app from the app store download the {{jigx}} android app from the google play store the {{jigxapp}} is only supported in portrait mode on ios and android phones you can brand your app through s organization settings docid\ kswowlfrxuzeqt30ssuuq see also jigx color palette docid\ alxcnrj rgickyu94iyws jigx icons docid\ kcd yl jqeuthf7cpfe91