Lorsque vous utilisez l'API ODBC en PHP, avec un script Python, du Java, C, C++ ou tout autre langage de programmation, vous pouvez vous connecter sans utiliser un DSN mais au moyen d'une chaîne de connexion.

Exemple avec Python:

Cet exemple utilise les keywords suivants :

• Driver : défini pour utiliser le pilote 4D ODBC
• Server : défini pour utiliser le 4D Server sur la machine avec l'adresse IP= "187.145.45.23" ; aucun port n'étant spécifié, le port par défaut (19812) sera utilisé.
• UID et PWD : défini pour se connecter en tant que "Designer" en utilisant le mot de passe "123456".

Les mots-clés ne sont pas sensibles à la casse et peuvent être utilisés dans n'importe quel ordre, excepté pour "Driver" qui doit être placé en premier s'il est utilisé. Si vous ne spécifiez aucun mot-clé, ce sont les valeurs par défaut qui sont utilisées.

Une chaîne de connexion peut aussi utiliser un DSN. Lorsque vous créez un DSN en utilisant la fenêtre de configuration de 4D, les paramètres sont sauvegardés dans le registre ou dans le fichier odbc.ini en utilisant les mêmes mots-clés.

Par exemple, si vous utilisez la chaîne de connexion :

... c'est l'équivalent d'une chaîne de connexion utilisant les mêmes valeurs dans le DSN "My_4D_DSN".

Une description de tous les mots-clés utilisés dans une chaîne de connexion, ou lorsque vous configurez un DSN, est disponible au point suivant.

• Driver :
  Indique le pilote ODBC utilisé.
  Pour une chaîne de connexion : Utilisez la valeur "{4D ODBC Driver 64-bit}"
  Pour une définition de DSN (macOS) : Utilisez "/Library/ODBC/4D ODBC x64.bundle/Contents/MacOS/4D ODBC x64" dans le fichier obdc.ini ou dans la configuration DSN générique par paire clé/valeur.
• DSN :
  Pour une chaîne de connexion : Indique un DSN à utiliser.
  Dans ce cas, il n'est pas nécessaire d'utiliser d'autres mots-clés puisqu'ils sont déjà définis dans le DSN.
  Pour une définition de DSN : vous assignez directement un nom et n'avez pas besoin d'un mot-clé.
• Description :
  Pour une chaîne de connexion : ce mot-clé n'est pas utilisé.
  Pour une définition de DSN : vous pouvez saisir une rapide description (optionnel).
  Valeur par défaut : ""
• Server :
  Indique l'adresse IP ou le nom du 4D Server auquel vous souhaitez vous connecter. Exemples : "127.0.0.1", "localhost", "2001:0db8:0000:85a3:0000:0000:ac1f:8001".
  Valeur par défaut : “localhost”.
• Port :
  Spécifie le port de connexion.
  Valeur par défaut : 19812
  Ce port doit être le même que celui qui est indiqué dans les Propriétés de la base, page SQL/Configuration (sur la machine serveur)
  

• UID :
  Identifie le nom de l'utilisateur sous lequel vous vous connectez.
  Valeur par défaut : ""
• PWD :
  Fournit le mot de passe associé au nom d'utilisateur spécifié dans la clé UID.
  Valeur par défaut : ""
• SSL :
  Autorise la connexion TLS.
  Pour une chaîne de connexion : peut être soit "True" ou "False"
  Pour une définition de DSN : apparaît en tant que case à cocher.
  Valeur par défaut : "False"
• PhysicalConnectionTimeout* :
  Une connexion ODBC débute par une connexion au réseau TCP/IP.
  Ces valeurs fixent le délai d'attente pour cette étape.
  Valeur par défaut : 0
• LoginTimeout* :
  Une fois que le pilote est connecté au réseau TCP/IP, il doit alors être reconnu par 4D Server. Pour cela, il envoie une trame réseau contenant l'utilisateur, le mot de passe et d'autres informations. Ce délai d'attente fixe le temps maximum d'attente pour une réponse.
  Valeur par défaut : 0
• QueryTimeout* :
  Une fois que le pilote ODBC est connecté, il peut exécuter les requêtes et gérer les données. Ce délai, exprimé en secondes, sera alors appliqué.
  Valeur par défaut : 0
  * les délais d'attente fixent les temps d'attente avant d'annuler une action. Ces valeurs sont exprimées en secondes, 0 signifiant pas de délai d'attente (c'est-à-dire délai illimité).
• DefaultPageSize (paramétrage avancé) :
  Valeur exprimée en lignes.
• NetworkCacheSize (paramétrage avancé) :
  Valeur exprimée en Ko.
• FavouriteImageFormats (paramétrage avancé) :
  Contient une liste des formats d'images acceptés, séparés par des espaces, choisis par les formats suivants : .tiff, .gif, .jpg, .png, .bmp.
  Valeur par défaut : "" (accepte n'importe quel format d'image)
• CharsEncoding (paramétrage avancé) :
  Pour une chaîne de connexion : Peut être "UTF-8" ou "System".
  Pour une définition de DSN : montré en tant que bouton radio.
  Valeur par défaut : UTF-8
• OpenQuery (paramétrage avancé) :
  Pour une chaîne de connexion : Utilisez "True" ou "False". Si vous utilisez SQLServerManagementStudio et rencontrez des difficultés de connexion à 4D, il est préférable d'exécuter le script suivant :
  
  EXEC sp_addlinkedserver
@server = '<Your name>',
@srvproduct = '<Anything>',
@provider = 'MSDASQL',
@provstr = 'OpenQuery=true;dsn=<a 4D-defined DSN>;UID=<your 4D User>;PWD=<Password>'
  
  Pour une définition de DSN : apparaît en tant que case à cocher.
  Valeur par défaut : False (non cochée)
• MSAccess (paramétrage avancé) :
  Pour une chaîne de connexion : Utilisez "True" ou "False". Si vous rencontrez des problèmes avec les dates ou des heures, vous pouvez essayer de fixer cette option à "True".
  Pour une définition de DSN : apparaît en tant que case à cocher.
  Valeur par défaut : False (non cochée)
• Windev (paramétrage avancé) :
  Pour une chaîne de connexion : Utilisez "True" ou "False". Si vous rencontrez des problèmes avec Windev, vous pouvez essayer de fixer cette option à "True".
  Pour une définition de DSN : apparaît en tant que case à cocher.
  Valeur par défaut : False (non cochée)