Referência de Consulta de Pesquisa

Updated: June 11, 2026

Este documento é um guia de referência para a sintaxe, os operadores e as convenções usados na linguagem de pesquisa de projetos de hardware do Workspace. As consultas de pesquisa são baseadas em uma sintaxe field:value familiar e podem ser usadas tanto para pesquisas rápidas e simples quanto para construir consultas avançadas e precisas.

Consulte Pesquisa no Web Viewer para obter informações de uso relacionadas.

Sintaxe e Guia de Pesquisa

As informações de referência abaixo estão agrupadas por tipos de alvos de pesquisa (componentes, conexões etc.), com cada seção incluindo subtipos de categoria de uso, exemplos de uso e consultas de exemplo correspondentes.

Pesquisa de Componentes

Use Category	Application Example	Query
Basics	Localize um componente conhecido pelo seu Designador.	`R14`
	Localize um componente CI específico pelo Designador.	`designator:U7`
	Localize componentes pelo seu Nome/Comentário (ex.: ERJ-2RKF1002X ou "Capacitor 100nF +/-20% 50V 0402"]).	`comment:ERJ-2RKF1002X`
	Localize componentes pelo parâmetro Value (ex.: 100nF ou 4.7k).	`value:100nF`
	Localize componentes em um encapsulamento físico específico (ex.: QFN-48).	`package:0402`
	Localize componentes que usam um nome específico de footprint de PCB.	`footprint:RESC0402`
Identifiers	Localize componentes que sejam dispositivos de montagem em superfície (SMD).	`mounting:smd`
Identifiers	Localize todos os componentes Through-Hole Technology (THT).	`mounting:tht`
Types	Localize todos os componentes passivos (resistores, capacitores, indutores).	`type:passive`
	Localize todos os componentes ativos (CIs, transistores, diodos).	`type:active`
	Localize todos os componentes classificados como conectores.	`type:connector`
Connections	Localize componentes que contenham um nome ou número de pino específico.	`pin:SCLK`
Connections	Localize componentes que contenham pinos com uma direção especificada (ex.: input, output, IO etc.). Também localiza Ports com a direção especificada.	`direction:output`
Parametric	Localize componentes com uma propriedade ou parâmetro específico (ex.: Tolerance) com qualquer valor.	`has:tolerance`
	Localize componentes em que um parâmetro tenha um valor específico	`tolerance:1%`
	Localize componentes em que um parâmetro numérico esteja dentro de um intervalo. Filtro. Observe que nomes de parâmetros com um caractere de espaço devem estar entre aspas.	`"Voltage Rating":[3V to 5.5V]`
	Localize componentes na camada Top com um parâmetro específico de potência nominal. Filtro	`power:63mW layer:Top`

Pesquisa de Nets

Use Category	Application Example	Query
Basics	Localize uma net conhecida pelo nome.	`GND`
Basics	Localize uma net de alimentação específica pelo nome (ex.: VCC, GND, VSENSE).	`net:VCC3`
Classes	Localize todas as nets que pertencem a uma classe de nets.	`netclass:analog`
	Localize as nets de um par diferencial específico.	`diffpair:USB_SYS`
	Localize todos os pares de nets na classe de pares diferenciais.	`diffpairclass:USB`

Conectividade

Use Category	Application Example	Query
Simple Search	Localize o componente U3 e tudo o que está conectado a ele. Caminhos de conexão lógicos também são mostrados, em que dispositivos passivos entre dispositivos ativos (ex.: resistores de terminação e capacitores de acoplamento) são ignorados.	`connectsTo:U3`
Simple Search	Localize a net 'SYS_CLK' e tudo o que está conectado a ela.	`connectsTo:SYS_CLK`
Advanced Search	Localize o componente U3 e tudo o que está diretamente conectado a ele. Somente conexões físicas (mesma net) são mostradas – conexões lógicas entre dispositivos ativos não estão incluídas.	`connectsTo.Direct:U3`
	Localize o componente U3 e as conexões físicas e lógicas a ele, mas exclua conexões aos trilhos de alimentação.	`connectsTo.noPower:U3`
	Localize o componente U3 e as conexões físicas (mesma net) a ele, mas exclua conexões aos trilhos de alimentação.	`ConnectsTo.Direct:U3 ConnectsTo.NoPower:U3`
	Localize a net específica conectada ao pino 5 do componente U12.	`connectsTo:U12.5`
	Localize a net específica conectada à entrada 'D_CLK' do componente U12.	`connectsTo:U12.D_CLK`
	Localize nets do barramento CAN em camadas específicas da PCB (ex.: L3 e Bottom). Filtro	`net:can* layer:Bottom layer:L3`

Objetos de Projeto

Use Category	Application Example	Query
General Types	Localize objetos de um tipo específico [ex.: pad, via, track].	`object:pad`
General Types	Localize objetos específicos em uma net específica (ex.: vias na net de terra). Filtro	`object:via net:GND`
Advanced	Localize tracks (trilhas) em camadas intermediárias da PCB (ou seja, nem Top nem Bottom). Filtro	`object:track -layer:Top -layer:Bottom`
	Localize todos os pinos designados como saídas. Filtro	`direction:output object:pin`
	Localize todos os pads com tipo de forma retangular. Filtro	`object:pad shape:rectangle`

Filtros Lógicos e de Intervalo

Use Category	Application Example	Query
Wildcards	Localize todas as nets cujo nome inclua vários caracteres após 'VCC' (ex.: VCC1, VCC_Digital, VCC_Analog).	`net:VCC*`
Wildcards	Localize todos os componentes cujos designadores incluam um único caractere após 'C1' (ou seja, capacitores C11 a C19)	`C1?`
Logic Combinations	Localize capacitores na camada Top. Observe que um espaço entre expressões de pesquisa é um AND implícito.	`type:Capacitor AND layer:Top`
	Localize componentes usando encapsulamento 0402 ou 0603. Observe que uma expressão lógica OR deve ser colocada entre parênteses quando usada com lógica AND.	`package:0402 OR package:0603`
	Mostre todas as conexões com U1, mas não inclua as da camada GND. Observe que o caractere '-' é equivalente ao qualificador lógico 'NOT' (-term:value).	`connectsto:U1 NOT Layer:GND`
Parentheses Logic	Localize componentes usando encapsulamento 0402 ou 0603.	`package:(0402 OR 0603)`
Parentheses Logic	Localize tracks (trilhas) em camadas intermediárias da PCB (ou seja, nem Top nem Bottom).	`object:track -layer:(Top or Bottom)`
Ranges	Localize tracks de PCB com comprimento maior que um comprimento especificado. Observe que o caractere '>' substitui os dois-pontos do termo.	`object:Track tracklength>100mm`
	Localize pads de PCB com tamanhos de furo maiores ou iguais a um diâmetro especificado.	`object:Pad holesize>=0.6mm`
	Localize resistores que tenham um valor dentro de um intervalo especificado. Observe o uso de colchetes.	`R* Value:[100k to 200k]`
	Localize nets de PCB com comprimentos de 1 mm a 1,5 mm. Incluirá conexões (pads, vias, pinos etc.).	`NetLength:[1mm to 1.5mm]`

Pesquisa Hierárquica e de Agrupamento

Use Category	Application Example	Query
Logical Groups	Localize todos os componentes na classe de componentes 'DecouplingCaps'.	`componentClass:DecouplingCaps`
Logical Groups	Localize todas as nets pertencentes à classe de nets 'DDR_DATA'.	`netClass:DDR_DATA`
Physical Groups	Localize todas as entidades em uma camada específica da PCB (ex.: Mid 3).	`layer:"Mid 3"`
Physical Groups	Localize todos os componentes dentro da room 'RF_Shield' na PCB.	`room:RF_Shield`

Projeto Físico

Use Category	Application Example	Query
Physical Properties	Localize nets de alta velocidade com trilhas maiores que 50 mm. Filtro	`netClass:HighSpeed netlength>50mm`
	Mostre trilhas da placa (tracks) mais largas que 10 mil. Filtro	`object:track trackwidth>10mil`
	Localize vias com tamanho de furo de perfuração menor que 8 mil. Filtro	`object:via holesize<8mil`

Pesquisas em Documentos

Use Category	Application Example	Query
Document Objects	Localize todos os objetos em um documento de PCB do projeto (ex.: 'Module1').	`document:module1.pcbdoc`
	Localize todos os objetos no documento esquemático 'Power'.	`sheet:power.schdoc`
	Localize resistores em um esquemático especificado. Filtro	`sheet:power.schdoc type:resistor`

Gerenciamento de Bibliotecas

Use Category	Application Example	Query
Status	Localize todos os componentes que têm um footprint de PCB, mas não têm modelo 3D. Filtro	`has:footprint -has:model3d`
Status	Localize qualquer componente que não tenha um modelo de simulação.	`-has:simulation_model`
Parts Source	Localize componentes usados de uma fonte de biblioteca específica (ex.: Workspace, estoque interno de peças, project.IntLib).	`Library_Path:"Company Stock"`

Versão para impressão

Localizado por IA

Caso encontre um problema, selecione o texto/imagem e primaCtrl + Enterpara nos enviar o seu feedback.