---
title: Migration
slug: oip-next/releases-v4-q4-migration
createdAt: 2026-10-05T10:24:00.646Z
---

Services OIP mis à jour :

- `fasstech/oip-headless` v1.2.0

Bibliothèques OIP mises à jour :

- `@fasstech/oip-core` v4.1.4
- `@fasstech/oip-starter-utils` v4.3.1
- `@fasstech/oip-tools` v4.2.0

Bien que ces nouvelles versions n'introduisent pas de changements structurels, il est nécessaire de prendre connaissance des points suivants.

# Mise à jour des dépendances

Mettre à jour les dépendances OIP dans le fichier `package.json` de votre projet :

```json
{
  "dependencies": {
    "@fasstech/oip-core": "4.1.4",
    "@fasstech/oip-starter-utils": "4.3.1"
  },
  "devDependencies": {
    "@fasstech/oip-tools": "4.2.0"
  }
}
```

# Évolution du type GraphQL Process

:::BlockQuote
\[!IMPORTANT]
Changements requis au niveau de la code-base du projet.
:::

La version **v4.3.1** de la bibliothèque **OIP Starter Utils** introduit une évolution du type GraphQL interne `Process` : un champ `clientId` est ajouté.

Par conséquent, afin de rendre votre projet compatible avec cette évolution, il est nécessaire d'ajouter le champ `clientId` à la définition GraphQL du type `ExtendedProcess` côté client et serveur.

Côté client, fichier `app/graphql/fragments/process.js` par défaut :

```javascript
import { gql } from '@apollo/client';

export const ProcessFragment = gql`
  fragment ProcessFragment on ExtendedProcess {
    projectId
    viewId
    viewData
    sessionId
    clientId
  }
`;
```

Côté serveur, fichier `server/graphql/types/extended-process-type.mjs` par défaut :

```javascript
import { gql } from 'graphql-tag';

export const ExtendedProcessType = gql`
  scalar ViewData

  type ExtendedProcess implements Process {
    projectId: ID
    viewId: ID
    viewData: ViewData
    sessionId: ID
    clientId: ID
  }
`;
```

# Fichiers docker-compose.yml et environnements Portainer (dev, recette, prod, etc.)

Mettre à jour le tag de l'image du service `oip-headless-api` en v1.2.0 :

```yaml
services:
  oip-headless-api:
    image: fasstech/oip-headless:1.2.0
    # ...
```
