Wiki1000 - Contributions de l'utilisateur [fr]

Einvoicing afnor api

2026-07-01T13:29:50Z

Flfay :

{{version2026r1}}

==Plateforme authentifiée==

Menu d'accès :

[[image:afnor_menu.png]]

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

{{warning|FRP1000 ne supporte que le format UBL. extrait de la norme : //Note 1 au 5.4.2 : le Fournisseur API peut permettre au Client API de configurer la règle suivante : l’ensemble des factures reçues en UBL sont converties en Factur-x, pour que ces conversions puissent être préparées en amont.}}

{{tip|Par défaut, FRP1000 ne télécharge pas le lisible des factures, il est possible de le faire en surchargeant la méthode '''TProcessusTaskAFNOR.doGetReadable'''.}}

{{tip|Cet assistant peut être planifié.}}

==Consulter les flux==

[[image:afnor_consult_flow_1.png]]

[[image:afnor_consult_flow_2.png]]

Types de flux
* facture
* statut
* ereporting

Statuts
* en attente : le flux est envoyé, son statut sera mis à jour lors de la synchronisation suivante
* succès : le flux est bien reçu ou bien envoyé
* erreur : le flux envoyé a été refusé par la PA ou bien le traitement du flux reçu a provoqué une erreur, un message d'erreur est lié au flux
* non traité : le flux reçu n'a pas été traité (flux non reconnu ou bien la société de gère pas la réception de facture)

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T13:42:10Z

Flfay :

{{version2026r1}}

==Plateforme authentifiée==

Menu d'accès :

[[image:afnor_menu.png]]

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

{{tip|Cet assistant peut être planifié.}}

==Consulter les flux==

[[image:afnor_consult_flow_1.png]]

[[image:afnor_consult_flow_2.png]]

Types de flux
* facture
* statut
* ereporting

Statuts
* en attente : le flux est envoyé, son statut sera mis à jour lors de la synchronisation suivante
* succès : le flux est bien reçu ou bien envoyé
* erreur : le flux envoyé a été refusé par la PA ou bien le traitement du flux reçu a provoqué une erreur, un message d'erreur est lié au flux
* non traité : le flux reçu n'a pas été traité (flux non reconnu ou bien la société de gère pas la réception de facture)

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T13:39:03Z

Flfay :

{{version2026r1}}

==Plateforme authentifiée==

Menu d'accès :

[[image:afnor_menu.png]]

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

{{tip|Cet assistant peut être planifié.}}

==Consulter les flux==

[[image:afnor_consult_flow_1.png]]

[[image:afnor_consult_flow_2.png]]

Types de flux
* facture
* statut
* ereporting

Statuts
* en attente : le flux est envoyé, son statut sera mis à jour lors de la synchronisation suivante
* succès : le flux est bien reçu ou bien envoyé
* erreur : le flux envoyé a été refusé par la PA, un message d'erreur est lié au flux
* non traité : le flux reçu n'a pas été traité (flux non reconnu ou bien la société de gère pas la réception de facture)

[[Category:Version2026r1]]
[[Category:Release note]]

Fichier:Afnor consult flow 2.png

2026-06-30T13:30:28Z

Flfay :

Fichier:Afnor consult flow 1.png

2026-06-30T13:29:54Z

Flfay :

Fichier:Afnor menu.png

2026-06-30T13:29:23Z

Flfay :

Einvoicing afnor api

2026-06-30T13:16:05Z

Flfay : /* Synchroniser les flux */

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

{{tip|Cet assistant peut être planifié.}}

==Consulter les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T13:08:46Z

Flfay :

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

==Consulter les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T13:06:02Z

Flfay : /* Synchroniser les flux */

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

Cet assistant permet de synchroniser les flux via l'api AFNOR (factures statuts, ereporting).

La synchronisation permet :
* de mettre à jour l'état des flux envoyés
* d'envoyer des flux
* de recevoir des flux
* de traiter les flux reçus

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T12:58:07Z

Flfay : /* Paramétrer une plateforme authentifiée (PA) */

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.

Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.

Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T12:56:34Z

Flfay : /* Paramétrer une plateforme authentifiée (PA) */

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode '''TEInvoicingPDPAFNOR.getEndPoint''' pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.
Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requête.
Il est également possible de surcharger la méthode '''TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient)''' afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T12:55:58Z

Flfay :

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

Renseigner l'url du endpoint api afnor.
{{tip|Certaines implémentations positionnent la société dans l'endpoint, il est alors possible de surcharger la méthode TEInvoicingPDPAFNOR.getEndPoint pour contextualiser l'url.}}

[[image:afnor_pa_1.png]]

Pour chaque société, on stocke la date du dernier flux récupéré, cette date est utilisée lors de la synchronisation pour obtenir seulement les flux non encore téléchargés.
Pour chaque société, il est possible de renseigner le champs OrganizationID, prévu par la norme AFNOR, qui sera placé dans les header http de chaque requete.
Il est égamement possible de surcharger la méthode TProcessusEinvoicingAFNOR.DSMOnCreateAFNORHttpClient(ahttpClient:THttpClient) afin d'ajouter d'autre headers spécifiques.

[[image:afnor_pa_2.png]]

===Paramétrer l'authentification===

L'api AFNOR peut utiliser une authentification oAuth2.
L'authentification est par utilisateur par défaut, mais il est possible de paramétrer un attribut de contexte d'authentification afin que le token soit propre à un contexte société (en plus de l'utilisateur).

[[image:afnor_auth_1.png]]

{{tip|Il est possible d'utiliser grant type oAuth2 "client_credentials" en laissant vide le champs EndPoint.}}

{{warning|L'url cible doit être la même que cette paramétré dans la plateforme authentifiée.}}

[[image:afnor_auth_2.png]]

==Synchroniser les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Einvoicing afnor api

2026-06-30T11:52:24Z

Flfay : Page créée avec « {{version2026r1}} ==Plateforme authentifiée== ===Paramétrer une plateforme authentifiée (PA)=== ===Paramétrer l'authentification=== ==Synchroniser les flux== [[... »

{{version2026r1}}

==Plateforme authentifiée==

===Paramétrer une plateforme authentifiée (PA)===

===Paramétrer l'authentification===

==Synchroniser les flux==

[[Category:Version2026r1]]
[[Category:Release note]]

Fichier:Afnor auth 2.png

2026-06-30T11:49:04Z

Flfay :

Fichier:Afnor auth 1.png

2026-06-30T11:48:52Z

Flfay :

Fichier:Afnor pa 2.png

2026-06-30T11:48:43Z

Flfay :

Fichier:Afnor pa 1.png

2026-06-30T11:48:18Z

Flfay :

Déclaration des URLs de services externes

2026-06-09T10:03:38Z

Flfay :

==Contexte ==

L’application communique avec plusieurs services tiers via HTTP/HTTPS.

Dans des environnements sécurisés (entreprise, production), les flux sortants sont souvent restreints.

Cette documentation décrit les URLs des services externes utilisés.

Ces endpoints doivent être explicitement autorisés par les administrateurs (réseau, sécurité, proxy, pare-feu) afin de garantir le bon fonctionnement de l’application.

==Liste des URLs à autoriser ==

{| class="wikitable"
|+ Liste des services externes
|-
! Service !! URL / Domaine !! Port !! Protocole !! Commentaire
|-
| Sage Update|| frp1000.blob.core.windows.net|| 443 || https ||
|-
| Sage Service Fabric || api-money.sage.com || 443 || https || api inscription Service Sage (peut ouvrir une url qui fait des appels *.gstatic.com)
|-
| Sage Service Fabric || www.sagetokenservice.com|| 443 || https || api obtention des jetons services Sage
|-
| Sage Service Fabric || regulatory-reports.sagecompliance.com|| 443 || https || api siren, signature pdf, taxid validation
|-
| Sage Network || api.sbc.sage.com|| 443 || https || api Inscription Sage Network
|-
| Sage Network || app.sbc.sage.com|| 443 || https || Url gestion Sage Network
|-
| Sage Network || api.network.sage.com|| 443 || https || api Sage network
|-
| Sage Network || network.sage.com|| 443 || https || url Sage connect
|-
| Sage ID || id.sage.com|| 443 || https || url Sage ID
|-
| Sage ID || id.auth.sage.com|| 443 || https || api Sage ID
|-
| Sage ID redirector || frp1000.sidr.sagedatacloud.com|| 443 || https || api Sage ID redirector
|-

|}

Déclaration des URLs de services externes

2026-03-19T09:53:12Z

Flfay :

Déclaration des URLs de services externes

2026-03-19T09:51:57Z

Flfay : /* Liste des URLs à autoriser */

= Documentation – Déclaration des URLs de services externes =

==Contexte ==

L’application communique avec plusieurs services tiers via HTTP/HTTPS.
Dans des environnements sécurisés (entreprise, production), les flux sortants sont souvent restreints.
Cette documentation décrit les URLs des services externes utilisés.
Ces endpoints doivent être explicitement autorisés par les administrateurs (réseau, sécurité, proxy, pare-feu) afin de garantir le bon fonctionnement de l’application.

==Liste des URLs à autoriser ==

{| class="wikitable"
|+ Liste des services externes
|-
! Service !! URL / Domaine !! Port !! Protocole !! Commentaire
|-
| Sage Update|| frp1000.blob.core.windows.net|| 443 || https ||
|-
| Sage Service Fabric || api-money.sage.com || 443 || https || api inscription Service Sage (peut ouvrir une url qui fait des appels *.gstatic.com)
|-
| Sage Service Fabric || www.sagetokenservice.com|| 443 || https || api obtention des jetons services Sage
|-
| Sage Service Fabric || regulatory-reports.sagecompliance.com|| 443 || https || api siren, signature pdf, taxid validation
|-
| Sage Network || api.sbc.sage.com|| 443 || https || api Inscription Sage Network
|-
| Sage Network || app.sbc.sage.com|| 443 || https || Url gestion Sage Network
|-
| Sage Network || api.network.sage.com|| 443 || https || api Sage network
|-
| Sage Network || network.sage.com|| 443 || https || url Sage connect
|-

|}

Déclaration des URLs de services externes

2026-03-19T09:28:59Z

Flfay : Page créée avec « = Documentation – Déclaration des URLs de services externes = ==Contexte == L’application communique avec plusieurs services tiers via HTTP/HTTPS. Dans des environ... »

= Documentation – Déclaration des URLs de services externes =

==Contexte ==

L’application communique avec plusieurs services tiers via HTTP/HTTPS.
Dans des environnements sécurisés (entreprise, production), les flux sortants sont souvent restreints.
Cette documentation décrit les URLs des services externes utilisés.
Ces endpoints doivent être explicitement autorisés par les administrateurs (réseau, sécurité, proxy, pare-feu) afin de garantir le bon fonctionnement de l’application.

==Liste des URLs à autoriser ==

{| class="wikitable"

| ! Service !! URL / Domaine !! Port !! Protocole !! Description | | | | | | | | |
| -------------------------------------------------------------- | - | --------------------------- | - | --- | - | ----- | - | ----------------------------------------- |
| API principale | | https://api.exemple.com | | 443 | | HTTPS | | Accès aux données métier |
| - | | | | | | | | |
| Authentification | | https://auth.exemple.com | | 443 | | HTTPS | | Service d’authentification (OAuth2 / SSO) |
| - | | | | | | | | |
| Notifications | | https://notify.exemple.com | | 443 | | HTTPS | | Envoi de notifications |
| - | | | | | | | | |
| Stockage fichiers | | https://storage.exemple.com | | 443 | | HTTPS | | Upload / téléchargement de fichiers |
| } | | | | | | | | |

Main Page

2026-03-19T09:25:17Z

Flfay :

__NOTOC__
=Sage FRP 1000 =

===Architectures===
* [[Vue d'ensemble 1000 (arch)|Vue d'ensemble]]
* [[Architecture 2 Tiers (arch)|Architecture 2 Tiers]]
* [[Architecture 3 Tiers (arch)|Architecture 3 Tiers]]
* [[Architecture cluster (arch)|Architecture cluster]]

===Guides des administrateurs===

* [[Administration (admin)|Administration]]
* [[Console d'administration (admin)|Référence de la console d'administration]]
* [[Flux d'administration|Flux d'administration]]
* [[Déclaration des URLs de services externes|Déclaration des URLs de services externes]]

===Guides des intégrateurs===

* [[Automates|Automates]]
* [[Processus Métiers (bp)|Processus Métiers et Workflow]]
* [[Imports|Imports]]
* [[Exports|Exports]]
* [[Guide de la traduction|Traduction]]
* [[Pilotage|Pilotage]]
* [[Publication|Publication]]
* [[Portail|Portail]]
* [[Serveur|Serveur]]
* [[Complément Outlook (Outlook)|Complément Outlook]]
* [[Complément Excel (Excel)|Complément Excel]]

===Guides des développeurs===

* [[Développement ESM|Guide de développement ESM]]
* [[Développement DSM|Guide de développement DSM]]
{{IfLatest|
* [[Développement Mobile|Guide de développement d'applications Mobiles]]
}}
* [[Processus Métiers (bp)|Guide des processus métiers et Workflow]]
* [[Web Services (ws)|Guide de développement de Web Services]]
* [[SData|Guide de développement de l'API Rest SData]]
* [[Tableaux de bord (dev)|Guide de développement des Tableaux de bord]]

* [[Concepteur de modèle|Concepteur de modèle]]
* [[Concepteur d'écran|Concepteur d'écran]]
* [[Concepteur de requêtes (Concepteur de requêtes)|Concepteur de requête]]
* [[Guide des formats |Guide des formats de génération/intégration de fichier]]
* [[Référence_pour_les_formats_de_fichier|Référence pour les formats de fichier]]

===Références===

* [[:Category:RTL|Référence du langage et de l'API]]
* [[Référence des styles|Référence des styles desktop]]
* [[Référence des styles web|Référence des styles webtop]]

===Vidéos===
* [[:Category:Video|Didactitiels vidéo (nécessite flash version 9.02 ou plus)]]

===Versions===

* [[Version 6.00 (release note)|Version 6.00]]
* [[Version 6.50 (release note)|Version 6.50]]
* [[Version 7.00 (release note)|Version 7.00]]
* [[Version 7.10 (release_note)|Version 7.10]]
* [[Version 8.00 (release_note)|Version 8.00]]
* [[Version 9.00 (release_note)|Version 9.00]]
* [[Version 9.10 (release_note)|Version 9.10]]
* [[Version 9.20 (release_note)|Version 9.20]]
* [[Version 10.00 (release_note)|Version 10.00]]
* [[Version 11.00 (release_note)|Version 11.00]]
* [[Version 2024 r1 (release_note)|Version 2024 r1]]
* [[Version 2024 r2 (release_note)|Version 2024 r2]]
* [[Version 2025 r1 (release_note)|Version 2025 r1]]
* [[Version 2025 r2 (release_note)|Version 2025 r2]]
* [[Version 2026 r1 (release_note)|Version 2026 r1]]

===Documents===
* [[Documents|Documents]]

AdminManager2 V10

2025-11-28T07:29:01Z

Flfay :

==Présentation==

AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande.

Il est disponible en version 10 [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1000/adminmanager/adminmanager.zip ici]

Il est disponible en version 11 [https://frp1000.blob.core.windows.net/version-1100/adminmanager/adminmanager.zip ici]

==Mise en oeuvre==

{{warning|AdminManager2 doit être lancé en mode administrateur}}

===Authentification au référentiel===

Les informations de connexion aux référentiels sont stockées dans la base de registre, et sont partagées avec le client lourd.

Les commandes authentifiées attendent un paramètre "alias" qui identifie l'entrée de la base de registre par le nom de la clef ou par le libellé de la base.

===Mode interactif===

Les commandes disponibles

==== about====

===== about:update=====
about:update
Télécharge le dernier binaire en ligne et remplace le binaire actuel.

===== about:version=====
about:version
Affiche la version courante et la version disponible en ligne

==== accessProfile ====
===== accessProfile:create=====
accessProfile:create [--accessProfileCaption=xx] [--connectionsTypes=xx] [--isUniqueAccess=xx] [--readOnlyAccess=xx] [--alertOnLoginFail=xx] [--timeToBlock=xx] [--nbLoginFailToLoc=xx] [--failPeriod=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une politique d'accès. les types de connexions possibles sont ctDesktop,ctWebTop,ctService,ctTask,ctOutlook,ctExcel,ctDashboard,ctMobile,ctSOAP,ctSDATA,ctFTP,ctAdmin.

==== accesstoken ====
===== accesstoken:create =====
accesstoken:create --caption=xx --folderName=xx [--databaseName=xx] [--societyName=xx] --applicationName=xx --userName=xx [--expireDays=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un jeton d''accès et l''enregistre dans le répertoire "accesstoken" dans un fichier nommé par le paramètre "caption". Il est de la responsabilité de l'appelant de supprimer ce fichier une fois récupéré.
Le contenu du jeton peut être copié dans une variable d'environnement "varName"

==== application====
===== application:deploy=====
application:deploy --applicationNames=xx [--masterPath=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste d'applications dans le référentiel

Si le master est absent, l'application est téléchargée

Les applications sont Sage1000Entreprise,Tresorerie,AppNotesFrais,cautionsbancaires,comptaGenFin,comptaGenFinGroup,immobilisation,rapprobancaire,banquepaiement

===== application:list=====
application:list
affiche la liste des applications disponibles en ligne

===== application:update=====
application:update [--onlyBySerialNummber=xx] [--verbose=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
télécharge et installe les patchs disponibles puis synchronise les bases métiers si nécessaire

==== authProfile====
===== authProfile:create=====
authProfile:create [--authProfileCaption=xx] [--doConfirmContactInf=xx] [--isComplexPassword=xx] [--minLengthPassword=xx] [--maxAgePassword=xx] [--minAgePassword=xx] [--nbHistorPassword=xx] [--trialNbToBlockUser=xx] [--forbiddenWords=xx] [--doubleFactor=xx] [--allowPasswordReInit=xx] [--passwordReInitSms=xx] [--allowRegister=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une politique d'authentification

==== azureKV====
===== azureKV:get=====
azureKV:get --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur du secret du coffre fort Azure est copiée dans une variable d'environnement "varName"
La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre

===== azureKV:set=====
azureKV:set --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur de la variable d'environnement "varName" est copiée dans le secret du coffre fort Azure.
La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre

==== container====
===== container:create=====
container:create --containerName=xx --containerCaption=xx --containerManager=xx [--azureContainerName=xx] [--azureStorageAccount=xx] [--azureStorageAccessKey=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un conteneur

==== database====
===== database:create=====
database:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--textSupport=xx] [--shareSupport=xx] [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--databaseUser=xx] [--databasePassword=xx] [--databaseGiven=xx] [--doInitialize=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une base de données métier

===== database:delete=====
database:delete [--databaseName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Supprime une base de données métier

===== desktop:install=====
desktop:install [--path=xx] [--url=xx]
Installe le client lourd

==== directory====
=====directory:addEntity=====

directory:addEntity --directoryName=xx [--directoryIdentifier=xx] [--userName=xx] [--groupName=xx] [--authProfile=xx] [--accessProfile=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur ou un groupe à un annuaire et positionne le cas échéant une politique d'accès ou d'authentification.

=====directory:removeEntity=====
directory:removeEntity --directoryName=xx [--userName=xx] [--groupName=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Retire un utilisateur ou un groupe d'un annuaire.

==== directoryAD====
=====directoryAD:create=====
directoryAD:create [--dnBase=xx] --login=xx --password=xx [--isSSO=xx] [--domainName=xx] [--accessProfile=xx] [--name=xx] [--caption=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Créé un annuaire Active Directory

==== directorySageID====
=====directorySageID:create=====
directorySageID:create [--isShadow=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Créé un annuaire Sage Cloud ID

==== dbmaster ====
===== dbmaster:create =====
dbmaster:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--masterPath=xx] --userName=xx --userPassword=xx [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--multitenant=xx] [--providerName=xx] --alias=xx

Crée un référentiel

exemples :
dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny

dbmaster:create --serverName=FRPO150757\SQLEXPRESS --databaseName=dbMaster900_Test --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny

dbmaster:create --serverName=localhost\SQLEXPRESS --databaseName=dbMaster910 --alias="910" --userName=test --userPassword=test --osAuthentication=1

===== dbmaster:update =====
dbmaster:update --alias=xx

synchronise un référentiel

==== env====
===== env:set=====
env:set --name=xx --value=xx
Positionne une variable d'environnement

===== env:get=====
env:get --name=xx
Retourne une variable d'environnement

==== folder====
===== folder:authorize=====
folder:authorize --folderName=xx [--userName=xx] [--groupName=xx] [--applicationName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Autorise un utilisateur sur un dossier

===== folder:create=====
folder:create --folderName=xx --applicationName=xx --databaseName=xx [--dbRefScript=xx] [--initArchive=xx] [--docContainers=xx] [--taskMode=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un dossier
dbRefScript est
* soit le chemin complet vers un fichier xml qui décrit le fichier .sql associé
* soit le nom d'un script disponible dans le master en ligne, il est alors téléchargé (voir online:dbrefs )

===== folder:delete=====
folder:delete --folderName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Supprime un dossier

==== group====
===== group:add=====
group:add --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur à un groupe

===== group:create=====
group:create --groupName=xx [--parentName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un groupe d'utilisateurs

=====group:remove =====
group:remove --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Retire un utilisateur d'un groupe

==== license====
===== license:deploy=====
license:deploy [--keys=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste de clefs dans le référentiel

===== license:validate=====
license:validate --codes=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Enregistre un code DUA

====mail====
=====mail:setup=====
mail:setup --server=xx --TLSimplicit=xx --TLSexplicit=xx --user=xx [--password=xx] [--exp=xx] [--port=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Paramètre le serveur de mail

=====mail:send=====
mail:send --dest=xx --subject=xx --body=xx [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Envoie un mail (utile pour tester le paramétrage du serveur de mail)

====online====
=====online:dbrefs=====
online:dbrefs
Retourne la liste des scripts de références disponibles en ligne

=====online:demos=====
online:demos
Retourne la liste des bases de démo disponibles en ligne

====server====
=====server:install=====
server:install [--path=xx] [--withLoader=xx] [--url=xx]

Télécharge et installe le serveur Sage FRP 1000, ajoute une exception au pare feu pour le service.
Le paramètre "withLoader" permet d'installer le service avec le loader de service

====service ====
=====service:create =====
service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--path=xx] [--withLoader=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un service dans le fichier de configuration ainsi que le service windows associé
Le paramètre "withLoader" permet d'installer le service avec le loader de service

=====service:update=====
service:update --keys=xx --values=xx [--path=xx] [--withLoader=xx] --name=xx
Modifie le fichier de configuration du service

=====service:delete=====
service:delete [--path=xx] [--withLoader=xx] --name=xx
Supprime un service dans le fichier de configuration ainsi que le service windows associé

=====service:start=====
service:start --name=xx
Démarre le service windows lié

=====service:stop =====
service:stop --name=xx
Arrête le service Windows

=====service:list=====
service:list [--path=xx] [--withLoader=xx]
Liste les services présents dans le fichier de configuration du service

====tools:init====
=====tools:init=====
tools:init
Installe les composants nécessaires: libraisiries SSL, OVPs, sage.common.dll, drivers SQL

====user====
=====user:add =====
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--hasPersonalDataRestrictions=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Crée un utilisateur, le paramétre expire indique le nombre de jour avant l'expiration du compte (à partir de la date de création)

=====user:update =====
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--hasPersonalDataRestrictions=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Modifie un utilisateur

=====user:getName =====
user:getName --userMail=xx [--varName=xx]

===Mode batch===

il est possible d'appeler l'exécutable avec en paramètre un fichier contenant une liste de commandes

frp.exe --file="C:\projets\Desktop\adminl1000_scripts\commands.txt"

==Exemples==
user:update
user:update --userName=xx [--userCaption=xx] [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx

===Exemple 1 : Première utilisation===

Téléchargement et installation des prérequis

'''tools:init'''

Téléchargement et installation du server Sage FRP 1000

'''server:install'''

===Exemple 2 : Création d'un référentiel et d'un dossier===

Créer le référentiel

'''dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny '''

Installer l'application suite financière

'''application:deploy --applicationNames=Sage1000Entreprise --alias="ref test" '''

Installer les clefs d'authenticité

'''license:deploy --alias="ref test" --keys=XXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXX '''

Créer la base de données métier

'''database:create --alias="ref test" --url=msodbc://FRPO150757\SQLEXPRESS/baseSuiteTest?prefix="dbo." --masterUserName=sa --masterUserPassword=bunny'''

Créer le dossier

'''folder:create --alias="ref test" --databaseName=baseSuiteTest --applicationName=Sage1000Entreprise --folderName=monDossierSuite --dbRefScript=sql_dbRefGCF1000-euro'''

Créer un groupe

'''group:create --alias="ref test" --groupName="mon groupe"'''

Créer un utilisateur

'''user:add --alias="ref test" --userName="mon user" --userCaption="jean dupont" --userMail="dupont@gmail.com" '''

Associer l'utilisateur au groupe

'''group:add --alias="ref test" --groupName="mon groupe" --userName="mon user"'''

Autoriser le groupe sur le dossier

'''folder:authorize --alias="ref test" --folderName=monDossierSuite --groupName="mon groupe"'''

===Exemple 3 : Création d'un service===

Ajouter l'utilisateur de service

'''user:add --alias="ref test" --userName="webuser" --userCaption="webuser" --userPassword=P@ss'''

Autoriser l'utilisateur

'''folder:authorize --alias="ref test" --folderName=monDossierSuite --userName="webuser" '''

Créer le service

'''service:create --alias="ref test" --name="900_suitefi" --applicationName=Sage1000Entreprise --folderNames="monDossier" --serverUser=webuser --serverPassword=P@ss'''

Démarrer le service

'''service:start --name="900_suitefi"'''

===Exemple 4 : utilisation des variables d'environnement===

Les variables peuvent être définies dans le script, dans le programme appelant, ou bien au niveau du système.

{{tip|Les variables sont substituées sur la ligne de commande, si la variable contient des espaces il faut la référencée entre guillemets "%maVariableAvecEspaces%"}}

<pre>
env:set --name=monAlias --value="référentiel 910"
env:set --name=monServeur --value="FRPO150757\SQLEXPRESS"
dbmaster:create --url=msodbc://%monServeur%/dbMasterTest4?prefix="dbo." --alias="%monAlias%" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny
</pre>

===Exemple 5 : Créer un jeton d'accès===

'''accesstoken:create --caption="test1" --folderName="Compta" --societyName="S1" --applicationName="comptaGenFin" --userName="sage" --alias="920 locale" --expireDays=10'''

===Exemple : Fichier batch===

'''Création d'une base master, installation de la Suite Financière et création d'une base métier'''

<pre>
; Set variables
;
env:set --name=masterAlias --value="master local"
env:set --name=dbServer --value="xxxx"
env:set --name=saPassword --value="xxxx"
;
env:set --name=dbUser --value="syfre"
env:set --name=dbUserPassword --value="xxxx"
;
env:set --name=dbName --value="db1100SuiteFi"
;
env:set --name=folder --value="Test Suite Fi"
env:set --name=group --value="users"
env:set --name=user --value="syfre"

; Initialization
;
tools:init

; Create master database
;
dbmaster:create --url=msodbc://%dbServer%/dbMaster1100?prefix="dbo." --alias="%masterAlias%" --userName=%dbUser% --userPassword=%dbUserPassword% --masterUserName=sa --masterUserPassword=%saPassword%

; Install Sage FRP 1000 Suite Fi
;
application:deploy --applicationNames=Sage1000Entreprise --alias="%masterAlias%"

; Create product database
;
database:create --alias="%masterAlias%" --url=msodbc://%dbServer%/%dbName%?prefix="dbo." --masterUserName=sa --masterUserPassword=%saPassword%
folder:create --alias="%masterAlias%" --databaseName=%dbName% --applicationName=Sage1000Entreprise --folderName="%folder%" --dbRefScript=sql_dbRefGCF1000-euro

; Create group and user
;
group:create --alias="%masterAlias%" --groupName=%group%
user:add --alias="%masterAlias%" --userName=%user% --userCaption="sylvain frere" --userMail="sylvain.frere@sage.com"
group:add --alias="%masterAlias%" --groupName=%group% --userName=%user%
folder:authorize --alias="%masterAlias%" --folderName="%folder%" --groupName=%group%
</pre>

[[Category:Administration]]
[[Category:Version1000]]

TPropertyInfo (MM)

2025-09-19T10:16:12Z

Flfay :

===Introduction===
Cette classe gère la description d'un attribut dans le modèle métier.

====Propriétés :====

[[Propriétés communes (MM)|Propriétés communes aux objets du modèle]].

{|class="wikitable"
|-
! Attribut
! Type
! Accès
! Description
|-
|[[DataType (AMM)|DataType]]
|[[TumlDatatype (MM)|TumlDatatype]]
|read only
|Retourne le type de l'attribut.
|-
|[[UmlDatatype (AMM)|UmlDatatype]]
|string
|read only
|Retourne le type UML de l'attribut.
|-
|[[IsPersistent (AMM)|IsPersistent]]
|boolean
|read only
|Retourne true si l'attribut est persistant.
|-
|[[IsNoPersistent (AMM)|IsNoPersistent]]
|boolean
|read only
|Retourne true si l'attribut n'est pas persistant.
|-
|[[IsVariable (AMM)|IsVariable]]
|boolean
|read only
|Retourne true si l'attribut est variable.
|-
|[[IsStored (AMM)|IsStored]]
|boolean
|read only
|Retourne true si l'attribut est stocké en base.
|-
|[[IsReadOnly (AMM)|IsReadOnly]]
|boolean
|read only
|Retourne true si l'attribut est en lecture seule.
|-
|[[IsImportant (AMM)|IsImportant]]
|boolean
|read only
|Retourne true si l'attribut est marqué comme important.
|-
|[[IsSerialDatatype (AMM)|IsSerialDatatype]]
|boolean
|read only
|Retourne true si le type est un type sérialisé.
|-
|[[IsSimpleDatatype (AMM)|IsSimpleDatatype]]
|boolean
|read only
|Retourne true si le type est un type simple.
|-
|[[IsVarStringDatatype (AMM)|IsVarStringDatatype]]
|boolean
|read only
|Retourne true si le type est une chaîne variable.
|-
|[[IsTextDatatype (AMM)|IsTextDatatype]]
|boolean
|read only
|Retourne true si le type est un type texte.
|-
|[[IsBinaryDatatype (AMM)|IsBinaryDatatype]]
|boolean
|read only
|Retourne true si le type est un type binaire.
|-
|[[IsNumericDatatype (AMM)|IsNumericDatatype]]
|boolean
|read only
|Retourne true si le type est un type numérique.
|-
|[[IsIntegerDatatype (AMM)|IsIntegerDatatype]]
|boolean
|read only
|Retourne true si le type est un type entier.
|-
|[[IsMoneyDatatype (AMM)|IsMoneyDatatype]]
|boolean
|read only
|Retourne true si le type est un type monétaire.
|-
|[[IsNumberDatatype (AMM)|IsNumberDatatype]]
|boolean
|read only
|Retourne true si le type est un type nombre.
|-
|[[IsDatetimeDatatype (AMM)|IsDatetimeDatatype]]
|boolean
|read only
|Retourne true si le type est un type date et heure.
|-
|[[IsDateDatatype (AMM)|IsDateDatatype]]
|boolean
|read only
|Retourne true si le type est un type date.
|-
|[[IsTimeDatatype (AMM)|IsTimeDatatype]]
|boolean
|read only
|Retourne true si le type est un type heure.
|-
|[[IsBooleanDatatype (AMM)|IsBooleanDatatype]]
|boolean
|read only
|Retourne true si le type est un type logique.
|-
|[[IsFrameworkDatatype (AMM)|IsFrameworkDatatype]]
|boolean
|read only
|Retourne true si le type est un type complexe du framework.
|-
|[[IsRoleDatatype (AMM)|IsRoleDatatype]]
|boolean
|read only
|Retourne true si le type est un rôle.
|-
|[[IsRef (AMM)|IsRef]]
|boolean
|read only
|Retourne true si l’attribut est une référence.
|-
|[[IsReference (AMM)|IsReference]]
|boolean
|read only
|Retourne true si l’attribut référence une autre classe.
|-
|[[IsRoleList (AMM)|IsRoleList]]
|boolean
|read only
|Retourne true si le rôle est une collection.
|-
|[[IsRoleAssociation (AMM)|IsRoleAssociation]]
|boolean
|read only
|Retourne true si le rôle est une association.
|-
|[[IsUniqueDatatype (AMM)|IsUniqueDatatype]]
|boolean
|read only
|Retourne true si le type est un identifiant unique.
|-
|[[RefClassName (AMM)|RefClassName]]
|string
|read only
|Retourne le nom de la classe référencée si l'attribut est un rôle.
|-
|[[AssClassName (AMM)|AssClassName]]
|string
|read only
|Retourne le nom de la classe associée si l'attribut est un rôle d'association.
|-
|[[IsEnumeration (AMM)|IsEnumeration]]
|boolean
|read only
|Retourne true si le type est une énumération.
|-
|[[EnumerationName (AMM)|EnumerationName]]
|string
|read only
|Retourne le nom de l'énumération si le type est une énumération.
|-
|[[TypeParam1 (AMM)|TypeParam1]]
|string
|read only
|Retourne le premier paramètre de type (si applicable).
|-
|[[TypeParam2 (AMM)|TypeParam2]]
|string
|read only
|Retourne le deuxième paramètre de type (si applicable).
|-
|[[TypeParam3 (AMM)|TypeParam3]]
|string
|read only
|Retourne le troisième paramètre de type (si applicable).
|-
|[[IsUnicode (AMM)|IsUnicode]]
|boolean
|read only
|Retourne true si le type est Unicode.
|-
|[[IsPersonalData (AMM)|IsPersonalData]]
|boolean
|read only
|Retourne true si l'attribut contient des données personnelles.
|-
|[[IsSensitiveData (AMM)|IsSensitiveData]]
|boolean
|read only
|Retourne true si l'attribut contient des données sensibles.
|-
|[[Caption (AMM)|Caption]]
|string
|read only
|Retourne le libellé de l'attribut.
|-
|[[NativeCaption (AMM)|NativeCaption]]
|string
|read only
|Retourne le libellé natif de l'attribut.
|-
|[[ShortCaption (AMM)|ShortCaption]]
|string
|read only
|Retourne le libellé court de l'attribut.
|-
|[[NativeShortCaption (AMM)|NativeShortCaption]]
|string
|read only
|Retourne le libellé court natif de l'attribut.
|-
|[[Hint (AMM)|Hint]]
|string
|read only
|Retourne l'indice ou aide de l'attribut.
|-
|[[NativeHint (AMM)|NativeHint]]
|string
|read only
|Retourne l'indice natif de l'attribut.
|-
|[[IsFramework (AMM)|IsFramework]]
|boolean
|read only
|Retourne true si l'attribut appartient au framework.
|-
|[[IsRefOid (AMM)|IsRefOid]]
|boolean
|read only
|Retourne true si l'attribut est un OID de référence.
|-
|[[IsChild (AMM)|IsChild]]
|boolean
|read only
|Retourne true si l'attribut représente un enfant (composition).
|}

{{Footer|Code métier}}
[[category:Code métier]]
[[category:ModelManager]]

Fichier de configuration (server)

2025-09-02T14:09:59Z

Flfay :

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 10 000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes à ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Domaine publique du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0}}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SAML====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SAMLv2 Log=1
|Boolean
|Active la trace SAML (à retirer une fois la mise au point effectuée)
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

====Logs====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Log keep days
|entier
|durée en jour de rétention des fichiers dans le répertoire de log, par défaut 10
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Fichier de configuration (server)

2025-09-02T14:07:57Z

Flfay :

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 10 000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes à ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Domaine publique du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0}}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SAML====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SAMLv2 Log=1
|Boolean
|Active la trace SAML (à retirer une fois la mise au point effectuée)
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

====Logs====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Log keep days
|entier
|durée en jour de rétention des fichiers dans le répertoire de log, par défaut 10
|}

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Fichier de configuration (server)

2025-07-01T14:57:33Z

Flfay : /* Service */

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 10 000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes à ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Domaine publique du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0}}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SAML====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SAMLv2 Log=1
|Boolean
|Active la trace SAML (à retirer une fois la mise au point effectuée)
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Fichier de configuration (server)

2025-02-25T11:21:26Z

Flfay :

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Domaine publique du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvTLSv1_1, sslvTLSv1_2, sslvTLSv1_3 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|TLS 1.3 supporté à partir de la version 10 en utilisant OpenSSL 3.0}}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SAML====

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SAMLv2 Log=1
|Boolean
|Active la trace SAML (à retirer une fois la mise au point effectuée)
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

CreateSelector (class)

2023-12-12T14:48:12Z

Flfay :

<source lang='delphi'>constructor CreateSelector(const iWhere,iOrderBy:string; iDescendants:boolean; const iArgs:Array of variant):TSelector;</source>

Cette fonction crée un sélecteur vérifiant une expression objet.

{|class="wikitable"
|-
|Result
|Un [[Selecteur (tech)|sélecteur]] sur la classe.
|-
|iWhere
|[[Expressions objets (code)|Expression objet]] principale.
|-
|iOrderBy
|Ordre de tri.
|-
|iDescendants
|Inclure les classes descendantes.
|-
|iArgs
|Tableau des arguments des expressions.
|}

Exemple
<source lang='delphi'>
var sel:TSelector; S:string; stag:string; inst:WFClasseA;
begin
sel := WFClasseA.CreateSelector('','',true,[]);

S := ''; stag := '';
foreach inst in sel.AsList do
begin
S := S+stag+inst.unCode;
stag := ',';
end;

ShowMessage(S);
end;</source>

Voir aussi :

* [[Selecteur (tech)|Sélecteur]]

{{Footer|Classes métiers (tech)}}
[[category:Classes métiers]]
[[Category:Version700]]

EncodeURL (http)

2023-11-07T18:23:03Z

Flfay : Page créée avec « <source lang='delphi'>property EncodeURL:boolean;</source> '''Lecture/Ecriture''' Cette propriété indique si l'url doit être encodée, la valeur par défaut est vrai.... »

<source lang='delphi'>property EncodeURL:boolean;</source>

'''Lecture/Ecriture'''

Cette propriété indique si l'url doit être encodée, la valeur par défaut est vrai.

{{info|Positionner cette valeur peut être utile si l'encodage de l'url est géré dans le code}}

Exemple:
<source lang='delphi'>
begin
end;
</source>

Voir aussi:

{{Footer|Requêtes HTTP (tech)}}
[[category:Requêtes HTTP]]

Langage

2023-11-02T06:07:53Z

Flfay :

==Introduction==
Le langage 1000 est un langage managé dont la syntaxe hérite du Pascal Objet.

Les différences principales avec le Pascal Objet sont les suivantes :

*Il n'y a pas de support pour définir des types, classes et structures. Dans la méthodologie de développement d’une application ligne 1000 cette partie est faite dans le Modèle Métier.

*La mémoire est managée de sorte qu’il n’est pas nécessaire d’allouer ou de libérer explicitement la mémoire.

*Il n'y a pas de support pour les types ensembles (SET) et les opérateurs associés.

==Le langage==
===Bloc de code===
Un bloc de code à la structure suivante :

<pre>
var
declarations ;
begin
instructions ;
end;
</pre>

La partie déclaration peut contenir des déclarations de variables ou des procédures imbriquées.

===Variables===
Les variables DOIVENT être explicitement déclarées en utilisant la syntaxe suivante :

<pre>
var
identifier : type;
identifier, identifier : type;
identifier : Array[0..X] of type;
identifier : Array of type;
</pre>

===Types===
Le langage supporte des déclarations de type fort et contrôle l'intégrité des types; toutefois, pour des raisons de compatibilité ascendante, les erreurs de contrôle de type génèrent des messages d'alerte et pas des erreurs.

{| class="wikitable"
|-
!type
!alias(*)
!remarks
|-
|integer
|int,unsigned,short,long,unsignedlong
|Entier 32 bit signé
|-
|longint
|
|Entier 64 bit signé
|-
|double
|float (***)
|Nombre flottant double précision
* 5.0e-324 .. 1.7e+308
* 15-16 chiffres significatifs
|-
|currency
|decimal
|Valeur monétaire virgule fixe à 4 décimales
* -922337203685477.5808.. 922337203685477.5807
* 10-20 chiffres significatifs
|-
|boolean
|
|Valeur logique vrai ou fausse
|-
|string
|anyURI
|Chaîne de caractère (**)
|-
|char
|
|Caractère
|-
|enum
|
|Enumération
|-
|TDatetime
|datetime
|Date et heure encodée en double
|-
|date
|
|Date encodée en double
|-
|time
|
|Heure encodée en double
|-
|variant
|
|Containeur de variable de type dynamique.
|-
|TClass
|
|Type classe générique
|-
|TObject
|
|Type objet générique
|-
|TPersistent
|
|Type persistent générique
|}
(*) Les alias sont définis pour supporter les sérialisation SOAP

(**) L'encodage des chaînes de caractère peut dépendre des versions; jusqu'à la version 5.60 incluse les chaînes sont basées sur un encodage ANSI. Dans le futur les chaînes pourraient être basées sur un encodage unicode.

(***) Le type Double (Float) n'est pas adéquat pour réaliser des calculs monétaires, utiliser le type Currency

Les types suivants sont spécifiquement introduis pour le support de la sérialisation SOAP :

{| class="wikitable"
|-
!type
!alias
!remarks
|-
|normalizedString
|
|
|-
|token
|
|
|-
|duration
|
|
|-
|base64binary
|
|Binary base 64 encoded stream
|-
|hexbinary
|
|Hexadecimal encoded stream
|}

===Constantes===
Il n'y a pas de support pour déclarer des constantes.

{| class="wikitable"
|-
|integer
| 10
|-
|hexadecimal
| $0A
|-
|float
| 1.00
|-
|char
| 'A'
|-
|char
| #10
|-
|string
| 'This is a string with a '' quote'
|}
===Procedures et fonctions===
Tout comme en langage Pascal les procédures et fonctions peuvent être imbriquées dans un bloc de code :

<pre>
var
p1,p2,p3 : type;

function name(p4:type):type;
var p2:type;
begin
Result := p1+p4+p2;
end;

begin
...
p3 := name(p1,p2);
end;
</pre>

==Opérateurs==
===Arithmétiques===
{| class="wikitable"
|-
| +
|Addition
|-
| -
|Subtraction
|-
|unary (-)
|Negation
|-
| /
|Division
|-
| *
|Multiplication
|-
| div
|Integer division
|-
| mod
|Integer modulo
|}

===Logiques===
{| class="wikitable"
|-
| and
|logical AND
|-
| or
|logical OR
|-
| xor
|logical XOR
|-
| not
|Negation
|}

===Comparaisons===
{| class="wikitable"
|-
| =
|equal
|-
| <>
|not equal
|-
| >
|upper
|-
| >=
|upper equal
|-
| <
|lower
|-
| <=
|lower equal
|}

==Expression==
Les expressions sont évaluées de la gauche vers la droite, les termes doivent être placés entre parenthèses :

<pre>
(a=b) and (c=d) ....
</pre>

L'évaluation des expressions est optimisée :

<pre>
// term is not evaluate.
false and term

// term is not evaluate.
true or term
</pre>

==Instructions==
===Instruction===
Les instruction doivent être séparées par un point virgule ";"

<pre>
x := 1;
y := 2;
x := x+y;
</pre>

Plusieurs instructions peuvent être assemblées en utilisant begin / end :

<pre>
begin
x := 1;
y := 2;
x := x+y;
end;
</pre>

===Affectation===
L'affectation utilise l'opérateur ":=" :

<pre>
x := 1;
</pre>

===for===
L'instruction for permet l'implémentation de boucle basées sur un index :

<pre>
for index:=lower to upper do
statement ;

for index:=upper downto lower do
statement ;
</pre>

La variable d'index DOIT être une variable entière.

===while===
L'instruction while permet l'implémentation de boucle basées sur une expression :

<pre>
while (expression) do
statement ;
</pre>

Le corps de la boucle peut ne pas être exécuté.

===repeat===
L'instruction repeat permet l'implémentation de boucle basées sur une expression :

<pre>
repeat
statement ;
until (expression)
</pre>

Le corps de la boucle sera au moins exécuté une fois.

===foreach===
L'instruction foreach permet l'itération à l'intérieur d'une collection :

<pre>
foreach V in C do
statement ;

foreach V in C index I do
statement ;
</pre>

C DOIT être une [[:category:Objets itérateurs|collection]] (ex : liste, curseur)
V DOIT être une variable du type de la collection.

Optionnellement une variable d'index I peut être utilisée, dans ce cas elle DOIT être une variable entière.

===break===
L'instruction break permet d'interrompre l'exécution d'une boucle :

<pre>
for index:=lower to upper do
begin
....
if expression then break;
end;
</pre>

L'effet de l'instruction break est de sortir de la boucle.

L'instruction break peut être utilisée dans les boucles for,foreach,while,repeat.

===continue===
L'instruction continue permet d'interrompre l'exécution du corps de boucle et de passer à l'itération suivante :

<pre>
for index:=lower to upper do
begin
if expression then continue;
....
end;
</pre>

L'effet de l'instruction continue est de passer à l'itération suivante.

L'instruction continue peut être utilisée dans les boucles for,foreach,while,repeat.

===if===
L'instruction if permet de réaliser un branchement en fonction d'un test :

<pre>
if expression then statement ;

if expression then statement else statement ;
</pre>

===case===
L'instruction case permet un branchement en fonction de la valeur d'une variable.

<pre>
case V of
const1 : statement1;
const2 : statement2;
...
else statementN;
end;
</pre>

La variable peut être une variable de type entière ou chaîne de caractère.

===Support des exceptions===
Une exception peut être levée par le code managé, la librairie d'exécution ou le framework. Dans tous les cas les exceptions peuvent être traitées par des blocs try finally / except.

====Lever une exception====
L'instruction raise permet de lever une exception :

<pre>
raise ERule.Create('some message here');
</pre>

La classe de l'exception doit être une des classes suivantes :

{| class="wikitable"
|-
|ERule
|Erreur métier
|}

====Try / finally====
Un bloc d'instruction Try / finally permet d'intercepter une exception en vu d'assurer l'exécution d'un code de sortie :

<pre>
try
statement 1;
finally
statement 2;
end;
statement 3 ;
</pre>

Si une exception est levée dans le bloc 1 l'exécution se poursuit dans le bloc 2 avant de revenir au bloc supérieur. Le bloc 3 n'est jamais exécuté.

====Try / except block====
Un bloc d'instruction Try / except permet d'intercepter une exception en vu de traiter l'erreur :

<pre>
try
statement 1;
except
statement 2;
end;
statement 3;
</pre>

Si une exception est levée dans le bloc 1 l'exécution se poursuit dans le bloc 2 puis dans le bloc 3.

L'objet d'exception E peut être manipulé dans le bloc d'exception :

<pre>
try
statement 1;
except
showMessage(E.Message);
statement 2;
end;
statement 3;
</pre>

L'exception peut être de nouveau levée a l'intérieur d'un bloc d'exception :

<pre>
try
statement 1;
except
statement 2;
raise ;
end;
statement 3;
</pre>

Si une exception est levée dans le bloc 1 l'exécution se poursuit dans le bloc 2 puis est redéclenchée; le bloc 3 n'est pas exécuté.

==Fonctions magiques==
===Assign()===
La fonction Assign() permet de tester qu'une variable contenant un objet est affecté, c'est à dire que la référence de l'objet n'est pas nil.

Exemple :
<source lang='delphi'>
begin
// Teste le retour d'une fonction
inst := someFunctionWichReturnAnObject(...);
if Assigned(inst) then
begin
end;
end;

begin
// Teste si une référence est affectée
if Assigned(Ref1) and Assigned(Ref1.Ref2) and Assigned(Ref1.Ref2.Ref3) then
begin
V := Ref1.Ref2.Ref3.Attribute;
end;
end;
</source>

A partir de la version 5.60 il est possible de tester directement une notation pointée :

<source lang='delphi'>
begin
// Teste si une référence est affectée (safe in 5.60)
if Assigned(Ref1.Ref2.Ref3) then
begin
V := Ref1.Ref2.Ref3.Attribute;
end;
end;
</source>

===_TP()===
La fonction _TP() permet de convertir une chaîne de caractère dans la langue utilisée lors de l'exécution.

Cette fonction à deux usages :
# Elle permet aux outils de traduction de retrouver les chaînes de caractère à traduire.
# Elle traduit les chaînes de caractère dans la langue utilisée lors de l'exécution.

Le développeur doit respecter certaine règles pour permettre une traduction efficace:

'''Ne pas utiliser de variable dans les messages :'''
<source lang='delphi'>
begin
// Message impossible à extraire (Erreur de compilation) :
AMsg := _TP('L''objet '+inst.Caption+' ne remplit pas la condition ... ');

// Forme correcte :
AMsg := Format(_TP('L''objet %s ne remplit pas la condition ...'),[inst.Caption]);
end;
</source>

'''Ne pas couper les messages en morceaux incompréhensibles :'''
<source lang='delphi'>
begin
// Message incompréhensible pour le traducteur :
AMsg := _TP('L'objet') +inst.Caption+ _TP(' ne remplit pas la condition');
end;
</source>

'''Gérer l'ordre des paramètres dans les formats :'''
<source lang='delphi'>
begin
// L'ordre des paramètres pourra être inversé dans le message traduit.
AMsg := Format(_TP('L''objet %1s ne remplit pas la condition exprimée par %2s'),[inst.Caption,AExpression]);
end;
</source>

Voir aussi :

* [[Guide de la traduction|Traduction]]
* [[:Category:RTL Traduction|Fonctions de traduction]]

===AS===
'''AS''' est un opérateur de transtypage utilisable sur les classes métiers.

L'opérateur AS est évaluée à la compilation pour permettre au compilateur de connaître la classe de l'objet transtypé '''ET''' à l'exécution pour vérifier que la classe de l'objet est bien conforme à celle indiquée dans le transtypage.

Exemple :
<source lang='delphi'>
function foo(inst:TitObject):Integer;
begin
// Si inst n'est pas un objet de MyClasse une exception sera levée.
Result := (inst as MyClasse).MyVariable;
end;

function foo(inst:TitObject):Integer;
var V:MyClasse;
begin
// Si inst n'est pas un objet de MyClasse une exception sera levée.
V := (inst as MyClasse);
Result := V.MyVariable;
end;
</source>

===IS===
'''IS''' est un opérateur boolean qui teste si un objet est d'une classe métier particulière.

Exemple:
<source lang='delphi'>
function foo(inst:TitObject):Integer;
begin
if (inst is MyClass) then
begin
...
end
else
if (inst is OtherClass) then
begin
....
end;
end;
</source>

{{Footer}}
[[category:DSM]]
[[category:Développement]]
[[category:Langage]]

AdminManager2 V10

2023-09-18T07:13:43Z

Flfay :

==Présentation==

AdminManager2 est un outil permettant d'effectuer des tâches d'administration en ligne de commande.

Il est disponible en version 10 [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1000/adminmanager/adminmanager.zip ici]

Il est disponible en version 11 [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1100/adminmanager/adminmanager.zip ici]

==Mise en oeuvre==

{{warning|AdminManager2 doit être lancé en mode administrateur}}

===Authentification au référentiel===

Les informations de connexion aux référentiels sont stockées dans la base de registre, et sont partagées avec le client lourd.

Les commandes authentifiées attendent un paramètre "alias" qui identifie l'entrée de la base de registre par le nom de la clef ou par le libellé de la base.

===Mode interactif===

Les commandes disponibles

==== about====

===== about:update=====
about:update
Télécharge le dernier binaire en ligne et remplace le binaire actuel.

===== about:version=====
about:version
Affiche la version courante et la version disponible en ligne

==== accessProfile ====
===== accessProfile:create=====
accessProfile:create [--accessProfileCaption=xx] [--connectionsTypes=xx] [--isUniqueAccess=xx] [--readOnlyAccess=xx] [--alertOnLoginFail=xx] [--timeToBlock=xx] [--nbLoginFailToLoc=xx] [--failPeriod=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une politique d'accès. les types de connexions possibles sont ctDesktop,ctWebTop,ctService,ctTask,ctOutlook,ctExcel,ctDashboard,ctMobile,ctSOAP,ctSDATA,ctFTP,ctAdmin.

==== accesstoken ====
===== accesstoken:create =====
accesstoken:create --caption=xx --folderName=xx [--databaseName=xx] [--societyName=xx] --applicationName=xx --userName=xx [--expireDays=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un jeton d''accès et l''enregistre dans le répertoire "accesstoken" dans un fichier nommé par le paramètre "caption". Il est de la responsabilité de l'appelant de supprimer ce fichier une fois récupéré.
Le contenu du jeton peut être copié dans une variable d'environnement "varName"

==== application====
===== application:deploy=====
application:deploy --applicationNames=xx [--masterPath=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste d'applications dans le référentiel

Si le master est absent, l'application est téléchargée

Les applications sont Sage1000Entreprise,Tresorerie,AppNotesFrais,cautionsbancaires,comptaGenFin,comptaGenFinGroup,immobilisation,rapprobancaire,banquepaiement

===== application:list=====
application:list
affiche la liste des applications disponibles en ligne

===== application:update=====
application:update [--onlyBySerialNummber=xx] [--verbose=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
télécharge et installe les patchs disponibles puis synchronise les bases métiers si nécessaire

==== authProfile====
===== authProfile:create=====
authProfile:create [--authProfileCaption=xx] [--doConfirmContactInf=xx] [--isComplexPassword=xx] [--minLengthPassword=xx] [--maxAgePassword=xx] [--minAgePassword=xx] [--nbHistorPassword=xx] [--trialNbToBlockUser=xx] [--forbiddenWords=xx] [--doubleFactor=xx] [--allowPasswordReInit=xx] [--passwordReInitSms=xx] [--allowRegister=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une politique d'authentification

==== azureKV====
===== azureKV:get=====
azureKV:get --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur du secret du coffre fort Azure est copiée dans une variable d'environnement "varName"
La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre

===== azureKV:set=====
azureKV:set --keyvaultName=xx --secretName=xx [--varName=xx]
La valeur de la variable d'environnement "varName" est copiée dans le secret du coffre fort Azure.
La machine qui exécute l'adminmanager doit être service principal pour accéder au coffre

==== container====
===== container:create=====
container:create --containerName=xx --containerCaption=xx --containerManager=xx [--azureContainerName=xx] [--azureStorageAccount=xx] [--azureStorageAccessKey=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un conteneur

==== database====
===== database:create=====
database:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--textSupport=xx] [--shareSupport=xx] [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--databaseUser=xx] [--databasePassword=xx] [--databaseGiven=xx] [--doInitialize=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée une base de données métier

===== database:delete=====
database:delete [--databaseName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Supprime une base de données métier

===== desktop:install=====
desktop:install [--path=xx] [--url=xx]
Installe le client lourd

==== directory====
=====directory:addEntity=====

directory:addEntity --directoryName=xx [--directoryIdentifier=xx] [--userName=xx] [--groupName=xx] [--authProfile=xx] [--accessProfile=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur ou un groupe à un annuaire et positionne le cas échéant une politique d'accès ou d'authentification.

=====directory:removeEntity=====
directory:removeEntity --directoryName=xx [--userName=xx] [--groupName=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Retire un utilisateur ou un groupe d'un annuaire.

==== directoryAD====
=====directoryAD:create=====
directoryAD:create [--dnBase=xx] --login=xx --password=xx [--isSSO=xx] [--domainName=xx] [--accessProfile=xx] [--name=xx] [--caption=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Créé un annuaire Active Directory

==== directorySageID====
=====directorySageID:create=====
directorySageID:create [--isShadow=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Créé un annuaire Sage Cloud ID

==== dbmaster ====
===== dbmaster:create =====
dbmaster:create [--url=xx] [--masterUserName=xx] [--masterUserPassword=xx] [--osAuthentication=xx] [--compressed=xx] [--unicode=xx] [--masterPath=xx] --userName=xx --userPassword=xx [--driver=xx] [--serverName=xx] [--databaseName=xx] [--databaseSchema=xx] [--multitenant=xx] [--providerName=xx] --alias=xx

Crée un référentiel

exemples :
dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny

dbmaster:create --serverName=FRPO150757\SQLEXPRESS --databaseName=dbMaster900_Test --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny

dbmaster:create --serverName=localhost\SQLEXPRESS --databaseName=dbMaster910 --alias="910" --userName=test --userPassword=test --osAuthentication=1

===== dbmaster:update =====
dbmaster:update --alias=xx

synchronise un référentiel

==== env====
===== env:set=====
env:set --name=xx --value=xx
Positionne une variable d'environnement

===== env:get=====
env:get --name=xx
Retourne une variable d'environnement

==== folder====
===== folder:authorize=====
folder:authorize --folderName=xx [--userName=xx] [--groupName=xx] [--applicationName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Autorise un utilisateur sur un dossier

===== folder:create=====
folder:create --folderName=xx --applicationName=xx --databaseName=xx [--dbRefScript=xx] [--initArchive=xx] [--docContainers=xx] [--taskMode=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un dossier
dbRefScript est
* soit le chemin complet vers un fichier xml qui décrit le fichier .sql associé
* soit le nom d'un script disponible dans le master en ligne, il est alors téléchargé (voir online:dbrefs )

===== folder:delete=====
folder:delete --folderName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Supprime un dossier

==== group====
===== group:add=====
group:add --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Ajoute un utilisateur à un groupe

===== group:create=====
group:create --groupName=xx [--parentName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un groupe d'utilisateurs

=====group:remove =====
group:remove --groupName=xx --userName=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx
Retire un utilisateur d'un groupe

==== license====
===== license:deploy=====
license:deploy [--keys=xx] [--varName=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Déploie une liste de clefs dans le référentiel

===== license:validate=====
license:validate --codes=xx [--adminUser=xx] [--adminPassword=xx] --alias=xx [--org=xx]
Enregistre un code DUA

====mail====
=====mail:setup=====
mail:setup --server=xx --TLSimplicit=xx --TLSexplicit=xx --user=xx [--password=xx] [--exp=xx] [--port=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Paramètre le serveur de mail

=====mail:send=====
mail:send --dest=xx --subject=xx --body=xx [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Envoie un mail (utile pour tester le paramétrage du serveur de mail)

====online====
=====online:dbrefs=====
online:dbrefs
Retourne la liste des scripts de références disponibles en ligne

=====online:demos=====
online:demos
Retourne la liste des bases de démo disponibles en ligne

====server====
=====server:install=====
server:install [--path=xx] [--withLoader=xx] [--url=xx]

Télécharge et installe le serveur Sage FRP 1000, ajoute une exception au pare feu pour le service.
Le paramètre "withLoader" permet d'installer le service avec le loader de service

====service ====
=====service:create =====
service:create --name=xx --applicationName=xx --folderNames=xx --serverUser=xx --serverPassword=xx [--path=xx] [--withLoader=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Crée un service dans le fichier de configuration ainsi que le service windows associé
Le paramètre "withLoader" permet d'installer le service avec le loader de service

=====service:update=====
service:update --keys=xx --values=xx [--path=xx] [--withLoader=xx] --name=xx
Modifie le fichier de configuration du service

=====service:delete=====
service:delete [--path=xx] [--withLoader=xx] --name=xx
Supprime un service dans le fichier de configuration ainsi que le service windows associé

=====service:start=====
service:start --name=xx
Démarre le service windows lié

=====service:stop =====
service:stop --name=xx
Arrête le service Windows

=====service:list=====
service:list [--path=xx] [--withLoader=xx]
Liste les services présents dans le fichier de configuration du service

====tools:init====
=====tools:init=====
tools:init
Installe les composants nécessaires: libraisiries SSL, OVPs, sage.common.dll, drivers SQL

====user====
=====user:add =====
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--hasPersonalDataRestrictions=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--adminUser=xx] [--adminPassword=xx] [--org=xx] --alias=xx
Crée un utilisateur, le paramétre expire indique le nombre de jour avant l'expiration du compte (à partir de la date de création)

=====user:update =====
user:add --userName=xx --userCaption=xx [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--hasAdminRole=xx] [--hasAdminFolderRole=xx] [--hasDevelopperRole=xx] [--haveToChangePassword=xx] [--randomPassword=xx] [--hasPersonalDataRestrictions=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx
Modifie un utilisateur

=====user:getName =====
user:getName --userMail=xx [--varName=xx]

===Mode batch===

il est possible d'appeler l'exécutable avec en paramètre un fichier contenant une liste de commandes

frp.exe --file="C:\projets\Desktop\adminl1000_scripts\commands.txt"

==Exemples==
user:update
user:update --userName=xx [--userCaption=xx] [--userMail=xx] [--newUserPassword=xx] [--expire=xx] [--adminUser=xx] [--adminPassword=xx] --alias=xx

===Exemple 1 : Première utilisation===

Téléchargement et installation des prérequis

'''tools:init'''

Téléchargement et installation du server Sage FRP 1000

'''server:install'''

===Exemple 2 : Création d'un référentiel et d'un dossier===

Créer le référentiel

'''dbmaster:create --url=msodbc://FRPO150757\SQLEXPRESS/dbMaster900_Test?prefix="dbo." --alias="ref test" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny '''

Installer l'application suite financière

'''application:deploy --applicationNames=Sage1000Entreprise --alias="ref test" '''

Installer les clefs d'authenticité

'''license:deploy --alias="ref test" --keys=XXXXXXXXXXXXXXX,XXXXXXXXXXXXXXXXXXX '''

Créer la base de données métier

'''database:create --alias="ref test" --url=msodbc://FRPO150757\SQLEXPRESS/baseSuiteTest?prefix="dbo." --masterUserName=sa --masterUserPassword=bunny'''

Créer le dossier

'''folder:create --alias="ref test" --databaseName=baseSuiteTest --applicationName=Sage1000Entreprise --folderName=monDossierSuite --dbRefScript=sql_dbRefGCF1000-euro'''

Créer un groupe

'''group:create --alias="ref test" --groupName="mon groupe"'''

Créer un utilisateur

'''user:add --alias="ref test" --userName="mon user" --userCaption="jean dupont" --userMail="dupont@gmail.com" '''

Associer l'utilisateur au groupe

'''group:add --alias="ref test" --groupName="mon groupe" --userName="mon user"'''

Autoriser le groupe sur le dossier

'''folder:authorize --alias="ref test" --folderName=monDossierSuite --groupName="mon groupe"'''

===Exemple 3 : Création d'un service===

Ajouter l'utilisateur de service

'''user:add --alias="ref test" --userName="webuser" --userCaption="webuser" --userPassword=P@ss'''

Autoriser l'utilisateur

'''folder:authorize --alias="ref test" --folderName=monDossierSuite --userName="webuser" '''

Créer le service

'''service:create --alias="ref test" --name="900_suitefi" --applicationName=Sage1000Entreprise --folderNames="monDossier" --serverUser=webuser --serverPassword=P@ss'''

Démarrer le service

'''service:start --name="900_suitefi"'''

===Exemple 4 : utilisation des variables d'environnement===

Les variables peuvent être définies dans le script, dans le programme appelant, ou bien au niveau du système.

'''env:set --name=monAlias --value="référentiel 910"'''

'''env:set --name=monServeur --value="FRPO150757\SQLEXPRESS"'''

'''dbmaster:create --url=msodbc://%monServeur%/dbMasterTest4?prefix="dbo." --alias="%monAlias%" --userName=test --userPassword=test --masterUserName=sa --masterUserPassword=bunny'''

===Exemple 5 : Créer un jeton d'accès===

'''accesstoken:create --caption="test1" --folderName="Compta" --societyName="S1" --applicationName="comptaGenFin" --userName="sage" --alias="920 locale" --expireDays=10'''

[[Category:Administration]]
[[Category:Version1000]]

Connexion VM Sage Partner Cloud

2023-04-13T16:08:27Z

Flfay :

Il existe deux options pour se connecter à la VM

==Connexion via un lien Bastion==

Les informations de connexions peuvent être obtenues en cliquant sur l'icône "Infrastructure du site".

{{warning|Le transfert de fichiers n'est pas possible dans ce cas.}}

[[image:SPC_15.png]]

==Connexion via un client RDP==

Cette option téléchargera un script powershell que vous devez exécuter sur votre ordinateur local.

Vous aurez besoin
* d'un nom d'utilisateur et d'un mot de passe Azure pour valider votre utilisateur
* des informations d'identification pour la machine virtuelle.(Vous pouvez obtenir ces identifiants de VM en cliquant sur l'icône "infrastructure du site".)

{{tip|Veuillez noter que vous devrez peut-être désactiver les politiques d'exécution de la portée de votre machine locale pour pouvoir exécuter le script powershel}}

[https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.3 voir la documentation sur le site de Microsoft]

Connexion VM Sage Partner Cloud

2023-04-13T16:08:13Z

Flfay :

Connexion VM Sage Partner Cloud

2023-04-13T16:06:53Z

Flfay :

Il existe deux options pour se connecter à la VM

==Connexion via un lien Bastion==

Les informations de connexions peuvent être obtenues en cliquant sur l'icône "Infrastructure du site".

{{warning|Le transfert de fichiers n'est pas possible dans ce cas.}}

[[image:SPC_15.png]]

==Connexion via un client RDP==

Cette option téléchargera un script powershell que vous devez exécuter sur votre ordinateur local.

Vous aurez besoin d'un nom d'utilisateur et d'un mot de passe Azure pour valider votre utilisateur ainsi que les informations d'identification pour la machine virtuelle.
Vous pouvez obtenir ces identifiants de VM en cliquant sur l'icône "infrastructure du site".

[[image:SPC_15.png]]

Veuillez noter que vous devrez peut-être désactiver les politiques d'exécution de la portée de votre machine locale pour pouvoir exécuter le script powershel

[https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.3 voir la documentation sur le site de Microsoft]

Fichier:SPC 15.png

2023-04-13T16:04:56Z

Flfay :

Connexion VM Sage Partner Cloud

2023-04-13T16:01:56Z

Flfay : Page créée avec « Il existe deux options pour se connecter à la VM ==Connexion via un lien Bastion== Les informations de connexions peuvent être obtenues en cliquant sur l'icône "Infra... »

Il existe deux options pour se connecter à la VM

==Connexion via un lien Bastion==

Les informations de connexions peuvent être obtenues en cliquant sur l'icône "Infrastructure du site".
Le transfert de fichiers n'est pas possible dans ce cas.

==Connexion via un client RDP==

Cette option téléchargera un script powershell que vous devez exécuter sur votre ordinateur local.
Vous aurez besoin d'un nom d'utilisateur et d'un mot de passe Azure pour valider votre utilisateur ainsi que les informations d'identification pour la machine virtuelle.
Vous pouvez obtenir ces identifiants de VM en cliquant sur l'icône "infrastructure du site".
Veuillez noter que vous devrez peut-être désactiver les politiques d'exécution de la portée de votre machine locale pour pouvoir exécuter le script powershel

[https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/set-executionpolicy?view=powershell-7.3 voir la documentuation sur le site de Microsoft]

Fichier de configuration (server)

2023-03-29T20:00:38Z

Flfay : /* Mise au point, debugger {{Version700}} */

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Nom réseau du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvSSLv2, sslvSSLv23, sslvSSLv3, sslvTLSv1, sslvTLSv1_1, sslvTLSv1_2 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en temps réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Fichier de configuration (server)

2023-03-20T12:57:40Z

Flfay : /* Quotas */

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Nom réseau du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvSSLv2, sslvSSLv23, sslvSSLv3, sslvTLSv1, sslvTLSv1_1, sslvTLSv1_2 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en tant réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

{{tip|La liste des extensions suivantes n'est jamais filtrée car le service est susceptible de créer des fichiers de ce type (xlsx,ods,xml,pdf,,csv,sxc,xls,,jpg,jpeg,png,asice)}}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

SMTP oAuth2

2023-02-16T14:58:54Z

Flfay :

Il est possible d'authentifier la messagerie système grâce à oAuth2.

==Mise en œuvre==

===Inscription de l'application dans l'annuaire ===

Sage1000 doit être inscrit en tant qu'application dans le fournisseur d'identité.

Cette inscription permet l'obtention un identifiant (Client ID) et des url oAuth2, nécessaires dans l'étape suivante.

Cette étape est propre à chaque fournisseur d'identité.

Exemple avec [https://learn.microsoft.com/fr-fr/azure/active-directory/develop/quickstart-register-app Azure AD]

===Paramétrage du fournisseur de service===

Pour l'exemple on utilise Azure AD, les informations sont équivalentes pour les autres fournisseurs d'identité.

* Créer un fournisseur de service authentifié de type oAuth2.
* Renseigner le client ID avec la valeur obtenue dans ID d'application
* Renseigner le champs endoint avec la valeur obtenue dans "Point de terminaison d'autorisation Oauth2.0 (v2)"
* Renseigner le champs AccessTokenUrl avec la valeur obtenue dans "Point de terminaison de jeton Oauth2.0 (v2)"
* Renseigner le champs Scope avec la valeur "https://outlook.office.com/SMTP.Send offline_access"

[[image:smtp_oauth2_3.JPG]]
[[image:smtp_oauth2_2.JPG]]

===Paramétrage de la messagerie système===

* Choisir le type d'authentification oAuth2
* Renseigner l'identifiant utilisé pour se connecter au fournisseurs d'identité.(une adresse mail)
* Sélectionner le fournisseur de service précédemment créé.
* Cliquer sur le bouton connecter, le jeton de l'utilisateur identifié sera alors utilisé pour tous les envois de mails systèmes.

[[image:smtp_oauth2_1.JPG]]

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:OAuth2]]

SMTP oAuth2

2023-02-16T14:58:04Z

Flfay :

Il est possible d'authentifier la messagerie système grâce à oAuth2.

==Mise en œuvre==

===Inscription de l'application dans l'annuaire ===

Sage1000 doit être inscrit en tant qu'application dans le fournisseur d'identité.

Cette inscription permet l'obtention un identifiant (Client ID) et des url oAuth2, nécessaires dans l'étape suivante.

Cette étape est propre à chaque fournisseur d'identité.

Exemple avec [https://learn.microsoft.com/fr-fr/azure/active-directory/develop/quickstart-register-app Azure AD]

===Paramétrage du fournisseur de service===

Pour l'exemple on utilise Azure AD, les informations sont équivalentes pour les autres fournisseurs d'identité.

* Créer un fournisseur de service authentifié de type oAuth2.
* Renseigner le client ID avec la valeur obtenue dans ID d'application
* Renseigner le champs endoint avec la valeur obtenue dans "Point de terminaison d'autorisation Oauth2.0 (v2)"
* Renseigner le champs AccessTokenUrl avec la valeur obtenue dans "Point de terminaison de jeton Oauth2.0 (v2)"
* Renseigner le champs Scope avec la valeur "https://outlook.office.com/SMTP.Send offline_access"

[[image:smtp_oauth2_3.JPG|thumb]]
[[image:smtp_oauth2_2.JPG|thumb]]

===Paramétrage de la messagerie système===

* Choisir le type d'authentification oAuth2
* Renseigner l'identifiant utilisé pour se connecter au fournisseurs d'identité.(une adresse mail)
* Sélectionner le fournisseur de service précédemment créé.
* Cliquer sur le bouton connecter, le jeton de l'utilisateur identifié sera alors utilisé pour tous les envois de mails systèmes.

[[image:smtp_oauth2_1.JPG|thumb]]

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:OAuth2]]

SMTP oAuth2

2023-02-16T14:56:59Z

Flfay :

Fichier:Smtp oauth2 3.JPG

2023-02-16T14:55:10Z

Flfay :

Fichier:Smtp oauth2 2.JPG

2023-02-16T14:54:56Z

Flfay :

Fichier:Smtp oauth2 1.JPG

2023-02-16T14:54:34Z

Flfay :

SMTP oAuth2

2023-02-16T14:54:00Z

Flfay : a

Il est possible d'authentifier la messagerie système grâce à oAuth2.

==Mise en œuvre==

===Inscription de l'application dans l'annuaire ===

Sage1000 doit être inscrit en tant qu'application dans le fournisseur d'identité.

Cette inscription permet l'obtention un identifiant (Client ID) et des url oAuth2, nécessaires dans l'étape suivante.

Cette étape est propre à chaque fournisseur d'identité.

Exemple avec [https://learn.microsoft.com/fr-fr/azure/active-directory/develop/quickstart-register-app Azure AD]

===Paramétrage du fournisseur de service===

Pour l'exemple on utilise Azure AD, les informations sont équivalentes pour les autres fournisseurs d'identité.

* Créer un fournisseur de service authentifié de type oAuth2.
* Renseigner le client ID avec la valeur obtenue dans ID d'application
* Renseigner le champs endoint avec la valeur obtenue dans "Point de terminaison d'autorisation Oauth2.0 (v2)"
* Renseigner le champs AccessTokenUrl avec la valeur obtenue dans "Point de terminaison de jeton Oauth2.0 (v2)"
* Renseigner le champs Scope avec la valeur "https://outlook.office.com/SMTP.Send offline_access"

===Paramétrage de la messagerie système===

* Choisir le type d'authentification oAuth2
* Renseigner l'identifiant utilisé pour se connecter au fournisseurs d'identité.(une adresse mail)
* Sélectionner le fournisseur de service précédemment créé.
* Cliquer sur le bouton connecter, le jeton de l'utilisateur identifié sera alors utilisé pour tous les envois de mails systèmes.

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:OAuth2]]

Fichier de configuration (server)

2023-01-10T13:47:02Z

Flfay : /* Service */

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes ne pas proposer, séparées par des points virgules (9.20)

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Nom réseau du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvSSLv2, sslvSSLv23, sslvSSLv3, sslvTLSv1, sslvTLSv1_1, sslvTLSv1_2 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en tant réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Fichier de configuration (server)

2023-01-10T13:46:43Z

Flfay : /* Service */

===Introduction===
Le Serveur d'application Sage 1000 utilise un fichier de configuration situé dans le répertoire du serveur.

{{info|Le nom du fichier est serverl1000.ini}}

Ce fichier peut être soit modifié à l'aide de la console d'administration des services, soit manuellement par un éditeur de texte.

{{tip|Le fichier est chargé au démarrage du service.}}

===Structure===
Le fichier peut configurer plusieurs services exécutés sur le même serveur, chaque service comporte au moins deux sections :

* [\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SERVICE_NAME]
: Cette entrée détermine la configuration réseau du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE]
: Cette entrée détermine la configuration logicielle du service.

* [\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SERVICE\Export]
: Cette entrée configure la fonction d'exportation du service.

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\MYSERVICE]
ipcMode=ipcSHM
tcpPort=8090
shmAddress=SYFRE

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\MYSERVICE]
Master base=orasql://myhost/DBMASTER_ORA?prefix="DBMASTERT_ORA."
Master driver=orasql
Master OS Authentication=0
Master user=DBMASTER_ORA
Master password=DBMASTER_ORA
Server Societies=Société de démonstration GCF 1000
Server Application=Sage 1000 Suite Financière
...
</pre>

Chaque section est composée d'une liste de variables (NomVariable=ValeurVariable), les types de données des variables sont :

{|class="wikitable"
|-
!Variable
!Type
|-
|String
|Chaîne de caractère
|-
|Boolean
|Valeur logique 0:Non 1:Oui
|-
|Integer
|Valeur entière
|-
|Liste de chaîne
|Liste de chaîne de caractère séparée par des virgules.
|}

===Section IPC===

{|class="wikitable"
|-
!Variable
!Type
!Contexte
!Usage
|-
|ipcMode
|enumération
|Client/Serveur
|
*ipcTCP
:Mode de communication par TCP/IP
*ipcSHM
:Mode de communication par mémoire partagée (dépréciée)
|-
|tcpPort
|Integer
|Client/Serveur
|Port de communication TCP
|-
|tcpAddress
|string
|Client/Serveur
|Adresse de communication TCP
|-
|shmAddress
|string
|Client/Serveur
|Nom du segment de mémoire partagé
|-
|serverList
|Serveur
|String list
|Configuration de Cluster 
Liste des services associés à cet identifiant de service.
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\TRESO]
ipcMode=ipcTCP
tcpPort=8090
tcpAddress=localhost
</pre>

Exemple de configuration Cluster :

'''fichier du configuration des services :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

'''fichier du configuration du client HTTP :'''

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE]
serverList=SYFRE1,SYFRE2

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE1]
ipcMode=ipcTCP
tcpPort=8091
tcpAddress=syfre

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\SYFRE2]
ipcMode=ipcTCP
tcpPort=8092
tcpAddress=syfre
</pre>

===Section Servers===
====IPC====
Ces variables configurent la gestion des services IPC.

La configuration des services IPC peut être renseignée dans une section IPC

[\SOFTWARE\Sage\Ligne 1000\Administration\IPC\nom_de_profil]

puis référencée par la variable "IPC Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|IPC Profil
|String
|Référence un nom de section IPC contenant la configuration
|-
|IPC Started
|boolean
|Démarre les services IPC (défaut true)
|}

Les services IPC sont les services permettant de communiquer via RPC.

Vous avez besoins des services IPC si :
* Vous utilisez un serveur HTTP externe (IIS ou Apache).
* Vous utilisez la Console des Processus Métiers pour dialoguer avec ce Service.
* Vous utilisez le Contrôleur des services.
* Ce Service exécute des tâches de traitement déléguées par un autre Service.

Si vous n'utilisez pas les services IPC il est conseillé de ne pas les démarrer.

{{tip|Ce paramètre n'est pas modifiable depuis la console des services car si vous désactivez les services IPC le contrôleur n'est plus opérationnel}}

====Sessions====
Ces variables configurent la gestion des sessions.

La configuration des sessions peut être renseignée dans une section SESSIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\SESSIONS\nom_de_profil]

puis référencée par la variable "SESSIONS Profil"

{|class="wikitable"
|-
!Variable
!Type
!Défaut
!Min
!Usage
|-
|SESSIONS Profil
|String
|
|
|Référence un nom de section SESSIONS contenant la configuration
|-
|CheckInterval
|Entier
|1 minute
|1 minute
|Délai entre chaque test d'expiration en seconde.
|-
|ExpireInterval
|Entier
|15 minutes
|
|Délai d'expiration des sessions en seconde.
|}

====Base master====
Ces variables configurent la base Master utilisée par le service.

La configuration de la base master peut être renseignée dans une section MASTER

[\SOFTWARE\Sage\Ligne 1000\Administration\MASTER\nom_de_profil]

puis référencée par la variable "Master Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Master Profil
|String
|Référence un nom de section MASTER contenant la configuration
|-
|Master base
|String
|Nom de la base de données Master
|-
|Master driver
|String
|Nom du driver de la base de données Master
|-
|Master OS Authentication
|Boolean
|Utiliser l'authentification du système d'exploitation.
|-
|Master user
|String
|Nom d'utilisateur utilisé pour la connexion à la base Master
|-
|Master password
|String
|Mot de passe utilisé pour la connexion à la base Master
|}

====Application et Sociétés====
Ces variables configurent l'application et les sociétés servies par le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Societies
|String
|
|Liste des sociétés/dossiers servies par le service.
|-
|Server Application
|String
|
|Nom de l'application servie par le service.
|-
|Server User
|String
|
|Nom de l'utilisateur du service.
|-
|Server Password
|String
|
|Mot de passe de l'utilisateur du service.
|-
|Server User Group
|String
|
|Nom du groupe de l'utilisateur du service.
|-
|Server Authentication
|String
|
|Annuaire utilisé pour l'authentification.
|-
|Authentication Directories
|liste de chaîne
|8.00
|Annuaires disponibles pour ce service.(code des annuaires séparés par ";")
|}

====Service====
Ces variables configurent le service.

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Server Name
|String
|
|Nom du service.
|-
|Cache Folder
|String
|
|Répertoire où stocker les fichiers temporaires et les fichiers en cache.
|-
|[[Zone publique (server)|Public Folder]]
|String
|
|[[Zone_publique_(server)|Racine des répertoires partagés du service]].
|-
|[[Public links (server)|Public Links]]
|Liste de chaîne
|
|Liste de répertoires réseaux (séparés par un ;) pour lesquels des [[Stockage_des_documents|documents peuvent être associés]].
|-
|Send Alert To
|String
|
|Liste d'adresses emails (séparées par un ;) auxquelles seront envoyés les messages d'alertes.
|-
|Scripts
|Liste de chaîne
|
|Liste de références CSS ajouté aux pages HTML
|-
|MaxDatagridRowCount
|Integer
|
|Limite le nombre de lignes affichées dans les grilles (par défaut à 5000).
|-
|[[Security mode (server)|Security Mode]]
|String
|7.00
|Valeurs possibles : Intranet (valeur par défaut) / Internet [[Service_exposé_sur_internet|Voir Service exposé sur internet]]
|-
|Enable Remember User
|boolean
|7.10
|Permet à l'utilisateur d'avoir son nom pré-renseigné dans la page d'authentification (par défaut à vrai)
|-
|MaxPreviewPageCount
|Integer
|
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview max page
|Integer
|10.00
|Limite le nombre de pages affichées dans les aperçus des éditions (par défaut à 50).
|-
|Preview blocking
|Boolean
|10.00
|1:Les aperçus sont affichés directement en onglet 0:les aperçus sont envoyés dans la bam.
|-
|Preview timeout
|Integer
|10.00
|Délai d'attente de fin d'aperçu si Preview blocking=1.
|-
|Printer Filter
|chaine
|
|Noms des imprimantes ne pas proposer, séparées par des points virgules

|}

====Automates====
Ces variables configurent le serveur d'automate inclus dans le serveur.

Ces variables peuvent être renseignées dans une section AUTOMATE

[\SOFTWARE\Sage\Ligne 1000\Administration\AUTOMATE\nom_de_profil]

puis référencées par la variable "Automate Profil"

{|class="wikitable"
|-
!Variable
!Type
!Version
!Usage
|-
|Automate Profil
|String
|
|Référence une section AUTOMATE.
|-
|Automate Started 
Process Server Started
|Boolean
|
|Démarre le serveur d'automate. (défaut) (*) 
|-
|Automate Name 
Process Server Name
|String
|
|Nom du serveur d'automate à démarrer. (*)
|-
|Automate Message Box 
Process Server Message Box
|String
|
|Boite à messages utilisé par le serveur d'automate.
|-
|Automate Task Service 
Process Task Service
|String
|
|Nom du Service 1000 exécutant les tâches du serveur d'automate.(hostname.servicename)
|-
|Automate Task Count 
|Integer
|6.50
|Nombre maximal de tâches automates simultanées (défaut 1).
|-
|Automate Debug 
|Boolean
|7.00 Patch
|Active le mode debug verbose (**).
|}

{{Version700}} (*) Ces valeurs peuvent être modifiées sur la ligne de commande

{{Version700}} (**) A utiliser conjointement avec la console de trap snmp

====Processus métiers====
Ces variables configurent le service de Processus Métiers inclus dans le serveur.

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|BP Started
|Boolean
|Démarre le service de Processus Métiers (défault).
|}

{{Version700}} Cette valeur peut être modifiée sur la ligne de commande

====Système====
Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PROCESS

[\SOFTWARE\Sage\Ligne 1000\Administration\PROCESS\nom_de_profil]

puis référencée par la variable "Process Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Process Profil
|string
|Référence une section PROCESS
|-
|ProcessAffinity
|String
|Détermine les coeurs utilisés par le processus sur une machine multi-coeurs 
ex : 1,3 pour utiliser les coeurs 1 et 3 d'une machine multi-coeurs.
|-
|ThreadPoolSize
|Integer
|Taille du pool de thread (20)
|-
|FormCacheSize
|Integer
|Taille du cache pour un écran (défaut:20, 0:désactive l'utilisation du cache)
|-
|FormCacheLimit
|Integer
|Taille du cache pour l'ensemble des écrans (256)
|-
|FormCacheReuse
|Integer
|Nombre de fois qu'un écran peut être réutilisé (-1 : pas de limite)
|}

*ProcessAffinity
:Le Processus du serveur est un processus multi-threadé, sur une machine multi-coeurs il utilise tous les coeurs disponibles sur le système d'exploitation. Dans certain cas il est souhaitable de restreindre l'exécution à certains coeurs.

*ThreadPoolsize
:Chaque requête sur le service est exécutée par une thread allouée d'un pool ; lorsque le pool est plein la requête est suspendue jusqu'à ce qu'une thread se libère dans le pool. Cette variable limite la taille du pool de thread et par conséquence limite les contentions et les "context switches" provoqués par le processus.

*FormCacheSize
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre d'instance d'un écran dans le cache.

*FormCacheLimit
:L'opération d'ouverture d'un écran est une opération coûteuse, pour cette raison les écrans fermés sont placés dans un cache pour être réutilisés. Cette variable limite le nombre maximal d'écran dans le cache et par conséquent la mémoire utilisée par le cache d'écran.

*FormCacheReuse
:Indique le nombre de fois qu'un écran en cache peut être réutilisé.

{{info|Pour pouvoir utiliser WMI la dll serviceL1000perf.dll doit être présente dans le répertoire du serveur.}}
{{info|Pour désactiver le cache, définir la valeur de FormCacheSize à 0}

====Files d'attente====
Ces variables configurent le service de consommation de file d'attente.

Ces variables peuvent être renseignées dans une section PERF.

[\SOFTWARE\Sage\Ligne 1000\Administration\QUEUELISTENER\nom_de_profil]

puis référencée par la variable "Queue listener Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Queue listener Started
|Boolean
|Démarre le service de consommation de file d'attente.
|-
|Queue listener queues
|Liste de chaînes séparées par des ,
|Liste des files d'attente à consommer.
|-
|Queue listener Task count
|Entier
|Nombre maximal de tâches simultanées par service.
|}

Les paramètres de scrutation d'une file d'attente peuvent être configurés à la suite du nom de la file d'attente en séparant les paramètres par un caractère ":"

{|class="wikitable"
|-
!Paramètre
!Valeur par défaut (ms)
!Usage
|-
|Initial
|1000
|Délai initial de scrutation (ms)
|-
|Max
|10000
|Délai maximal de scrutation (ms)
|-
|Increment
|1000
|Incrément du délai jusqu'au délai maximal si aucun message n'est disponible (ms)
|}

Exemple :
<pre>
Queue listener queues=MyQueue1:2000:10:20000,MyQueue2,MyQueue3:100:10:1000
</pre>

Avec les valeurs par défaut, une file d'attente est lue initialement toutes les secondes, puis si aucun message n'est reçu, ce délai monte jusqu'à 10 secondes. Lorsque un message est reçu le délai est réinitialisé à 1 seconde et ainsi de suite.

====Compteurs de performance====

Ces variables configurent le Processus du serveur.

Ces variables peuvent être renseignées dans une section PERF

[\SOFTWARE\Sage\Ligne 1000\Administration\PERF\nom_de_profil]

puis référencée par la variable "Performance Counters Profil"

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|Start Performance Counters
|Boolean
|Démarre les compteurs de performance
|-
|Start Performance Clock
|Boolean
|Démarre l'horloge de performance
|-
|Performance Clock Delay
|Cardinal
|Période de l'horloge de performance (ms)
|-
|HTTP PerfServer Start
|Boolean
|Démarre le serveur HTTP de performance
|-
|HTTP PerfServer Port
|Integer
|Port du serveur HTTP de performance
|-
|HTTP PerfServer Protocol
|String
|Protocole du serveur HTTP de performance
|}

*Start Performance Counters
:Le serveur inclus un certain nombre de [[Compteurs de performance (monitoring)|compteurs de performance]] interrogeables par le [[Serveur de performance (monitoring)|serveur de performance]].

*Start Performance Clock
: Démarre une horloge permettant de générer un évènement de monitoring.

*Performance Clock Delay
: Période de l'horloge de performance. (défaut 1000)

*HTTP PerfServer Start
: Démarre le server HTTP de performance.

*HTTP PerfServer Port
: Port du serveur HTTP de performance. (défaut 9999)

*HTTP PerfServer Protocol
:Protocole du serveur HTTP de performance (défaut http)

Voir la catégorie [[:Category:Monitoring]]

====HTTP====
Ces variables peuvent être renseignées dans une section HTTP

[\SOFTWARE\Sage\Ligne 1000\Administration\HTTP\nom_de_profil]

puis référencée par la variable "HTTP Profil"

Les variables suivantes configurent le protocole HTTP utilisé par le service, elles sont utilisées pour construire des URL pointant sur le service.

{|class="wikitable"
|-
!Nom de variable
!Type
!Version
!Par défaut
!Usage
|-
|HTTP Protocol
|String
|Toute
|http:
|Protocole HTTP publique du Service (http: ou https:)
|-
|HTTP Port
|Integer
|Toute
|80
|Port HTTP publique du Service
|-
|HTTP HostName
|String
|Toute
|Nom local de la machine
|Nom réseau du serveur HTTP frontal
|-
|HTTP ServiceName
|String
|6.51
|Nom du service
|
Nom du service load-balancé utilisé par le service 
Ce nom peut différer du nom du service dans une configuration load balancée. 
C'est ce nom qui est enregistrée dans les URLs de la registry SDATA 
Implémenté pour SOAP à partir de la version 7 
|}

Les variables suivantes configurent [[Serveur HTTP (server)|le service HTTP interne]] inclus dans le serveur.

{{Version700}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP Started
|boolean
|Démarre le serveur HTTP
|-
|HTTP Listen Protocol
|String
|Protocole HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le protocole est défini par HTTP Protocol
|-
|HTTP Listen Port
|Integer
|Port HTTP écouté par le serveur HTTP embarqué 
Si cette variable n'est pas défini le port est défini par HTTP Port
|-
|HTTP Site
|String
|Répertoire du site utilisé par le serveur HTTP
|-
|HTTP Alias
|String
|Nom de section des alias de répertoire du serveur HTTP
|-
|HTTP CertFile
|String
|Si le protocole est https, représente le fichier certificat (.pem)
|-
|HTTP RootCertFile
|String
|Si le protocole est https, représente le fichier certificat de l'autorité intermédiaire qui a signé le certificat "CertFile" (.pem). 
Ce paramètre est optionnel, il est utile si l'autorité intermédiaire n'est pas directement reconnue par le navigateur.
|-
|HTTP KeyFile
|String
|Si le protocole est https, représente le fichier clef privée (.pem ou .key) qui est liée au certificat
|-
|HTTP KeyPassword
|String
|Si le protocole est https, représente le mot de passe qui permet de décoder la clef privée
|-
|HTTP CertIssuer
|String
|Si le protocole est https, représente l'émetteur du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP CertSerial
|String
|Si le protocole est https, représente le numéro de série du certificat du site permettant de l'identifier dans le magasin Windows
|-
|HTTP SSLVersion
|String
|Version du protocole SSL à utiliser: sslvSSLv2, sslvSSLv23, sslvSSLv3, sslvTLSv1, sslvTLSv1_1, sslvTLSv1_2 (par défaut :sslvTLSv1_2)
|-
|HTTP SSLCipherList
|String
|Sceaux proposés par le serveur (par défaut "HIGH:!aNULL:!MD5:!RC4") [https://www.openssl.org/docs/manmaster/apps/ciphers.html en savoir plus] Version 7.10
|-
|HTTP KeepAlive
|Boolean
|Détermine la valeur du paramètre KeepAlive des réponses du serveur HTTP. 
La valeur est True (1) par défaut et le serveur renvoi KeepAlive dans ses réponses. 
Cette valeur doit être false (0) pour une configuration load balancée.
|-
|HTTP Private Started
|Boolean
|Permet de démarrer un service http "privé", utile dans le cadre d'une configuration load balancée. 
Ce service n'est adressé que par les autres services, et permet d'économiser la partie SSL des échanges. 
Le port de ce service ne doit pas être exposé au clients web.
|-
|HTTP Private Port
|Integer
|Détermine la valeur du port http privé.
|-
|HTTP Log
|Booléen
|Active la journalisation des flux http (Version 10)
|}

{{tip|Le protocole/port publique peuvent être différent du protocole/port d'écoute si un load balancer est utilisé.}}

Voir aussi :
* [[Serveur HTTP (server)|Serveur HTTP interne]]
* [[Configuration_du_Serveur_HTTPS|Configuration du serveur en HTTPs]]
* [[Configuration_du_Serveur_HTTP_derrière_un_répartiteur_de_charge|Configuration derrière un répartiteur de charge]]

Certains de ces paramètres peuvent être remplacés par [[Service_1000_(server)|les paramètres de la ligne de commande]] :

{|class="wikitable"
|-
!Paramètre
!Paramètre de la ligne de commande
|-
|HTTP Listen Port
|HTTPPORT
|-
|HTTP KeepAlive
|HTTPKEEPALIVE
|}

====HTTP ACLs====
{{version710}}

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP ACL
|string
|Liste de règles séparées par une virgule, par ordre de priorité
|}

La syntaxe d'une règle ACL :
<pre>
action-IP/Nob
</pre>

*action
: Type de règle, doit être accept ou deny
*IP
: Addresse IP en notation pointé
*Nob (facultatif)
:Nombre de bits du masque de sous réseau, par exemple 29 correspond au masque 255.255.255.248 et défini un sous réseau de 8 adresses.

[http://jodies.de/ipcalc Calculateur de masque]

Exemple 1 :

Autorise les adresses 192.168.1.0 ... 192.168.1.7 à l’exception de 192.168.1.5

<pre>
deny-192.168.1.5
accept-192.168.1.0/29
</pre>

Exemple 2 :

Autorise seulement l'adresse 192.168.1.1

<pre>
accept-192.168.1.1
deny-0.0.0.0/0
</pre>

====HTTP Web Worker====
{{version800}}

Le Web Worker est un mécanisme de notification asynchrone permettant au client Web d'être notifié des événements survenant coté serveur.

Il permet de gérer les notifications de boîte à message ainsi que les notifications de traitement.

L'utilisation du web worker améliore l'expérience utilisateur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web worker started
|Integer
|Active (1) ou désactive (0) l'utilisation du web worker
|}

{{Tip|Lorsque le web worker est activé, le client génère des requêtes msg.pending périodiques.}}

====HTTP Web Socket====
{{version800}}

Les WebSockets utilisent un protocole permettant de créé des canaux de communication full-duplex à l'intérieur d'une connexion TCP.

L'utilisation des WebSockets améliore l'expérience utilisateur par une meilleur fluidité des échanges.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Web socket started
|Integer
|Active (1) ou désactive (0) l'utilisation de WebSocket
|}

{{Tip|

#Les WebSocket ne sont prises en charge que par le serveur HTTP embarqué et en mode '''HTTPs uniquement'''.
#Les WebSockets sont activées par défaut.
#Les WebSocket peuvent ne pas fonctionner ou provoquer des problèmes dans le cas d'utilisation du serveur Sage 1000 derrière un load balancer qui ne supporterait pas le protocole WebSocket.
#L'url utilisée doit correspondre au domaine du certificat SSL. Par exemple, en entreprise, si votre serveur est myhost sur le domaine interne xxx.yyy.zzz le nom de domaine du certificat auto-généré sera myhost.xxx.yyy.zzz. Vous devez utiliser https://myhost.xxx.yyy.zzz comme url d'accès même si https://myhost est valide sur votre réseau. A défaut l'établissement des connexions websockets échoueront.}}

{{Tip|Lorsque les websockets sont actives, le dialogue d'attente n'est pas affiché.}}

====HTTP CSP====
La [https://developer.mozilla.org/fr/docs/Web/HTTP/CSP stratégie de sécurité du contenu] permet d'améliorer la sécurité des sites web.

{{version1000}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CSP
|Liste de chaines
|Liste des règles séparées par ";"
|}

Exemple

HTTP CSP = default-src 'self'; script-src https://example.com

La valeur par défaut est ''default-src 'self'''

====HTTP CORS====
Le [https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS CORS] permet d'autoriser des requêtes provenant d'autre domaine.

{{version800}}
{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|HTTP CORS Allow origin
|Liste de chaines
|Liste des domaines autorisés
|}

La liste des domaines doit être séparée par des virgules, utilisez * pour autoriser tous les domaines.

Les domaines doivent être qualifié par le protocole, par exemple http://origin.com

Les domaines indiqués ici seront comparés à la valeur du champ d'entête Origin

Lorsque le domain est autorisé, le service retourne dans la réponse :

{| class="wikitable"
|-
!Champ
!Valeur
|-
|Access-Control-Allow-Origin
|Valeur du chanmp Origin de la requête
|-
|Vary
|Origin
|-
|Access-Control-Allow-Credentials
|true
|-
|Access-Control-Allow-Methods
|POST,PUT,DELETE,GET,OPTION
|-
|Access-Control-Allow-Headers
|Valeur de Access-Control-Request-Headers de la requête
|-
|Access-Control-Max-Age
|86400
|}

====FTPs====
Ces variables configurent le serveur FTPs inclu dans le servcice.
Le serveur FTP peut être utilisé sur les containeurs.

[\SOFTWARE\Sage\Ligne 1000\Administration\FTP\nom_de_profil]

puis référencée par la variable "FTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP Profil
|string
|Référence une section FTP
|-
|FTP Start
|1 ou 0
|Démarre le service FTP
|-
|FTP ACL
|Chaîne
|Définit une liste d'ACL optionnelle
|}

====WEB====
Ces variables configurent le service WEB inclu dans le service.

Ces variables peuvent être renseignées dans une section WEB

[\SOFTWARE\Sage\Ligne 1000\Administration\WEB\nom_de_profil]

puis référencée par la variable "WEB Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|WEB Profil
|string
|Référence une section WEB
|-
|MaxDatagridRowCount
|Entier
|Détermine le nombre maximal de lignes chargées dans une grille (défaut 5000)
|-
|GridWindowSize
|Entier
|Détermine le nombre maximal de lignes affichées dans une page de grille. (Défaut 25)
|-
|MDIForms
|1 ou 0
|Défaut 0
|-
|MDIAssistants
|1 ou 0
|Défaut 1
|-
|UseTreeBookClassic
|1 ou 0
|Défaut 0
|-
|SavePortalTabForms
|1 ou 0
|Défaut 1
|-
|DebugJS
|1 ou 0
|Utilise les javascript en mode debug (Défaut 0)
|-
|RecordMode
|1 ou 0
|Active le mode enregistrement pour JMeter (Défaut 0)
|-
|FormRedirect
|1 ou 0
|Active la redirection des urls d'écran, pour IIS cette redirection doit être désactivée. (défaut 1, ativé)
|}

====Mise au point, debugger {{Version700}}====
Ces variables configurent le remote debugger inclus dans le service.

Le remote debugger permet à un poste client desktop de visualiser, modifier et poser des points d'arrêt dans le code métier exécuté par le service.

Ces variables peuvent être renseignées dans une section DEBUGGER

[\SOFTWARE\Sage\Ligne 1000\Administration\DEBUGGER\nom_de_profil]

puis référencée par la variable "DEBUGGER Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|DEBUGGER Profil
|string
|Référence une section DEBUGGER
|-
|DEBUGGER Started
|Boolean
|Démarre le service de Remote debugging
|-
|DEBUGGER Users
|Strings
|Liste des utilisateurs autorisés à utiliser le service de remote debugging
|-
|DEBUGGER Handlers
|Strings
|Liste des handlers des évènements de trace qui seront interceptés et redirigés vers le journal d'évènement, ceci vous permet de visualiser en tant réel ces traces dans la console SNMP. Les handlers possibles sont:
* script
: Evènements générés par la fonction dbgMsg() du code métier
* queries
: Evènements de trace des requêtes SQL
|}

{{warning|L'utilisation de DEBUGGER Handlers peut provoquer une forte consommation de mémoire}}
{{warning|Ces fonctionnalités ne doivent pas être activés sur un serveur de production}}

====LDAP====
Ces variables configurent le serveur LDAP inclus dans le service.

Ces variables peuvent être renseignées dans une section LDAP

[\SOFTWARE\Sage\Ligne 1000\Administration\LDAP\nom_de_profil]

puis référencée par la variable "LDAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|LDAP Profil
|string
|Référence une section LDAP
|-
|LDAP Started
|Boolean
|Démarre le service LDAP (défaut false).
|-
|LDAP Port
|Integer
|Port d'écoute du service LDAP
|-
|LDAP Password
|String
|Mot de passe administrateur du compte system du serveur LDAP ('uid=admin,ou=system')
|}

====SOAP====
Ces variables configurent le service SOAP inclus dans le serveur.

Ces variables peuvent être renseignées dans une section SOAP

[\SOFTWARE\Sage\Ligne 1000\Administration\SOAP\nom_de_profil]

puis référencées par la variable "SOAP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SOAP Profil
|string
|Référence une section SOAP
|-
|SOAP Log Documents
|Boolean
|Active la journalisation des documents SOAP
|-
|SOAP Log Messages
|Boolean
|Active la journalisation des messages SOAP
|-
|SOAP 5.5x
|Boolean
|Utilise l'implémentation SOAP des versions 5.5x
|}

*SOAP 5.5x
:L'implémentation de SOAP a été récrite en version 5.6x, en cas de problème de compatibilité avec des développements existant il est possible d'utiliser l'ancienne implémentation.

====SMTP====
Ces variables configurent le client SMTP utilisé par le service pour envoyer des EMails.

Ces variables peuvent être renseignées dans une section SMTP

[\SOFTWARE\Sage\Ligne 1000\Administration\SMTP\nom_de_profil]

puis référencés par la variable "SMTP Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SMTP Profil
|string
|Référence une section SMTP
|-
|SMTP Host
|String
|Adresse du serveur SMTP.
|-
|SMTP Port
|Integer
|Port du serveur SMTP.
|-
|SMTP Login
|String
|Utilisateur de connexion du serveur SMTP.
|-
|SMTP Password
|String
|Mot de passe de connexion du serveur SMTP.
|-
|SMTP From
|String
|Adresse EMail de l'expéditeur.
|-
|SMTP UseTLS
|Boolean
|Utilise une sécurisation TLS
|}

====SNMP====
Ces variables peuvent être renseignées dans une section SNMP

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\nom_de_profil]

puis référencés par la variable "SNMP Profil"

Ces variables configurent l'agent SNMP inclus dans le serveur.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Profil
|string
|Référence une section SNMP
|-
|SNMP Started
|Boolean
|Démarre l'agent SNMP
|-
|SNMP Port
|Integer
|Port UDP de l'agent SNMP (161)
|-
|SNMP sysName
|String
|Valeur de la variable sysName pour la MIB2
|-
|SNMP sysContact
|String
|Valeur de la variable sysContact pour la MIB2
|-
|SNMP sysLocation
|String
|Valeur de la variable sysLocation pour la MIB2
|-
|SNMP Traps
|liste de chaîne
|Référence des sections SNMPTRAP
|}

Les sections SNMPTRAP permettent de définir des points d'écoute SNMP auquels seront envoyés les messages de traps.

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\nom_de_profil]

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|SNMP Trap Host
|string
|Nom réseau du point d'écoute
|-
|SNMP Trap Port
|Integer
|Numéro du port du point d'écoute
|-
|SNMP Trap Categories
|Liste de chaîne
|Catégories des traps à envoyer à ce point d'écoute 
|}

La liste des catégories de trap est la suivante :

{|class="wikitable"
|-
!Nom de catégorie
!Type de message
|-
|Service
|Messages relatifs au processus du service.
|-
|Automate
|Messages relatifs aux exécutions de l'automate.
|-
|BP
|Messages relatifs aux exécutions des Processus métiers.
|-
|Authenticate
|Messages relatifs aux erreurs d'authentification.
|}

Exemple de configuration SNMP :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\SNMP\CONFIG_SNMP_1]
SNMP Started=1
SNMP Start=1
SNMP Port=161
SNMP sysContact = toto@sage.com
SNMP sysName = toto
SNMP sysLocation = Paris,France
SNMP Traps=Service,Automate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Service]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Service,Authenticate

[\SOFTWARE\Sage\Ligne 1000\Administration\SNMPTRAP\Automate]
SNMP Trap Host=localhost
SNMP Trap Port=162
SNMP Trap Categories=Automate,BP
</pre>

====PROXY====

{{tip|Déprécié, utiliser le paramétrage dans la console d'administration.}}

Ces variables configurent le PROXY utilisé par le client HTTP.

Ces variables peuvent être renseignées dans une section PROXY

[\SOFTWARE\Sage\Ligne 1000\Administration\PROXY\nom_de_profil]

puis référencée par la variable "PROXY Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|PROXY Profil
|string
|Référence une section PROXY
|-
|PROXY Host
|String
|Adresse du serveur PROXY.
|-
|PROXY Port
|Integer
|Port du serveur PROXY (défaut 8080).
|-
|PROXY Login
|String
|Utilisateur de connexion du serveur PROXY.
|-
|PROXY Password
|String
|Mot de passe de connexion du serveur PROXY.
|-
|PROXY Timeout
|Integer
|Délai d'expiration du PROXY. (défaut 60 secondes)
|}

====Exceptions====
Ces variables configurent l'enregistrement des exceptions du service.

Ces variables peuvent être renseignées dans une section EXCEPTIONS

[\SOFTWARE\Sage\Ligne 1000\Administration\EXCEPTIONS\nom_de_profil]

puis référencées par la variable "Exceptions logs Profil"

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Exceptions logs Profil
|string
|Référence une section EXCEPTIONS
|-
|Exceptions logs Started
|boolean
|Enregistrer les exceptions. Vrai par défaut.
|-
|Exceptions logs path
|String
|Répertoire dans lequel seront créés les fichiers d'exception.
|-
|Exceptions logs ignore
|Liste de chaîne
|Liste d'exception à ignorer.
|-
|Exceptions logs write file
|booléen
|Un fichier d'exception est écrit. Vrai par défaut. Il peut être inutile d'écrire un fichier d'exception si les exceptions sont transmises à un gestionnaire de log (voir LOG MANAGER) et permet dans ce cas ne ne pas encombrer le disque.(V8)
|}

====Captcha====

Dans le cadre d'un service public, les utilisateurs souhaitant s'enregistrer peuvent être soumis à un captcha.

Si l'utilisateur commet trois erreurs lors de l'authentification, il devra saisir un captcha.

voir http://www.google.com/recaptcha

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Recaptcha Public Key
|string
|Clef publique Recaptcha
|-
|Recaptcha Private Key
|String
|Clef privée Recaptcha
|}

====Quotas====

Dans le cadre d'un service public, les utilisateurs téléversent des fichiers dans un répertoire propres à la session.

Ces fichiers doivent avoir une extension prévue pour des questions de sécurité.

La taille totale du répertoire est définie pour éviter un manque de place sur le disque.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Upload Document Size
|integer
|Taille maximale en Mb d'un fichier uploadé; valeur par défaut : 0 (non limité)
|-
|Upload User Quota
|integer
|Taille maximale en Mb du répertoire upload de l'utilisateur par session; valeur par défaut : 50
|-
|Upload Ext Allowed
|String
|Extensions autorisées; valeur par défaut : vide (tout est autorisé)
|-
|Auto delete messages
|Entier
|Durée de conservation en jours des messages
|}

====Clefs====

Le stockage de certaines clefs peut être externalié

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Key Cookie
|chaine
|[[keyvault_url|url d'un stockage sécurisé externe]], si la clef est non trouvée, elle y sera créée
|}

===Sections SDATA===
Ces sections permettent de configurer les points d'accès SDATA qui seront exposés par le service.

Les noms de ces sections sont

[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\<<nom du service>>\SData\<<incrément 1...>>]

{|class="wikitable"
|-
!Variable
!Type
!Usage
|-
|DataSetName
|string
|Nom du dataset dans l'URL SDATA
|-
|Title
|string
|Libellé informatif sur l'usage du point d'accès
|-
|Contract
|string
|Nom du paquet de service SDATA
|-
|Version
|string
|Numéro de version, peut être utilisé pour supporté plusieurs version du même contrat
|-
|Folder
|string
|Nom du dossier utilisé par ce point d'accès
|-
|Database
|string
|Nom de la base de donnée utilisé pour ce point d'accès (multi-bases)
|-
|Society
|string
|Nom de la société pour ce point d'accès (multi-société)
|-
|Restitution
|string
|Nom de la famille de restitution pour ce point d'accès (multi-société)
|}

Exemple :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\SData\1]
DataSetName=iphone
Title=syfre iphone
Contract=ndfContract
Version=1
Folder=Test Syfre iPhone
Database=dbTestIPhone
Society=
Restitution=
</pre>

===Section Export===
Cette section permet de configurer la fonction d'exportation des vignettes de portail des Services.

Deux mode d'exportation sont possibles :

*ftp
: Dans ce mode les vignettes sont générées et copiées dans un répertoire public accessible par ftp.

*file
: Dans ce mode les vignettes sont générées et copiées dans un répertoire local du serveur. Ce mode n'est utile que si le répertoire est un répertoire du Site et que celui-ci est public.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Protocol
|String
|ftp ou file
|-
|Export URL
|String
|Cette URL référence le répertoire où la vignette a été générée.
|}

Si le protocole est 'ftp' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|FTP host
|String
|Addresse du serveur FTP
|-
|FTP Port
|Integer
|Numéro du port du serveur FTP
|-
|FTP Login
|String
|Utilisateur de connexion du serveur FTP
|-
|FTP Password
|String
|Mot de passe de connexion du serveur FTP
|-
|FTP Directory
|String
|Répertoire d'exportation sur le serveur FTP
|}

Si le protocole est 'file' les variables suivantes sont utilisées :

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|Directory
|String
|Répertoire d'exportation sur le serveur.
|}

Exemple de configuration ftp utilisant une zone publique Free :

<pre>
[\SOFTWARE\Sage\Ligne 1000\Administration\Servers\SYFRE\Export]
Protocol=ftp
Export URL=http://syfre.free.fr/sage/
FTP Host=ftpperso.free.fr
FTP Port=21
FTP Login=syfre
FTP Password=XXXXXXXXXX
FTP Directory=sage
</pre>

===Section ConfigServer===

Cette section permet d'utiliser un fichier de configuration disponible sur une url.

{|class="wikitable"
|-
!Nom de variable
!Type
!Usage
|-
|url
|String
|Cette URL permet de récupérer le fichier de configuration.
|}

Un POST HTTP est effectué sur cette url avec les données suivantes :

<source lang="javascript">
{"deploymentId":"nom_système_de_la_machine"}
</source>

Le résultat attendu est

<source lang="javascript">
{"config":"contenu_du_fichier_de_configuration"},
{"certificate":"certificat_au_format_pfx"}
</source>

*[[Exemple de configuration (server)|Exemple de configuration]]
*[[Service_1000_(server)|Ligne de commande]]

{{Footer|Serveur}}
[[category:Serveur]]

Version 10.00 (release note)

2022-11-24T13:49:28Z

Flfay : /* Sécurisation du service */

__TOC__

===Mise à jour===
* [[Installation de la version 10 (10.00)|Installation de la version 10]]
* [[Procédure de mise à jour de la version (10.00)|Procédure de mise à jour de version antérieure à la version 8.00]]
* [[Procédure de mise à jour de la version 8.00 (10.00)|Procédure de mise à jour de la version 8.00]]
* [[Procédure de mise à jour de la version 9.xx (10.00)|Procédure de mise à jour de la version 9.xx]]

==Support de TLS 1.3==
* [[Support_TLS_1_3|Mise à jour des librairies SSL ce qui permet de supporter TLS 1.3]]

==Installation du service==
* [[AdminManager2_V10#service:create|Installation en ligne de commande]]
* [[ServiceL1000_Loader|Remplacement du contrôleur par le loader du service]]

==Gestion du service==
* [[Gestion du service (administration web)|Gestion du service par l'administration web]]

==Sécurisation du service==
* Lorsque le service est public (exposé sur internet) la sécurité est renforcée :
: [[Service_exposé_sur_internet|Activation du mode Internet]].
: Profil d'authentification forte sur l'annuaire d'entreprise.

* [[Fichier_de_configuration_(server)#Service|Gestion d'un répertoire public en mode Internet]]
* [[Fichier_de_configuration_(server)#HTTP_CSP|Support de Content Security Policy (CSP)]]

==Administration==
* [[Double_authentification_annuaire_entreprise|Double authentification grâce à l'application Authenticator]]
* Amélioration de la gestion du service dans l'administration Web

==Interface utilisateur==
* [[Améliorations des contrôles d'interface (Version 10.00)]]

==Client Web==
* [[RegisterSearchKey_(MM)|Améliorations des clés de recherche]]
* [[AddAction_(TSearchResult)|Action sur les résultats de recherche]]

==Applications htmls==
* [[Application_html_(portail)#Menu_du_portail|Amélioration du support des applications htmls]]

[[Category:Version1000]]
[[Category:Release note]]

Configurer un reverse proxy (Azure)

2022-11-23T14:26:33Z

Flfay : /* Paramétrage d'Apache HTTPS/Mobiles Filter sous windows */

L'utilisation d'un reverse proxy permet d'exposer certaines fonctionnalités du serveur d'application 1000 sans pour autant exposer l'ensemble de l'application.

__TOC__

==Vue de l'architecture==

[[image:architecture-reverse-proxy.png]]

==Configuration d'un reverse proxy sur Azure==

===Paramétrage du VPN===
On considère à ce stade que votre VM azure est paramétrée pour avoir accès au VPN de votre Réseau Local et que la résolution d'IP
fonctionne dans les deux sens : Azure > Local Network & Local Network > Azure.

Tutoriel VPN Site To Point :
http://www.cloudcomputingadmin.com/articles-tutorials/windows-azure/configure-client-based-remote-access-vpn-windows-azure-virtual-networks.html

===Paramétrage de la VM Azure===
Afin d'utiliser une VM azure comme hébergeur du reverse proxy, il faut ajouter un point de terminaison pour accéder à HTTPS.

[[Fichier:Terminaison443Azure.PNG]]

Il faudra également ouvrir un le port 443 dans le firewall.

[[Fichier:Firewall443-1.PNG]] [[Fichier:Firewall443-2.PNG]]
[[Fichier:Firewall443-3.PNG]]

Voila l'accès au port 443 est ouvert dans le CloudService et dans le firewall.

===Paramétrage d'Apache HTTPS/Mobiles Filter sous windows===

Pour pouvoir utiliser la fonction Reverse Proxy d'Apache en HTTPS voici les modules à activer :

* LoadModule headers_module modules/mod_headers.so
* LoadModule proxy_module modules/mod_proxy.so
* LoadModule proxy_connect_module modules/mod_proxy_connect.so
* LoadModule proxy_http_module modules/mod_proxy_http.so
* LoadModule rewrite_module modules/mod_rewrite.so
* LoadModule ssl_module modules/mod_ssl.so

Ensuite il faudra paramétrer le VirtualHost dans le fichier httpd.conf
<Pre>
Listen 443
<VirtualHost *:443>
ServerAdmin admin@cloudapp.net
ServerName reverseproxy.cloudapp.net
ErrorLog "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/reverseproxy-error.log"
CustomLog "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/reverseproxy-access.log" combined
SSLEngine On
ProxyRequests Off
ProxyPreserveHost On
RewriteEngine On
RewriteRule ^/mobiles - [L]
RewriteRule ^mobiles/([^/]*) mobiles/$1 [L,NC]
RewriteRule . /mobiles [R=301,L]
SSLCipherSuite HIGH:MEDIUM
SSLProtocol all -SSLv2
SSLCertificateFile "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/ssl/reverseproxy.cloudapp.net.cer"
SSLCertificateKeyFile "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/ssl/reverseproxy.cloudapp.net.key"
<Location />
ProxyPass http://192.168.0.3:8081/
ProxyPassReverse http://192.168.0.3:8081/
</Location>
</VirtualHost>
</Pre>

Dans cette exemple on filtre les URLs afin de limiter l'exposition du service aux requêtes "mobiles" c'est une nécessité dans ce type de configuration car les sauts de serveurs grève les performances et plus l'application est légère meilleur seront les temps de réponse.

[[Category:Mobiles]]
[[Category:Cluster]]
[[Category:Version700]]
[[Category:Latest]]

Configurer un reverse proxy (Azure)

2022-11-23T14:22:57Z

Flfay : /* Paramétrage d'Apache HTTPS/Mobiles Filter sous windows */

L'utilisation d'un reverse proxy permet d'exposer certaines fonctionnalités du serveur d'application 1000 sans pour autant exposer l'ensemble de l'application.

__TOC__

==Vue de l'architecture==

[[image:architecture-reverse-proxy.png]]

==Configuration d'un reverse proxy sur Azure==

===Paramétrage du VPN===
On considère à ce stade que votre VM azure est paramétrée pour avoir accès au VPN de votre Réseau Local et que la résolution d'IP
fonctionne dans les deux sens : Azure > Local Network & Local Network > Azure.

Tutoriel VPN Site To Point :
http://www.cloudcomputingadmin.com/articles-tutorials/windows-azure/configure-client-based-remote-access-vpn-windows-azure-virtual-networks.html

===Paramétrage de la VM Azure===
Afin d'utiliser une VM azure comme hébergeur du reverse proxy, il faut ajouter un point de terminaison pour accéder à HTTPS.

[[Fichier:Terminaison443Azure.PNG]]

Il faudra également ouvrir un le port 443 dans le firewall.

[[Fichier:Firewall443-1.PNG]] [[Fichier:Firewall443-2.PNG]]
[[Fichier:Firewall443-3.PNG]]

Voila l'accès au port 443 est ouvert dans le CloudService et dans le firewall.

===Paramétrage d'Apache HTTPS/Mobiles Filter sous windows===

Pour pouvoir utiliser la fonction Reverse Proxy d'Apache en HTTPS voici les modules à activer :

* LoadModule headers_module modules/mod_headers.so
* LoadModule proxy_module modules/mod_proxy.so
* LoadModule proxy_connect_module modules/mod_proxy_connect.so
* LoadModule proxy_http_module modules/mod_proxy_http.so
* LoadModule rewrite_module modules/mod_rewrite.so
* LoadModule ssl_module modules/mod_ssl.so

Ensuite il faudra paramétrer le VirtualHost dans le fichier httpd.conf
<Pre>
Listen 443
<VirtualHost *:443>
ServerAdmin admin@cloudapp.net
ServerName reverseproxy.cloudapp.net
ErrorLog "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/reverseproxy-error.log"
CustomLog "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/logs/reverseproxy-access.log" combined
SSLEngine On
ProxyRequests Off
ProxyPreserveHost On
RewriteEngine On
RewriteRule ^/mobiles - [L]
RewriteRule ^mobiles/([^/]*) mobiles/$1 [L,NC]
RewriteRule . /mobiles [R=301,L]
SSLCipherSuite HIGH:MEDIUM
SSLProtocol all -SSLv2
SSLCertificateFile "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/ssl/reverseproxy.cloudapp.net.cer"
SSLCertificateKeyFile "c:/Program Files (x86)/Apache Software Foundation/Apache2.2/ssl/reverseproxy.cloudapp.net.key"
<Location>
ProxyPass http://192.168.0.3:8081/
ProxyPassReverse http://192.168.0.3:8081/
</Location>
</VirtualHost>
</Pre>

Dans cette exemple on filtre les URLs afin de limiter l'exposition du service aux requêtes "mobiles" c'est une nécessité dans ce type de configuration car les sauts de serveurs grève les performances et plus l'application est légère meilleur seront les temps de réponse.

[[Category:Mobiles]]
[[Category:Cluster]]
[[Category:Version700]]
[[Category:Latest]]