Historias antecedentes, curiosidades y anuncios.

Protogrid vive y evoluciona sin parar. Responsables de esto son, entre otros, nuestros ingenieros innovativos y diseñadores creativos los cuales les gustaria compartir aquí sus historias, anécdotas y muchos consejos útiles y trucos con usted.

Discover the JSON-API with Postman

Sonja Blum , 2017-10-06
With Protogrid, a simple, useful App can be created without any programming skills. As soon as you want to add some customized comfort functionalities with JavaScript, it can be neccessary to access the database of the application through the JSON-API. There exists a documentation of the JSON-API, which explains requests and responses. Nevertheless it can be helpful to test the requests and see, what the responses look like, without running code to discover the API.

Postman

Our Developers use Postman to do this. Postman allows to make different requests and look at the responses. Thanks to the included authorization it is easy to imitate the behaviour of the script library.
Authentication with Postman

Under the tab "Authorization" you can choose the option BasicAuth and log in with your Protogrid Login data.
Now you can start different requests. I show you the basics of GET and POST, since those are the most frequent request types.
GET-Request with Postman

To perform a request of type GET, first choose the option GET at the top and enter the desired API request. By clicking on Send your request gets sent and you get the response below the "Authorization". Now you can see, how the returned JSON-object response looks like and where you find your desired information.
Post-Request witht Postman

To perform a reqest of type POST, choose the option POST and enter the address. Now you need to add the data you want to send with the request. Do so by choosing "Body" in the top tab bar, where you also find the "Authorization" tab. As type, choose "raw" and in the appearing drop down menu select "JSON(application/json)". Now you can enter your data. After sending the request, you find the response in the same text field as before.

By performing this operations, you come to know better the API and you are able to test your requests. Please be aware, that your requests get tested on the real data and therefore will be visible in your Environment.
For additional questions, our protogrid support team is happy to help you.

iOS Rollout of a Protogrid App

Raphael Grob , 2017-09-15
You have finished your very first Protogrid App and you would like to publish it on your iOS devices? This blog will take you through the necessary steps, to export your App on iOS devices. Due to Apple's very restrictive app verification, you can't just install a Protogrid Client to access all your Protogrid Apps. For each Protogrid App you must generate a native iOS App to access it on Apple's mobile devices. Before we explain how to generate such native iOS App, we should take a closer look at the requirement first.

Requirements

To generate an iOS App, you need a computer from Apple (MacBook, iMac or a similar device). On this machine, you must install the latest version of Xcode and you should have an Apple Developer Account to publish your app after its generation.
The first step of your App generation is to download the Xcode project directly from your Protogrid App under the menu point "Export/Import". The following screenshot shows you the location of the Xcode project.
Screenshot of the Xcode project download

Generate the iOS-App

Now you should decompress the project and rename the folder to "Protogrid-Build". In the decompressed folder, you will find the "readme.md" file, it contains very detailed instructions of the steps presented in this blog. Please have a look at these instructions, if you struggle with your App generation.
Open the file "Protogrid.xcodeproj" with Xcode. Then you navigate to the file "Protogrid/General/PGridInfo.plist", open it and edit the 4 entries marked on the next screenshot.
Screenshot of the Xcode project
The subsequent list states all the entries you must change and where you can find the corresponding information.
  • First you have to adjust the "Application Database ID". You will find this ID in your Protogrid App by clicking on "This Card" and afterwards on "Show Properties" on an arbitrary card of your App. The following screenshot shows you the "Card Property" window.
    Screenshot of the Card Properties
    You need to enter the marked entry "Application ID" in Xcode.
  • Then you should fill in the URL of your Protogrid Environment in the field "Protogrid Host". An example would be "ategra.protogrid.com".
  • The next entry we edit is the "Bundle Identifier", which is used by Apple to identify your iOS App. The Identifier should have a structure like this: "com.your-organization.your-department.your-app-name". It is important, that all your Apps have an unique name.
  • And finally you can give your app a display name by changing the entry "Bundle display name". You can choose whatever name you like.
After you entered the information, you should be able start your App for the first time in the simulator to initialize it. Click on the "Play Button" at the top left corner of the Xcode window to perform this action. Then you are asked to login with your Protogrid Login. Your app will now be initialized and the subsequent message will be displayed if the initialization was successful:
Screenshot of the success message
Your App should now run on the simulator and all your iOS devices. Publish your App as usual on the Appstore or company-internally by using the Apple Developer Enterprise Program.
The "readme.md" file contains additional information such as tips for your advanced iOS App preferences or a step-by-step instruction on how to update your iOS App.
Please contact our Protogrid Support Team, if you have any further questions or problems.

Gestión de datos facilitada gracias a su propia app

Sonja Blum , 2017-09-06
La gestión de datos puede tener diferentes formas: los empleados y sus tareas actuales deben estar organizados. Los catálogos de los productos deben estar accesibles para uso móvil. Los documentos importantes deben estar disponibles offline. Para estos y análogos problemas hay muchas aplicaciones que son casi, pero no del todo, adecuadas para lo que se está buscando. Con construcciones auxiliares propias (que generalmente requieren mucho tiempo y son complicadas) se pueden crear aplicaciones que satisfacen cada necesidad. Por lo menos, hasta el próximo cambio estructural de los datos. Tal vez sería más simple y eficiente programar una propia pequeña aplicación que se adapta perfectamente a su problema y que se adapta rápidamente a los ajustes internos. Para esto, a menudo son necesarios conocimientos de programación, y cuando no hay una persona con estas habilidades, la programación se vuelve cara. Este es el punto de partida desde el cual Protogrid ofrece ayuda. Protogrid es una plataforma que permite programar una aplicación para la gestión de datos sin conocimientos previos. Después de la registración gratuita en modalidad de prueba, se puede crear una aplicación con un clic. Se pueden definir el nombre y el URL de la aplicación, tanto como los permisos de lectura y escritura, así ya se ha creado una aplicación vacía. Ahora se pueden definir diferentes “protos”. Un proto representa una unidad de datos, por ejemplo, una persona, un producto o un documento. Al agregar diferentes campos, el proto recibe nuevas propiedades: un campo de texto para el nombre, un campo de fecha para el cumpleaños, un campo de relación para la división en la cual el trabajador está empleado. En el proto de la división creamos una vista de la lista donde están listadas todas las personas empleadas en antedicha división. No queremos dar el permiso a las personas para los archivos adjuntos, pero para los proyectos debe ser posible colgar archivos. Diferentes colores para diferentes unidades simplifican la navegación: rojo para avisos urgentes, verde para autorizaciones. Para que aún los colaboradores que hablan un idioma extranjero puedan utilizar la aplicación, añadimos otro idioma y traducimos la aplicación en la lengua correspondiente. Si estas capacidades básicas de Protogrid no bastan para adecuar óptimamente la aplicación al problema, es posible programar ampliaciones con JavaScript.
Una vez que la aplicación tiene su estructura de base, esta puede publicarse como aplicación para iOS. Esta aplicación es también accesible offline y actualiza los datos cuando hay conexión a un servidor. Cuando alguien añade un nuevo campo, la aplicación iOS se adapta sin que sea necesaria una nueva publicación, así que los usuarios estarán siempre actualizados, y pequeños cambios estarán siempre posibles. A través de diferentes permisos de acceso se puede garantizar que solamente los colaboradores designados tengan permiso para cambiar los datos. De esta manera uno puede crear en pocas horas una aplicación que se adapta perfectamente a su propia situación.

Es impresionante. Es gratis.

Protogrid es totalmente gratuito hasta dos usuarios con cualquier número de aplicaciones.