IsiGéo JavaScript API : Guide d'utilisation

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

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

Cette documentation est conçue pour vous permettre de découvrir comment utiliser et exploiter les méthodes de l'API IsiGéo.

Cette documentation s'adresse aux administrateurs IsiGéo, familiarisés avec la programmation JavaScript et les concepts de programmation orientée objet.


Obtenir une clé d'authentification

Contactez-nous

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.


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 section <head> de votre page html.

<head>

  <!-- Include IsiGeo API javascript file -->
  <script type='text/javascript' src='https://monsite.geomatika.fr/services/javascript/isigeo_API.js'></script>

</head>

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.

Dans la section body de la page.

<body>
  <!-- Div qui recevra IsiGéo -->
  <div id='myMap' style='width:800px;height:600px'></div>
  ...

  <!-- Instanciation d'IsiGéo dans le div -->
  <script type='text/javascript'>
    var myIsigeo = new isigeo({
      urlIsigeo : 'https://monsite.geomatika.fr/',
      target: 'myMap',
      login: 'demo_geomatika',
      key:'yourKey'
    });
  </script>

</body>

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.

Exemples

Ajouter un nouveau formulaire de saisie pour la table choisie.

//Fonction addForm
//Liste des paramètres :
/*
{String | Integer} 	tableId 	 [Identifiant de deftable | Nom de la table]
 {[object]} 			options   	 [Liste d'options disponibles ci-dessous
	{JSON}	 						values	 	 	[JSON indiquant des valeurs par défaut construit de la façon suivante : {idchamp : valeur}
	{String (default : 'none')}	 	gps	 		 	[Active la localisation GPS avec récupération des coordonées GPS dans l'INSERT ('none' ou 'insert')}
	{String (default : 'hide')}	 	accordionDraw	[Permet de ne pas switcher sur l'accordion Dessin à la saisie d'un objet GEO ('hide' ou 'show'}
	{Bool (default : false)}	 	hideForm		[Permet de ne pas ouvrir la fiche après la saisie (true/false)}
	{Object | String}	 			notif			[Notification à l'appel de la fonction}
		  {String}	 						 text			[Texte de la notification]
		  {String (default : 'standard')}	 type			[Type de notification]
		  {Integer (default : 2500)} 		 duration 		[Durée de la notification]	
*/


// Ajouter un nouveau formulaire de saisie ALPHA ou GEO
myIsigeo.addForm (tableId, {
		 forceAlpha:true, 
		 values:{"champ":"valeurchamp"}, 
		 gps:'none', 
		 accordionDraw:'hide', 
		 hideForm:false,
		 notif : {
			text : 'Le texte de ma notification',
			type : 'success',
			duration : 6000
	 	}
})
Ajouter une armoire électrique

 

Ouvrir un formulaire de saisie pour la table et l'identifiant unique choisi.

//Fonction openForm
//Liste des paramètres : 
/** 
*  {string | integer}	 	tableId		[identifiant unique de la couche | Nom de la couche]
*  {string}	 		id 		[identifiant unique de l'objet]
*  {object} 			options 	[Objet d'options]
*  	{String (default : 'Y')} 	valid  	   [Activer la validation du formulaire (Y/N)]
*	{Bool (default : false)} 	forceValid [Force la vérification des données saisies avant la fermeture]	
*        {Bool (default : false)}	edit	   [Ouvrir la fiche en édition]
*        {Object | String}	 	notif	   [Notification à l'appel de la fonction}
*    	    {String}	 			 text		[Texte de la notification]
*	    {String (default : 'standard')}	 type		[Type de notification]
*	    {Integer (default : 2500)} 		 duration 	[Durée de la notification] 
**/
	
// Ouvrir un formulaire de saisie
myIsigeo.openForm (tableId,idObjet, {
		 edit : false, 
		 notif : {
			text : 'Le texte de ma notification',
			type : 'success',
			duration : 6000
	 	}		 
})
Ouvrir une armoire électrique

 

Ouvrir une table de données

// Fonction search
// Liste des paramètres :
/**   
*	 {Integer | String} tableId 				[ID Table destinataire / Nom table destinataire]
*  	 {Object} 			 options 				[Objet d'options]
*       {String} mode 			[Mode de recherche ('byID' ou 'byIsigeo')]
*       {String} target 			[Onglet cible ('MAP' ou 'DATA')]
*       {String} listIds 		[Liste des identifiants d'objets séparés par des , (Uniquement avec mode='byID')]
*       {Object} isigeo_context 	[Selection de la colonne filtre (Uniquement avec mode='byIsigeo')]
*         {String} filterColumn 				[Selection de la colonne filtre]
*         {String} filterValue   			[Valeur du filtre colonne]
*         {String} searchValue 				[Valeur de la recherche]
*         {Integer} openFiche 				[Ouvrira la fiche de la ligne correspondant. (La premiere ligne commence a l'indice 0)] 
**/
	
// Ouvrir une table de données
myIsigeo.search(tableId,{
	mode : 'byIsigeo', 
	target : 'DATA', 
	isigeo_context : {
		filterColumn : 'secteur', 
		filterValue : 'Secteur 2', 
		searchValue : 'Allée des platanes' 
	}
})
Ouvrir une table de données

Localiser des objets sur la carte

// Fonction search
// Liste des paramètres :
/**   
*	 {Integer | String} tableId 				[ID Table destinataire / Nom table destinataire]
*  	 {Object} 			 options 				[Objet d'options]
*       {String} mode 			[Mode de recherche ('byID' ou 'byIsigeo')]
*       {String} target 			[Onglet cible ('MAP' ou 'DATA')]
*       {String} listIds 		[Liste des identifiants d'objets séparés par des , (Uniquement avec mode='byID')]
*       {Object} isigeo_context 	[Selection de la colonne filtre (Uniquement avec mode='byIsigeo')]
*         {String} filterColumn 				[Selection de la colonne filtre]
*         {String} filterValue   			[Valeur du filtre colonne]
*         {String} searchValue 				[Valeur de la recherche]
*         {Integer} openFiche 				[Ouvrira la fiche de la ligne correspondant. (La premiere ligne commence a l'indice 0)] 
**/
	
// Localiser des objets sur la carte
myIsigeo.search(tableId,{
	mode : 'byID', 
	target : 'MAP', 
	listIds : '25,26'
})
Localiser des objets sur la carte

 


Communication avec des logiciel Tiers

Nous disposons aujourd'hui d'une longue expérience dans l'intéropérabilité avec des logiciels tiers.

Les passerelles réalisées offrent des fonctionnalités d’interaction/d'interfaçage, de synchronisation.

On peut citer :

  1. Cart@ds de la société GFI
  2. Oxalys de la société Opéris
  3. R'ADS de la société SIRAP
  4. OpenADS de la société AtReal
  5. WgeoPC
  6. VisitAnyWhere
  7. Sirtaqui
2018-05-18T16:06:30+00:00