Knowledge

Artículos y guías

MarketplaceContenido y documentosVersión 0.1.0manifest

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.

CampoTipoClase de datosDatos personalesGrupoLos agentes venDescripción
titletextnonenoknowledge.useren claroArticle title
parent_idref → knowledge_articlenonenoknowledge.useren claroThe article this one is nested under; empty for a top-level article
bodylongtextnonenoknowledge.useren claroArticle content (Markdown)
visibilityselect (private, workspace, public)nonenoknowledge.useren claroWho the article is meant for: private, workspace, public
tagstextnonenoknowledge.useren claroComma-separated tags, for example onboarding,hr
author_nametextpublic_directorysíknowledge.userenmascaradoName of the author
sequencenumbernonenoknowledge.useren claroOrder among its siblings, lowest first
published_ondatenonenoknowledge.useren claroDay the article was published (YYYY-MM-DD)
stateselect (draft, published, archived)nonenoknowledge.useren claroArticle status: draft, published, archived

Flujos de trabajo ​

knowledge_article ​

AcciónMueveQuién puede ejecutarlaAprobación
knowledge_article.publishstate: draft → publishedknowledge.managerno
knowledge_article.unpublishstate: published → draftknowledge.managerno
knowledge_article.archivestate: published → archivedknowledge.managerno

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