Jigx Concepts
14 min
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 solutions by tapping the more ellipsis icon in the navigation bar and selecting your desired solution the currently active solution is highlighted with a checkmark icon if only one solution is available, the more icon is hidden home hub the home hub is the first screen you see when you open and sign into the jigx mobile app the home hub 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 home hub by adding a video player # or carousel # at the top of the home hub for more information, see home hub docid\ gpvp1ajqwxiru83 jpzed and creating a home hub docid\ pwsk7pz9prbcwznf6xy7s 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 vs code with the jigx builder (code editor) docid\ cd4 zsg qvqg ro3cqdix , which is an extension that allows you to build, test, and publish jigx mobile app solutions the jigx builder 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\ ckwtdzjxtojdm 642bgc functionality to assist with troubleshooting your development predefined code snippets are provided in the jigx files to help make development easier and faster the jigx builder loads with a editor docid 0qer6kqt7jb1pjap7d36t 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 jigx builder in the index jigx file, you configure what must be displayed on the home screen (home hub) of your solution on the jigx mobile app the file opens with a pre populated code snippet to help you configure the home hub for more information, see index settings docid\ hot lq18vpoliy5xrbcex , and creating a home hub docid\ pwsk7pz9prbcwznf6xy7s widgets widgets are navigational menu blocks set up on jigs, allowing them to be utilized in various parts of the solution, including the home hub and multiple jigs (screens) these widgets are configurable to display various ui elements, such as locations, images, charts, and more for more information, see content widget components # 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\ gpvp1ajqwxiru83 jpzed opens a jig for more information, see jigs (screens) docid\ i3uxj6x77d qvigo kjjc and jig types # sections in this guide components components are elements that can be used when creating a jigx solution in the jigx builder these elements provide an incredible amount of functionality components include interactive images, video players, expanders, and charts for more information, see components (controls) docid\ tkd4w4rzpfm j suigvcp and components # 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\ ygtqc7neyjmft y 9fyb4 and action examples # 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\ xnf08yobxqfzm8evt9 jt , soap functions docid\ hk ihab1xztxonq51dmgs , and sql functions docid\ ws5cio1ihns9vbyfnssiz 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 https //jsonata org/ https //jsonata org/ jsonata and try out your expressions in their https //try jsonata org/ https //try jsonata org/ 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\ gsvs1zswrgpc0ewjvpihm , expressions cheatsheet docid\ iw enfrdfajwjiimxcjha and expression examples # datasources datasources docid\ zztav4gd3sttkeg8ihvgo 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 dynamic data 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 dynamic data is managed in jigx management for more information, see dynamic data docid\ ghdcdrnekxytnuvin5whf and dynamic data examples # database a data providers docid\ hi5nkisjutyk6mkml7la6 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\ hi5nkisjutyk6mkml7la6 and data provider examples # 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\ zjbvpf4gxbcdqsesfwlt menu option in jigx management other databases are managed using the connections https //docs jigx com/connections , sql functions docid\ ws5cio1ihns9vbyfnssiz , rest functions docid\ xnf08yobxqfzm8evt9 jt , and soap functions docid\ hk ihab1xztxonq51dmgs in jigx management for more information, see execute entity # jigx management jigx management 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\ bpr3enodaznr56ewkjnav jigx app the jigx app is available on ios and android and works on any device download the jigx ios app from the https //apps apple com/sg/app/jigx/id1495596537 https //apps apple com/sg/app/jigx/id1495596537 app store download the jigx android app from the https //play google com/store/apps/details?id=com jigx android\&pli=1 https //play google com/store/apps/details?id=com jigx android\&pli=1 google play store the jigx app is only supported in portrait mode on ios and android phones you can brand your app through s organization settings docid 0n744qgfgwwdxrishbjpi see also jigx color palette docid\ molycr518br0ssqkcbqlajigx icons docid 0vs mac9xgx524crpdiar