Preferanser for eksterne tjenester

Hvis du vil aktivere integrasjon med en ekstern tjeneste, for eksempel et FileNet Image Services-bibliotek (IS), må du installere og konfigurere en ressursadapter og deretter konfigurere stedspreferansen Eksterne tjenester. Når en ekstern tjeneste er aktivert, kan en bruker legge til en fil i et objektlager som finnes i et eksternt lager. Det faktiske innholdet i filen forblir i det eksterne lageret, og kan ikke sjekkes ut eller endres via applikasjonen. Brukere kan allikevel vise filen og oppdatere egenskapene.

Hvis du for eksempel skal få tilgang til filer i et FileNet IS-bibliotek på samme nettverk, må du installere og konfigurere FileNet Image Services Resource Adapter (ISRA) på Application Engine-serveren. I ISRA-konfigurasjonen konfigurerer du distribusjonsdeskriptorer for ressursadapteren slik at JNDI-navneegenskapen settes til det symbolske navnet (domenenavnet) til FileNet Image Services-biblioteket du vil ha tilgang til. Hvis biblioteknavnet for eksempel er atlas:Pacific, skriver du inn atlas.

MERK  Du må installere den riktige programvaren for ressursadapteren før du konfigurerer innstillingene.

Tjenestenavn

Hver konfigurerte eksterne tjeneste vises med en kort beskrivelse. Du kan legge til en ny ekstern tjeneste eller endre eller slette en eksisterende tjeneste.

Slik konfigurerer du en ekstern referansetjeneste

  1. Gå til Stedspreferanser > Eksterne tjenester.
  2. Klikk på Legg til ny, eller klikk på Endre under navnet til en eksisterende tjeneste. Skriv inn informasjonen for den eksterne tjenesten, og bruk følgende tabell som en rettledning.
    Generell informasjon Beskrivelse Eksempel der et FileNet IS-biblioteket blir brukt som en ekstern tjeneste
    Visningsnavn for tjeneste Tjenestenavnet som vises i Type-feltet i Velg fil-trinnet når du legger til eller sjekker inn et dokument.

    Image Service

    "Image Service" vises i Type-kolonnen (for filen).

    Tjenesteplassering for omdirigering

    Servletten til leverandøren av den eksterne tjenesten som brukes til å hente innhold.

    For en ekstern leverandørtjeneste skriver du inn navnet på servletten fra leverandøren.

    For IS bruker du en av følgende metoder:

    • getISContent
      (For å bruke servletten på serveren som er vert for Workplace.)
    • http://otherAppEngine:port
      /Workplace/getISContent

      (For å bruke en servlett på en annen applikasjonsserver.)
    Referert innholdstype MIME-type levert av ressursleverandøren (forteller Content Engine at dette er et eksternt dokument, og identifiserer dokumenttypen).

    application/x-filenet-external-is

    (MIME-type for FileNet ISRA.)

    Vis på Velg fil-side Viser eller skjuler det eksterne tjenestealternativet i Velg fil-trinnet når du legger til eller sjekker inn et dokument.

    Vis

    Velg Vis for å inkludere Image Services på veivisersidene Legg til nytt dokument og Sjekk inn dokument.

    Krever Token Fastslår om et brukertoken sendes til den eksterne tjenesten for å tillate tilgang uten å tvinge brukeren til å logge seg på tjenesten. Standardinnstillingen er Nei.

    Ja

    Velg Ja for å sende brukerlegitimasjon automatisk til Image Services.

    Include Redirect Flag

    Fastslår om IgnoreRedirect-egenskapsinnstillingen for dokumentet tilføyes til nettadressen. Når denne verdien settes til Ja, og IgnoreRedirect-egenskapen for dokumentet er sann, blir ikke dokumentinnholdet omdirigert til en annen applikasjon, men blir vist i nettleseren. Standardinnstillingen er Ja.

    Denne preferansen samhandler med innstillingen i filen content_redir.properties på Application Engine-serveren. Se filen content_redir.properties hvis du vil ha mer informasjon om å angi hvilke filer som åpnes i hvilken applikasjon.

    Ja

    Når denne verdien er satt til Nei, fastslår filen content_redir.properties på Application Engine-serveren om dokumentet åpnes i Image Viewer eller nettleseren. Standardinnstillingene i denne filen omdirigerer bildetyper (for eksempel BMP, JPG, TIFF og COLD) til Image Viewer.

    URI-informasjon (W3C RFC 2396-oppsett) Beskrivelse Eksempel
    URI <scheme>:<abs_path> Den absolutte banen til den eksterne ressursen. Formatet er scheme:abs_path

    filenet:/is

    Parameterized URI

    En ordnet liste over parameterne, definert i parametere {0} til {3}. Formatet er ?query.

    Skriv inn den parametriserte URI-en uten mellomrom eller linjeskift.

    ?libraryName={0}&id={1}
    &objectType=document
    &pageNumber={2}

    Definerer feltene, som vist i eksemplene nedenfor i henhold til RFC 2396-oppsettet.

    Parameter {0} display name Den første av opptil fire parametere som vises ved siden av oppføringsfeltene for den eksterne tjenesten når du legger til eller sjekker inn et dokument.

    Biblioteknavn

    "Biblioteknavn" er feltetiketten. Det forventes at brukeren skriver inn et biblioteknavn.

    Optional format hint for {0} Et teksttips, eller en beskrivelse, for parameteren {0}. Det vises under det første feltet.

    (for eksempel SolarImages)

    Viser denne teksten som et tips under "Biblioteknavn".

    Parameter {1} display name Den andre av opptil fire parametere som vises ved siden av oppføringsfeltene for den eksterne tjenesten når du legger til eller sjekker inn et dokument.

    Dokument-ID

    "Dokument-ID" er feltetiketten. Dette feltet krever dokument-ID-en.

    Optional format hint for {1} Et teksttips, eller en beskrivelse, for parameteren {1}. Det vises under det andre feltet.

    (for eksempel 123456)

    Viser denne teksten som et tips under "Document-ID".

    Parameter {2} display name

    Den tredje av opptil fire parametere som vises ved siden av oppføringsfeltene for den eksterne tjenesten når du legger til eller sjekker inn et dokument.

    Sidetall

    "Sidetall" er feltetiketten. For IS skriver brukeren inn et bestemt sidetall eller en "0" for å hente alle sidene.

    Optional format hint for {2} Et teksttips, eller en beskrivelse, for parameteren {2}. Det vises under det tredje feltet.

    (skriv inn et sidetall eller 0 for å hente alle)

    Viser denne teksten som et tips under "Sidetall".

    Parameter {3} display name Den fjerde av opptil fire parametere som vises ved siden av oppføringsfeltene for den eksterne tjenesten når du legger til eller sjekker inn et dokument.

    Brukes ikke for IS.

    Optional format hint for {3} Et teksttips, eller en beskrivelse, for parameteren {3}. Det vises under det fjerde feltet.

     

  3. Lagre endringene.