Zum Hauptinhalt springen
Um PEGA zu installieren, müssen Sie den Connector auf den Server importieren und eine Java-Funktion in Pega erstellen. So importieren Sie den Connector auf den Server:
  1. Öffnen Sie Dev Studio und klicken Sie auf Configure → Application → Distribution → Import.
  1. Laden Sie die Datei FlexiCaptureConnector.jar auf den Server.
  2. Öffnen Sie das Pega Self-Service Portal und klicken Sie auf Restart Server.
So erstellen Sie eine Java-Funktion, die Methoden aus Connector-Klassen aufruft:
  1. Erstellen Sie eine neue Bibliothek, indem Sie auf Records → Technical → Library → Create klicken, und geben Sie ihr z. B. den Namen FlexiCaptureLibrary. Fügen Sie dann die folgenden Pakete hinzu:
    • java.util.*
    • java.nio.file.*
    • com.abbyy.connectors.*
    • com.abbyy.connectors.models.*
  1. Klicken Sie auf Save und anschließend auf Generate Library.
  2. Erstellen Sie eine neue Funktion, indem Sie auf Records → Technical → Function → Create klicken.
  3. Geben Sie im Feld Label einen Namen für die neue Funktion an (z. B. CaptureData).
  4. Geben Sie im Abschnitt Parameters die folgenden beiden Eingabeparameter an:
NameJava-Typ
FileNameString
Base64ContentString
  1. Geben Sie im Feld Library den Namen der Bibliothek ein, die Sie in Schritt 1 erstellt haben, und klicken Sie auf Create and open.
  2. Geben Sie im sich öffnenden Fenster auf dem Parameters-Tab String als Datentyp im Feld Java data type an:
  1. Kopieren Sie den Code aus der Datei CodeExample.java, die Sie unter %Installation Path%\Connector for FlexiCapture as a Service\Samples\Pega Function finden (der Code ist unten der Einfachheit halber noch einmal aufgeführt). Klicken Sie im selben Fenster auf den Tab Java und fügen Sie den gerade kopierten Code ein. Dieser Beispielcode sendet Dateien an FC und gibt die Verarbeitungsergebnisse in Form von JSON-Strings mit den Namen der erfassten Felder und ihren Werten zurück. Die gelb hervorgehobenen Codefragmente müssen durch gültige Verbindungsdaten ersetzt werden, die für die Verbindung zum FC Application Server erforderlich sind. Laden Sie dann Ihr Projekt auf den FC Application Server hoch und konfigurieren Sie es.
// FlexiCapture Web Services API-Client wird erstellt. Bitte geben Sie hier die Adresse des FlexiCapture Application Servers an. 
try (FlexiCaptureWebServiceClient client = new FlexiCaptureWebServiceClient("https://FlexiCaptureApplicationServer")) {
// Bitte kommentieren Sie die folgende Zeile ein und geben Sie einen Unternehmensnamen an, um mit FlexiCapture Cloud oder einem Tenant zu interagieren.
// client.setTenant("Company");
// Bitte geben Sie gültige FlexiCapture-Benutzeranmeldedaten an.
client.setCredentials(new Credentials("Username", "Password"));
// FlexiCapture-Projekt wird abgerufen. Bitte geben Sie hier einen Projektnamen an.
try (FlexiCaptureProject project = client.getProject("InvoiceDemoProject")) {
// Eine Datei wird für den Upload zu FlexiCapture vorbereitet. 'FileName' und 'Base64Content' sind Pega-Funktionsparameter.
List<File> files = new ArrayList<File>();
files.add(new File(FileName, Base64.getDecoder().decode(Base64Content.replace("\n", "").replace("\r", ""))));
// Ein Auftrag für die FlexiCapture-Batch-Verarbeitung wird vorbereitet.
BatchCreationJob job = new BatchCreationJob(files);
job.setName("Pega_" + System.currentTimeMillis());  // FlexiCapture-Batch-Name wird festgelegt.
job.setType("Default");                             // FlexiCapture-Batch-Typname wird festgelegt.
// FlexiCapture-Batch wird erstellt und ausgeführt.
int batchId = project.create(job);
// Es wird auf die Verarbeitung des Batches gewartet und die Verarbeitungsergebnisse werden abgerufen.
Result result = project.getResult(batchId);
// Prüfen, ob die Batch-Stufe Processed ist.
if (result.getStage() == com.abbyy.connectors.models.Stage.Processed) {
// Erfasste Felder werden als JSON-String zurückgegeben.
return result.getFields();
} else {
// Für andere Stufen wird eine Ausnahme ausgelöst.
// Anstatt die Ausnahme auszulösen, kann hier die Verarbeitung dieser Stufen konfiguriert werden.
throw new FlexiCaptureConnectorException(String.format("Unsupported FlexiCapture stage type '%s'.", result.getStage()));
}
}
} catch (Exception ex) {
// Fehlermeldungen werden verkettet.
Throwable cause = ex.getCause();
String message = ex.getMessage();
while (cause != null) {
message += " " + cause.getMessage();
cause = cause.getCause();
}
// Verkettete Meldung wird ausgelöst.
throw new FlexiCaptureConnectorException(message);
}
  1. Klicken Sie auf die Registerkarte Imports & Exceptions und geben Sie im Abschnitt Exceptions thrown Exception ein.
  2. Gehen Sie zurück zur Registerkarte Java, wählen Sie die Option Function ready to be compiled? aus, speichern Sie Ihre Änderungen und klicken Sie auf Generate function. Wenn die Funktion erfolgreich generiert wurde, wird diese Meldung angezeigt: