DocCheck: DocCheck Mobile Login iOS

Der folgende Artikel richtet sich an App-Entwickler und ITler. Allgemeine Informationen zu unserem Mobile Login finden Sie hier

1 Hinzufügen des Antwerpes-Frameworks

Wichtig: Die iOS SDK Frameworks CFNetwork, SystemConfiguration und libz.dylib sind für den DocCheck App-Login erforderlich. Wir empfehlen stehts die aktuellste XCode-Version zu verwenden. Im letzten Schritt passen wir die Login-Schnittstelle an Ihre App an. Bitte teilen Sie uns hierfür die ID Ihres DocCheck Logins sowie Ihre AppID (Bundle Identifier) mit.

Um den DocCheckLogin innerhalb Ihrer App verwenden zu können müssen Sie zunächst das Antwerpes.framework zu ihrem Projekt hinzufügen.

Klicken Sie dazu mit der rechten Maustaste auf „Frameworks“ → „Add“ → „Existing Files...“.


Navigieren Sie in das Verzeichnis, in das Sie den Ordner Antwerpes.framework entpackt haben. Wählen Sie Antwerpes.framework und klicken Sie „Add“.


2 Controller anpassen

Erstellen Sie hierzu zunächst unter http://crm.doccheck.com einen neuen Login. Während der Konfiguration erhalten Sie die Login ID. Die Start- und Ziel-URL sind nicht wichtig, hier können Sie einfach Dummy-URLs eintragen. Importieren Sie in der .h Datei einer Klasse (z.B. einem View Controller) das Antwerpes Framework und fügen Sie ihr das DocCheckLoginDelegate Protokoll hinzu.

Beispiel der Klasse DocCheckLoginTestViewController.h:

  1. import <Antwerpes/Antwerpes.h>
@interface
DocCheckLoginTestViewController :
UIViewController<DocCheckLoginDelegate> {
...
}
...
@end

Um das DocCheck Login Formular anzuzeigen muss folgender Code verwendet werden (z.B. in einer IBAction):

– (IBAction) startLogin {
APDocCheckLogin *dcl = [APDocCheckLogin sharedInstance];
dcl.loginId = @“1234567890123“; // Ihre DocCheck Login ID
dcl.delegate = self;
dcl.language = @”de”; // Erlaubte Sprachen: de, com, es, fr, nl, it
[self.view addSubview:dcl.view]; // Fügt den DocCheckLogin ihrer
View hinzu
}

Sie haben auch die Möglichkeit den Login bereits im Hintergrund zu laden. Ersetzen Sie dazu [self.view addSubview:dcl.view]; durch [dcl requestRemoteLoginForm];.

Bitte beachten Sie bei dieser Variante auf die zusätzlichen Methoden zu erfolgtem oder fehlerhaftem Laden des Templates!

Wird diese Variante bevorzugt, kann das Login Formular im Anschluss wie folgt aufgerufen werden:

– (IBAction) startLogin {
APDocCheckLogin *dcl = [APDocCheckLogin sharedInstance];
[self.view addSubview:dcl.view]; // Fügt den DocCheckLogin Ihrer
View hinzu.
}

3 Methoden

Zusätzlich müssen die folgenden Methoden des DocCheckLoginDelegates implementiert werden:

– (void)docCheckLoginSuccessful; Wird aufgerufen sobald der Login erfolgreich abgeschlossen ist. Nun kann das Programm normal weiter ausgeführt werden, die View des DocCheck Login entfernt sich eigenständig.

– (void)docCheckLoginFailedWithError:(NSError *)error; Wird aufgerufen, wenn der Login aufgrund einer nicht bestehenden Internetverbindung fehlschlägt. Der Nutzer sollte über den Fehler informiert und der Fehler angemessen behandelt werden.

Die folgenden Methoden des DocCheckLoginDelegates können optional implementiert werden:

– (void)docCheckLoginCanceled; Wird aufgerufen, sobald der Login von dem Benutzer manuell durch Betätigung des „Zurück-Pfeiles“ abgebrochen wurde.

– (void)docCheckLoginReceivedUserInfo:(NSDictionary *)userInfo; Wird aufgerufen, nachdem der Login erfolgreich abgeschlossen wurde. userInfo beinhaltet detaillierte Informationen des Benutzerprofils, falls der Benutzer zuvor der Verwendung entsprechender Daten in seinen Profileinstellungen zugestimmt hat.

– (void)docCheckLoginFormDidFailInBackgroundWithErrpr:(NSError*)error; Wird aufgerufen, wenn der Login im Hintergrund geladen wird, es auf Grund von technischen Problemen aber zu einem Fehler führt.

– (void)docCheckLoginFormDidLoadInBackground; Wird aufgerufen, wenn der Login erfolgreich im Hintergrund geladen wurde.

Um diesen Artikel zu kommentieren, melde Dich bitte an.

Klicke hier, um einen neuen Artikel im DocCheck Flexikon anzulegen.
0 Wertungen (0 ø)

1.934 Aufrufe

Hast du eine allgemeine Frage?
Hast du eine Frage zum Inhalt?
Copyright ©2020 DocCheck Medical Services GmbH | zur mobilen Ansicht wechseln
DocCheck folgen: