Batch de transfert
Cliquer ici pour voir cette page dans le contexte complet

Batch de transfert

A l'intérieur de l'élément parent <LorikSoftwareBatch></LorikSoftwareBatch> se trouve 3 éléments enfants requis:

<ProductName>

<BatchVersion>

<BatchItem>

L'élément <ProductName>

Lorsque le batch concerne LorikGISMapper, la valeur de l'élément est LorikGISMapper, ce qui donne:

<ProductName>LorikGISMapper</ProductName>

L'élément <BatchVersion>

C'est la version du fichier de batch. Actuellement la valeur de l'élément est 1, ce qui donne:

<BatchVersion>1</BatchVersion>

L'élément <BatchItem>

Cet élément possède un attribut format dont la valeur détermine le type d'opération à exécuter en batch avec LorikGISMapper. Pour ce batch dexport de page, la valeur de l'attribut est: Transfer, ce qui donne:

<BatchItem format="Transfer">

Il y a autant de <BatchItem> dans le fichier *.xml que de batch à exécuter.

Les possibles sous-éléments d'un <BatchItem> et leurs caractéristiques sont

Nom de l'élément

Définition

Attributs

Valeur possible des attributs ou de l'élément

Requis

<Mapper_DocumentName>

Chemin absolu du fichier LorikGISMapper

 

C:\Temp\transfer.lgm

x

<Transfer>

Mode de transfert

Mode

  • "New": définit un nouveau transfert

  • "Continue": continue transfert existant

  • "Replay": rejoue un transfert existant

De plus, des sous-éléments doivent être définis (voir plus bas)

 

<Destination_DocumentName>

SI transfert vers un répertoire LKC :

Chemin absolu du fichier lkc

new

C:\Temp\fichier.lkc

  • "Yes" ou "True": création d'un nouveau fichier lkc

  • "No" ou "False": utilisation d'un fichier lkc existant

 

x

  ou

<Destination_Database>

SI transfert vers une base de données :

Paramètres de connexion à la base.

 

name

  • "Yes" ou "True": création d'une nouvelle base de données

  • "No" ou "False": utilisation d'une base de données existante

De plus, des sous-éléments doivent être définis (voir plus bas)

x

<GisDataNotFoundStopsBatch>

La valeur de cet élément indique au programme s'il doit poursuivre ou interrompre l'exécution lorsqu'une source de données SIG est manquante.

 

  • "Yes" ou "True": arrêt du batch

  • "No" ou "False": pas d'arrêt du batch

  

<UnlockTransfertAtEnd>

Déverrouiller ou non le fichier ou la base créés à la fin du transfert

  

  • "Yes" ou "True": déverrouiller les données.

  • "No" ou "False":ne pas déverrouiller les données.

 

L'élément <Transfer>

Nom de l'élément

Définition

Attributs

Valeur possible des attributs ou de l'élément

Requis

<TransferName>

Nom du transfert LorikGISMapper

 

Transfert1

x

Si <Transfer Mode="New">

 

<TileDimension>

Taille des tuiles de transfert (en cm)

height

width

height="100"  width="100"

x

<AeraName>

Nom de la zone à utiliser

  

Area1

x

<AeraDimension>

Coordonnées du point bas-gauche et dimension de la zone à transférer

 X_origin Y_origin

height

width

 X_origin="0" Y_origin="0" height="29.7" width="21"  

  Si <Transfer Mode="Continue">

<JumpNextTile>

Ignorer la tuile suivante

 

  • "Yes" ou "True": la tuile est ignorée

  • "No" ou "False":  la tuile est traitée

  

<ProcessJumpedTile>

Générer les tuiles sautées.

 

  • "Yes" ou "True": génération des tuiles

  • "No" ou "False": pas de génération des tuiles

  

 

 

Destination

New="Yes"

New="No"

Transfert

 

Mode="New"

Créer un nouveau fichier ou base de données.

Ajoute des données dans un fichier ou une base de données.

Mode="Continue"

NA

Continue un transfert existant.

Mode="Replay"

NA

Remplace un transfert dans un document existant.

 

L'élément <Destination_Database>

Les possibles sous-éléments d'un <Destination_Database> et leurs caractéristiques sont:

Nom de l'élément

Définition

Attributs

Valeur possible des attributs ou de l'élément

Requis

<Connection>

Paramètre de connexion

 

Des sous-éléments différents doivent être définis selon le mode de définition sélectionné (voir plus bas).

x

<TransfertLockedAreaDirectory>

Chemin absolu du répertoire temporaire de transfert

 

C:\Temp\transfert

 

x

<Local_extended_attributes>

 

Utilisation ou non du mode de stockage interne des attributs complémentaires.

 

  • "Yes" ou "True": oui

  • "No" ou "False": non

x

<Digest_parameters>

Paramètres pour définir de stockage des données DIGEST.

 

Des sous-éléments différents doivent être définis selon le mode de définition sélectionné (voir plus bas).

x

(*) Les champs marqués comme requis ne le sont que si le transfert cible une base de données.

L'élément <Connection>

Les possibles sous-éléments d'un <Connection> et leurs caractéristiques sont:

Nom de l'élément

Définition

Attributs

Valeur possible des attributs ou de l'élément

Requis

<type>

type de la base de données

 

  • PostgreSQL Database

  • Oracle Database

x

<Connection_Field>

Paramètres de la connexion

key

Communs :

"USER_NAME" : nom de l'utilisateur

"PASSWORD" : mot de passe de l'utilisateur

"PREFIX" : préfixe des tables (optionnel)

Oracle :

"DATABASE_INSTANCE" : instance de la base de données

PostgreSQL :

"DATABASE_NAME" : nom de la base de données

"HOST_NAME" : nom du serveur (optionnel)

"HOST_ADDR" : adresse IP du serveur (optionnel)

"PORT_NUMBER" : port pour accéder à la base (optionnel)

x

L'élément <Digest_parameters>

Les possibles sous-éléments d'un <Digest_parameters> et leurs caractéristiques sont:

Nom de l'élément

Définition

Attributs

Valeur possible des attributs ou de l'élément

Requis

<Coordinates_system>

Système de coordonnées

 

  • Paper

  • Kilometric

  • Geographic

x

<Unit>

Unité pour les coordonnées

 

(si <Coordinates_system> = Paper)

  • Millimeters

  • Centimeters

  • Meters

  • Kilometers

  • Miles

  • Nautical Miles

  • Feet

  • Inches

  • Yards

 (si <Coordinates_system> = Kilometric)

  • Meters

(si <Coordinates_system> = Geographic)

  • Decimal degrees

x

<Georef_name>

 

Nom du georef

 

Nom_du_georef

Uniquement si <Coordinates_system> = Kilometric ou <Coordinates_system> = Geographic

x

<SRID>

 

Identifiant du système de référence spatiales

 

(si <Coordinates_system> = Paper)

  • -1

 (si <Coordinates_system> = Kilometric) ou (si <Coordinates_system> = Geographic)

  • Numéro EPSG de la projection

 

<Flattening_tolerance>

 

Valeur de facettisation

 

Valeur exprimée en mètres.

 

 

Exemple

<?xml version="1.0"  encoding="UTF-8"  standalone="no" ?>

<LorikSoftwareBatch>

  <LKXMLVersion>1.0</LKXMLVersion>

  <ProductName>LorikGisMapper</ProductName>

  <BatchVersion>1</BatchVersion>

  <BatchItem format="Transfer">

    <Mapper_DocumentName>E:\Temp\zonage.lgm</Mapper_DocumentName>

    <Destination_DataBase New="Yes">

      <Connection>

        <Type>PostgreSQL Database</Type>

        <Connection_Field key="HOST_NAME">Computer1</Connection_Field>

        <Connection_Field key="USER_NAME">postgres</Connection_Field>

        <Connection_Field key="PREFIX">a_</Connection_Field>

        <Connection_Field key="HOST_ADDR">192.154.1.179</Connection_Field>

        <Connection_Field key="PORT_NUMBER">5433</Connection_Field>

        <Connection_Field key="DATABASE_NAME">test_lkgm1</Connection_Field>

        <Connection_Field key="PASSWORD">postgres</Connection_Field>

      </Connection>

      <TransfertLockedAreaDirectory>C:\Temp\transfer</TransfertLockedAreaDirectory>

      <Digest_parameters>

        <Coordinates_system>Geographic</Coordinates_system>

        <Unit>Decimal degrees</Unit>

        <Georef_name>UTM_31N</Georef_name>

        <SRID>4171</SRID>

        <Flattening_tolerance>1</Flattening_tolerance>

      </Digest_parameters>

    </Destination_DataBase>

    <Transfer Mode="New">

      <TransferName>Zone1:lundi 9 septembre 2013 17:06:49</TransferName>

      <TileDimension height="100"  width="100"/>

      <AreaName>Zone1</AreaName>

      <AreaDimension X_origin="0"  Y_origin="0"  height="29.7"  width="21"/>

    </Transfer>

    <GisDataNotFoundStopsBatch>Yes</GisDataNotFoundStopsBatch>

    <UnlockTransfertAtEnd>Yes</UnlockTransfertAtEnd>

  </BatchItem>

</LorikSoftwareBatch>