---
title: Les Contrôleurs
slug: oip-next/ahuwtsnxr4wjbfpadd39
description: Learn about the various controllers offered by OIP-Core, including processAction, getProcess, getProject, goto, runTask, linkProject, and getView. These controllers handle transition logic and enable the connection between the current session and project.
icon: {"lucideIcon":"📘"}
createdAt: 2023-04-03T14:02:46.000Z
---

*Cette page décrit les différents contrôleurs exposés par l'OIP-Core, notamment&#x20;*`processAction`*qui \*\*gère la transition \*\*d'une vue à l'autre,&#x20;*`getProcess`*&#x20;qui récupère le&#x20;*`process`*&#x20;actuel,&#x20;*`getProject`*&#x20;qui récupère le projet à partir d'un&#x20;*`process`*,&#x20;*`goto`*qui gère la transition vers une vue spécifique et&#x20;*`runTask`*qui gère l'exécution d'une tâche.&#x20;*

*Ces contrôleurs gèrent les logiques de transitions et permettent d'exposer au niveau de l'OAV un contexte depuis l'objet&#x20;*`process`*&#x20;qui relie la session courante au projet courant.*

## Liste des contrôleurs exposés :

### getProcess

Paramètres : `{ sessionId, projectId }`

Ce contrôleur permet de récupérer un `process` par `sessionId` ou par la paire `{ sessionId, projectId }` si `projectId` est aussi passé en paramètre.

Si le `process` n'est pas trouvé, un nouveau `process` est alors créé.

Si un nouveau `process` est créé pour la paire `{ sessionId, projectId }`, `viewId` et `actions` seront définis par rapport au dernier `process` mis à jour lié au même `projectId` (si il existe) pour gérer la reprise au niveau de l'OAV.

Le `process` trouvé (ou créé) est retourné.

***Exemple :***

```javascript
import { getProcess } from '@fasstech/oip-core/controllers';

const process = await getProcess({ 
  sessionId: 'my-session-id',
  projectId: 'my-project-id'
});

console.log(process);
```

### processAction

Paramètres : `{ sessionId, projectId, action, object, goto }`

Ce contrôleur gère la logique de transition d'une vue à l'autre en fonction de l'action spécifiée.&#x20;`action` doit correspondre à une action déclarée dans le fichier de configuration de la vue courrante.

La logique de transition est appelée, `viewId` et `actions` du `process` concerné sont mis à jour.

Si `projectId` est passé également en paramètre, `viewId` et `actions` sont mis à jour pour chaque `process` lié au `projectId` spécifié. Ce qui permet une reprise continue pour toutes les sessions liées à ce projet.

Le `process` mis à jour est retourné.

***Exemple :***

```javascript
import { processAction } from '@fasstech/oip-core/controllers';

const process = await processAction({ 
  sessionId: 'my-session-id',
  projectId: 'my-project-id',
  action: 'HOME_NEXT'
});

console.log(process);
```

### goto

Paramètres : `process, viewId`

Ce contrôleur gère la logique de transition vers une vue spécifique. Il prend en paramètres le processus (`process`) courant et l'identifiant de la vue désirée (`viewId`). L'identifiant de la vue (`viewId`) doit correspondre à l'id d'une vue déclarée dans les fichiers de configuration des vues.&#x20;

L'identifiant de la vue (`viewId`) et les actions (`actions`) du processus (`process`) concerné sont mis à jour.

Le `process` mis à jour est retourné.

***Exemple :***

```javascript
import { goto } from '@fasstech/oip-core/controllers';

const process = await getProcess({ 
  sessionId: 'my-session-id',
  projectId: 'my-project-id'
});

const updatedProcess = await goto(process, 'START');

console.log(updatedProcess);
```

### linkProject

Paramètres : `{ sessionId, projectId, viewId }`

Ce contrôleur permet de lier un projet au `process` ciblé par `sessionId`.  `viewId` doit correspondre à l'id d'une vue déclarée dans les fichiers de configuration des vues.

`viewId` et `actions` du `process` ciblé seront définis par rapport au dernier `process` mis à jour lié au `projectId` spécifié (si il existe) pour gérer la reprise au niveau de l'OAV.

Le `process` mis à jour est retourné ou `null` si `projectId` est omis, nul ou indéfini.

***Exemple :***

```javascript
import { linkProject } from '@fasstech/oip-core/controllers';

const process = await linkProject({ 
  sessionId: 'my-session-id',
  projectId: 'my-project-id',
  viewId: 'START'
});

console.log(process);
```

### getProject

Paramètres : `process`

Ce contrôleur permet de récupérer l'entité projet lié au `process` passé en paramètre.

Si `projectId` du `process` passé en paramètre est nul ou indéfini, un nouveau projet est créé et le `process` est mis à jour pour le lier au projet créé (ajout de `projectId`).

L'entité projet correspondante est retournée.

***Exemple :***

```javascript
import { getProject } from '@fasstech/oip-core/controllers';

const process = await getProcess({ 
  sessionId: 'my-session-id',
  projectId: 'my-project-id'
});

const project = await getProject(process);

console.log(project);
```

### runTask

:::hint{type="warning"}
Ce\_contrôleur\_est\_déprécié\_à\_partir\_de\_la\_version\_2.2.0.*Voir*[Gestions\_des\_tasks](https://doc.fasst.tech/oip-next/awj0vvxdigwzaunohfnj) pour en apprendre davantage sur la gestion des tâches et les contrôleurs liés.
:::

Paramètres : `{ sessionId, projectId, taskName }`

Ce contrôleur gère l'exécution d'une tâche ciblée par `taskName`. Le `process` ciblé par `sessionId` ou par `{ sessionId, projectId }` si `projectId` est aussi passé en paramètre, est alors mis à jour. L'objet de la forme `taskName: { taskId, status, statusCode }` est ajouté ou mis à jour dans le tableau `tasks` du `process` ciblé.

Une erreur est renvoyée si `taskName` est omis ou si `taskName` n'est pas trouvé au niveau de la configuration de l'OIP.

Le `process` mis à jour est retourné.

### getView

:::hint{type="info"}
Ce contrôleur est disponible à partir de la version 2.5.0
:::

Paramètres : `{ projectId }`

Ce contrôleur permet de récupérer les informations de la vue courante depuis le ou les `process` liés au `projectId` passé en paramètre.

***Exemple :***

```javascript
import { getView } from '@fasstech/oip-core/controllers';

const view = await getView({ projectId: 'my-project-id' });

console.log(view);
```
