Diferencias

Muestra las diferencias entre dos versiones de la página.

--- informatica:software:aplicaciones_web:kanboard [2021/02/08 16:14] – [API] tempwin
+++ informatica:software:aplicaciones_web:kanboard [2025/09/26 14:48] (actual) – [Docker] tempwin
@@ Línea 4: / Línea 4: @@
   * [[https://kanboard.org/|Web oficial]]
+  * [[https://docs.kanboard.org/en/latest/index.html|Documentación oficial]]
+  * [[https://github.com/kanboard/kanboard|Repositorio de código oficial]] (GitHub)
+{{ https://kanboard.org/assets/img/board.png |}}
 ===== Instalación =====
 ==== Docker ====
-  * [[informatica:programas:docker:docker_compose:kanboard|Configuración para Docker Compose]].
+Ejemplo de ''docker-compose.yml'' utilizando [[informatica:sistemas_operativos:virtualizacion:docker:docker_compose|Docker Compose]]:
+<code yaml>
+version: '3.5'
+services:
+  kanboard:
+    container_name: kanboard
+    image: kanboard/kanboard
+    volumes:
+      - ./data:/var/www/app/data
+      - ./plugins:/var/www/app/plugins
+    environment:
+      - DATABASE_URL=mysql://kanboard_user:kanboard_password@database_server/kanboard_database
+    restart: unless-stopped
+</code>
+  * ''/data'': datos de la aplicación (ficheros adjuntos, base de datos Sqlite, etc)
+  * ''/plugins'': plugins de Kanboard
+  * ''DATABASE_URL'': en caso de usar MySQL/MariaDB, la conexión con la base de datos que usará Kanboard.
+El credenciales por defecto son:
+  * Usuario: ''admin''
+  * Contraseña: ''admin''
 ===== API =====
@@ Línea 27: / Línea 54: @@
 curl -u "usuario:contraseña" -d '{"jsonrpc": "2.0", "method": "getMyProjectsList", "id": 1718627783}' https://mikanboard.com/jsonrpc.php
 </code>
+Ejemplo de respuesta:
+<code javascript>
+{
+    "jsonrpc":"2.0",
+    "result": {
+        "13":"Casa",
+        "17":"IT",
+        "9":"Learning",
+        "8":"Tareas casa",
+        "19":"VPS",
+        "18":"Work",
+        "12":"tempwin.net"
+    },
+    "id":1718627783
+}
+</code>
+==== Tareas ====
+Obtener información de una tarea por su identificador:
+<code>
+curl -u "usuario:contraseña" -d '{"jsonrpc": "2.0", "method": "getTask", "id": 1718627783, "params":{"task_id":116}}' https://mikanboard.com/jsonrpc.php
+</code>
+Ejemplo de salida:
+<code javascript>
+{
+    "jsonrpc": "2.0",
+    "result": {
+        "id": "116",
+        "title": "Cambiar domiciliación impuesto circulación coche",
+        "description": "El impuesto se llama **IVTM**: Impuesto sobre Vehículos de Tracción Mecánica",
+        "date_creation": "1612271756",
+        "date_completed": null,
+        "date_due": "1614639600",
+        "color_id": "yellow",
+        "project_id": "13",
+        "column_id": "42",
+        "owner_id": "4",
+        "position": "1",
+        "score": "0",
+        "is_active": "1",
+        "category_id": "0",
+        "creator_id": "3",
+        "date_modification": "1612271967",
+        "reference": "",
+        "date_started": "1612271700",
+        "time_spent": "0",
+        "time_estimated": "0",
+        "swimlane_id": "13",
+        "date_moved": "1612271756",
+        "recurrence_status": "0",
+        "recurrence_trigger": "0",
+        "recurrence_factor": "0",
+        "recurrence_timeframe": "0",
+        "recurrence_basedate": "0",
+        "recurrence_parent": null,
+        "recurrence_child": null,
+        "priority": "0",
+        "external_provider": null,
+        "external_uri": null,
+        "url": "https://mikanboard.com/?controller=TaskViewController&action=show&task_id=116&project_id=13",
+        "color": {
+            "name": "Yellow",
+            "background": "rgb(245, 247, 196)",
+            "border": "rgb(223, 227, 45)"
+        }
+    },
+    "id": 1718627783
+}
+</code>
+Obtener tareas atrasadas de un proyecto:
+<code>
+curl -u "usuario:contraseña" -d '{"jsonrpc": "2.0",  "method": "getOverdueTasksByProject", "id": 1718627783, "params":{"project_id":1}}' https://mikanboard.com/jsonrpc.php
+</code>
+Salida:
+<code javascript>
+{
+    "jsonrpc": "2.0",
+    "result": [
+        {
+            "id": "93",
+            "title": "Modificar número de cuenta impuesto circulación",
+            "date_due": "1606777200",
+            "project_id": "1",
+            "creator_id": "3",
+            "owner_id": "3",
+            "project_name": "Mudanza - Domiciliaciones, pagos",
+            "assignee_username": "TempWin",
+            "assignee_name": "TempWin"
+        }
+    ],
+    "id": 1718627783
+}
+</code>
+===== Búsquedas =====
+  * [[https://docs.kanboard.org/v1/user/search/|Documentación sobre búsqueda avanzada]]
+==== Por etiqueta (tag) ====
+<code>
+tag:"Mi etiqueta"
+</code>
+==== Por fecha objetivo / límite ====
+Si queremos filtrar las tareas que tengan una fecha límite / objetivo:
+<code>
+due:today
+</code>
+Mostrará las tareas cuya fecha límite se cumple hoy.
+<code>
+due:<today
+</code>
+Mostrará las tareas fuera de plazo.