---
title: Guía para la migración a catálogo
slug: Guía_para_la_migración_a_catálogo
tags:
  - NeedsContent
  - Places
---
<p>{{ Fx_minversion_header(3) }}
Este documento es para los desarrolladores de aplicaciones y extensiones que tienen código los API de los marcadores y de el historial es Firefox 2 y anteriores y que están migrando a Firefox 3.
</p>
<h2 id="Visi.C3.B3n_general" name="Visi.C3.B3n_general">Visión general</h2>
<p><a href="es/Cat%c3%a1logo">Catálogo</a> es un conjunto de API para la administración del historial de navegación y los meta datos de las URI. Esto incluye historial, marcadores, pestañas, favicons y anotaciones. Existen dos modelos de identidad en el sistema: URI e identificadores únicos para elementos del sistema de marcadores. Algunos de los API están centrados en URI, mientras que otros usan identificadores de elementos. La firma del API y su contexto, generalmente dejan claro qué modelo se requiere.
</p>
<h2 id="Marcadores" name="Marcadores"> Marcadores </h2>
<p>El servicio del toolkit marcadores es {{ Source("toolkit/components/places/public/nsINavBookmarksService.idl", "nsINavBookmarksService") }}:
</p>
<pre>var bookmarks = Cc["@mozilla.org/browser/nav-bookmarks-service;1"].
                getService(Ci.nsINavBookmarksService);
</pre>
<p>EL almacenamiento de los marcadores es jerárquico, sirviendo de modelo a las carpetas y su contenido. Varias carpetas significativas están disponibles como atributos de {{ Interface("nsINavBookmarksService") }}.
</p>
<ul><li> nsINavBookmarksService.placesRoot - La carpeta raíz de la jerarquía.
</li><li> nsINavBookmarksService.bookmarksMenuFolder - El contenido de esta carpeta es visible en el menú Buscadores.
</li><li> nsINavBookmarksService.toolbarFolder - El contenido de esta carpeta está visible en la barra de herramientas Marcadores.
</li><li> nsINavBookmarksService.unfiledBookmarksFolder - Los elementos que han sido marcados con una estrella, pero que no están incluidos en ninguna carpeta.
</li><li> nsINavBookmarksService.tagsFolder - Las sub carpetas de esta carpeta son pestañas y sus hijos son URI que han sido marcadas con ese naombre de carpeta.
</li></ul>
<p>Nota: Este documento cubre el servicio de tolkit Catálogo. Sin embargo, los desarrolladores de Firefox pueden aprovechar diversos API de ayuda que son específicos del navegador: </p>
<ul><li> <a href="es/FUEL">FUEL</a>
</li><li> {{ Source("browser/components/places/public/nsIPlacesTransactionsService.idl", "nsIPlacesTransactionsService") }}
</li><li> <a href="es/Utilidades_Javascript_para_Cat%c3%a1logo">Utilidades_Javascript_para_Catálogo</a>
</li></ul>
<h3 id="Creaci.C3.B3n" name="Creaci.C3.B3n"> Creación </h3>
<p>Crear un Marcador
</p>
<pre>// create an nsIURI for the URL to be bookmarked.
var bookmarkURI = Cc["@mozilla.org/network/io-service;1"].
                  getService(Ci.nsIIOService).
                  newURI("http://www.mozilla.com", null, null);

var bookmarkId = bookmarks.insertBookmark(
  bookmarks.toolbarFolder, // El Id de la carpeta donde se guardará el marcador.
  bookmarkURI,             // La URI del marcador - un objeto nsIURI.
  bookmarks.DEFAULT_INDEX, // La posición del marcador en su carpeta padre.
  "my bookmark title");    // El título del marcador.
</pre>
<p>Crear una carpeta
</p>
<pre>var folderId = bookmarks.createFolder(
  bookmarks.toolbarFolder, // La id de la carpeta donde se guardará la nueva carpeta.
  "my folder title",       // El título de la nueva carpeta.
  bookmarks.DEFAULT_INDEX);    // La posición de la nueva carpeta en su carpeta padre.
</pre>
<p>Crear un separador
</p>
<pre>var separatorId = bookmarks.insertSeparator(
  bookmarks.toolbarFolder, // La id de la carpeta donde será puesto el separador.
  bookmarks.DEFAULT_INDEX);    // La posición del separador en su carpeta padre.
</pre>
<p>Crear un marcador dinámico
</p>
<pre>var IOService = Cc["@mozilla.org/network/io-service;1"].
                  getService(Ci.nsIIOService);

var siteURI = IOService.newURI("http://www.mozilla.com", null, null);
var feedURI = IOService.newURI("http://www.mozilla.org/news.rdf", null, null);

var livemarks = Cc["@mozilla.org/browser/livemark-service;2"].
                getService(Ci.nsILivemarkService);

livemarks.createLivemark(bookmarks.toolbarFolder, // La id de la carpeta donde será almacenado el marcador dinámico
  "My Livemark Title",        // El título del marcador dinámico
  siteURI,                    // La URI del sitio. Un objeto nsIURI.
  feedURI,                    // La URI del Canal. Un objeto nsIURI.
  bookmarks.DEFAULT_INDEX);   // La posición del marcador dinámico en su carpeta padre.
</pre>
<h3 id="Lectura" name="Lectura"> Lectura </h3>
<h4 id="Propiedades_de_los_elementos" name="Propiedades_de_los_elementos">Propiedades de los elementos</h4>
<p>Para todos los elementos:
</p>
<ul><li> String getItemTitle(aItemId) - XXX
</li><li> Int64 getItemIndex(aItemId) - XXX
</li><li> PRTime getItemType(aItemId) - XXX
</li><li> PRTime getItemDateAdded(aItemId) - XXX
</li><li> PRTime getItemLastModified(aItemId) - XXX
</li><li> Int64 getFolderIdForItem(aItemId) - Devuelve la id de la carpeta que contienen el elemento dado.
</li><li> String getItemGUID(aItemId) - Devuelve un identificador global único del elemento. Esto se usa principalmente en las extensiones, para sincronizar los datos de los marcadores entre diferentes perfiles.
</li></ul>
<p>Para marcadores:
</p>
<ul><li> nsIURI getBookmarkURI(aItemId) - XXX
</li><li> String getKeywordForBookmark(aItemId) - XXX
</li></ul>
<p>Para carpetas:
</p>
<ul><li> Int64 getChildFolder(aFolderId, aSubfolderTitle) - Devuelve la id de la primera sub carpeta que coincide con el título dado.
</li><li> Int64 getIdForItemAt(aFolderId, aPosition) - Devuelve la id del elemento en la posición determinada .
</li><li> Bool getFolderReadonly(aFolderId)
</li></ul>
<h4 id="Contenido_de_las_carpetas" name="Contenido_de_las_carpetas">Contenido de las carpetas</h4>
<p>Las consultas en Catálogo se ejecutan a través del servicio principal de historial. El ejemplo siguiente, muestra como listar el contenido de una carpeta de Marcadores y cómo acceder a las propiedades de cada elemento.
</p>
<pre>var history = Cc["@mozilla.org/browser/nav-history-service;1"].
              getService(Ci.nsINavHistoryService);
var query = history.getNewQuery();
query.setFolders([myFolderId], 1);

var result = history.executeQuery(query, history.getNewQueryOptions());

// La propiedad raíz del resultado de una consulta es un objeto representando la carpeta que especificaste.
var folderNode = result.root;

// Abre la carpeta y actúa reiterativamente con su contenido.
folderNode.containerOpen = true;
for (var i=0; i &lt; folderNode.childCount; ++i) {
  var childNode = folderNode.getChild(i);

  // Algunas propiedades del elemento.
  var title = childNode.title;
  var id = childNode.itemId;
  var type = childNode.type;

  // Algunas acciones específicas del tipo.
  if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_URI) {

    var uri = childNode.uri;

  }
  else if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_FOLDER) {

    childNode.QueryInterface(Ci.nsINavHistoryContainerResultNode);
    childNode.containerOpen = true;
    // ahora puedes actuar reiterativamente sobre el 'hijo' de una carpeta.

  }
}
</pre>
<p>Hay documentación sobre otros tipos de nodo disponible en <a class="external" href="http://mxr.mozilla.org/seamonkey/source/toolkit/components/places/public/nsINavHistoryService.idl">IDL</a>.
</p>
<h4 id="B.C3.BAsqueda" name="B.C3.BAsqueda">Búsqueda</h4>
<h3 id="Actualizaci.C3.B3n" name="Actualizaci.C3.B3n">Actualización</h3>
<p>Para todos los elementos:
</p>
<ul><li> setItemTitle(aItemId, aTitle) - Cambia el título de un elemento.
</li><li> setItemIndex(aItemId, aIndex) - Cambia la posición de un elemento. NOTA: este no cambia los indices de toda la carpeta - para una solución administrada, usa moveItem.
</li><li> setItemDateAdded(aItemId, aDateAdded) - Ajusta la fecha en que fue añadido el elemento por primera vez, en micro segundos.
</li><li> setItemLastModified(aItemId, aLastModified) - Ajusta la fecha en que fue añadido el elemento por última vez, en micro segundos.
</li><li> setItemGUID(aItemId, aGUID) - Devuelve un identificador global único del elemento. Esto se usa principalmente en las extensiones, para sincronizar los datos de los marcadores entre diferentes perfiles.
</li><li> moveItem (aFolderId, aNewParentId, aIndex) - Mueve un elemento de una carpeta a otra.
</li></ul>
<p>Para marcadores:
</p>
<ul><li> changeBookmarkURI(aItemId, aURI) - Cambia la URI del marcador.
</li><li> setKeywordForBookmark(aItemId, aKeyword) - Ajusta la palabra-clave para el marcador.
</li></ul>
<h3 id="Borrado" name="Borrado">Borrado</h3>
<ul><li> Elementos
</li><li> Contenedores
</li></ul>
<h3 id="Observar" name="Observar">Observar </h3>
<h3 id="Importar.2FExportar_en_formato_HTML" name="Importar.2FExportar_en_formato_HTML">Importar/Exportar en formato HTML</h3>
<h3 id="Respaldo.2FRestauraci.C3.B3n" name="Respaldo.2FRestauraci.C3.B3n">Respaldo/Restauración</h3>
<h3 id="Nuevo" name="Nuevo">Nuevo</h3>
<ul><li> Pestañas
</li><li> Anotaciones
</li><li> Búsquedas guardadas
</li><li> Contenedores dinámicos
</li></ul>
<h2 id="Historia" name="Historia">Historia</h2>
<h3 id="Agregar" name="Agregar">Agregar</h3>
<h3 id="Consultas" name="Consultas">Consultas</h3>
<h3 id="Observar_2" name="Observar_2">Observar</h3>
<h3 id="Nuevo_2" name="Nuevo_2">Nuevo</h3>
<div class="noinclude">
</div>
{{ languages( { "es": "es/Lugares/Gu\u00eda_para_migraci\u00f3n_con_lugares", "fr": "fr/Guide_de_migration_vers_Places", "ja": "ja/Places/Migration_Guide", "en": "en/Places_migration_guide" } ) }}