Comment installer et configurer Pawa Connector (Windows)

Prérequis

• Un système Windows 10/11 avec accès en écriture à D:\Pawa.

• Accès réseau à ton instance Pawa (ex. https://yourinstance.pawa.zone/).

• Un jeton d’API Pawa.

• Accès à ta source de données (ex. via DSN ODBC).

• .NET Desktop Runtime si requis par ton environnement.

• Droits administrateur pour créer des tâches planifiées Windows.

Télécharger et débloquer Pawa Connector

1. Téléchargez Pawa Connector depuis le menu Administration > Pawa Connector :
   

   

2. Avant l’extraction :

   • Clic droit sur le fichier ZIP → Propriétés.

   • Onglet Général → cochez Débloquer (si présent).

   • Cliquez sur Appliquer → OK.

3. Extrayez ensuite le ZIP dans D:\Pawa\PawaConnector\.

Si vous omettez l’étape de déblocage, Windows peut bloquer les exécutables et empêcher leur exécution.

Structure de dossiers recommandée

Crée la structure suivante dans D:\Pawa

• 📁D:\Pawa

  ├─ 📁configs\

  │ └─ 📄configs.json

  ├─ 📁scripts\

  │ └─ 📄ImportTSUMasterList.sql

  ├─ 📁logs\

  │ └─ 📄prod.log

  ├─ 📁PawaConnector\

  │ ├─ 🟧Pawa.Connector.exe

  │ └─ 📄Tools.json

  ├─ 📄LoadToPawa.bat

  └─ 📄pawa.token

Configuration suggérée

Créer le fichier batch (LoadToPawa.bat)

Créez D:\Pawa\LoadToPawa.bat avec le contenu suivant :

cd /d %~dp0 
cd PawaConnector
Pawa.Connector.exe --Tool ApiLoader --Args ..\configs\configs.json > ..\logs\prod.log

echo %errorlevel%

exit %errorlevel%

• Les journaux d’exécution sont enregistrés dans D:\Pawa\logs\prod.log.

• Le code de sortie du processus est renvoyé, utile pour le suivi ou les tâches planifiées.

Configurer Tools.json

Éditez ou créez D:\Pawa\PawaConnector\Tools.json

[
  {
    "ToolName": "ApiLoader",
    "ApiBearerToken": "file:..\\pawa.token",
    "CheckVersionUrl": "https://yourinstance.pawa.zone/api/api-loader/version",
    "DownloadPackageUrl": "https://yourinstance.pawa.zone/api/api-loader/download",
    "ExeName": "Pawa.ApiLoader.exe"
  }
]

Remplacez yourinstance.pawa.zone par le domaine de votre instance Pawa.
Pour la version 32 bits utilisez le DownloadPackageUrl suivant: https://yourinstance.pawa.zone/api/api-loader/download-x86

Configurer configs.json

Modifiez ou créez D:\Pawa\configs\configs.json

{
  "ApiSettings": {
    "PawaRootUrl": "https://yourinstance.pawa.zone/",
    "ApiToken": "file:..\\pawa.token"
  },
"EmailSettings": {
    "FailureEmailAddress": "[email protected]"
  },
  "ImportSettings": {
      "DataSourceConnectionString": "DSN=Pawa........",
      "DataSourceProvider": "ODBC",
      "Imports": [
	{
      "Api": "Core",
	  "Methodname": "CreateHealthMonitorLog",
	  "DataSourceQuery": "SELECT 'Importation Update Start' Source, 'start' JsonLog"
     },
     {
       "Api": "Sop",
       "Methodname": "ImportTSUMasterList",
       "DataSourceQueryFile": "scripts\\30-ImportTSUMasterList.sql"
     },
     {
       "Api": "Core",
	   "Methodname": "CreateHealthMonitorLog",
	   "DataSourceQuery": "SELECT 'Importation Success NaturaeDecor' Source, 'start' JsonLog"
      }
 	]
  }
}

PawaRootUrl → votre instance Pawa.
FailureEmailAddress → adresse e-mail de noification en cas d’erreur.
DataSourceConnectionString → votre DSN ODBC ou votre chaîne de connexion.
scripts\*.sql → adapte pour tes noms de scripts SQL.

Pour exporter les prévisions depuis Pawa, configure ton fichier config.json comme suit :

{
  "ApiSettings": {
    "PawaRootUrl": "https://yourinstance.pawa.zone/",
    "ApiToken": "file:..\\pawa.token"
  },
  "EmailSettings": {
    "SuccessEmailAddress": "[email protected]",
    "FailureEmailAddress": "[email protected];[email protected]"
  },
  "ExportSettings": {
    "DataDestinationConnectionString": "Data Source=instancename;Integrated Security=SSPI;Initial Catalog=databasename",
    "Exports": [
      {
        "Api": "Sop",
        "MethodName": "ExportForecastCurrent",
        "Arguments": [
          {
            "Key": "RelativeStartYear",
            "Value": "-1"
          },
          {
            "Key": "RelativeEndYear",
            "Value": "2"
          },
          {
            "Key": "ForecastIncrementTransactionTypeCode",
            "Value": "Base"
          },
          {
            "Key": "IncludeZeroedForecasts",
            "Value": "True"
          }
        ],
        "DataDestinationTableName": "dbo.ExportedForecastCurrent"
      },
      {
        "Api": "Sop",
        "MethodName": "ExportForecastCommited",
        "Arguments": [
          {
            "Key": "RelativeStartYear",
            "Value": "-1"
          },
          {
            "Key": "RelativeEndYear",
            "Value": "2"
          },
          {
            "Key": "ForecastIncrementTransactionTypeCode",
            "Value": "Base"
          },
          {
            "Key": "IncludeZeroedForecasts",
            "Value": "True"
          }
        ],
        "DataDestinationTableName": "dbo.ExportedForecastCommited"
      }
    ]
  }
}

Ajoutez le jeton d’API Pawa

• Créez un fichier : D:\Pawa\pawa.token.

• Collez votre token API sur une seule ligne (sans guillemets).

• Restreignez les droits d’accès à ce fichier (ex. permissions NTFS).

Teste un exécution manuel

Double-cliquez sur D:\Pawa\LoadToPawa.bat

Aucun droit admin requis

• Vérifiez D:\Pawa\logs\prod.log pour succès ou erreurs.

• Vérifiez dans votre instance Pawa (Health Monitor ou données d'entité) si les imports ont réussis.

Planifier l’exécution automatique (Planificateur de tâches Windows)

Onglet Général

• Nom : Pawa – LoadToPawa

• Cocher : Exécuter avec les autorisations maximales

• Configurer pour : Windows 10/11

Onglet Déclencheurs

• Nouveau déclencheur :

  • Toutes les X heures : Choisir Quotidien → Répéter la tâche toutes les X heures → Indéfiniment.

  • Tous les X jours : Choisir Quotidien → Répéter tous les X jours.

Onglet Actions

• Programme/script : D:\Pawa\LoadToPawa.bat

Onglet Paramètres

• Cocher Exécuter la tâche dès que possible après un démarrage planifié manqué.

• Cocher Arrêter la tâche si elle s’exécute plus de 2 heures.

2. Enregistrez la tâche et saisissez les identifiants si demandé.

3. Testez en faisant clic droit sur la tâche → Exécuter.

4. Vérifiez prod.log.