> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Fabric

> Synchronisez les événements personnalisés de Microsoft Fabric vers OneSignal pour déclencher des parcours automatisés et des campagnes de messagerie personnalisées basées sur le comportement des utilisateurs.

export const DATA_TYPE_0 = "table columns"

export const PLATFORM_0 = "Microsoft Fabric"

export const COLUMN_HEADER_0 = "Fabric Column"

export const PROPERTIES_DESCRIPTION_0 = "JSON object with event metadata"

## Vue d'ensemble

L'intégration OneSignal + Microsoft Fabric permet la synchronisation automatique des événements personnalisés depuis votre lakehouse ou entrepôt Fabric vers OneSignal pour déclencher des campagnes de messagerie automatisées et des parcours basés sur le comportement des utilisateurs.

Microsoft Fabric est une plateforme d'analytique unifiée qui rassemble l'ingénierie des données, la science des données, l'analytique en temps réel et l'intelligence d'affaires dans un environnement unique.

***

## Prérequis

* Accès aux [Event Streams](/docs/en/event-streams) pour les événements de message sortants (Les limitations de forfait et les dépassements s'appliquent)
* Accès aux [Événements personnalisés](/docs/en/custom-events) pour la synchronisation des événements entrants (Les limitations de forfait et les dépassements s'appliquent)
* [Forfait de compte mis à jour](https://onesignal.com/pricing) (non disponible sur les applications gratuites)

### Microsoft Fabric

* **Capacité Microsoft Fabric** avec accès à l'espace de travail
* **Principal de service** avec les permissions appropriées
* **Point de terminaison SQL** (Entrepôt ou Lakehouse) contenant les données d'événement
* **Accès à l'API externe** activé dans les paramètres du locataire

***

## Configuration

<Steps>
  <Step title="Créer un principal de service dans Azure">
    Créez un nouveau principal de service pour permettre à OneSignal d'accéder à vos ressources Fabric :

    1. Connectez-vous au portail Azure
    2. Naviguez vers **Microsoft Entra ID** > **Inscriptions d'applications**
    3. Cliquez sur **+ Nouvelle inscription**
    4. Entrez le nom : "OneSignal Fabric Integration"
    5. Sélectionnez **Comptes dans cet annuaire organisationnel uniquement**
    6. Cliquez sur **Inscrire**
    7. Notez l'**ID d'application (client)** et l'**ID d'annuaire (locataire)**
    8. Sous **Certificats et secrets**, créez un nouveau secret client
    9. Notez la **valeur du secret client**
  </Step>

  <Step title="Configurer les paramètres du locataire Fabric">
    Activez l'accès externe pour les principaux de service :

    1. Dans Microsoft Fabric, cliquez sur **Paramètres** > **Portail d'administration**
    2. Allez dans **Paramètres du locataire**
    3. Sous **Paramètres développeur**, activez **Les principaux de service peuvent utiliser les API Fabric**
    4. Sous **Paramètres OneLake**, activez **Les utilisateurs peuvent accéder aux données stockées dans OneLake avec des applications externes à Fabric**
  </Step>

  <Step title="Accorder l'accès à l'espace de travail">
    Ajoutez le principal de service à votre espace de travail Fabric :

    1. Naviguez vers votre espace de travail (créez un espace de travail partagé si vous utilisez "Mon espace de travail")
    2. Cliquez sur **Gérer l'accès** > **+ Ajouter des personnes ou des groupes**
    3. Sélectionnez votre principal de service
    4. Définissez le rôle sur **Contributeur**
  </Step>

  <Step title="Obtenir le point de terminaison SQL">
    Obtenez la chaîne de connexion SQL pour votre source de données :

    1. Dans votre espace de travail, survolez votre entrepôt/lakehouse
    2. Cliquez sur **...** > **Paramètres**
    3. Copiez la **chaîne de connexion SQL** (c'est votre nom d'hôte)
  </Step>

  <Step title="Se connecter à OneSignal">
    Dans OneSignal, allez dans **Data > Integrations** et cliquez sur **Add Integration**.

    Sélectionnez **Microsoft Fabric** et fournissez :

    * **Nom d'hôte :** Point de terminaison SQL de l'étape 4
    * **Base de données/Catalogue :** Le nom de votre lakehouse ou entrepôt
    * **ID du locataire :** ID d'annuaire de l'étape 1
    * **ID client :** ID d'application de l'étape 1
    * **Secret client :** Valeur du secret de l'étape 1
  </Step>
</Steps>

***

### Mappage des données d'événement

Mappez vos {DATA_TYPE_0} {PLATFORM_0} au format des événements personnalisés de OneSignal :

| Champ OneSignal | {COLUMN_HEADER_0} | Description                     | Requis |
| --------------- | ----------------- | ------------------------------- | ------ |
| `name`          | `event_name`      | Identifiant de l'événement      | Oui    |
| `external_id`   | `user_id`         | Identifiant de l'utilisateur    | Oui    |
| `timestamp`     | `event_timestamp` | Quand l'événement s'est produit | Non    |
| `properties`    | `event_data`      | {PROPERTIES_DESCRIPTION_0}      | Non    |

### Exemple de schéma de table d'événements

```sql theme={null}
-- Exemple de structure de table Fabric
CREATE TABLE user_events (
    event_name STRING,
    user_id STRING,
    event_time TIMESTAMP,
    properties JSON,
    session_id STRING,
    device_type STRING
);
```

***

## Modes de traitement

### Mode requête SQL

Rédigez des requêtes SQL personnalisées pour transformer vos données Fabric avant la synchronisation :

```sql theme={null}
SELECT
    event_name,
    user_id,
    event_time,
    TO_JSON(STRUCT(
        session_id,
        device_type,
        product_id
    )) as properties
FROM user_events
WHERE event_time >= CURRENT_DATE - INTERVAL 7 DAYS
```

### Mode table

Synchronisez des tables ou des vues entières directement depuis votre espace de travail Fabric. OneSignal mappera automatiquement les colonnes aux champs d'événement.

***

## Limitations

* Nécessite une capacité Fabric (non disponible en version d'essai)
* Les points de terminaison SQL doivent être accessibles aux services externes
* Les grands ensembles de résultats peuvent affecter les performances de synchronisation

***

## FAQ

### Comment optimiser les performances des requêtes ?

Utilisez le partitionnement et l'indexation dans vos tables Fabric. Envisagez de créer des vues matérialisées pour les données d'événement fréquemment consultées.

### Puis-je synchroniser à partir de lakehouses et d'entrepôts ?

Oui, OneSignal prend en charge toute ressource Fabric qui expose un point de terminaison SQL, y compris les lakehouses, les entrepôts et les points de terminaison d'analytique SQL.

***