majorsilence_reporting

Installation

Aucune gem n'est encore publiée sur RubyGems. Chargez depuis les sources via $LOAD_PATH ou require_relative :

# Ajouter le répertoire lib au chemin de chargement
$LOAD_PATH.unshift '/path/to/reporting-ruby/lib'

# Charger les trois classes d'un coup
require 'majorsilence_reporting'

# Ou charger les classes individuellement
require 'majorsilence_reporting/report'
require 'majorsilence_reporting/report_aot'
require 'majorsilence_reporting/report_native'

Aucune dépendance gem en runtime. Le mode natif FFI utilise la bibliothèque standard intégrée de Ruby Fiddle.

Modes d'intégration

Report — sous-processus (dotnet)

require 'majorsilence_reporting/report'

rpt = Report.new('/path/to/report.rdl', '/path/to/RdlCmd.dll')
rpt.set_connection_string('Data Source=/path/to/data.db')
rpt.set_parameter('StartDate', '2026-01-01')

# Enregistrer sur le disque
rpt.export('pdf', '/tmp/output.pdf')

# Ou obtenir les octets en mémoire (par ex. pour un contrôleur Rails)
data = rpt.export_to_memory('pdf')
send_data data, type: 'application/pdf', disposition: 'inline'

ReportAot — binaire AOT

Même API que Report, mais cible un binaire autonome. Aucun runtime .NET requis. Débloque des formats d'export supplémentaires (xlsx_table, tifb, mht).

require 'majorsilence_reporting/report_aot'

rpt = ReportAot.new('/path/to/report.rdl', '/path/to/RdlCmd')
rpt.set_connection_string('Data Source=/path/to/data.db')

data = rpt.export_to_memory('xlsx_table')

# Dans une réponse Rack/Sinatra :
[200, { 'Content-Type' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' }, [data]]

ReportNative — FFI Fiddle

Charge librdlnative.so directement dans le processus Ruby via la bibliothèque intégrée Fiddle. Aucun processus enfant n'est lancé.

require 'majorsilence_reporting/report_native'

# Charger une seule fois au démarrage. Précharge les fichiers .so/.dylib associés et définit RDLNATIVE_LIB_DIR.
lib = RdlLibrary.load('/path/to/librdlnative.so')

rpt = ReportNative.new(lib, '/path/to/report.rdl')
rpt.set_connection_string('Data Source=/path/to/data.db')

data = rpt.export_to_memory('pdf')   # renvoie une String binaire

API principale

Les trois classes partagent la même interface :

Jeux de données en mémoire

ReportNative permet de fournir des données entièrement en mémoire via add_data() — aucune connexion à une base de données requise. Passez un nom de jeu de données et un tableau de hash où chaque valeur est une chaîne.

rpt.add_data('SalesData', [
  { 'Product' => 'PDF Library Pro',  'Revenue' => '1200.00', 'Units' => '3' },
  { 'Product' => 'Report Designer',   'Revenue' => '250.00',  'Units' => '1' },
  { 'Product' => 'Support (12 mo.)',  'Revenue' => '500.00',  'Units' => '1' },
])

data = rpt.export_to_memory('pdf')

Formats d'export