Base64 kodierte Inhalte einer Datei in AgilePoint Prozessdaten laden

Einige Webservices erforden als Eingang Base64 kodierte Inhalte einer Datei. Speichern Sie diese in AgilePoint Prozessdaten und verwenden diese dann im Mapping auf die eine WebService Methode. Hierzu benötigen Sie eine AgilePoint Erweiterung - exemplarisch umgesetzt als WebService. Die Methode "GetFileContentAsBase64" rufen Sie aus einem AgileProzess heraus auf. Diese lädt eine Datei über eine URL und gibt deren Inhalt Base64 kodiert zurück. Laden Sie den WebService hier runter.

1.) Extrahieren Sie das Archive und stellen Sie den WebSerice im IIS bereit

2.) Setzen Sie den Application Pool, z.B. der AgilePoint AppPool. Der Account des App Pool muss auch auf URLs berechtigt sein, die Sie später aufrufen (z.B. SharePoint DocLib).

3.) Erstellen Sie ein Global Acces Token auf den WebService

4.) Erstellen Sie eine AgilePoint Anwendung

5.) Fügen Sie dem Formular ein "File Upload" Control hinzu und konfigurieren eine SharePoint DocLib als Repository

6.) Erstellen Sie eine lokale Variable zum Speichern des Base64 kodierten Inhaltes

7.) Erstellen Sie im Prozess mit dem WCF WebService Activity den Zugriff auf den eigenen WebService und konfigurieren den Zugriff

8.) Führen Sie das Deployment der Anwendung durch

9.) Füllen Sie das Formular aus und senden es ab

10.) Suchen Sie die Prozessdaten raus und kontrollieren die Base64  kodierten Inhalte der  Datei

11.) Verwenden Sie die Base64  kodierten Inhalte der  Datei nun in folgenden Activities (z.B. andere WebService Calls).

Dynamische Abfrage einer Datenbank Tabelle mit eingeloggtem Benutzer im Filterkriterium

Oft benötigen Sie die Abfrage einer Datenbank Tabelle unter Einbezug des eingeloggten Benutzers als Filterkriterium und verwenden dies in einem e-Form Formular oder Prozess. Das folgende Beispiel zeigt die Verwendung der folgenden Datenbank Tabelle mit den Feldern "Id", "Name" und "Owner" mit exemplarischem Inhalt:

1.) Verwenden/Erstellen Sie die Datenbank und erstellen Sie dann ein AgilePoint  "Global Access Token" auf diese Datenbank.

2.) Erstellen Sie ein e-Form und fügen zwei Textboxen und eine DropDown hinzu

3.) Weisen Sie der einen Textbox aus "System Data" den Wert "UserName" zu

Verfahren analog mit der zweiten Textbox und weisen den Wert "UserGroups" aus "System Data" zu. Dies wird aber im Beispiel nicht verwendet, sondern soll zeigen wie Sie die Gruppemigliedschaften dynamisch im Formular z.B. im Filter eines Lookups abfragen können.

4.) Konfigurieren Sie das Lookup auf die Datenbank Tabelle und verwenden das zuvor erstellte "Global Access Token"

5.) Führen Sie das Deployment der Anwendung durch

6.) Rufen Sie das e-Fom auf

Anmerkung: Sie können die Werte "UserName" und "UserGroups" aus "System Data" direkt in Filterkriterien verwenden ohne den Umweg über Textboxen. Dieses Weg hier empfehlen wir zum Einstieg.

AgilePoint Benutzername aus Fullname ermitteln

In einigen Szenarien ist nur der Fullname eines Benutzers bekannt (bspw. per Schnittstelle übergeben) - die Aufgabenvergabe in AgilePoint basiert jedoch für Benutzer auf Basis des Benutzernamen. Per WebService Call fragen Sie diese Informationen nach. Sie benötigen die Methode "QueryRegisterUsers" mit der Sie beliebig komplexe Abfragen gegen AgilePoint Benutzer formulieren per SQL Statement. Im folgenden verwenden wir den Zugriff per REST, SOAP funktioniert analog:

1.) Finden Sie die Swagger URL im AgilePoint Portal

2.) Öffnen Sie Swagger und authorisieren Sie sich mit einem Benutzer entsprechender Rechte (z.B. Egine Account)

3.) Testen Sie die AgilePoint Admin Service Methode "QueryRegisterUsers" mit Swagger, verwenden Sie dazu als SQL Statement FULLNAME = 'OneOfYourUsersFullName'. Fügen Sie die Abfrage ein

und senden Sie die Abfrage ab mit Klicken der Schaltfläche "Try it out". Das ergibt dann als Antwort ein Benutzer, falls es diesen gibt:

Anmerkung: verwenden Sie in Ihrer SQL Abfrage immer Spaltennamen aus dem AgilePoint DB Schema (nicht die Property Namen aus dem Objektmodell >> hier: FULL_NAME anstatt Fullname). Für Benutzer sind diese wie folgt:

4.) Verwenden Sie nun "QueryRegisterUsers" entsprechend in Ihrem Prozess (REST Workflow Activity) oder in einem e-Form Formular (Lookup)