Mai 28, 2018

IsiGéo API : Exemples

Exemples d’intégration de l’API IsiGéo

Intégration d'IsiGéo dans WordPress

Intégration d'isigéo en mode API dans un article WordPress. Présentation des géoServices MapBox.

Exemple d’intégration du composant IsiGéo API dans le CMS WordPress

Intégration d'IsiGéo dans WordPress

Carte des logements vacants

Communauté d'Agglomération d'Agen : Cartographie des commerces vacants

Exemple d’intégration du composant IsiGéo API permettant aux citoyens de la ville d’Anglet d’obtenir des notes de renseignements d’urbanisme.

Carte des logements vacants

Notes de renseignement d'urbanisme

Ville d'Anglet : Renseignement d'urbanisme

Exemple d’intégration du composant IsiGéo API permettant aux citoyens de la ville d’Anglet d’obtenir des notes de renseignements d’urbanisme.

Notes de renseignement d'urbanisme

OAPH

Agence Technique Départementale de Dordogne ( ATD24 ) : OPAH

OPAH : Pays de l’Isle

OAPH

Demande d'assistance

Agence Technique Départementale de Dordogne ( ATD24 ) : demande d'assistance

Exemple d’intégration du composant IsiGéo API permettant aux utilisateurs des services de l’ATD 24 de créer des demandes de support.

Demande d'assistance

PPRL

Communauté de Communes de l'île de Noirmoutier : Plans de Prévention des Risques naturels ( PPRL / PPRI )

Plans approuvés en octobre 2015

PPRL

Mai 26, 2018

IsiGéo API : Présentation

Par Géomatika dans IsiGéo, IsiGéo API Étiquette API, Communication, Plateforme WEB

IsiGéo API v1.0

IsiGéo API est un composant Javascript permettant de placer IsiGéo, dans n’importe quelle page web et de le piloter. Sa mise en place est très simple. Quelques lignes de code suffisent.

Compatible IsiGéo v4.2.156+ / v5.0.4+

Description de l’interface javascript

IsiGéo API est basé sur une classe javascript, avec un constructeur et des méthodes associées.

Deux familles de méthodes sont proposées :

Des méthodes publiques, accessible depuis l’extérieur de l’application. L’API IsiGéo est utilisée par toute société tierce qui souhaite s’interfacer avec IsiGéo. Il est également utiliser pour intégrer IsiGéo dans un portail cartographique. Son utilisation est simplement liée à un besoin de publier des information sur le web.
Des méthodes privées, uniquement manipulable dans IsiGéo. Elles sont utilisées par les administrateurs IsiGéo pour créer des scénarios accompagnants, ou des workflows dans leurs applications métiers. L’utilisation de ces méthodes est conditionné par l’activation du module assistant. Notre plateau technique utilise ces possibilités avancées pour produire des applications professionnelles, poussées et sur mesure.

Cette documentation s’adresse aux administrateurs IsiGéo, familiarisés avec la programmation JavaScript et les concepts de programmation orientée objet. L’utilisation d’IsiGéo Javascript API nécessite d’une part, l’activation du module Assistant et d’autre part, une clef d’authentification obtenue à partir de la console d’administration d’IsiGéo.

Exemples d’intégration

Résultat

Classe IsiGéo

Classe isigeo

Constructeur

var myIsigeo = new isigeo( { url, target, login, key } );

Méthodes

Classe	Méthode	Portée	Disponibilité
isigeo	addForm()	Publique	v4.2.156+ v5.05+
	openForm()	Publique	v4.2.156+ v5.05+

Contactez nous

Mai 22, 2018

Méthode .openForm()

.openForm( tableId : Integer | String, id : Integer, options : Object )

Permet d’ouvrir le formulaire associé à un objet id dans la table tableId;

Paramètres de la méthode

nom	Typage	Description
tableId	Integer \| String [OBLIGATOIRE]	Identifiant de la table dans le catalogue de donnée IsiGéo ou nom de la table
id	Integer [OBLIGATOIRE]	Identifiant de l’objet dans la table. Le champ de référence doit être le champ identifant défini dans le catalogue de données IsiGéo.
options	Object javascript	Options d’exécution de la méthode. Les propriétés de l’objet sont décrites dans le paragraphe suivant

nom

Typage

Description

tableId

Integer | String

[OBLIGATOIRE]

Identifiant de la table dans le catalogue de donnée IsiGéo ou nom de la table

id

Integer

[OBLIGATOIRE]

Identifiant de l’objet dans la table.

Le champ de référence doit être le champ identifant défini dans le catalogue de données IsiGéo.

options

Object javascript

Options d’exécution de la méthode.

Les propriétés de l’objet sont décrites dans le paragraphe suivant

Propriétés de l’objet « options »

nom	Typage	Description
edit	Boolean	Permet d’ouvrir le formulaire en édition
options	Object javascript	Options d’éxécution de la méthode. Les propriétés de l’objet sont décrits dans le paragraphe suivant

nom

Typage

Description

edit

Boolean

Permet d’ouvrir le formulaire en édition

options

Object javascript

Options d’éxécution de la méthode.

Les propriétés de l’objet sont décrits dans le paragraphe suivant

Propriétés de l’objet « notif »

Nom	Typage	Description
text	String	Texte de la notification. Les balises html sont interprétées.
type	String	Type de notification. Peut prendre les valeurs ‘standard’ \| ‘error’ \| ‘success’ \| ‘alertify’ Valeur par défaut : ‘standard’. .
duration	Integer	Durée de persistance de la notification en ms. Valeur par défaut : 2500 ms (2,5 secondes ).

Nom

Typage

Description

text

String

Texte de la notification.

Les balises html sont interprétées.

type

String

Type de notification.

Peut prendre les valeurs ‘standard’ | ‘error’ | ‘success’ | ‘alertify’

Valeur par défaut : ‘standard’.

.

duration

Integer

Durée de persistance de la notification en ms.

Valeur par défaut : 2500 ms (2,5 secondes ).

Exemples de manipulation de la méthode

Copy to Clipboard

Page d’exemple simple

Ouverture de la fiche d’un poste électrique dans une application d’éclairage public

Copy to Clipboard

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="content-type" content="text/html;charset=UTF8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no" />
    <meta name="email" content="support@geomatika.fr" />
    <meta name="author" content="GAMOY FX,contact@geomatika.fr" />
    <meta name="publisher" content="Géomatika" />
    <meta name="copyright" content="Copyright GEOMATIKA©2002-2013" />
    <link rel="shortcut icon" href="../../favicon.ico" />
    <title>IsiGéo API - Méthode openForm()</title>

<script type='text/javascript' src='https://demo.geomatika.fr/services/javascript/isigeo_API.js'></script>
    
  </head>
  <body>
    <h1>Méthode addForm()</h1>
    <a href='javascript:openFormulaire();'>Ouvrez la fiche d'un poste électrique</a>
    <div id="myIsiGeo" style="width:1000px;height:600px;"></div>
    ...
    
    <script type='text/javascript'>
      var myIsigeo = new isigeo({
        urlIsigeo : 'https://demo.geomatika.fr/',
        target: 'myIsiGeo',
        login: 'commune_ep',
        key: 'LI6DN(hE|XXxrMZ9(m(wzbEPGnipmW0hImR%205QKzOw8T@PiU'
      });

function openFormulaire() {
        myIsigeo.openForm('ec_poste',5,
        {
          edit:false,
          notif : {
            text : 'Le texte de ma notification',
            type : 'success',
            duration : 6000
            }
        });
      };

</script>

</body>
</html>

Mai 21, 2018

IsiGéo API .addForm()

Par Géomatika dans IsiGéo API

Méthode .addForm()

.addForm( tableId : Integer | String, options : Object);

Permet de déclencher l’ajout d’un nouvel objet dans une table selon différents scénarii. ( Ajout d’un objet alphanumérique / Ajout d’un objet Géographique avec outil de dessin / Ajout d’un objet géographique à partir des coordonnées GPS ).

Paramètres de la méthode

nom	Typage	Description
tableId	Integer \| String [OBLIGATOIRE]	Identifiant de la table dans le catalogue de donnée IsiGéo ou nom de la table
options	Object javascript	Options d’éxécution de la méthode. Les propriétés de l’objet sont décrites dans le paragraphe suivant

nom

Typage

Description

tableId

Integer | String

[OBLIGATOIRE]

Identifiant de la table dans le catalogue de donnée IsiGéo ou nom de la table

options

Object javascript

Options d’éxécution de la méthode.

Les propriétés de l’objet sont décrites dans le paragraphe suivant

Propriétés de l’objet « options »

Nom	Typage	Description
values	json	Valeurs par défaut du formulaire exprimées sous la forme <clé : valeur> Exemple : { « Mon champ 1 » : « Ma valeur 1 » , « Mon champ 2 » : « Ma valeur 2 »}
gps	String	Lors de l’ajout d’un objet, utiliser les coordonnées du GPS pour géo-localiser le formulaire. gps peut prendre la valeur ‘none’ pour ignorer le gps ou ‘insert’ pour récupérer les coordonnées GPS à l’insertion de l’objet dans la table.
accordionDraw	String	Lors de l’ajout d’un objet géographique, faut il activer le menu de paramétrage du dessin dans l’accordéon. accordionDraw peut prendre la valeur ‘hide‘ pour cacher le panneau de paramétrage du dessin dans l’accodéon, ou ‘show‘ pour l’activer.
forceAlpha	Boolean	Permet de saisir un objet dans une table de type Géographique, en ignorant la géométrie. Valeurs possibles : true / false – Valeur par défaut : false
hideForm	Boolean	Permet de ne pas ouvrir la fiche à l’issue d’une saisie cartographique. ( Exemple : saisie massive de données géographiques ) Valeurs possibles : true / false – Valeur par défaut : false
notif	String \| Object	Ajout d’une notification d’accompagnement à la fin de l’ajout de la formulaire Dans le cas d’un string, notification contextuelle par défaut. Dans le cas un d’un objet, il est possible de personnaliser la notification. ( texte, style, durée ) Les propriétés de l’objet notif sont décrites dans le paragraphe suivant

Propriétés de l’objet « notif »

l’objet Javascript de paramétrage de la notification dispose de 3 propriétés

Nom	Typage	Description
text	String	Texte de la notification. Les balises html sont interprétées.
type	String	Type de notification. Peut prendre les valeurs ‘standard’ \| ‘error’ \| ‘success’ \| ‘alertify’ Valeur par défaut : ‘standard’. .
duration	Integer	Durée de persistance de la notification en ms. Valeur par défaut : 2500 ms (2,5 secondes ).

Nom

Typage

Description

text

String

Texte de la notification.

Les balises html sont interprétées.

type

String

Type de notification.

Peut prendre les valeurs ‘standard’ | ‘error’ | ‘success’ | ‘alertify’

Valeur par défaut : ‘standard’.

.

duration

Integer

Durée de persistance de la notification en ms.

Valeur par défaut : 2500 ms (2,5 secondes ).

Exemples de manipulation de la méthode

Copy to Clipboard

Page d’exemple simple

Ajout d’un poste électrique dans une application d’éclairage public

Copy to Clipboard

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="content-type" content="text/html;charset=UTF8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1, minimum-scale=1, user-scalable=no" />
    <meta name="email" content="support@geomatika.fr" />
    <meta name="author" content="GAMOY FX,contact@geomatika.fr" />
    <meta name="publisher" content="Géomatika" />
    <meta name="copyright" content="Copyright GEOMATIKA©2002-2013" />
    <link rel="shortcut icon" href="../../favicon.ico" />
    <title>IsiGéo API - Méthode addForm()</title>

<script type='text/javascript' src='https://demo.geomatika.fr/services/javascript/isigeo_API.js'></script>
    
  </head>
  <body>
    <h1>Méthode addForm()</h1>
    <a href='javascript:addFormulaire();'>Ajoutez une armoire éléctrique</a>
    <div id="myIsiGeo" style="width:1000px;height:600px;"></div>
    ...
    
    <script type='text/javascript'>
      var myIsigeo = new isigeo({
        urlIsigeo : 'https://demo.geomatika.fr/',
        target: 'myIsiGeo',
        login: 'commune_ep',
        key: 'LI6DN(hE|XXxrMZ9(m(wzbEPGnipmW0hImR%205QKzOw8T@PiU'
      });

function addFormulaire() {
        myIsigeo.addForm('ec_poste',
        {
          forceAlpha:true,
          gps:'none',
          accordionDraw:'hide',
          hideForm:false,
          notif : {
            text : 'Le texte de ma notification',
            type : 'success',
            duration : 6000
            }
        });
      };

</script>

</body>
</html>

Exemple d’utilisation dans Worpdress

Cliquez sur le bouton ci-dessous pour ajouter un nouveau poste électrique

Ajoutez une armoire

Mai 17, 2018

IsiGéo API : isigeo class

Par Géomatika dans Dossiers, IsiGéo API Étiquette API, Plateforme WEB

isigeo class / Classe isigeo

IsiGéo API v1.0
Compatible IsiGéo v4.2 / v5.x

Obtenir une clé d’authentification

L’utilisation d’IsiGéo Javascript API nécessite d’une part, l’activation du module Assistant et d’autre part, une clef d’authentification obtenue à partir de la console d’administration d’IsiGéo.

Contactez nous

Constructeur

var myIsigeo = new isigeo( { url, target, login, key } );

nom	Typage	Description
urlIsigeo	url [OBLIGATOIRE]	Url du service web IsiGéo exemple : https://monservice.geomatika.fr/
target	String [OBLIGATOIRE]	Identifiant du Div qui recoit IsiGéo.
login	String [OBLIGATOIRE]	Utilisateur IsiGéo
key	String [OBLIGATOIRE]	Clé d’authentification. Cette clé peut être obtenue à partir de la console d’administration.

Méthodes de la classe isigeo

nom	Typage	Description
.addForm()	void	Permet différents scénarios pour ajouter un objet dans une table.
.openForm()	void	Permet d’ouvrir un objet dans un formaulaire, en édition ou en consultation

Premier pas : Intégration d’IsiGéo dans une page web.

Section Head de la page HTML

Afin de pouvoir utiliser les méthodes d’IsiGéo, il faut inclure la librairie isigeo_API.js dans la sectionde votre page html.

Copy to Clipboard

Section Body de la page HTML

Dans le corps de la page, placez un div en lui attribuant un identifiant unique pour votre page ( ici myMap)

Placez un bloc de code Javascript pour instancier IsiGéo.

Les options sont les suivantes :

urlIsigeo : Adresse du votre service web IsiGéo.

target : l’identifiant du div cible qui recevra IsiGéo.

login : Utilisateur IsiGéo

key : Clé d’authentification. Cette clé peut être obtenue à partir de la console d’administration.

Copy to Clipboard

Résultat

IsiGéo s’ouvre dans le div prévu à cet effet. L’application s’initialise sur le profil ‘demo_geomatika’ et hérite de ses droits.

Archive dans mai 2018

Exemples d’intégration de l’API IsiGéo

Intégration d'isigéo en mode API dans un article WordPress. Présentation des géoServices MapBox.

Communauté d'Agglomération d'Agen : Cartographie des commerces vacants

Ville d'Anglet : Renseignement d'urbanisme

Agence Technique Départementale de Dordogne ( ATD24 ) : OPAH

Agence Technique Départementale de Dordogne ( ATD24 ) : demande d'assistance

Communauté de Communes de l'île de Noirmoutier : Plans de Prévention des Risques naturels ( PPRL / PPRI )

IsiGéo API v1.0

Description de l’interface javascript

Résultat

Classe isigeo

Constructeur

Méthodes

Méthode .openForm()

Paramètres de la méthode

Propriétés de l’objet « options »

Propriétés de l’objet « notif »

Exemples de manipulation de la méthode

Page d’exemple simple

Méthode .addForm()

Paramètres de la méthode

Propriétés de l’objet « options »

Propriétés de l’objet « notif »

Exemples de manipulation de la méthode

Page d’exemple simple

Exemple d’utilisation dans Worpdress

isigeo class / Classe isigeo

Obtenir une clé d’authentification

Constructeur

Méthodes de la classe isigeo

Premier pas : Intégration d’IsiGéo dans une page web.

Section Head de la page HTML

Section Body de la page HTML

Résultat

Résultat