Wiki1000 - Contributions [fr]

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]]

Authentification SAML IP cert Settings(Administration)

2022-11-13T20:35:52Z

Flfay : /* Exemple de paramétrage avec Okta */

==Exemple de paramétrage avec Google==

[[image:IDP_cert_google.JPG|600px]]

==Exemple de paramétrage avec Okta==

[[image:idp_cert_okta.JPG|600px]]

[[image:idp_cert_okta_2.JPG|600px]]

==Exemple de paramétrage avec AD==

[https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/tutorial-manage-certificates-for-federated-single-sign-on Voir la documentation]

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Authentification SAML IP cert Settings(Administration)

2022-11-13T20:35:17Z

Flfay : /* Exemple de paramétrage avec AD */

==Exemple de paramétrage avec Google==

[[image:IDP_cert_google.JPG|600px]]

==Exemple de paramétrage avec Okta==

[[image:idp_cert_okta.JPG|600px]]

[[image:idp_cert_okta_2.PNG|600px]]

==Exemple de paramétrage avec AD==

[https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/tutorial-manage-certificates-for-federated-single-sign-on Voir la documentation]

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Authentification SAML IP cert Settings(Administration)

2022-11-13T20:34:18Z

Flfay :

==Exemple de paramétrage avec Google==

[[image:IDP_cert_google.JPG|600px]]

==Exemple de paramétrage avec Okta==

[[image:idp_cert_okta.JPG|600px]]

[[image:idp_cert_okta_2.PNG|600px]]

==Exemple de paramétrage avec AD==

[[https://learn.microsoft.com/en-us/azure/active-directory/manage-apps/tutorial-manage-certificates-for-federated-single-sign-on|Voir la documentation]]

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Fichier:Idp cert okta 2.JPG

2022-11-13T20:32:18Z

Flfay :

Fichier:Idp cert okta.JPG

2022-11-13T20:32:09Z

Flfay :

Fichier:IDP cert google.JPG

2022-11-13T20:31:56Z

Flfay :

Authentification SAML IP cert Settings(Administration)

2022-11-13T20:30:38Z

Flfay : Page créée avec « ==Exemple de paramétrage avec Google== ==Exemple de paramétrage avec Okta== ==Exemple de paramétrage avec AD== Category:Administration Category:Annuaires [[C... »

==Exemple de paramétrage avec Google==

==Exemple de paramétrage avec Okta==

==Exemple de paramétrage avec AD==

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Authentification SAML (Administration)

2022-11-13T20:29:39Z

Flfay : /* Description de l'écran */

__TOC__

{{Version800}}

Les annuaires SAML v2 sont des annuaires de gestion d'identités implémentant le protocole d'authentification [https://en.wikipedia.org/wiki/SAML_2.0 SAML v2]

De nombreux fournisseurs de service implémentent SAML v2.

Les bénéfices de l'utilisation d'un annuaire SAML v2 sont les suivants :
* Vous n'avez plus besoin de gérer les identités des utilisateurs.
* Vos utilisateurs se connectent avec les identifiants du fournisseur de l'annuaire.
* Vos utilisateurs sont automatiquement connectés lorsqu'ils sont authentifiés sur le fournisseur de l'annuaire.(SSO)

===Définitions===

On distingue
* Le fournisseur de service (Service Provider ou SP). Dans notre cas, c'est Sage 1000.
* Le fournisseur d'identité (Identity Provider ou IP). Le service qui gère les identités.
* L'utilisateur (User Agent).

Les messages échangés sont appelés assertions.

===Mise en oeuvre===

====Paramétrer le fournisseur d'identité====

La mise en oeuvre d'un annuaire SAML v2 nécessite que vous enregistriez votre Service 1000 auprès du fournisseur d'identité. Les informations mises en oeuvre au cours de cette étapes sont :

* Une URL de rappel pointant sur votre Service 1000 contenant l'action samlv2_success.l1000, par exemple https://[hôte]/samlv2_success.l1000
* Un identifiant (SP Entity ID). Cet identifiant unique peut être proposé par l'Identiy Provider.
* Le certificat public du SP pour que l'IP puisse vérifier les signatures des assertions.(facultatif)
* Le paramétrage des attributs. En effet, Sage1000 doit faire correspondre les attributs de l'Identiy Provider avec ceux de Sage1000.
Le nom des attributs doit correspondre à celui paramétré dans l'annuaire Sage 1000

{{tip|Si le serveur web n'est pas intégré (IIS), utiliser comme adresse de rappel https://[hôte]/[nom du Service]/server/samlv2_success.l1000 }}

[[Authentification_SAML_IP_Settings_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_IP_Settings_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_IP_Settings_Google(Administration)|Exemple avec Google G Suite]]

====Paramétrer le fournisseur de service (l'annuaire dans la console d'administration)====

[[image:samlauthdirectory1.PNG|600px]]

=====Description de l'écran=====

*Identity Provider Single Sign-On URL
: URL de connexion vers l'Identiy Provider, fourni par l'Identiy Provider.

*Identity Provider Issuer
: Identifiant de l'Identiy Provider, fourni par l'Identiy Provider.

*Audience (SP Entity ID)
: Identifiant du Service Provider, peut être proposé par l'Identiy Provider ou à renseigner.

*Force Authentification
: Permet de redemander l'authentification à un utilisateur déjà authentifié par ailleurs. Désactive donc la fonction SSO.

*Auto create users
: Mode de création des utilisateurs ([[voir#Paramétrer le mode de création des utilisateurs]])

*Authentication context declaration reference
: Permet de spécifierà l'Identity Provider un mode d'authentification particulier (par exemple double authentification)

*Authentification comparison
: Permet de spécifier l'opérateur à appliquer au paramétrage précédent.(par exemple "au moins une double authentification" ou "exactement une double authentification")

*Sign SAML request
: Signer les assertions envoyées.Nécessite le paramétrage d'un certificat avec une clef privée et de fournir un certificat public à l'Identity Provider pour qu'il puisse vérifier les signatures.

*Verify SAML response
: Vérifier les assertions reçues.Nécessite le paramétrage du certificat public de l'Identity Provider pour pouvoir vérifier les signatures.

{{warning|La vérification de la signature de la réponse est obligatoire}}

[[Authentification_SAML_IP_cert_Settings(Administration)|Exemples de paramétrage]]

*First Name attribute
: Nom de l'attribut à lier au prénom de l'utilisateur.

*Last Name attribute
: Nom de l'attribut à lier au nom de l'utilisateur.

*Email attribute
: Nom de l'attribut à lier au mail de l'utilisateur.

*Member of attribute
: Nom de l'attribut à lier au groupe de l'utilisateur.(seulement si on choisit de créer automatiquement les utilisateurs)

Il faut paramétrer :

* L'URL de connexion vers l'Identiy Provider.
* L'identifiant (SP Entity ID) paramétré précédemment dans l'Identiy Provider.
* Le certificat public de l'Identity Provider que Sage1000 puisse vérifier les signatures des assertions.(facultatif)
* Le paramétrage des attributs.

[[Authentification_SAML_SP_Settings_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_SP_Settings_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_SP_Settings_Google(Administration)|Exemple avec Google G suite]]

====Paramétrer le logo====

[[image:samlauthdirectory2.PNG|600px]]

La fenêtre de connexion affiche les annuaires SAMLv2 actifs

[[image:samlportallogo.PNG|600px]]

====Paramétrer le mode de création des utilisateurs====

*Création automatique des utilisateurs

Il faut cocher la case "auto create users".

Ce choix implique le paramétrage de l'attribut "member of".

Il faut créer le groupe et le lier à l'annuaire et renseigner l'identifiant annuaire.
L'identifiant annuaire correspond à l'identifiant du groupe dans l'Identiy Provider.

Lorsque l'utilisateur se connecte, si il appartient au groupe, il est automatiquement créé et associé au groupe dans Sage 1000.

*Autorisation préalable

Il est possible d'autoriser préalablement les utilisateurs.
Il faut créer l'utilisateur le lier à l'annuaire et renseigner l'identifiant annuaire.
L'identifiant annuaire correspond à l'identifiant de l'utilisateur dans l'Identiy Provider.

[[Authentification_SAML_UserId_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_UserId_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_UserId_Google(Administration)|Exemple avec Google G Suite]]

*Autorisation à la demande

Si un utilisateur souhaite se connecter à l'application mais qu'il n'est pas reconnu, une demande d'autorisation est envoyée aux utilisateurs qui ont le rôle d'administration des utilisateurs et dossier.

Les rôles nécessaires pour recevoir le message :

[[image:role_admin.png]]

Le traitement des demandes d'autorisation :

[[image:demande_autorisation.png]]

Cet assistant crée l'utilisateur, le lie à l'annuaire, et l'ajoute aux utilisateurs autorisés du dossier choisi.

Une fois la demande acceptée un message est envoyé au demandeur.

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Authentification SAML (Administration)

2022-10-26T11:26:47Z

Flfay :

__TOC__

{{Version800}}

Les annuaires SAML v2 sont des annuaires de gestion d'identités implémentant le protocole d'authentification [https://en.wikipedia.org/wiki/SAML_2.0 SAML v2]

De nombreux fournisseurs de service implémentent SAML v2.

Les bénéfices de l'utilisation d'un annuaire SAML v2 sont les suivants :
* Vous n'avez plus besoin de gérer les identités des utilisateurs.
* Vos utilisateurs se connectent avec les identifiants du fournisseur de l'annuaire.
* Vos utilisateurs sont automatiquement connectés lorsqu'ils sont authentifiés sur le fournisseur de l'annuaire.(SSO)

===Définitions===

On distingue
* Le fournisseur de service (Service Provider ou SP). Dans notre cas, c'est Sage 1000.
* Le fournisseur d'identité (Identity Provider ou IP). Le service qui gère les identités.
* L'utilisateur (User Agent).

Les messages échangés sont appelés assertions.

===Mise en oeuvre===

====Paramétrer le fournisseur d'identité====

La mise en oeuvre d'un annuaire SAML v2 nécessite que vous enregistriez votre Service 1000 auprès du fournisseur d'identité. Les informations mises en oeuvre au cours de cette étapes sont :

* Une URL de rappel pointant sur votre Service 1000 contenant l'action samlv2_success.l1000, par exemple https://[hôte]/samlv2_success.l1000
* Un identifiant (SP Entity ID). Cet identifiant unique peut être proposé par l'Identiy Provider.
* Le certificat public du SP pour que l'IP puisse vérifier les signatures des assertions.(facultatif)
* Le paramétrage des attributs. En effet, Sage1000 doit faire correspondre les attributs de l'Identiy Provider avec ceux de Sage1000.
Le nom des attributs doit correspondre à celui paramétré dans l'annuaire Sage 1000

{{tip|Si le serveur web n'est pas intégré (IIS), utiliser comme adresse de rappel https://[hôte]/[nom du Service]/server/samlv2_success.l1000 }}

[[Authentification_SAML_IP_Settings_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_IP_Settings_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_IP_Settings_Google(Administration)|Exemple avec Google G Suite]]

====Paramétrer le fournisseur de service (l'annuaire dans la console d'administration)====

[[image:samlauthdirectory1.PNG|600px]]

=====Description de l'écran=====

*Identity Provider Single Sign-On URL
: URL de connexion vers l'Identiy Provider, fourni par l'Identiy Provider.

*Identity Provider Issuer
: Identifiant de l'Identiy Provider, fourni par l'Identiy Provider.

*Audience (SP Entity ID)
: Identifiant du Service Provider, peut être proposé par l'Identiy Provider ou à renseigner.

*Force Authentification
: Permet de redemander l'authentification à un utilisateur déjà authentifié par ailleurs. Désactive donc la fonction SSO.

*Auto create users
: Mode de création des utilisateurs ([[voir#Paramétrer le mode de création des utilisateurs]])

*Authentication context declaration reference
: Permet de spécifierà l'Identity Provider un mode d'authentification particulier (par exemple double authentification)

*Authentification comparison
: Permet de spécifier l'opérateur à appliquer au paramétrage précédent.(par exemple "au moins une double authentification" ou "exactement une double authentification")

*Sign SAML request
: Signer les assertions envoyées.Nécessite le paramétrage d'un certificat avec une clef privée et de fournir un certificat public à l'Identity Provider pour qu'il puisse vérifier les signatures.

*Verify SAML response
: Vérifier les assertions reçues.Nécessite le paramétrage du certificat public de l'Identity Provider pour pouvoir vérifier les signatures.

{{warning|La vérification de la signature de la réponse est nécessaire en production}}

*First Name attribute
: Nom de l'attribut à lier au prénom de l'utilisateur.

*Last Name attribute
: Nom de l'attribut à lier au nom de l'utilisateur.

*Email attribute
: Nom de l'attribut à lier au mail de l'utilisateur.

*Member of attribute
: Nom de l'attribut à lier au groupe de l'utilisateur.(seulement si on choisit de créer automatiquement les utilisateurs)

Il faut paramétrer :

* L'URL de connexion vers l'Identiy Provider.
* L'identifiant (SP Entity ID) paramétré précédemment dans l'Identiy Provider.
* Le certificat public de l'Identity Provider que Sage1000 puisse vérifier les signatures des assertions.(facultatif)
* Le paramétrage des attributs.

[[Authentification_SAML_SP_Settings_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_SP_Settings_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_SP_Settings_Google(Administration)|Exemple avec Google G suite]]

====Paramétrer le logo====

[[image:samlauthdirectory2.PNG|600px]]

La fenêtre de connexion affiche les annuaires SAMLv2 actifs

[[image:samlportallogo.PNG|600px]]

====Paramétrer le mode de création des utilisateurs====

*Création automatique des utilisateurs

Il faut cocher la case "auto create users".

Ce choix implique le paramétrage de l'attribut "member of".

Il faut créer le groupe et le lier à l'annuaire et renseigner l'identifiant annuaire.
L'identifiant annuaire correspond à l'identifiant du groupe dans l'Identiy Provider.

Lorsque l'utilisateur se connecte, si il appartient au groupe, il est automatiquement créé et associé au groupe dans Sage 1000.

*Autorisation préalable

Il est possible d'autoriser préalablement les utilisateurs.
Il faut créer l'utilisateur le lier à l'annuaire et renseigner l'identifiant annuaire.
L'identifiant annuaire correspond à l'identifiant de l'utilisateur dans l'Identiy Provider.

[[Authentification_SAML_UserId_Okta(Administration)|Exemple avec Okta]]

[[Authentification_SAML_UserId_AZURE(Administration)|Exemple avec Azure AD]]

[[Authentification_SAML_UserId_Google(Administration)|Exemple avec Google G Suite]]

*Autorisation à la demande

Si un utilisateur souhaite se connecter à l'application mais qu'il n'est pas reconnu, une demande d'autorisation est envoyée aux utilisateurs qui ont le rôle d'administration des utilisateurs et dossier.

Les rôles nécessaires pour recevoir le message :

[[image:role_admin.png]]

Le traitement des demandes d'autorisation :

[[image:demande_autorisation.png]]

Cet assistant crée l'utilisateur, le lie à l'annuaire, et l'ajoute aux utilisateurs autorisés du dossier choisi.

Une fois la demande acceptée un message est envoyé au demandeur.

[[Category:Administration]]
[[Category:Annuaires]]
[[Category:SAML V2]]
[[Category:Version800]]

Keyvault url

2022-09-28T12:17:06Z

Flfay :

{{version1000}}

==Principe général==

Certains secrets peuvent être fournis à l'application afin d'augmenter la sécurité.

{{warning|Ces secrets sont lus et mis en cache, ils sont rechargés au redémarrage de l'application.}}

Certains secret, comme des clefs de chiffrements, peuvent être initialisés par l'application.

Le secret est fourni sous la forme d'une url.
kv://[fournisseur]/[nomDuCoffre]/[cookieKey]

==Fournisseurs supportés==
===Azure===
Pour accéder à un secret dans un keyvault Azure, le service 1000 doit être exécuté sur une VM étant un service principal et ayant les droits sur le keyvault.

Par exemple pour accéder à la clef "myKey" du keyvault nommé "myKeyVault" l'url à utiliser est alors
kv://azure/myKeyVault/myKey

==Clefs supportés==

[[Fichier_de_configuration_(server)#Clefs|Clefs dans le fichiers de configuration]]

[[Category:Version1000]]

Keyvault url

2022-09-28T12:15:41Z

Flfay : Page créée avec « ==Principe général== Certains secrets peuvent être fournis à l'application afin d'augmenter la sécurité. {{warning|Ces secrets sont lus et mis en cache, ils sont r... »

==Principe général==

Certains secrets peuvent être fournis à l'application afin d'augmenter la sécurité.

{{warning|Ces secrets sont lus et mis en cache, ils sont rechargés au redémarrage de l'application.}}

Certains secret, comme des clefs de chiffrements, peuvent être initialisés par l'application.

Le secret est fourni sous la forme d'une url.
kv://[fournisseur]/[nomDuCoffre]/[cookieKey]

==Fournisseurs supportés==
===Azure===
Pour accéder à un secret dans un keyvault Azure, le service 1000 doit être exécuté sur une VM étant un service principal et ayant les droits sur le keyvault.

Par exemple pour accéder à la clef "myKey" du keyvault nommé "myKeyVault" l'url à utiliser est alors
kv://azure/myKeyVault/myKey

==Clefs supportés==

[[Fichier_de_configuration_(server)#Clefs|Clefs dans le fichiers de configuration]]

Fichier de configuration (server)

2022-09-28T12:04:21Z

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.
|}

====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]]

OIDs numériques (framework)

2022-09-09T13:52:42Z

Flfay :

{{version900}}

Une base en OIDs numériques stocke les OID en entier 64 bits au lieu de les stocker en chaîne de caractères.

Les avantages sont :

* Gain de taille, la taille d'un oid numérique est de 8 octets alors que la taille d'un oid caractère est de 32 octets
* Gain de performance, le serveur SQL est plus performant dans la manipulation d'entier.
* Gain réseau, le volume de données échangé est réduit.

{{tip|Seul le stockage est différent, le framework et le code métier utilisent toujours des OIDs au format caractère en interne}}

===Struture interne===

{|class="wikitable"
|-
!nom
!taille
!Remarque
|-
|LID
|16 bits
|Local OID, incrément propre à chaque client
|-
|GID
|32 bits
|Root OID, stocké dans la séquence RootOID, incrémenté par chaque client à la connexion
|-
|OTP
|16 bits
|identifie la classe, grâce à la table sysOTPs
|}

===Revue de code métier===
Les éléments suivants doivent être revue pour s'assurer que le code métier est correctement implémenté :

* Queries brokers
* Curseurs utilisant une construction SQL

Les points à vérifier sont :

* Utilisation de dbOutOID() pour encoder les OIDs dans les requêtes

'''Support de l'encodage d'OID par translateur :'''

{|class="wikitable"
|-
!Fonction
!Supporte l'encodage d'OID
!Remarque
|-
|dboutOID()
|Oui
|
|-
|dbOutStr()
|Non
|
|-
|dbOutVariant()
|Non
|
|-
|dbOutWhereString('oidXXX','=',' ')
|Oui
| oidXXX is NULL
|-
|dbOutWhereString('oidXXX','<>',' ')
|Oui
| oidXXX is NOT NULL
|-
|dbOutWhereString('oidXXX','=',aOID)
|Oui
|
|-
|dbOutWhereString('oidXXX','=',dbOutStr(aOID))
|non
|
|-
|dbOutWhereVariant('oidXXX','=',aOID)
|oui
|
|}

Exemples :

<source lang=delphi>
//Procedure TestQueryBroker;
var vQuery:TQuery; aOID,xOID:TOID; inst:WFClasseA; ctn:Integer;
begin
//find first instance
inst := WFClasseA.Find('','',True,[]);
if not Assigned(inst) then Exit;
aOID := inst.OID;

vQuery := QueryBroker(''{URL},'Test','WFClasseA');
vQuery.Sql.Add('SELECT oid FROM '+ClassManager.FindClassTableName('WFClasseA'));
vQuery.SQL.Add(Format('WHERE oid=%s',[vQuery.translator.dbOutOID(aOID)])); //!! Important use dbOutOID() to encode oid
//
ctn := 0;
vQuery.Open;
vQuery.First;
while not vQuery.Eof do
begin
ctn := ctn+1;
xOID := vQuery.Fields[0].AsVariant; // OK, Fields[] return the OID in char format
vQuery.Next;
end;
vQuery.Close;
//
if (ctn=1) and (aOID=xOID)
then showMessage('success')
else showMessage(Format('failed :%d, %s / %s',[ctn,aoid,xoid]));
end;
</source>

<source lang="delphi">
begin
// OK

// Equality test
aOID := inst.OID;
vQuery.SQL.Add(Format('WHERE oid=%s',[vQuery.translator.dbOutOID(aOID)]));

// Null test
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereString('oid','=','NULL')]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereString('oid','<>','NULL')]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereString('oid','=','')]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereString('oid','<>','')]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereString('oid','=',aOID)]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereNull('oid')]));
vQuery.SQL.Add(Format('AND %s',[vQuery.translator.dbOutWhereNotNull('oid')]));

// In test
aWhereIn := '('''+aOID+'')';
vQuery.SQL.Add(Format('WHERE oid in %s',[vQuery.translator.dbOutOID(aWhereIn)]);
end;
</source>

<source lang="delphi">
begin
// NOT OK

// Equality test
aOID := inst.OID;
vQuery.SQL.Add(Format('WHERE oid=''%s''',[aOID]));
vQuery.SQL.Add(Format('WHERE oid='''+aOID+''',[]));
vQuery.SQL.Add(Format('WHERE oid=%s',[vQuery.translator.dbOutStr(aOID)]));
vQuery.SQL.Add(Format('WHERE oid=%s',[vQuery.translator.dbOutVariant(aOID)]));

// In test
aWhereIn := '('''+aOID+'')';
vQuery.SQL.Add(Format('WHERE oid in %s',[aWhereIn]);
end;
</source>

{{tip|Il est recommandé de ne pas utiliser de Query broker ni de curseur avec du code SQL. En général, ceux-ci peuvent être remplacés par des sélecteurs ou des vues locales.}}

===Fonctions spécifiques SQL===
Dans certain cas il peut être nécessaire de convertir des OIDs numériques et alphanumériques dans des requêtes SQL

Il existe deux fonctions SQL pour réaliser ces conversions

* OIDToNumeric ( iOIDChar : CHAR_(12) )
: Retourne la valeur numérique d'un OID caractère

* NumericToOID (iDatabasePrefix : CHAR_(16), iOIDInt:BigInt )
: Retourne la valeur alphanumérique d'un OID numérique

{{tip|N'utiliser pas ces fonctions dans le script métier, il n'est jamais nécessaire de gérer le format des OIDs dans le code métier}}

Voir aussi:
* [[Translateurs_SQL_(tech)|Translateur]]
* [[Selecteur_(tech)|Sélecteurs]]
* [[Vue_locale_(langage)|Vues locales]]

[[category:Version900]]
[[Category:Base de données]]
[[Category:Framework]]

Administrer un dossier dans Sage Partner Cloud

2022-08-18T07:01:28Z

Flfay : /* Dans le contexte du fournisseur */

==Actions depuis le portail SPC==

Les actions suivantes interagissent avec le service Sage FRP 1000.

===Dans le contexte du site===
[[image:SPC_8.JPG]]

====Verrouiller/Déverrouiller un site====

Un site verrouillé interdit tout nouvelle connexion (sauf administrateur).
Le service Sage FRP 1000 continue de s'exécuter.

====Suspendre un site====

Un message est affiché à tous les utilisateurs connectés leur informant de l'arrêt imminent du service.
La machine virtuelle sur laquelle le service Sage FRP 1000 s'exécute s'éteint.

====Ajouter/retirer un utilisateur====

[[image:SPC_9.JPG]]

L'utilisateur authentifié par l'annuaire Sage Cloud ID est autorisé/retiré sur le dossier.

{{tip|La gestion des utilisateurs authentifiés par l'annuaire interne Sage 1000 s'effectue sur le service.}}

===Dans le contexte du partenaire===

====Paramétrer un fournisseur d'envoi de mail====

Le format attendu est smpt://{nomServeur}:{port}?sender={emetteur}&user={utilisater}&password={mot de passe}&tls={support TLS}

[[image:SPC_10.JPG]]

==Actions depuis Azure==

Sur le site, obtenir les informations d'infrastructure du site.

[[image:SPC_11.JPG]]

Ces informations permettent de se connecter à la VM via l'outil '''Bastion'''.

[[image:SPC_12.JPG]]

Sur la VM, le client lourd est installé.
Il est ainsi possible d'installer les patch métiers.

==Actions depuis Sage FRP 1000==

===Mise à jour du service===

Il est possible de mettre à jour le service depuis le menu d'administration.

[[image:SPC_13.JPG]]

{{tip|Les mises à jours corrigeant une faille de sécurité critique sont téléchargées automatiquement.}}

===Paramétrage Sage BI Reporting===

Sage BI Reporting nécessite un accès à la base de données SQL Azure.

Un utilisateur spécifique est créé sur la base de données métier.

Pour utiliser Sage BIO Reporting :

* Ajouter les adresses IP des postes nécessitant un accès à la base SQL Azure.
* Copier les informations de connexions (chiffrées et uniquement déchiffrables par Sage BI Reporting.

En cas de besoin, il est possible de renouveler le mot de passe de l'utilisateur BI {{warning| Sage BI Reporting doit être reparamétré ensuite}}

[[image:SPC_14.JPG]]

[[Category:Sage Partner Cloud]]
[[Category:Version1000]]
[[Category:latest]]

AdminManager2 V10

2022-07-08T09:42:09Z

Flfay : /* Présentation */

==Présentation==

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

Il est disponible [https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1000/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]]

AdminManager2 V10

2022-07-08T09:38:30Z

Flfay :

==Présentation==

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

Il est disponible [[https://bumge.sage.com.dl1.ipercast.net/SageFRP1000/1000/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]]

NestedDataSetType (Propriété)

2022-07-01T09:23:32Z

Flfay :

Cette propriété indique le mode de fonctionnement de l'ensemble de données associé au rôle.

'''ndstUseRole'''
Utilise le rôle. Attention le rôle charge tous ses objets en mémoire, lorsqu'une grande quantité d'objet sont concernés utilisez ndstQueryTable.

'''ndstUseRoleNW'''
Utilise le rôle mais l'ensemble de données n'est pas fenêtré. L'ensemble de données va créé un enregistrement pour chaque objet du rôle au lieu d'utiliser un nombre d'enregistrements correspondant au nombre demandé par les contrôles associés. Grâce à ce mode les grilles peuvent réaliser une gestion du défilement plus précis.

'''ndstQueryTable'''
Utilise la table SQL correspondante au rôle. Utilisez ce mode lorsque le rôle contient une grande quantité d'objet .

'''ndstUseRoleProvider'''
Usage interne

'''ndstUseRoleNoFilter'''
le filtre est ignoré, ce rôle est alimenté par le script uniquement

{{Footer|}}
[[category:Propriétés de contrôle]]

NestedDataSetType (Propriété)

2022-07-01T09:23:24Z

Flfay :

NestedDataSetType (Propriété)

2022-07-01T07:33:03Z

Flfay :

Cette propriété indique le mode de fonctionnement de l'ensemble de données associé au rôle.

'''ndstUseRole'''
Utilise le rôle. Attention le rôle charge tous ses objets en mémoire, lorsqu'une grande quantité d'objet sont concernés utilisez ndstQueryTable.

'''ndstUseRoleNW'''
Utilise le rôle mais l'ensemble de données n'est pas fenêtré. L'ensemble de données va créé un enregistrement pour chaque objet du rôle au lieu d'utiliser un nombre d'enregistrements correspondant au nombre demandé par les contrôles associés. Grâce à ce mode les grilles peuvent réaliser une gestion du défilement plus précis.

'''ndstQueryTable'''
Utilise la table SQL correspondante au rôle. Utilisez ce mode lorsque le rôle contient une grande quantité d'objet .

'''ndstUseRoleProvider'''
Usage interne

'''ndstUseRoleNP'''

{{Footer|}}
[[category:Propriétés de contrôle]]

Administrer un dossier dans Sage Partner Cloud

2022-06-30T11:32:03Z

Flfay : /* Paramétrage Sage BI Reporting */

==Actions depuis le portail SPC==

Les actions suivantes interagissent avec le service Sage FRP 1000.

===Dans le contexte du site===
[[image:SPC_8.JPG]]

====Verrouiller/Déverrouiller un site====

Un site verrouillé interdit tout nouvelle connexion (sauf administrateur).
Le service Sage FRP 1000 continue de s'exécuter.

====Suspendre un site====

Un message est affiché à tous les utilisateurs connectés leur informant de l'arrêt imminent du service.
La machine virtuelle sur laquelle le service Sage FRP 1000 s'exécute s'éteint.

====Ajouter/retirer un utilisateur====

[[image:SPC_9.JPG]]

L'utilisateur authentifié par l'annuaire Sage Cloud ID est autorisé/retiré sur le dossier.

{{tip|La gestion des utilisateurs authentifiés par l'annuaire interne Sage 1000 s'effectue sur le service.}}

===Dans le contexte du fournisseur===

====Paramétrer un fournisseur d'envoi de mail====

Le format attendu est smpt://{nomServeur}:{port}?sender={emetteur}&user={utilisater}&password={mot de passe}&tls={support TLS}

[[image:SPC_10.JPG]]

==Actions depuis Azure==

Sur le site, obtenir les informations d'infrastructure du site.

[[image:SPC_11.JPG]]

Ces informations permettent de se connecter à la VM via l'outil '''Bastion'''.

[[image:SPC_12.JPG]]

Sur la VM, le client lourd est installé.
Il est ainsi possible d'installer les patch métiers.

==Actions depuis Sage FRP 1000==

===Mise à jour du service===

Il est possible de mettre à jour le service depuis le menu d'administration.

[[image:SPC_13.JPG]]

{{tip|Les mises à jours corrigeant une faille de sécurité critique sont téléchargées automatiquement.}}

===Paramétrage Sage BI Reporting===

Sage BI Reporting nécessite un accès à la base de données SQL Azure.

Un utilisateur spécifique est créé sur la base de données métier.

Pour utiliser Sage BIO Reporting :

* Ajouter les adresses IP des postes nécessitant un accès à la base SQL Azure.
* Copier les informations de connexions (chiffrées et uniquement déchiffrables par Sage BI Reporting.

En cas de besoin, il est possible de renouveler le mot de passe de l'utilisateur BI {{warning| Sage BI Reporting doit être reparamétré ensuite}}

[[image:SPC_14.JPG]]

[[Category:Sage Partner Cloud]]
[[Category:Version1000]]

Administrer un dossier dans Sage Partner Cloud

2022-06-30T11:31:51Z

Flfay : /* Mise à jour du service */

==Actions depuis le portail SPC==

Les actions suivantes interagissent avec le service Sage FRP 1000.

===Dans le contexte du site===
[[image:SPC_8.JPG]]

====Verrouiller/Déverrouiller un site====

Un site verrouillé interdit tout nouvelle connexion (sauf administrateur).
Le service Sage FRP 1000 continue de s'exécuter.

====Suspendre un site====

Un message est affiché à tous les utilisateurs connectés leur informant de l'arrêt imminent du service.
La machine virtuelle sur laquelle le service Sage FRP 1000 s'exécute s'éteint.

====Ajouter/retirer un utilisateur====

[[image:SPC_9.JPG]]

L'utilisateur authentifié par l'annuaire Sage Cloud ID est autorisé/retiré sur le dossier.

{{tip|La gestion des utilisateurs authentifiés par l'annuaire interne Sage 1000 s'effectue sur le service.}}

===Dans le contexte du fournisseur===

====Paramétrer un fournisseur d'envoi de mail====

Le format attendu est smpt://{nomServeur}:{port}?sender={emetteur}&user={utilisater}&password={mot de passe}&tls={support TLS}

[[image:SPC_10.JPG]]

==Actions depuis Azure==

Sur le site, obtenir les informations d'infrastructure du site.

[[image:SPC_11.JPG]]

Ces informations permettent de se connecter à la VM via l'outil '''Bastion'''.

[[image:SPC_12.JPG]]

Sur la VM, le client lourd est installé.
Il est ainsi possible d'installer les patch métiers.

==Actions depuis Sage FRP 1000==

===Mise à jour du service===

Il est possible de mettre à jour le service depuis le menu d'administration.

[[image:SPC_13.JPG]]

{{tip|Les mises à jours corrigeant une faille de sécurité critique sont téléchargées automatiquement.}}

===Paramétrage Sage BI Reporting===

Sage BI Reporting nécessite un accès à la base de données SQL Azure.

Un utilisateur spécifique est créé sur la base de données métier.

Pour utiliser Sage BIO Reporting :

* Ajouter les adresses IP des postes nécessitant un accès à la base SQL Azure.
* Copier les informations de connexions (chiffrées et uniquement déchiffrables par Sage BI Reporting.

En cas de besoin, il est possible de renouveler le mot de passe de l'utilisateur BI {{warning| Sage BI Reporting doit être reparamétré ensuite}}

[[image:SPC_13.JPG]]

[[Category:Sage Partner Cloud]]
[[Category:Version1000]]

Fichier:SPC 14.JPG

2022-06-30T11:31:23Z

Flfay :

Fichier:SPC 13.JPG

2022-06-30T11:31:14Z

Flfay :

Administrer un dossier dans Sage Partner Cloud

2022-06-30T11:30:48Z

Flfay : /* Actions depuis Sage FRP 1000 */

==Actions depuis le portail SPC==

Les actions suivantes interagissent avec le service Sage FRP 1000.

===Dans le contexte du site===
[[image:SPC_8.JPG]]

====Verrouiller/Déverrouiller un site====

Un site verrouillé interdit tout nouvelle connexion (sauf administrateur).
Le service Sage FRP 1000 continue de s'exécuter.

====Suspendre un site====

Un message est affiché à tous les utilisateurs connectés leur informant de l'arrêt imminent du service.
La machine virtuelle sur laquelle le service Sage FRP 1000 s'exécute s'éteint.

====Ajouter/retirer un utilisateur====

[[image:SPC_9.JPG]]

L'utilisateur authentifié par l'annuaire Sage Cloud ID est autorisé/retiré sur le dossier.

{{tip|La gestion des utilisateurs authentifiés par l'annuaire interne Sage 1000 s'effectue sur le service.}}

===Dans le contexte du fournisseur===

====Paramétrer un fournisseur d'envoi de mail====

Le format attendu est smpt://{nomServeur}:{port}?sender={emetteur}&user={utilisater}&password={mot de passe}&tls={support TLS}

[[image:SPC_10.JPG]]

==Actions depuis Azure==

Sur le site, obtenir les informations d'infrastructure du site.

[[image:SPC_11.JPG]]

Ces informations permettent de se connecter à la VM via l'outil '''Bastion'''.

[[image:SPC_12.JPG]]

Sur la VM, le client lourd est installé.
Il est ainsi possible d'installer les patch métiers.

==Actions depuis Sage FRP 1000==

===Mise à jour du service===

Il est possible de mettre à jour le service depuis le menu d'administration.

[[image:SPC_12.JPG]]

{{tip|Les mises à jours corrigeant une faille de sécurité critique sont téléchargées automatiquement.}}

===Paramétrage Sage BI Reporting===

Sage BI Reporting nécessite un accès à la base de données SQL Azure.

Un utilisateur spécifique est créé sur la base de données métier.

Pour utiliser Sage BIO Reporting :

* Ajouter les adresses IP des postes nécessitant un accès à la base SQL Azure.
* Copier les informations de connexions (chiffrées et uniquement déchiffrables par Sage BI Reporting.

En cas de besoin, il est possible de renouveler le mot de passe de l'utilisateur BI {{warning| Sage BI Reporting doit être reparamétré ensuite}}

[[image:SPC_13.JPG]]

[[Category:Sage Partner Cloud]]
[[Category:Version1000]]

Administrer un dossier dans Sage Partner Cloud

2022-06-30T11:16:14Z

Flfay : /* Actions depuis Azure */

Administrer un dossier dans Sage Partner Cloud

2022-06-30T11:16:05Z

Flfay : /* Actions depuis Azure */