Frequently Asked Questions
Have questions about how Ignifyr works or what it can do for your organization? Explore our FAQs to find answers to common queries and learn how to get the most out of Ignifyr.
General
-
What is Ignifyr, and how does it work?
Ignifyr is a powerful ETL (Extract, Transform, Load) tool that transforms healthcare data from various sources into HL7 FHIR® resources. Through its highly-functional web-based interface, you can configure the mappings, test them and execute them to generate corresponding FHIR resources and load them to a FHIR server.
-
Who can benefit from using Ignifyr?
Ignifyr is ideal for hospitals, regional health services or any healthcare organizations looking to enable data interoperability across different healthcare systems, prepare healthcare data for research or clinical use in FHIR format, and implement HL7 FHIR® standards within their infrastructure without extensive coding expertise.
-
What do I need to get started with Ignifyr?
You will need access to your data sources, a basic understanding of your data structure, and a deployment environment for Ignifyr (local, cloud, or containerized setup). Our team can assist you with the setup and configuration.
-
Is Ignifyr open-source, or do I need to purchase a license?
Ignifyr offers an open-source version that allows you to freely test its core functionality. For enhanced features such as a web-based graphical interface, high-performance scalability, advanced mapping configurations, and dedicated support, the Ignifyr Enterprise license is available.
Mapping Development
-
How long does it take to learn to develop mappings effectively with Ignifyr?
With its intuitive interface and guided tutorials, users can learn the basics of developing mappings within a few hours. Advanced mappings using the FHIRPath editor may take additional time based on your familiarity with the FHIR standard and FHIRPath expressions.
-
How long does it take to develop mappings to HL7 FHIR® within a healthcare organization?
With our team’s professional services, an initial set of mappings can be developed within 1 month given that all source data, data schema, required documentation and the infrastructure are available during the development. With extensive tests, archiving and security configurations, generally we make everything operational within 3 months.
-
What if I need to map to specific FHIR profiles, such as US Core profiles?
Ignifyr works with any FHIR profile, including US Core, the International Patient Summary (IPS), the German MII core data set and your own implementation guides. Import the profile StructureDefinitions from a FHIR server or as a ZIP file, and select a target profile, with its version, for each mapping. Ignifyr then processes the profile definitions and guides you through the required and constrained elements while you develop the mapping. Generated resources can be validated against the selected profiles on your FHIR server before you run the mapping on the full dataset.
-
Which FHIR versions does Ignifyr support?
Ignifyr supports HL7 FHIR® R4 and R5. The base resource definitions of the configured version, together with any profiles you import, are available during mapping development, and existing R4 resources can be mapped to R5.
-
Can I map my data to models other than FHIR, such as the OMOP CDM or a flat data structure?
Yes. A mapping can target a FHIR profile or a schema that you define yourself. Define the target model as a schema, for example a table of an OMOP-based common data model or any flat structure, and map to it with the same mapping language, functions and terminology services. The results are written to CSV, Parquet or NDJSON files. Ignifyr can also read FHIR resources and map them to such flat structures.
-
Can I use different tables from multiple database systems while mapping to a single FHIR resource?
Yes, Ignifyr can aggregate data from different data sources (e.g., some from a relational database, some from CSV files) to map to a single FHIR resource. 1-to-1, 1-to-many and many-to-1 mappings are possible.
-
Can I use my own terminology server during the mapping process?
Yes, Ignifyr supports external terminology servers provided that it conforms to FHIR Terminology Server specification.
-
How does Ignifyr handle code system translations, such as ICD-10 or LOINC? What terminology systems are supported?
Ignifyr can automatically integrate FHIR terminology servers and the corresponding terminology service function calls (within FHIRPath) interacts with the configured terminology server. On the other hand, Ignifyr ships with a local terminology server to which code systems, value sets and terminology translations can be loaded and then used during the mappings.
Integration and Compatibility
-
Which data source types are supported by Ignifyr?
Ignifyr supports a wide range of data sources, including file systems (CSV, TSV, Parquet, JSON, NDJSON, also inside ZIP archives or on HDFS), SQL databases over JDBC, REDCap projects, FHIR servers, and Apache Kafka streams. File folders and Kafka topics can be configured as streaming sources so that Ignifyr processes all new or updated source data as it arrives.
-
Can Ignifyr integrate with platforms like REDCap or LimeSurvey as data sources?
Yes, Ignifyr can connect to platforms like REDCap and LimeSurvey and allows you to use their data within your mappings. That is, REDCap or LimeSurvey results can be mapped to corresponding FHIR resources.
-
How does Ignifyr write or save FHIR resources after mapping?
Based on your preference, created FHIR resources can be sent to a FHIR server (such as Repofyr, HAPI, Firely etc.) as batch or transaction bundles, or saved to the file system as NDJSON, CSV or Parquet files, or as Delta Lake tables. File output can be partitioned by resource type.
-
How does Ignifyr handle very large datasets?
Ignifyr runs on Apache Spark. For sources with tens of millions of rows, the batching strategy splits a job into parameterised batches (for example by date range or ID range), runs them one after another and reports progress per batch. Recurring loads can use scheduled jobs that only pull the records changed since the previous run.
-
I don’t have a FHIR repository server. Can Ignifyr help me set one up?
Ignifyr belongs to an ecosystem of products that we develop around FHIR. We offer Repofyr that is a high-performant FHIR repository. You can also use its limited open-source version to test your Ignifyr installation.
Security and Compliance
-
Can Ignifyr be used in HIPAA-regulated environments?
Yes. Ignifyr is deployed on-premises or in your private cloud, next to your data sources, so protected health information (PHI) does not have to leave your environment. The Ignifyr API can be served over TLS, and connections to source and target FHIR servers can be secured with OAuth2 client credentials, bearer tokens or basic authentication. Every execution is logged, and Enterprise deployments can ship these logs to Elasticsearch and Kibana. HIPAA compliance also depends on your wider system, including access control, hosting and business associate agreements, and our team can help you configure Ignifyr for your requirements.
-
Does Ignifyr support GDPR-compliant processing?
Ignifyr is designed to support GDPR-compliant processing of health data. It runs inside the data controller's own infrastructure, so data residency stays under your control. Mappings let you process only the elements a use case needs (data minimisation), and execution logs record every job run and its results. In the DataTools4Heart and AI4HF projects, Ignifyr is part of a federated platform where the data of each clinical site is harmonised locally and only models and aggregate results are shared.
-
Can Ignifyr pseudonymise identifiers?
Ignifyr's mapping functions can generate deterministic hashed IDs from source identifiers, so the same patient always receives the same resource ID without the original identifier being copied. Direct identifiers and free-text fields can simply be left out of a mapping. Ignifyr does not include a full anonymisation toolkit, so techniques such as generalisation or k-anonymity should be applied with a dedicated tool before or after the transformation.
-
Where is my data processed?
Wherever you deploy Ignifyr. It is delivered as Docker images and standalone Java applications that run in your data centre or your cloud tenant, close to the data sources. Ignifyr does not send your health data to Pontegra or to any third-party service, unless you configure an external service yourself, such as a remote terminology server.
Testing and Validation
-
What tools does Ignifyr offer to ensure my mappings comply with FHIR standards?
Ignifyr provides an automated environment for testing and validating mappings and scripts at any stage of development. It offers a powerful FHIRPath editor with smart auto-completion to making it easier to create accurate mappings. Additionally, Ignifyr includes validation tools to verify that the generated FHIR resources conform to their respective FHIR profiles.
-
Can Ignifyr upgrade my existing FHIR R4 resources to the R5 version?
Yes, Ignifyr supports mappings from FHIR R4 to R5. We already have the mappings from FHIR R4 to R5, that is, once you connect Ignifyr to your data, you can transform to R5 right away.
-
Do I need to use Ignifyr every time new data needs to be mapped to my FHIR repository?
Not necessarily. Once mappings are configured, Ignifyr can automate the process and allow you to reuse mappings for recurring data transformations. This can be done through scheduled executions within Ignifyr or by configuring your source as a stream.
-
Does Ignifyr support batch and streaming data processing?
Yes, Ignifyr supports both batch processing and real-time streaming for continuous data ingestion.
-
Can I configure and monitor mapping execution directly from the Ignifyr web interface?
Yes, Ignifyr provides a user-friendly web interface where you can set up and customize your mappings and monitor the execution of mapping processing in real-time through an execution monitoring platform.
-
What support is available if I encounter issues while using Ignifyr?
Our dedicated support team is available to assist with technical issues, provide guidance, and resolve any challenges you encounter. Support plans are included with the Enterprise license.
-
Do you offer professional services to help with integration and implementation?
Yes, we offer professional integration services to help you develop mappings on Ignifyr quickly and effectively. Our team will help you to transform your data to be HL7 FHIR-ready while meeting your specific requirements.
