---
title: "Knowledge"
description: "Artículos y guías. Cada aplicación es un módulo sobre un único modelo de datos."
canonical: "https://obop.dev/es/apps/knowledge/"
lang: "es"
---

# Knowledge

## Para qué sirve

A wiki of articles arranged in a tree, with draft, published and archived states and tags. Visibility is a label: there are no row-level permissions yet, so everyone with access to the app reads every article.

## Qué hace y qué no hace el paquete

A wiki: articles arranged in a tree through a parent article, with a draft, published, archived flow, a visibility setting and tags. Visibility is a label for the UI and for people to respect; the platform has no row-level permissions yet, so everyone with the Knowledge groups can read every article.

## Modelos

### `knowledge_article`

An article of the knowledge base

Grupo de lectura: `knowledge.user`. Grupo de escritura: `knowledge.user`.

| Campo | Tipo | Clase de datos | Datos personales | Grupo | Los agentes ven | Descripción |
|---|---|---|---|---|---|---|
| `title` | text | `none` | no | `knowledge.user` | en claro | Article title |
| `parent_id` | ref → knowledge_article | `none` | no | `knowledge.user` | en claro | The article this one is nested under; empty for a top-level article |
| `body` | longtext | `none` | no | `knowledge.user` | en claro | Article content (Markdown) |
| `visibility` | select (private, workspace, public) | `none` | no | `knowledge.user` | en claro | Who the article is meant for: private, workspace, public |
| `tags` | text | `none` | no | `knowledge.user` | en claro | Comma-separated tags, for example onboarding,hr |
| `author_name` | text | `public_directory` | sí | `knowledge.user` | enmascarado | Name of the author |
| `sequence` | number | `none` | no | `knowledge.user` | en claro | Order among its siblings, lowest first |
| `published_on` | date | `none` | no | `knowledge.user` | en claro | Day the article was published (YYYY-MM-DD) |
| `state` | select (draft, published, archived) | `none` | no | `knowledge.user` | en claro | Article status: draft, published, archived |

## Flujos de trabajo

### `knowledge_article`

| Acción | Mueve | Quién puede ejecutarla | Aprobación |
|---|---|---|---|
| `knowledge_article.publish` | state: draft → published | `knowledge.manager` | no |
| `knowledge_article.unpublish` | state: published → draft | `knowledge.manager` | no |
| `knowledge_article.archive` | state: published → archived | `knowledge.manager` | no |

## Grupos de permisos

Grupos que usa esta aplicación:

- `knowledge.manager`
- `knowledge.user`

## Pasos con aprobación

Ningún paso de esta aplicación requiere aprobación, salvo eliminar registros.

## Qué pueden y qué no pueden hacer los agentes

Un agente puede leer, buscar, crear y actualizar registros de esta aplicación, y ejecutar las acciones que no requieren aprobación, dentro de los grupos de permisos de su token.

Solo puede proponer estos pasos, y una persona debe aprobarlos: `knowledge_article.delete`.

Los datos personales se enmascaran como tokens marcadores: `knowledge_article.author_name`.

## Dependencias

Ninguna.

## Instalación

Instálala desde la aplicación Customize (Marketplace) o desde la línea de comandos:

```bash
obop modules install-from knowledge
```

Requiere una base de datos y derechos de administrador.

## Crea la tuya

[La guía de módulos explica cómo se escriben aplicaciones como esta](/es/docs/reference/module-manifest/)