docs: databases under connections

i18n/ca/_build_forms/expressions/placeholders.md

@@ -3,7 +3,7 @@ layout: default
 title: Marcadors
 parent: Expressions
 nav_order: 0.5
-translated_from: bd63e437a4f77c707a1bf8d8ee99b1516063b62a
+translated_from: 7b1ef975e0d5d92c446f050ffda02ee4acfa97aa
 ---
 
 # Marcadors
@@ -31,7 +31,7 @@ valor, i es torna a avaluar cada vegada que aquest valor canvia. Així es constr
   values: [Amsterdam, Brussels]
 - name: datacenter
   type: enum
-  dbConfig: { name: CMDB, type: mysql }
+  dbConfig: CMDB            # a database of Connections > Databases
   query: select name from cmdb.datacenter where city='$(city)'
 ```
 
@@ -73,7 +73,7 @@ Posar `placeholderColumn: "*"` en un enum fa que `$(field)` doni tot el registre
 ```yaml
 - name: city
   type: enum
-  dbConfig: { name: CMDB, type: mysql }
+  dbConfig: CMDB
   query: select id, name from cmdb.city
   valueColumn: name
   placeholderColumn: id        # $(city) gives the id; $(city.name) still gives the name

i18n/ca/_build_forms/formfields/list.md

@@ -3,7 +3,7 @@ layout: default
 title: List
 parent: Camps de formulari
 nav_order: 13
-translated_from: b6209effaf1cc9783a27c36669004a239751fb3e
+translated_from: c454e7962323f4d82488bbdd30f92a7619162c32
 ---
 
 # Camp List
@@ -285,6 +285,9 @@ Files carregades des d'una consulta a base de dades:
   query: SELECT hostname, role FROM servers WHERE active = 1
 ```
 
+`dbConfig` nomena una [base de dades](../databases.html) de **Connexions > Bases de dades** (des de la 7.5.0), o si no una credencial de tipus base de
+dades, com abans (vegeu [Bases de dades als formularis](../databases/in-forms.html)).
+
 #### Des d'una expressió local (`runLocal`)
 
 Files calculades al navegador per una expressió local:

i18n/ca/_build_forms/formfields/yaml.md

@@ -3,7 +3,7 @@ layout: default
 title: YAML
 parent: Camps de formulari
 nav_order: 14
-translated_from: c7439c165a54cf525a91d0458a268a66ee8a136f
+translated_from: 8dde3e82c2a53e38adc729f5a8f3764b182718c7
 ---
 
 # Camp YAML
@@ -152,9 +152,7 @@ Fes-hi referència amb la sintaxi d'expressió estàndard `$(...)` a les definic
       label: VLAN
       # filter available VLANs based on the parent's selected region
       query: "select id,name from vlans where region='$(__parent__.region)'"
-      dbConfig:
-        name: MYDB
-        type: mysql
+      dbConfig: MYDB      # a database of Connections > Databases
       valueColumn: id
       placeholderColumn: name
 

i18n/ca/_configure/credentials.md

@@ -5,7 +5,7 @@ nav_order: 6
 has_children: true
 has_toc: false
 permalink: /credentials.html
-translated_from: 08110077a1cf59a4a52e078fc2ebc252f7cae48d
+translated_from: 0c8fddace3f97bb7d5a3a2642e3fccc296680454
 ---
 
 # Credencials
@@ -40,6 +40,9 @@ s'hi refereixen pel seu nom, de manera que la contrasenya mai no apareix en un f
 base de dades d'AnsibleForms, xifrats amb `ENCRYPTION_SECRET`, o bé es llegeixen d'un [magatzem de secrets](secret-stores/) cada vegada que
 s'utilitza la credencial.
 
+Des de la 7.5.0 els formularis consulten una [base de dades](databases.html) de **Connexions > Bases de dades**, que nomena la credencial de tipus
+**Base de dades** amb què es connecta; un formulari que nomena la mateixa credencial al `dbConfig` encara funciona, com abans.
+
 ---
 
 ## Qui pot canviar una credencial
@@ -69,6 +72,7 @@ mantenen aquests usuaris lluny de secrets que d'una altra manera no podrien lleg
 
 ## Credencials en ús
 
-Una credencial que encara nomenen altres registres no es pot suprimir ni reanomenar, perquè quedarien apuntant a res.
+Una credencial que encara nomenen altres registres, entre ells una [base de dades](databases.html) des de la 7.5.0, no es pot suprimir ni
+reanomenar, perquè quedarien apuntant a res.
 El rebuig indica quants registres la utilitzen; la pestanya **Usat per** de [la seva pàgina](credentials/credential-page.html) els llista.
 Apunta'ls primer a una altra credencial, i després suprimeix-la o reanomena-la.

i18n/ca/_configure/credentials/credential-page.md

@@ -3,7 +3,7 @@ layout: default
 title: "La pàgina d'una credencial"
 parent: Credencials
 nav_order: 3
-translated_from: 0269b5c0d313622bea6c910b96231f41ffd852d7
+translated_from: 204eca949763c8c23625369f1d8d8d0d06545c87
 ---
 
 # La pàgina d'una credencial
@@ -20,7 +20,7 @@ La pàgina d'una credencial mostra els passos del seu diàleg com a pestanyes, m
 | Tipus | Per a què serveix la credencial. |
 | Accés | Tots els camps del seu tipus, com al pas **Accés** del diàleg: l'usuari, la contrasenya i on inicia sessió (host i port, la base de dades, el servidor de correu, els servidors del directori, el tenant o l'emissor, l'adreça del servidor i el seu TLS). L'AppID, el certificat de client i la clau d'una credencial CyberArk. |
 | Magatzem | Base de dades o Magatzem de secrets, i el magatzem i la referència. No per a CyberArk ni HashiCorp Vault. |
-| Usat per | Tot el que nomena aquesta credencial: magatzems de secrets, canals de notificació, repositoris, directoris LDAP, proveïdors SSO, runners, l'assistent de xat, formularis i els workflows del dissenyador. Una fila l'obre. |
+| Usat per | Tot el que nomena aquesta credencial: magatzems de secrets, canals de notificació, repositoris, directoris LDAP, proveïdors SSO, runners, [bases de dades](../databases.html) (des de la 7.5.0), l'assistent de xat, formularis i els workflows del dissenyador. Una fila l'obre. |
 
 La contrasenya s'escriu a la pestanya **Accés** i no es torna a mostrar mai un cop desada: si es deixa buida, es conserva la desada. En una credencial
 CyberArk, deixa buida la clau de client per conservar la desada. A dalt a la dreta hi ha **Prova la connexió** (només credencials de base de dades),

i18n/ca/_configure/credentials/types.md

@@ -3,7 +3,7 @@ layout: default
 title: Tipus de credencial
 parent: Credencials
 nav_order: 1
-translated_from: 1f21f8fc1ae73953922d8c9f21de6db05b3b1a87
+translated_from: 2782b0144b1442eceb8684fb1407827cef5fde8f
 ---
 
 # Tipus de credencial
@@ -27,7 +27,7 @@ El tipus indica per a què serveix una credencial. Decideix quins camps demana e
 | SSH | Un usuari i una contrasenya per a SSH a un servidor, amb el seu host i el seu port | Playbooks, mitjançant les `credentials` o `ansibleCredentials` d'un formulari o un camp de credencial, i l'accés d'un node de workflow |
 | Git | Un usuari i una contrasenya o un token per a repositoris git | [Repositoris](../repositories/authentication.html) |
 | API | Un usuari i una contrasenya o un token per a una API REST | [Expressions REST](../expressions/credentials.html), el token d'un bot de Telegram, el bearer token d'un webhook, la clau d'API de l'assistent de xat |
-| Base de dades | Un accés a base de dades, amb el seu tipus, host, port i nom de base de dades | Consultes de formularis (`dbConfig`) i `fnCredentials`; es pot provar |
+| Base de dades | Un accés a base de dades, amb el seu tipus, host, port i nom de base de dades | Una [base de dades](../databases.html) que consulten els formularis (`dbConfig`), des de la 7.5.0, o directament el `dbConfig` d'un formulari; `fnCredentials`; es pot provar |
 | CyberArk | L'adreça del CyberArk Central Credential Provider (CCP) i el seu TLS, i l'AppID, el certificat de client i la clau amb què accedeix un magatzem CyberArk | Un magatzem de secrets [CyberArk](../secret-stores/cyberark.html) |
 | SMTP | Un servidor de correu, el seu port i TLS, i el seu accés (cap per a un relay) | Un [canal de notificació](../notification-channels.html) de correu |
 | LDAP | Els servidors, el port, el TLS i els certificats d'un directori, i el seu DN i contrasenya de bind | Un [directori LDAP](../authentication/ldap.html) |
@@ -39,7 +39,8 @@ El tipus indica per a què serveix una credencial. Decideix quins camps demana e
 | Jenkins | Un usuari, el seu token d'API i l'adreça d'un Jenkins | Un runner Jenkins |
 | HashiCorp Vault | El token i l'adreça amb què accedeix un magatzem Vault | Un magatzem de secrets [HashiCorp Vault](../secret-stores/hashicorp-vault.html) |
 
-Una credencial de base de dades pot ser de tipus MySQL, MSSQL, PostgreSQL, Oracle o MongoDB.
+Una credencial de base de dades pot ser de tipus MySQL, MSSQL, PostgreSQL, Oracle o MongoDB. Des de la 7.5.0 la tria una base de dades de
+[Connexions > Bases de dades](../databases.html), i l'actualització a la 7.5.0 en crea una per a cadascuna, amb el mateix nom.
 
 A l'API i a la [llavor de configuració](../seed/), els tipus són `userpass`, `ssh`, `git`, `api`, `database`, `cyberark`, `smtp`,
 `ldap`, `entraid`, `oidc`, `rte`, `awx`, `aap`, `ascender`, `semaphore`, `rundeck`, `jenkins` i `vault`. L'actualització des de la 6

i18n/ca/_configure/customization/index.md

@@ -1,11 +1,11 @@
 ---
 layout: default
 title: Variables d'entorn
-nav_order: 8
+nav_order: 9
 has_children: true
 has_toc: false
 permalink: /customization/
-translated_from: fd6e83f3550f59aa576c8addaf28bfa6115b96a0
+translated_from: e0bc1d7c5bd2df4a3f9036a2d9413a276b228156
 ---
 
 # Variables d'entorn

i18n/ca/_configure/databases.md

@@ -0,0 +1,150 @@
+---
+layout: default
+title: Bases de dades
+nav_order: 7
+has_children: true
+has_toc: false
+permalink: /databases.html
+translated_from: 7c14f8dd95d2314974c54a3f2c5aba279410d822
+---
+
+# Bases de dades
+{: .no_toc }
+
+Les bases de dades que consulten els formularis, amb la seva credencial
+{: .fs-6 .fw-300 }
+
+1. TOC
+{:toc}
+
+---
+
+Per a administradors: anomena les bases de dades que consulten els formularis, tria la credencial amb què es connecta cadascuna i prova-les.
+
+---
+
+## En aquesta secció
+
+| Pàgina | Què hi trobaràs |
+|---|---|
+| [La pàgina de bases de dades](databases/list.html) | La llista de bases de dades, les seves columnes i el diàleg que n'afegeix una |
+| [La pàgina d'una base de dades](databases/database-page.html) | Les pestanyes d'una base de dades, els formularis que la consulten, Prova la connexió i Suprimeix |
+| [Bases de dades als formularis](databases/in-forms.html) | Com el `dbConfig` d'un camp nomena una base de dades, i els formularis escrits abans de la 7.5.0 |
+
+---
+
+## Com funciona
+
+Des de la 7.5.0 una **base de dades** és una connexió pròpia, que s'afegeix a **Connexions > Bases de dades**, entre **Magatzems de secrets** i **Runners**.
+Té tres coses:
+
+| Camp | Què és |
+|---|---|
+| Nom | El nom que dona el `dbConfig` d'un camp per consultar-la, com ara `cmdb` |
+| Descripció | Per a què serveix |
+| Credencial | La credencial de [Connexions > Credencials](credentials.html), de tipus **Base de dades**, amb què es connecta |
+
+La credencial conserva tot el que fa referència a la connexió, com abans: el tipus de base de dades (MySQL, MSSQL, PostgreSQL, Oracle o MongoDB),
+el host i el port, el nom de la base de dades, el TLS, i l'usuari i la contrasenya, desats xifrats o llegits d'un [magatzem de secrets](secret-stores/).
+Una base de dades no té cap adreça ni cap secret propis, així que una base de dades i un runner trien la seva credencial de la mateixa manera.
+
+Un camp consulta una base de dades nomenant-la al `dbConfig`:
+
+```yaml
+- name: city
+  type: enum
+  dbConfig: cmdb            # a database of Connections > Databases
+  query: select name from cmdb.city
+```
+
+Un nom que no és cap base de dades es busca com una credencial de tipus base de dades, com abans de la 7.5.0, de manera que els formularis més antics
+continuen funcionant sense canvis (vegeu [Bases de dades als formularis](databases/in-forms.html)).
+
+---
+
+## Actualitzar a la 7.5.0
+
+L'actualització omple **Connexions > Bases de dades** una sola vegada, perquè els formularis que tens continuïn funcionant sense cap canvi.
+
+Crea una base de dades per a cada credencial de tipus base de dades, amb el nom i la descripció de la credencial, que es connecta amb aquesta
+credencial. Un formulari el `dbConfig` del qual nomena la credencial ara troba la base de dades del mateix nom, que es connecta amb la mateixa
+credencial: el resultat és el mateix. Les credencials conserven tots els seus camps.
+
+L'actualització només s'executa una vegada: una base de dades suprimida després no es torna a crear, i una credencial de base de dades afegida més tard
+no té cap base de dades fins que n'afegeixes una.
+
+---
+
+## Credencials en ús
+
+Una credencial amb què es connecta una base de dades està en ús, com la credencial amb què inicia sessió un runner.
+
+No es pot suprimir ni reanomenar mentre una base de dades la nomena, i la pestanya **Usat per** de la seva pàgina llista les bases de dades (vegeu
+[Credencials en ús](credentials.html#credentials-in-use)). Suprimir una base de dades deixa la seva credencial tal com està.
+
+---
+
+## Qui gestiona les bases de dades
+
+Les bases de dades segueixen les opcions de rol de les credencials que nomenen.
+
+La llista, la pàgina d'una base de dades i la seva API necessiten l'opció de rol `showSettings` o `showConnectionsSettings`, com les credencials.
+Només un admin pot fer que una base de dades es connecti amb una credencial que només un admin pot nomenar, com ara una que llegeix la seva
+contrasenya d'un magatzem de secrets (vegeu [Qui pot canviar una credencial](credentials.html#who-may-change-a-credential)): els formularis que la
+consulten es connectarien amb aquesta credencial, i **Prova la connexió** enviaria el seu secret al seu servidor. Un altre usuari pot tornar a desar una
+base de dades amb la credencial que ja nomena.
+
+Una base de dades declarada a la [llavor de configuració](seed/) és només de lectura a la seva pàgina: canvia-la al fitxer de la llavor.
+
+---
+
+## La llavor de configuració
+
+Una llavor declara les seves bases de dades en una secció `databases:`, després de les credencials que nomenen.
+
+Cada element té un `name`, una `credential` de tipus base de dades i, opcionalment, una `description`. La credencial pot venir de la secció
+`credentials` de la mateixa llavor o ser una creada a l'aplicació:
+
+```yaml
+credentials:
+  items:
+    - name: cmdb-login
+      credential_type: database
+      db_type: mysql
+      host: cmdb.example.com
+      port: 3306
+      user: svc_forms
+      password: ${SEED_CMDB_PW}
+
+databases:
+  items:
+    - name: cmdb                 # the name a field's dbConfig gives
+      description: The CMDB
+      credential: cmdb-login     # a credential of type database
+```
+
+Vegeu l'[exemple](seed/example.html) complet i [Objectes gestionats](seed/managed-objects.html) per saber com la llavor es fa seu el que declara.
+
+---
+
+## L'API REST
+
+Els scripts gestionen les bases de dades a través de l'[API REST](api/), sota `/api/v2/database`, amb les mateixes opcions de rol que la pàgina.
+
+| Crida | Què fa |
+|---|---|
+| `GET /api/v2/database` | Llista les bases de dades, cadascuna amb el tipus de base de dades, la base de dades, el host i el port de la seva credencial, i quants formularis la consulten (`used_by_count`) |
+| `GET /api/v2/database?name=<name>` | Obté la base de dades d'aquest nom |
+| `GET /api/v2/database/<id>` | Obté una base de dades |
+| `POST /api/v2/database` | Afegeix una base de dades: el seu `name`, la seva `credential` i, opcionalment, la seva `description` |
+| `PUT /api/v2/database/<id>` | Canvia una base de dades |
+| `DELETE /api/v2/database/<id>` | Suprimeix una base de dades; la seva credencial es queda |
+| `POST /api/v2/database/<id>/check` | Prova la seva connexió, amb la seva credencial |
+
+```bash
+curl -X POST https://forms.example.com/api/v2/database \
+  -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
+  -d '{ "name": "cmdb", "description": "The CMDB", "credential": "cmdb-login" }'
+```
+
+Una `credential` que no existeix, o que no és de tipus base de dades, es rebutja amb `400`. Cada canvi s'escriu al registre d'auditoria.

i18n/ca/_configure/databases/database-page.md

@@ -0,0 +1,61 @@
+---
+layout: default
+title: "La pàgina d'una base de dades"
+parent: Bases de dades
+nav_order: 2
+translated_from: b027ce5ca33397772148bb221bd9eaab4984f276
+---
+
+# La pàgina d'una base de dades
+{: .no_toc }
+
+Les pestanyes, els formularis que la consulten, provar-la i suprimir-la
+{: .fs-6 .fw-300 }
+
+1. TOC
+{:toc}
+
+---
+
+## Pestanyes
+
+La pàgina d'una base de dades mostra els passos del seu diàleg com a pestanyes, més els formularis que la consulten:
+
+| Pestanya | Què conté |
+|---|---|
+| Detalls | El **Nom**, el que dona el `dbConfig` d'un camp, i la **Descripció** |
+| Credencials | La **Credencial** amb què es connecta, una credencial de Connexions > Credencials de tipus **Base de dades**, que conté el seu tipus de base de dades, host, port, base de dades, TLS i accés |
+| Usat per | Els formularis que la consulten, amb el recompte a la pestanya, vegeu [Usat per](#used-by) |
+
+Cada pestanya té la seva pròpia adreça, com ara `/settings/databases/<id>/used-by`, de manera que un enllaç o una adreça d'interès l'obre. La cerca de la
+línia del títol filtra totes les pestanyes alhora.
+
+A la pestanya **Credencials**, **Afegeix una credencial** crea una credencial nova de tipus **Base de dades** i la tria. Una contrasenya no es torna a
+mostrar mai un cop desada: canvia-la a la credencial.
+
+---
+
+## Usat per
+
+La pestanya **Usat per** llista els formularis amb camps que consulten la base de dades, tal com l'aplicació els llegeix dels formularis.
+
+| Columna | Què mostra |
+|---|---|
+| Formulari | El formulari; una fila l'obre |
+| Descripció | La descripció del formulari |
+| Camp | Els camps d'aquest formulari el `dbConfig` dels quals nomena la base de dades |
+
+Un camp compta quan el seu `dbConfig` nomena la base de dades, o nomena la seva credencial, com fa un formulari escrit abans de la 7.5.0. Tots dos
+es connecten amb la mateixa credencial, així que tots dos es llisten. Quan no n'hi ha cap, la pestanya diu **Cap formulari no consulta aquesta base de dades.**
+
+---
+
+## Prova la connexió i Suprimeix
+
+Els botons de dalt a la dreta actuen sobre la base de dades tal com està desada.
+
+**Prova la connexió** es connecta amb la seva credencial i executa la consulta mínima del seu tipus de base de dades, i després ho indica en un missatge,
+**&lt;name&gt; connection ok**, o per què ha fallat. És la mateixa prova que la **Prova la connexió** de la credencial mateixa.
+
+**Suprimeix** demana confirmació, després suprimeix la base de dades i torna a la llista. La seva credencial es queda a **Connexions > Credencials**.
+Al seu costat, **Desa** desa les pestanyes Detalls i Credencials.