---
title: StatusHistory
slug: oip-next/g-em02bcjw7k5ehp4oijv
icon: {"lucideIcon":"📘"}
createdAt: 2024-04-08T10:17:29.000Z
---

# StatusHistory

## Description

L'entité StatusHistory contient l'historique des mises à jour du statut du projet.

## Relations

### Ascendantes

| Entité  | Propriété     |
| ------- | ------------- |
| Project | statusHistory |

### Descendantes

| Entité | Propriété |
| ------ | --------- |

## Propriétés

| Nom             | Type                    | Description                                                                                                                                                                      | Validateur | Lecture seule ? | Dépréciée ?                       | Dernière version modifiée |
| --------------- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | --------------- | --------------------------------- | ------------------------- |
| metadata        | `String`                | Données additionnelles/informatives liées à l'évènement.                                                                                                                         |            |                 | Utiliser l'entité Project.History | 2.4.0                     |
| status          | `ProjectStatusEnum`     | Statut du projet                                                                                                                                                                 |            | X               |                                   | 2.2.0                     |
| type            | `StatusHistoryTypeEnum` | Indique le type d'évènement lié au statut. OPERATIONAL est relatif au cycle de vie métier de l'OAV. TECHNICAL sert à stocker des évènements techniques (audit/traçabilité, etc). |            |                 | Utiliser l'entité Project.History | 2.4.0                     |
| id              | `String`                | Identifiant de l'entité `StatusHistory`                                                                                                                                          |            | X               |                                   |                           |
| code            | `String`                | Codification fonctionnelle de l'entité `StatusHistory`                                                                                                                           |            |                 |                                   |                           |
| externalId      | `String`                | Identifiant de l'entité `StatusHistory` dans le système client                                                                                                                   |            |                 |                                   |                           |
| externalCode    | `String`                | Codification fonctionnelle de l'entité `StatusHistory` dans le système client                                                                                                    |            |                 |                                   |                           |
| statusHistoryId | `String`                | Identifiant public de l'entité `StatusHistory` dans l'OIP                                                                                                                        |            |                 |                                   |                           |
| label           | `String`                | Information relative au nom de l'entité `StatusHistory` dans son contexte d'utilisation                                                                                          |            |                 |                                   |                           |
| createdAt       | `Date`                  | Date de création de l'entité `StatusHistory`                                                                                                                                     |            | X               |                                   |                           |
| updatedAt       | `Date`                  | Date de modification de l'entité `StatusHistory`                                                                                                                                 |            | X               |                                   |                           |

## Enumérations

### StatusHistoryTypeEnum

- `OPERATIONAL`
- `TECHNICAL`

## Enumérations génériques

- ProjectStatusEnum

## Exemple

```javascript
import { Entities } from '@fasstech/oip-core';
import { getProjectId } from '@fasstech/oip-core/entities/Project';
import { getStatusHistoryCode, getStatusHistoryExternalCode, getStatusHistoryExternalId, getStatusHistoryId, getStatusHistoryLabel, getStatusHistoryMetadata, getStatusHistoryStatusHistoryId, getStatusHistoryType, setStatusHistoryCode, setStatusHistoryExternalCode, setStatusHistoryExternalId, setStatusHistoryLabel, setStatusHistoryMetadata, setStatusHistoryStatusHistoryId, setStatusHistoryType } from '@fasstech/oip-core/entities/StatusHistory';
import { StatusHistoryTypeEnum } from '@fasstech/oip-core/entities/StatusHistory/enums';
import { ProjectStatusEnum } from '@fasstech/oip-core/entities/enums';

(async () => {
  let project = await Entities('Project').create();
  const statusHistory = await Entities('StatusHistory').create();
  
  setStatusHistoryMetadata('metadata', statusHistory);
  setStatusHistoryType(StatusHistoryTypeEnum.OPERATIONAL, statusHistory);
  setStatusHistoryCode('code', statusHistory);
  setStatusHistoryExternalId('externalId', statusHistory);
  setStatusHistoryExternalCode('externalCode', statusHistory);
  setStatusHistoryStatusHistoryId('statusHistoryId', statusHistory);
  setStatusHistoryLabel('label', statusHistory);
  
  project = await Entities('StatusHistory').save(project, statusHistory);
  await Entities('Project').save(project);
  
  const projectToTest = await Entities('Project').get({ id: getProjectId(project) });
  const statusHistoryToTest = await Entities('StatusHistory').get(projectToTest, { filter: ({ id }) => id === getStatusHistoryId(statusHistory) });
  
  getStatusHistoryMetadata(statusHistoryToTest); // 'metadata'
  getStatusHistoryType(statusHistoryToTest); // StatusHistoryTypeEnum.OPERATIONAL
  getStatusHistoryCode(statusHistoryToTest); // 'code'
  getStatusHistoryExternalId(statusHistoryToTest); // 'externalId'
  getStatusHistoryExternalCode(statusHistoryToTest); // 'externalCode'
  getStatusHistoryStatusHistoryId(statusHistoryToTest); // 'statusHistoryId'
  getStatusHistoryLabel(statusHistoryToTest); // 'label'
})();
```
