Ohjelmointirajapinnan käytön raportit

Ohjelmointirajapinnan käytön raportit kuvaa yhden resurssijoukon viittaukset toiseen resurssijoukkoon. Raportti voidaan luoda Ohjelmointirajapinnan käytön Ant-tehtävän avulla. Ulkoiset työkalut -valintaikkunassa on käyttöliittymä, jonka avulla raporttia voi muokata ja josta sen voi luoda. Jos haluat luoda uuden etsintäkokoonpanon, kaksoisnapsauta Ohjelmointirajapinnan käyttöraportti -kokoonpanon tyyppiä.

Ohjelmointirajapinnan käyttöraportti -välilehti

Ohjelmointirajapinnan käyttöraportti -välilehdellä voi määrittää analyysin asetuksia.

Seuraavassa esimerkissä näkyy kokoonpano, joka on määritetty muuntamaan kaikki Eclipsen version 3.4 resurssijoukkoihin tehdyt viittaukset.

Ohjelmointirajapinnan käyttöraportti -välilehti


Asetus

Kuvaus

Oletusarvo

Analysoi Voit valita, mitä haluat analysoida. Se voi olla joko ohjelmointirajapintojen perustaso, kohdemääritelmä tai resurssijoukkojen hakemisto. Lisäksi voit valita, että olemassa olevasta raportista luodaan vain HTML-tiedosto. Voit valita vain yhden vaihtoehdon, mutta voit kuitenkin määrittää kunkin vaihtoehdon asetuksia. Voit siis esimerkiksi muuttaa olemassa olevia perustasoja ohjelmointirajapintojen perustasojen oletusasetussivulta, jos valitset analysoitavaksi kohteeksi ohjelmointirajapintojen perustason. Ohjelmointirajapintojen perustaso
Analysoi > Ohjelmointirajapintojen perustaso Voit valita analysointia varten haluamasi ohjelmointirajapintojen perustason yhdistelmäruudusta. Oletusperustaso tai tyhjä
Analysoi > Perustasot... Sallii Ohjelmointirajapintojen perustasot -oletusasetussivun käytön analysoitavien perustasojen määrittämistä varten.  
Analysoi > Kohdemääritys Voit valita analysointia varten haluamasi kohdemäärityksen yhdistelmäruudusta. Aktiivinen kohdemääritys tai tyhjä
Analysoi > Kohteet Sallii Kohdekäyttöympäristö -oletusasetussivun käytön analysoitavien kohdemääritysten määrittämistä varten.  
Analysoi > Hakemisto Voit syöttää resurssijoukot sisältävän hakemiston absoluuttisen polun. tyhjä
Analysoi > Selaa... Voit etsiä analysoitavien resurssijoukkojen kansion selaamalla.  
Analysoi > Luo HTML-raportti olemassa olevasta käyttöetsinnästä Tämän avulla voit luoda raportin aiemmin suoritetusta etsinnästä, jolloin analyysia ei tarvitse suorittaa uudestaan.  
Hae > Viittauksia kohteeseen Voit määrittää sen resurssijoukon nimen (tai vastaavan RegEx:n), johon tehdyt viittaukset haluat nähdä. Oletetaan, että käytät esimerkiksi seuraavaa koodia: org\.eclipse.*. Tämä tarkoittaa, että haluamme nähdä kaikki viittaukset sellaisiin resurssijoukkoihin, joiden nimen alkuosa on org.eclipse.. tyhjä
Hae > Ohjelmointirajapinnan viittauksia Tämän avulla voit hakea ohjelmointirajapinnan viittauksia. ei valittuna
Hae > Sisäisiä viittauksia Tämän avulla voit hakea sisäisiä viittauksia. valittuna
Hae > Ohjelmointirajapinnan virheellisiä käyttötapoja Tämän avulla voit hakea ohjelmointirajapinnan virheellisiä käyttötapoja, kuten ohjelmointirajapinnan rajoitettujen jäsenten käyttöä. ei valittuna
Hae kohteesta > Vastaavat resurssijoukot Tämän avulla voit määrittää sen resurssijoukon nimen tai niiden resurssijoukkojen nimet (tai vastaavan RegEx:n), joista haluat etsiä viittauksia (ts. hakualueen). Oletetaan, että käytät esimerkiksi seuraavaa koodia: .*. Tämä tarkoittaa, että haluamme etsiä kaikista niistä resurssijoukoista, joiden nimi vastaa mitä tahansa merkkisarjaa. Sama lopputulos saavutetaan jättämällä kenttä tyhjäksi. tyhjä
Raportointi > Raporttityyppi Tämän asetuksen avulla voit valita kahdesta html-raporttimuodosta. Jos valitset Viitatut resurssijoukot -raportin (tuottajat), raportti näyttää kaikki resurssijoukot, jotka sisältävät etsityissä resurssijoukoissa viitattavia tyyppejä. Jos valitset Viittaavat resurssijoukot -raportin (kuluttajat), raportti näyttää kaikki etsittävän alueen resurssijoukot, jotka sisältävät viittauksia.

Jos vaihdat raporttityypin, tarkista, että viittaukset säännöllisiin lausekkeisiin ja säännöllisiä lausekkeita vastaavat resurssijoukot ovat oikein. Jos käytät yleismerkkiä (esimerkiksi .*) jossain asetuksessa, toiseen raporttityyppiin vaihtaminen vaatii tavallisesti yleismerkin siirtämisen toiseen asetukseen, jotta raportista saa parhaan mahdollisen hyödyn.

Viitatut resurssijoukot -raportti (tuottajat)
Raportointi > Raportin tulostussijainti Tämän avulla voit määrittää absoluuttisen polun, johon luodut raportit sijoitetaan. tyhjä
Raportointi > Selaa... Tämän avulla voit valita, mihin raportit sijoitetaan.  
Raportointi > Poista raporttihakemisto ennen uusien tulosten raportointia Tämän avulla voit poistaa aiempien XML-raporttien sijainnin ennen kuin hakutoiminto raportoi uusia tuloksia. Huomautus: Tämä vaihtoehto poistaa koko valitun raportointihakemiston (jos se on olemassa) sekä rekursiivisesti kaikki sen alihakemistot. ei valittuna
Raportointi > Luo HTML-raportit Muuntaa kaikki XML-tulosteet muotoilluiksi HTML-tiedostoiksi ja sijoittaa ne hakemistoon <raportin sijainti>\html ei valittuna
Raportointi > Poista HTML-raporttien sijainti Tämän avulla voit poistaa aiempien HTML-raporttien sijainnin ennen uusien raporttien luomista. Huomautus: Tämä vaihtoehto poistaa koko valitun HTML-hakemiston (jos se on olemassa) sekä rekursiivisesti kaikki sen alihakemistot. Tämä vaihtoehto on valittavissa vain, jos yllä mainittu Luo HTML-raportit -vaihtoehto on valittuna. ei valittuna
Raportointi > Avaa raportti, kun haku on valmis Avaa HTML-raportin analyysin valmistumisen jälkeen. Tämä vaihtoehto on valittavissa vain, jos yllä mainittu Luo HTML-raportit -vaihtoehto on valittuna. ei valittuna
Raportointi > Kuvaus Tämän avulla voit kirjoittaa raportille luettavassa muodossa olevan kuvauksen. tyhjä

Mallit-välilehti

Mallit-välilehden avulla voit luoda useita erilaisia käyttöanalyysin hallintaan käytettäviä säännöllisten lausekkeiden malleja. Järjestelmä tukee tällä hetkellä kolmenlaisia malleja:

  1. Arkistomalli - Tämän avulla voit määrittää sisäkkäiset arkistot, jotka ohitetaan analyysia tehtäessä.
  2. Pakettimalli - Tämän avulla voit määrittää ohjelmointirajapinnan paketit ja sisäiset paketit ilman, että sinun täytyy päivittää resurssijoukon manifest-tiedostoa.
  3. Raportin muuntomalli - Tämän avulla voit luoda paketin nimeä koskevan säännöllisen lausekkeen, jonka avulla raportoitavat viittaukset suodatetaan. Kaikki raportoitavat viittaukset suodatetaan niiden paketin tarkennetun nimen perusteella.

Mallit-välilehti


Asetus

Kuvaus

Oletusarvo

Lisää... Tämän avulla voit lisätä uuden mallin. Tämä painike käynnistää Ohjatun mallitoiminnon.  
Muokkaa Tämän avulla voit muokata valittuna olevaa mallia. Voit muokata vain yhtä mallia kerrallaan.  
Poista Tämän avulla voit poistaa valittuja malleja. Voit poistaa kerralla myös useita malleja.  

Aiheeseen liittyviä tehtäviä

Vertailu ohjelmointirajapintojen perustasoon
Perustason määritys

Aiheeseen liittyviä ohjeita

Ohjelmointirajapintojen perustasojen oletusasetukset
Ohjelmointirajapinnan käyttömallien ohjattu toiminto