Comparar revisiones

Guía para la migración a catálogo

Change Revisions

Revisión 287883:

Revisión 287883 de HenryGR el

Revisión 226114:

Revisión 226114 de HenryGR el

Título:
Guía para la migración a catálogo
Guía para la migración a catálogo
Enlace amigable (slug):
Guía_para_la_migración_a_catálogo
Guía_para_la_migración_a_catálogo
Etiquetas:
NeedsContent, Places
Contenido:

Revisión 287883
Revisión 226114
t7    <p>t
8      {{ Fx_minversion_header(3) }} Este documento es para los de
>sarrolladores de aplicaciones y extensiones que tienen código los 
> API de los marcadores y de el historial es Firefox 2 y anteriore 
>s y que están migrando a Firefox 3. 
9    </p>
10    <h2 id="Visi.C3.B3n_general" name="Visi.C3.B3n_general">
11      Visión general
12    </h2>
13    <p>
14      <a href="es/Cat%c3%a1logo">Catálogo</a> es un conjunto de A
>PI para la administración del historial de navegación y los meta  
>datos de las URI. Esto incluye historial, marcadores, pestañas, f 
>avicons y anotaciones. Existen dos modelos de identidad en el sis 
>tema: URI e identificadores únicos para elementos del sistema de  
>marcadores. Algunos de los API están centrados en URI, mientras q 
>ue otros usan identificadores de elementos. La firma del API y su 
> contexto, generalmente dejan claro qué modelo se requiere. 
15    </p>
16    <h2 id="Marcadores" name="Marcadores">
17      Marcadores
18    </h2>
19    <p>
20      El servicio del toolkit marcadores es {{ Source("toolkit/co
>mponents/places/public/nsINavBookmarksService.idl", "nsINavBookma 
>rksService") }}: 
21    </p>
22    <pre>
23var bookmarks = Cc["@mozilla.org/browser/nav-bookmarks-service;1"
>]. 
24                getService(Ci.nsINavBookmarksService);
25</pre>
26    <p>
27      EL almacenamiento de los marcadores es jerárquico, sirviend
>o de modelo a las carpetas y su contenido. Varias carpetas signif 
>icativas están disponibles como atributos de {{ Interface("nsINav 
>BookmarksService") }}. 
28    </p>
29    <ul>
30      <li>nsINavBookmarksService.placesRoot - La carpeta raíz de 
>la jerarquía. 
31      </li>
32      <li>nsINavBookmarksService.bookmarksMenuFolder - El conteni
>do de esta carpeta es visible en el menú Buscadores. 
33      </li>
34      <li>nsINavBookmarksService.toolbarFolder - El contenido de 
>esta carpeta está visible en la barra de herramientas Marcadores. 
35      </li>
36      <li>nsINavBookmarksService.unfiledBookmarksFolder - Los ele
>mentos que han sido marcados con una estrella, pero que no están  
>incluidos en ninguna carpeta. 
37      </li>
38      <li>nsINavBookmarksService.tagsFolder - Las sub carpetas de
> esta carpeta son pestañas y sus hijos son URI que han sido marca 
>das con ese naombre de carpeta. 
39      </li>
40    </ul>
41    <p>
42      Nota: Este documento cubre el servicio de tolkit Catálogo. 
>Sin embargo, los desarrolladores de Firefox pueden aprovechar div 
>ersos API de ayuda que son específicos del navegador: 
43    </p>
44    <ul>
45      <li>
46        <a href="es/FUEL">FUEL</a>
47      </li>
48      <li>{{ Source("browser/components/places/public/nsIPlacesTr
>ansactionsService.idl", "nsIPlacesTransactionsService") }} 
49      </li>
50      <li>
51        <a href="es/Utilidades_Javascript_para_Cat%c3%a1logo">Uti
>lidades_Javascript_para_Catálogo</a> 
52      </li>
53    </ul>
54    <h3 id="Creaci.C3.B3n" name="Creaci.C3.B3n">
55      Creación
56    </h3>
57    <p>
58      Crear un Marcador
59    </p>
60    <pre>
61// create an nsIURI for the URL to be bookmarked.
62var bookmarkURI = Cc["@mozilla.org/network/io-service;1"].
63                  getService(Ci.nsIIOService).
64                  newURI("http://www.mozilla.com", null, null);
65 
66var bookmarkId = bookmarks.insertBookmark(
67  bookmarks.toolbarFolder, // El Id de la carpeta donde se guarda
>rá el marcador. 
68  bookmarkURI,             // La URI del marcador - un objeto nsI
>URI. 
69  bookmarks.DEFAULT_INDEX, // La posición del marcador en su carp
>eta padre. 
70  "my bookmark title");    // El título del marcador.
71</pre>
72    <p>
73      Crear una carpeta
74    </p>
75    <pre>
76var folderId = bookmarks.createFolder(
77  bookmarks.toolbarFolder, // La id de la carpeta donde se guarda
>rá la nueva carpeta. 
78  "my folder title",       // El título de la nueva carpeta.
79  bookmarks.DEFAULT_INDEX);    // La posición de la nueva carpeta
> en su carpeta padre. 
80</pre>
81    <p>
82      Crear un separador
83    </p>
84    <pre>
85var separatorId = bookmarks.insertSeparator(
86  bookmarks.toolbarFolder, // La id de la carpeta donde será pues
>to el separador. 
87  bookmarks.DEFAULT_INDEX);    // La posición del separador en su
> carpeta padre. 
88</pre>
89    <p>
90      Crear un marcador dinámico
91    </p>
92    <pre>
93var IOService = Cc["@mozilla.org/network/io-service;1"].
94                  getService(Ci.nsIIOService);
95 
96var siteURI = IOService.newURI("http://www.mozilla.com", null, nu
>ll); 
97var feedURI = IOService.newURI("http://www.mozilla.org/news.rdf",
> null, null); 
98 
99var livemarks = Cc["@mozilla.org/browser/livemark-service;2"].
100                getService(Ci.nsILivemarkService);
101 
102livemarks.createLivemark(bookmarks.toolbarFolder, // La id de la 
>carpeta donde será almacenado el marcador dinámico 
103  "My Livemark Title",        // El título del marcador dinámico
104  siteURI,                    // La URI del sitio. Un objeto nsIU
>RI. 
105  feedURI,                    // La URI del Canal. Un objeto nsIU
>RI. 
106  bookmarks.DEFAULT_INDEX);   // La posición del marcador dinámic
>o en su carpeta padre. 
107</pre>
108    <h3 id="Lectura" name="Lectura">
109      Lectura
110    </h3>
111    <h4 id="Propiedades_de_los_elementos" name="Propiedades_de_lo
>s_elementos"> 
112      Propiedades de los elementos
113    </h4>
114    <p>
115      Para todos los elementos:
116    </p>
117    <ul>
118      <li>String getItemTitle(aItemId) - XXX
119      </li>
120      <li>Int64 getItemIndex(aItemId) - XXX
121      </li>
122      <li>PRTime getItemType(aItemId) - XXX
123      </li>
124      <li>PRTime getItemDateAdded(aItemId) - XXX
125      </li>
126      <li>PRTime getItemLastModified(aItemId) - XXX
127      </li>
128      <li>Int64 getFolderIdForItem(aItemId) - Devuelve la id de l
>a carpeta que contienen el elemento dado. 
129      </li>
130      <li>String getItemGUID(aItemId) - Devuelve un identificador
> global único del elemento. Esto se usa principalmente en las ext 
>ensiones, para sincronizar los datos de los marcadores entre dife 
>rentes perfiles. 
131      </li>
132    </ul>
133    <p>
134      Para marcadores:
135    </p>
136    <ul>
137      <li>nsIURI getBookmarkURI(aItemId) - XXX
138      </li>
139      <li>String getKeywordForBookmark(aItemId) - XXX
140      </li>
141    </ul>
142    <p>
143      Para carpetas:
144    </p>
145    <ul>
146      <li>Int64 getChildFolder(aFolderId, aSubfolderTitle) - Devu
>elve la id de la primera sub carpeta que coincide con el título d 
>ado. 
147      </li>
148      <li>Int64 getIdForItemAt(aFolderId, aPosition) - Devuelve l
>a id del elemento en la posición determinada . 
149      </li>
150      <li>Bool getFolderReadonly(aFolderId)
151      </li>
152    </ul>
153    <h4 id="Contenido_de_las_carpetas" name="Contenido_de_las_car
>petas"> 
154      Contenido de las carpetas
155    </h4>
156    <p>
157      Las consultas en Catálogo se ejecutan a través del servicio
> principal de historial. El ejemplo siguiente, muestra como lista 
>r el contenido de una carpeta de Marcadores y cómo acceder a las  
>propiedades de cada elemento. 
158    </p>
159    <pre>
160var history = Cc["@mozilla.org/browser/nav-history-service;1"].
161              getService(Ci.nsINavHistoryService);
162var query = history.getNewQuery();
163query.setFolders([myFolderId], 1);
164 
165var result = history.executeQuery(query, history.getNewQueryOptio
>ns()); 
166 
167// La propiedad raíz del resultado de una consulta es un objeto r
>epresentando la carpeta que especificaste. 
168var folderNode = result.root;
169 
170// Abre la carpeta y actúa reiterativamente con su contenido.
171folderNode.containerOpen = true;
172for (var i=0; i &lt; folderNode.childCount; ++i) {
173  var childNode = folderNode.getChild(i);
174 
175  // Algunas propiedades del elemento.
176  var title = childNode.title;
177  var id = childNode.itemId;
178  var type = childNode.type;
179  
180  // Algunas acciones específicas del tipo.
181  if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_URI) {
182 
183    var uri = childNode.uri;
184 
185  }
186  else if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_FOLDER)
> { 
187 
188    childNode.QueryInterface(Ci.nsINavHistoryContainerResultNode)
>; 
189    childNode.containerOpen = true;
190    // ahora puedes actuar reiterativamente sobre el 'hijo' de un
>a carpeta. 
191 
192  }
193}
194</pre>
195    <p>
196      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 
>>. 
197    </p>
198    <h4 id="B.C3.BAsqueda" name="B.C3.BAsqueda">
199      Búsqueda
200    </h4>
201    <h3 id="Actualizaci.C3.B3n" name="Actualizaci.C3.B3n">
202      Actualización
203    </h3>
204    <p>
205      Para todos los elementos:
206    </p>
207    <ul>
208      <li>setItemTitle(aItemId, aTitle) - Cambia el título de un 
>elemento. 
209      </li>
210      <li>setItemIndex(aItemId, aIndex) - Cambia la posición de u
>n elemento. NOTA: este no cambia los indices de toda la carpeta - 
> para una solución administrada, usa moveItem. 
211      </li>
212      <li>setItemDateAdded(aItemId, aDateAdded) - Ajusta la fecha
> en que fue añadido el elemento por primera vez, en micro segundo 
>s. 
213      </li>
214      <li>setItemLastModified(aItemId, aLastModified) - Ajusta la
> fecha en que fue añadido el elemento por última vez, en micro se 
>gundos. 
215      </li>
216      <li>setItemGUID(aItemId, aGUID) - Devuelve un identificador
> global único del elemento. Esto se usa principalmente en las ext 
>ensiones, para sincronizar los datos de los marcadores entre dife 
>rentes perfiles. 
217      </li>
218      <li>moveItem (aFolderId, aNewParentId, aIndex) - Mueve un e
>lemento de una carpeta a otra. 
219      </li>
220    </ul>
221    <p>
222      Para marcadores:
223    </p>
224    <ul>
225      <li>changeBookmarkURI(aItemId, aURI) - Cambia la URI del ma
>rcador. 
226      </li>
227      <li>setKeywordForBookmark(aItemId, aKeyword) - Ajusta la pa
>labra-clave para el marcador. 
228      </li>
229    </ul>
230    <h3 id="Borrado" name="Borrado">
231      Borrado
232    </h3>
233    <ul>
234      <li>Elementos
235      </li>
236      <li>Contenedores
237      </li>
238    </ul>
239    <h3 id="Observar" name="Observar">
240      Observar
241    </h3>
242    <h3 id="Importar.2FExportar_en_formato_HTML" name="Importar.2
>FExportar_en_formato_HTML"> 
243      Importar/Exportar en formato HTML
244    </h3>
245    <h3 id="Respaldo.2FRestauraci.C3.B3n" name="Respaldo.2FRestau
>raci.C3.B3n"> 
246      Respaldo/Restauración
247    </h3>
248    <h3 id="Nuevo" name="Nuevo">
249      Nuevo
250    </h3>
251    <ul>
252      <li>Pestañas
253      </li>
254      <li>Anotaciones
255      </li>
256      <li>Búsquedas guardadas
257      </li>
258      <li>Contenedores dinámicos
259      </li>
260    </ul>
261    <h2 id="Historia" name="Historia">
262      Historia
263    </h2>
264    <h3 id="Agregar" name="Agregar">
265      Agregar
266    </h3>
267    <h3 id="Consultas" name="Consultas">
268      Consultas
269    </h3>
270    <h3 id="Observar_2" name="Observar_2">
271      Observar
272    </h3>
273    <h3 id="Nuevo_2" name="Nuevo_2">
274      Nuevo
275    </h3>
276    <div class="noinclude"></div>{{ languages( { "es": "es/Lugare
>s/Gu\u00eda_para_migraci\u00f3n_con_lugares", "fr": "fr/Guide_de_ 
>migration_vers_Places", "ja": "ja/Places/Migration_Guide", "en":  
>"en/Places_migration_guide" } ) }} 

Volver al historial