Skip to main content
Administrator Guide
Laatst bijgewerkt: 2023-06-23
Referentie: eigenschappen voor transport FTP-uitgaan

Referentie: eigenschappen voor transport FTP-uitgaan

Tabblad Algemeen

Eigenschap
Naam XML-kenmerk
Omschrijving
ID
id
De unieke ID van de
ftp-uit-
component binnen de assemblage.
Routeert antwoord naar:
routes-response-to
De bestemming van het antwoordbericht voor het
ftp-uit-
transport.
Wanneer uitvoeren
execute-when
Een voorwaarde die bepaalt of het transport wordt uitgevoerd.
Eindpunt:
endpoint
Hiermee geeft u de host (en optioneel de poort) en de FTP-map op waarnaar bestanden moeten worden geschreven.
Volgt de notatie
ftp://FTP-directory
, waarbij
FTP-directory
is de doellocatie.
Voorbeeld:
ftp://ftpserver.example.org/outputDir
De maplocatie die u opgeeft, moet al bestaan op de FTP-server.
Binair bestand
binary-file
Hiermee wordt aangegeven of de uitvoerbestanden als binair moeten worden overgedragen.
Patroon voor invoerbestand
input-file-pattern
Een bestandsnaampatroon voor het matchen van bestanden van een bepaald type.
Voorbeeld: specificeer
*.xls
om alleen Excel-bestanden op te halen.
Type invoerinhoud
input-content-type
Het mediatype dat de runtime bevat voor ''
content-type
waarde in de berichtkop. Een mediatype bestaat uit ten minste twee delen: een type, een subtype en een of meer optionele parameters. De
text
subtype heeft een optioneel
charset
parameter, waarmee de tekencodering wordt opgegeven.
Voorbeeld:
text/html; charset=UTF-8
Deze eigenschap is met name handig in het geval van niet-XML-tekstbestandsindelingen waarbij het mediatype en de tekenset niet expliciet in het bestand worden vermeld.
Patroon uitvoerbestand
output-file-pattern
Hiermee wordt aangegeven hoe de namen van uitvoerbestanden worden gegenereerd. Het patroon kan zowel letterlijke tekenreeksen als een of meer van deze tokens bevatten:
  • ${INFILE}
    , die wordt vervangen door de naam van het invoerbestand.
  • ${UUID}
    , die wordt vervangen door een universeel unieke ID.
  • ${EXT}
    , aan het einde van het patroon, dat wordt vervangen door een bestandsnaamextensie op basis van het inhoudstype van de gegevens die naar de uitvoer van de assemblagecomponent worden geschreven.
Methode
method
Hiermee geeft u de overdrachtsmethode op:
  • put
    : schrijft bestanden naar het FTP-eindpunt dat de externe map bevat.
  • list
    : hiermee worden alle bestanden en mappen op het FTP-eindpunt weergegeven. De eigenschap
    Input File Pattern
    gebruiken met:
    list
    om een patroon toe te passen op de aanbieding die wordt geretourneerd. U hebt toegang tot de resultaten van de
    list
    met behulp van het
    ftp-
    object MVEL. Voorbeeld:
    ftp.list()
    retourneert een lijst met tekenreeksen die de laatst opgehaalde lijst bevat.
  • get
    : hiermee wordt het eerste bestand opgehaald dat matcht met de waarde van de eigenschap
    Input File Pattern
    .
  • delete
    : hiermee wordt het eerste bestand verwijderd dat matcht met de waarde van de eigenschap
    Input File Pattern
    .
    Een bestand wordt niet automatisch verwijderd van de FTP-site na a
    get
    is uitgevoerd. Als u een bestand wilt verwijderen, moet u een afzonderlijke methode aanroepen. Voorbeeld: u kunt een afzonderlijke opnemen
    ftp-out
    transport specifiek om het bestand te verwijderen.
Wachtwoord
password
Het wachtwoord dat is gekoppeld aan de gebruikersnaam die wordt gebruikt om toegang te krijgen tot de FTP-server.
Gebruikersnaam
username
De gebruikersnaam die wordt gebruikt om toegang te krijgen tot de FTP-server.

Tabblad Geavanceerd

Eigenschap
Naam XML-kenmerk
Omschrijving
Bericht opslaan
store-message
Geef
geen
op, tenzij anders aangegeven door de ondersteuningsafdeling van Workday.
Gebruik de
opslagstap
van Studio om berichten op te slaan.
Transportklasse
transport-class
Hiermee wordt indien vereist een alternatieve implementatieklasse per samenstel opgegeven.
U kunt de implementatieklassen globaal wijzigen door het bestand WEB-INF/classes/spring/assembly-bean.xml te bewerken.
Dynamische eindpunten negeren
ignore-dynamic-endpoints
Hiermee wordt aangegeven of de dynamische WS-Addressing (WSA)-waarde in de koptekst van het inkomende bericht moet worden genegeerd of moet worden gebruikt om de waarde in de eigenschap
Endpoint
van het transport te overschrijven.
Gebruik de stap
set-dynamic-endpoint
om WS-Addressing-details op te geven.
Passieve modus:
passive-mode
Hiermee wordt aangegeven of het transport FTP in de passieve modus ondersteunt.
In de passieve modus initieert de FTP-client beide verbindingen die vereist zijn voor de FTP-overdracht. De client maakt via de opdrachtpoort contact met de server en geeft de PASV-opdracht uit. De server antwoordt vervolgens en geeft aan naar welke poort wordt geluisterd voor de gegevensverbinding. De client start vervolgens de gegevensverbinding vanaf de gegevenspoort naar de opgegeven servergegevenspoort. Ten slotte verzendt de server een ACK terug naar de gegevenspoort van de client. In de actieve modus start de client de opdrachtverbinding en start de server de gegevensverbinding.
Time-out
timeout
Hiermee geeft u in milliseconden een time-outperiode op voor FTP-sessies tussen clients en de FTP-server waarop het transport luistert.
Als u geen waarde opgeeft, treedt er na 300.000 ms (5 minuten) een time-out op in de sessie.
Toewijzingsbestand MIME-typen
mime-types-map-file
De locatie van een toewijzingsbestand voor toewijzing tussen MIME-typen en bestandsextensies. Gebruik deze eigenschap om:
  • Wijs MIME-typen toe aan bestandsextensies wanneer de eigenschap
    Method
    is ingesteld op:
    put
    .
  • Bestandsextensies toewijzen aan MIME-typen wanneer de eigenschap
    Method
    is ingesteld op:
    get
    .
Het bestand voor deze toewijzing is
ccx/conf/mime.types
. U kunt uw eigen versie van dit bestand opgeven.
Dit transport kan bestandsnamen genereren voor de uitvoerbestanden met behulp van a
${EXT}
token geplaatst aan het einde van
output-file-pattern
waarde.
Naam tijdelijk bestand
temp-file-name
Hiermee geeft u een tijdelijke bestandsnaam op. Wanneer de eigenschap
Method
is ingesteld op:
put
, wordt het bestand geüpload met deze tijdelijke bestandsnaam. Nadat de FTP is voltooid, wordt de naam van het bestand gewijzigd in de naam die is opgegeven in de eigenschap
Output File Pattern
.
Verbinding sluiten
close-connection
Hiermee wordt aangegeven of de verbinding wordt verbroken wanneer de FTP-actie is voltooid.
Poolgrootte
pool-size
Het maximum aantal gelijktijdige verbindingen en sessies dat per host kan worden ondersteund voor deze component. Als meer dan het opgegeven aantal threads verbinding proberen te maken met dezelfde host, moeten sommige threads wachten op toegang tot de pool.
Als u de poolgrootte onbeperkt wilt maken, geeft u een negatief getal op.
Foutopsporing
debug
Schakelt de JSCAPE-foutopsporingsmodus in het transport in.