Um Relatório de Utilização da API descreve um conjunto de referências de um conjunto de agrupamentos para outro conjunto de agrupamentos. Um relatório pode ser gerado utilizando Tarefa Ant de Utilização da API. Uma interface de utilizador é fornecida para configurar e gerar um relatório na caixa de diálogo Ferramentas Externas. Para criar uma nova configuração de pesquisa basta fazer duplo clique no tipo de configuração Relatório de Utilização da API.
O separador Relatório de utilização da API permite configurar a análise.
O exemplo seguinte mostra uma configuração para extrair todas as referências para agrupamentos Eclipse numa instalação 3.4.

| Opção |
Descrição |
Predefinição |
|---|---|---|
| Analisar | É possível seleccionar o que pretende analisar: uma linha de base da API, uma definição de destino ou um directório de lotes. Pode igualmente seleccionar gerar apenas HTML para um relatório existente. Pode seleccionar somente uma opção, podendo configurar cada opção. Por exemplo, pode ir à página de preferências de linhas de base da API para editar linhas de base se seleccionar analisar uma linha de base da API. | Linha de base da API |
| Analisar > Linha de base da API | Pode escolher na caixa de combinação qualquer uma das linhas de base a analisar | Linha de base predefinida ou vazia |
| Analisar > Linhas de base... | Permite acesso à página de preferências de Linhas de base da API para configurar a linha de base a analisar. | |
| Analisar > Definição de destino | Pode escolher na caixa de combinação qualquer uma das definições de destino a analisar | Para activar a definição de destino ou vazio |
| Analisar > Destinos | Permite acesso à página de preferências de Plataforma destino para configurar a definição de destino a analisar. | |
| Analisar > Directório | Pode introduzir o caminho absoluto para o directório que contém os lotes. | vazio |
| Analisar > Navegar... | Permite navegar por uma pasta de lotes a analisar. | |
| Analisar > Gerar relatório HTML para pesquisa de utilização existente | Permite criar um relatório para uma pesquisa existente e não ter de executar a análise novamente. | |
| Pesquisar > Referências a | Permite especificar o nome (ou RegEx correspondente) do lote em que pretende ver referências a.
Considere o exemplo seguinte: org\.eclipse.*. Neste exemplo, declaramos que pretendemos ver todas as referências a qualquer lote que comece pelo nome org.eclipse.. |
vazio |
| Pesquisar referências > da API | Permite pesquisar referências a API. | não marcado |
| Pesquisar referências > internas | Permite pesquisar referências internas. | marcado |
| Pesquisar > Utilização ilegal da API | Permite pesquisar a utilização ilegal da API, isto é, a utilização de membros da API restritos. | não marcado |
| Pesquisar > Lotes correspondentes | Permite especificar o nome (ou RegEx correspondente) do lote(s) em que pretende pesquisar referências, isto é, um âmbito de pesquisa.
Considere o exemplo seguinte: .*. Neste exemplo, declaramos que pretendemos ver todos os lotes cujo nome corresponda a qualquer sequência de caracteres.
Pode ser conseguido o mesmo resultado deixando o campo em branco. |
vazio |
| Registar > tipo de relatório | Permite-lhe escolher entre dois formatos de relatórios html. Se a opção Relatório de lotes referenciados (Produtores) estiver seleccionada, o relatório
irá listar todos os lotes que contêm os tipos que estão a ser referenciados nos lotes pesquisados. Se a opção Relatório de lotes de referência (Consumidores) estiver seleccionada, o relatório será
organizado para mostrar todos os lotes no âmbito de pesquisa que contêm referências.
Ao trocar tipos de relatórios, verifique se as expressões regulares Referências a e Correspondência de lotes têm os valores correctos. Ao utilizar uma expressão de carácter global como .* numa definição, mudar para outro tipo de relatório requer muitas vezes que o carácter global seja movido para a outra definição para obter o relatório mais útil. |
Relatório de lotes referenciados (Produtores) |
| Criar relatórios > Relatório de localização de saída | Permite especificar o caminho absoluto em que quaisquer relatórios gerados deverão ser colocados. | vazio |
| Criar relatórios > Navegar... | Permite seleccionar a localização de saída de quaisquer relatórios. | |
| Criar relatórios > Limpar directório de relatórios antes de comunicar novos resultados | Permite limpar uma localização de relatórios XML existente antes de a pesquisa comunicar resultados. Deve ser tido em conta que esta opção irá remover totalmente o directório de relatórios especificado caso exista, incluindo também todos os seus directórios descendentes. | não marcado |
| Criar relatórios > Criar relatórios HTML | Converte todas as saídas em XML para HTML formatado e coloca-as em <report location>\html |
não marcado |
| Criar relatórios > Limpar localização de relatórios HTML | Permite limpar uma localização de HTML antes de criar relatórios novos. Deve ser tido em conta que esta opção irá remover completamente o directório de HTML caso exista, incluindo também todos os seus directórios descendentes. Esta opção é activada apenas se seleccionar a opção Criar relatórios HTML acima referida. | não marcado |
| Criar relatórios > Abrir relatório quando pesquisa terminar | Abre o relatório HTML quando a análise é concluída. Esta opção é activada apenas se seleccionar a opção Criar relatórios HTML acima referida. | não marcado |
| Criar relatórios > Descrição | Permite introduzir uma descrição legível do relatório. | vazio |
O separador Padrões permite criar vários padrões de Expressão regular para controlar a análise de utilização. Existem actualmente três tipos de padrões suportados:

| Opção |
Descrição |
Predefinição |
|---|---|---|
| Adicionar... | Permite adicionar um novo padrão. Este botão irá iniciar o assistente Assistente Padrões. | |
| Editar | Permite editar o padrão actualmente seleccionado. Só pode editar um padrão de cada vez. | |
| Remover | Permite remover os padrões seleccionados. Pode remover mais de um padrão de cada vez. |

Comparar com uma linha de base da API
Configurar uma linha de base

Preferências de Linhas de Base de API
Assistente de padrões de utilização da API