Exportar i importar instàncies
Qualsevol llista d'instàncies es pot convertir en un fitxer, i un fitxer es pot tornar a convertir en instàncies. La mateixa exportació serveix com a còpia de seguretat, com a manera de moure dades entre entorns i com a fitxer de llavors que un administrador aplica automàticament. Aquest tutorial cobreix els dos sentits.
Exportar
Obre la llista d'instàncies d'un model i fes clic a Exporta a la barra d'eines. El menú ofereix els resultats actuals en dos formats:
- Exporta els resultats (JSON) — el resultat complet de la cerca actual: s'apliquen el filtre actiu, l'ordenació i la marca d'incloure eliminades. Aquest és el format que Yellow pot tornar a llegir.
- Exporta els resultats (CSV) — les mateixes files com a full de càlcul. Obre'l amb Excel o importa'l a una altra eina. El CSV és per llegir, no per tornar-lo a importar a Yellow.
Tria un format, escull on desar el fitxer i ja està. El nom suggerit porta el nom del model.
Exportar una selecció
Quan només vols algunes files, activa la Selecció múltiple — el botonet de llista de verificació a l'esquerra de la barra de recompte, just sota la barra d'eines.
- Fes clic al botó de llista de verificació. Apareix una casella a cada fila.
- Marca les files que vulguis. La casella de l'extrem esquerre de la barra de recompte selecciona o buida totes les files carregades de cop, i una etiqueta mostra quantes n'hi ha de seleccionades.
- Torna a obrir Exporta — apareixen dues entrades noves: Exporta la selecció (JSON) i Exporta la selecció (CSV), amb el recompte.
La selecció sobreviu a la paginació i als canvis de filtre, així que pots reunir files de diverses cerques abans d'exportar. Desactivar el mode la buida.
Què hi ha dins dels fitxers
| Format | Una fila és… | Va bé per a… |
|---|---|---|
| JSON | la instància completa, amb totes les propietats i el seu identificador | tornar a importar, transferir entre entorns, fitxers de llavors |
| CSV | una línia, una columna per propietat | fulls de càlcul, informes, compartir amb persones |
Una exportació JSON pertany a un sol model — el fitxer registra quin. Les instàncies conserven els identificadors, i això és el que fa segura la reimportació: Yellow pot distingir «aquesta fila ja existeix» de «aquesta fila és nova».
Al CSV, una propietat Localized String es converteix en una columna per idioma (Name [ca], Name [en], …), les referències mostren el text que veus a pantalla, i les col·leccions s'uneixen amb ;.
Importar
Importar llegeix una exportació JSON cap al mateix model. Obre la llista d'instàncies d'aquell model, fes clic a Exporta → Importa des d'un fitxer… i tria el fitxer.
Si el fitxer pertany a un altre model, Yellow t'ho diu i s'atura — obre la llista del model correcte.
Després, tria què passa amb les instàncies que ja existeixen:
| Mode | Si la instància ja existeix | Si és nova |
|---|---|---|
| Només crea | es deixa intacta, comptada com a omesa | es crea |
| Crea i actualitza | rep una nova versió amb els valors del fitxer | es crea |
| Duplica | — totes les instàncies s'importen com a còpies amb un identificador nou | es crea |
Crea i actualitza és l'opció habitual quan retornes dades després d'editar-les fora, o quan refresques un entorn amb una exportació més nova. Només crea és l'opció segura quan només vols omplir buits. Duplica és per clonar files expressament.
Fes clic a Importa. La importació és tot o res: o bé s'apliquen totes les instàncies del fitxer, o bé — si alguna cosa falla — no se n'aplica cap, i un diàleg llista què ha fallat i a quina posició del fitxer. Corregeix el fitxer i torna-ho a provar.
Després d'una importació correcta la llista es refresca i un missatge mostra els recomptes: creades, actualitzades, omeses.
Coses que val la pena saber
- Les referències viatgen per identificador. Una referència dins del fitxer apunta a la seva instància de destinació. Les destinacions que també són al fitxer es resolen automàticament, en qualsevol ordre. Les de fora del fitxer han d'existir prèviament a l'entorn, o la importació informa d'un error.
- Les actualitzacions creen versions. «Crea i actualitza» no sobreescriu mai en silenci — els valors anteriors queden a l'historial de versions de la instància.
- Els permisos s'apliquen. Exportar requereix permís per llistar les instàncies del model; importar requereix permís per crear-les (i per actualitzar-les, en el cas de «Crea i actualitza»).
Relacionat
- Filtrar i trobar instàncies — dona forma a la cerca que exportes.
- Fitxers de llavors — fes que una exportació s'apliqui automàticament als entorns.
- Copiar dades entre entorns — l'assistent per a còpies massives entre entorns.