Direcciones web de consultas Places

Este artículo describe los parámetros que se pueden usar al crear direcciones web del tipo place. Estas direcciones web ejecutan consultas Places.

Se puede usar una dirección web del tipo place como marcador. Por ejemplo, desde la biblioteca de Firefox se puede ir a Otros marcadores, luego hacer clic en el botón Organizar y luego elegir Nuevo marcador… En el campo Dirección se puede ingresar una dirección web del tipo place para crear una consulta. Una vez creado esta carpeta de marcador inteligente, se puede arrastrar el mismo a la barra de direcciones y soltarlo allí, para que, al hacerle clic, aparezca un menú desplegable conteniendo los resultados de dicha consulta.

La siguiente dirección web del tipo place es la que se usa en el marcador inteligente Más visitadas, el cual pertenece al conjunto de marcadores inteligentes creados al comenzar a usar Firefox 3:

place:queryType=0&sort=8&maxResults=10

Los parámetros usados en esta consulta son:

queryType=0
Esto indica que la consulta debería tener en cuenta sólo el historial del usuario y no los marcadores.
sort=8
El parámetro sort indica que los resultados de la consulta deben ser mostrados en el orden numérico inverso, según la cantidad de visitas. En otras palabras, las páginas más visitadas deberían aparecer primero, y las páginas menos visitadas, últimas.
maxResults=10
Este parámetro especifica que se tiene que mostrar un máximo de 10 resultados en la consulta.

Si se quiere cambiar esta consulta para que sólo se tenga en cuenta las visitas de hoy, entonces se puede cambiar a:

place:queryType=0&sort=8&maxResults=10&beginTimeRef=1&beginTime=0

Estos son los nuevos parámetros agregados acá:

beginTimeRef=1
Indica que el parámetro beginTime que sigue se refiere a la medianoche de hoy.
beginTime
Especifica la cantidad de tiempo, en microsegundos, desde la medianoche en la que se comenzó a registrar las visitas. Al especificar 0 como valor, se indica que se quiere tener en cuenta todas las visitas ocurridas hoy.

Parámetros de consulta

Esta es una lista de los parámetros disponibles para usar.

Parámetro Tipo Descripción
beginTime unsigned long El tiempo, en microsegundos, del resultado más antiguo.
beginTimeRef unsigned long Indica el tiempo de referencia especificado en beginTime:
0
El "Tiempo Unix", contando a partir del 1º de enero de 1970, con huso horario GMT/UTC. Este es el valor predeterminado.
1
Este tiempo es relativo a la última medianoche. Esto es útil para consultas relacionadas al día de hoy.
2
Este tiempo es relativo a ahora mismo.
endTime unsigned long La hora, en microsegundos, del último resultado.
endTimeRef unsigned long Indica el tipo de referencia especificado en endTime. Los valores son los mismos que para beginTime.
terms cadena El término a consultar.
minVisits long Filtra resultados basados en el mínimo número de visitas. Especificar -1 (el valor predeterminado) para mostrar todos los resultados, o cualquier otro número para incluir sólo los resultados con una cantidad mayor de visitas al valor ingresado.
maxVisits long Filtra resultados basados en el máximo número de visitas. Sólo los elementos que hayan sido visitados menos veces que el número ingresado serán incluidos en los resultados. Especificar -1 (el valor predeterminado) para no filtrar.
onlyBookmarked lógico Si el valor es true, entonces sólo los elementos en marcadores serán incluidos en los resultados.
domainIsHost lógico Si el valor es true, entonces el dominio domain debe ser una coincidencia exacta. De lo contrario, todo lo que termine en domain es considerado una coincidencia.
domain cadena Consulta por elementos que coincidan con este servidor o nombre de dominio. Ver el parámetro domainIsHost para más información.
folder cadena La carpeta a consultar. Puede ser una de las siguientes:
PLACES_ROOT
La carpeta raíz de Places.
BOOKMARKS_MENU
El menú Marcadores.
TOOLBAR
La barra de marcadores.
TAGS
Etiquetas
UNFILED_BOOKMARKS
Otros marcadores
!annotation lógico Indica si incluir o rechazar elementos que coincidan la anotación especificada por annotation. Si el valor es true, entonces los elementos que no tengan la anotación especificada serán rechazados.
annotation cadena La anotación a coincidir al consultar.
uri cadena La dirección web a consultar.
uriIsPrefix lógico Si el valor es false, entonces la uri debe ser una coincidencia exacta; este es el valor predeterminado. Si el valor es true, entonces cualquier entrada que comience con la dirección web especificada, será considerada una coincidencia.
tag cadena .
!tags . .

Operadores de consulta

Los siguientes atributos permiten controlar los resultados con más precisión.

Operador Tipo Descripción
OR   Este es el operador lógico OR ["O"].
applyOptionsToContainers    
excludeItemIfParentHasAnnotation Obsoleto Gecko 13.0 cadena Los elementos cuyas raíces tengan este valor como anotación, son rechazadas de los resultados de la consulta. Este parámetro es ignorado para consultas sobre el historial. Por ejemplo, se pueden rechazar entradas de marcadores dinámicos especificando livemark/[dirección de la fuente web] acá.
excludeItems lógico Si el valor es true, entonces todas las direcciones web y separadores son rechazados de los resultados de la consulta de marcadores, así sólo se muestran las carpetas y las consultas. Si el valor es false, entonces se muestran todos los elementos; este es el valor predeterminado.
excludeQueries lógico Si el valor es true, entonces las consultas son rechazadas de los resultados; sin embargo, las consultas de carpetas individuales como la carpeta de marcadores symlinks todavía serán incluidas. El valor predeterminado false indica que las consultas deberían ser incluidas en los resultados.
excludeReadOnlyFolders lógico Si el valor es true, entonces las carpetas de sólo lectura serán rechazadas de los resultados. Esto sólo afecta en los casos en los cuales el nodo de resultados de la carpeta actual aparece en su carpeta anterior. El valor predeterminado es false.
expandQueries lógico Si el valor es true, entonces las direcciones web place aparecerán como contenedores en los resultados, con los contenidos rellenados con la consulta guardada. Esto no hace nada si excludeQueries tiene como valor true. El valor predeterminado es false, lo cual provoca que las direcciones web place aparezcan como elementos normales.
group    
includeHidden lógico Si el valor es true, entonces los elementos que normalmente se ocultarían en una consulta del historial (como el contenido de iframes así también como imágenes) son incluidos en los resultados. El valor predeterminado es false.
maxResults unsigned long El número máximo de resultados para aparecer. Esto no funciona al ordernar por título. El resultado es 0, lo que significa que se muestran todos los resultados.
originalTitle cadena Recupera el título original de la página.
queryType unsigned short El tipo de búsqueda para usar al consultar la base de datos. Este atributo se tiene en cuenta por nodos de consulta. Es ignorado para consultas de carpeta individual.
0
Historial
1
Marcadores
2
Tanto historial como marcadores (No implementado aún -- ver error 378798)
resolveNullBookmarkTitles lógico Si el valor es true, entonces los marcadores con títulos en blanco, recuperarán sus títulos desde el historial, de ser posible. Esto no aplica a marcadores con títulos vacíos. El valor predeterminado es false.
showSessions lógico Si el valor es true, entonces la información de sesión es usada para agrupar elementos del historial. Esto sólo hace diferencia al ordenar por fecha. El valor predeterminado es false.
sort unsigned short El orden para usar en los resultados.
0
Orden original del marcador
1
Ordenado por título, de la A a la Z
2
Ordenado por título, de la Z a la A
3
Ordenado por fecha de visita, lo más reciente a lo último
4
Ordenado por fecha de visita, lo más reciente primero
5
Ordenado por dirección web, de la A a la Z
6
Ordenado por dirección web, de la Z a la A
7
Ordenado por cantidad de visitas, ascendiente
8
Ordenado por cantidad de visitas, descendiente
9
Ordenado por palabra clave, de la A a la Z
10
Ordenado por palabra clave, de la Z a la A
11
Ordenado por fecha agregada, lo más reciente a lo último
12
Ordenado por fecha agregada, lo más reciente primero
13
Ordenado por última fecha modificada, lo más reciente a lo último
14
Ordenado por última fecha modificada, lo más reciente primero
17
Ordenado por etiquetas, ascendiente
18
Ordenado por etiquetas, descendiente
19
Ordenado por anotación, ascendiente
20
Ordenado por anotación, descendiente
sortingAnnotation cadena La anotación para usar al ordenar por anotación.
type unsigned short El tipo de resultados a mostrar.
0
Resultados como direcciones web (resultados "URI", uno por cada dirección web visitada en el rango)
1
Resultados como visitas (resultados "visita", con uno por cada vez que una página fue visitada - esto devolverá frecuentemente múltiples resultados para una misma dirección web)
2
Resultados como visitas totales (como en "visita", pero muestra todos los atributos para cada resultado)
3
Resultados como consulta de fecha (muestra resultados para un rango de fechas dado)
4
Resultados como consulta de sitio (muestra la última visita para cada dirección web en un servidor dado)
5
Resultados como consulta de fecha+sitio (muestra la lista de servidores visitados en un período dado)
6
Resultados como consulta de etiqueta (muestra una lista de marcadores con una etiqueta dada)
7
Resultados como contenedores de etiquetas (muestra marcadores con una etiqueta dada; para la misma dirección web usa la última modificada - el atributo folder=tag_folder_id tiene que estar presente en la consulta.)

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: KNTRO
 Última actualización por: KNTRO,