---
title: Résoudre la première vue
slug: oip-next/oGmL-resolution-de-la-1ere-vue-du-parcours
icon: {"lucideIcon":"📘"}
createdAt: 2025-12-04T09:40:20.000Z
---

# Vue d'ensemble

Nous avons vu dans le chapitre précédent comment résoudre l’entité *Project* associée au contexte client lors du décrochage sur l’OAV. **La résolution de la première vue du parcours&#x20;**&#x63;orrespond à la mécanique suivante, qui est exécutée par le moteur OIP pendant la phase de décrochage.

La fonction de rappel `process.resolveFirstView`, transmise en paramètre de la fonction `start` dans le fichier `server/index.mjs` de votre projet, permet de déterminer la première vue du parcours à afficher lors de l’initialisation ou de la reprise de la navigation.

***

# Fonction `process.resolveFirstView`

## Rôle

La fonction de rappel `resolveFirstView` :

- reçoit un objet contenant les informations nécessaires pour déterminer la vue initiale ;
- doit retourner l'**identifiant de la vue** souhaitée.

## Paramètres reçus

| Propriété   | Description                                                                                                           |
| ----------- | --------------------------------------------------------------------------------------------------------------------- |
| `projectId` | Identifiant de l’entité *Project* associée au décrochage                                                              |
| `viewId`    | Identifiant de la dernière vue active du parcours — présent uniquement si une session de navigation précédente existe |
| `metadata`  | Metadata associées à la dernière vue active, si disponibles                                                           |

Ces informations permettent d’implémenter une logique conditionnelle, par exemple pour :

- reprendre la navigation à la dernière vue connue ;
- décider de la première vue selon l'état du projet associé ;
- naviguer vers une vue alternative selon des règles métier.

## Valeur de retour

La fonction doit **toujours retourner l’identifiant d’une vue**.

Cette vue deviendra la première vue du parcours pour la nouvelle session de navigation.

***

# Exemple complet d’intégration

:::CodeblockTabs
index.mjs

```javascript
import { start } from '@fasstech/oip-starter-utils/server';
import { resolveFirstView } from './resolve-first-view.mjs'

const serverCfg = {
  process: {
    resolveFirstView,
  },
  // ...
};

const { app } = await start(serverCfg);
```

resolve-first-view\.mjs

```javascript
export const resolveFirstView = async ({ projectId, viewId, metadata }) => {
  // pour gérer la reprise du parcours
  if (viewId) {
    return viewId; // (ou autre viewId)
  }

  // récupération de l'entité Project
  const project = await $Project(projectId);

  // .. votre logique

  return 'my-desired-view-id';
};
```
:::

Dans cet exemple :

- la première vue du parcours est résolue grâce à la fonction de rappel `resolveFirstView` ;
- `viewId` est retourné (s'il existe) pour gérer la reprise de navigation ;
- il est possible de consommer les paramètres `projectId` et `metadata` pour déterminer dynamiquement la première vue à afficher.

***

# Résumé

Lors du décrochage, après la résolution du projet :

- `process.resolveFirstView` détermine la première vue du parcours ;
- La fonction reçoit `{ projectId, viewId, metadata }` en paramètre ;
- Un identifiant de vue valide est attendu en retour ;
- `resolveFirstView` permet d’implémenter des règles métier conditionnelles (reprise, état du projet, etc.).

La fonction de rappel `resolveFirstView` doit être définie dans la configuration du serveur passée à la fonction `start` dans `server/index.mjs`.
