Podłączanie do programu Vault

Połączenie VDF jest jednym z głównych punktów dostępu do usług dostarczanych za pomocą platformy VDF.

Połączenie VDF jest reprezentowane przez wystąpienie klasy VDF.Vault.Currency.Connection.Connection. W celu uzyskania obiektu połączenia VDF należy zalogować się z poziomu aplikacji klienckich do serwera Vault. Platforma VDF udostępnia programowe metody logowania zarówno w trybie interfejsu graficznego, jak i bez niego. Zwracają one albo obiekt zawierający nowo utworzone połączenie VDF, albo bezpośrednio obiekt połączenia.

Aby można było przeprowadzić logowanie w trybie interfejsu graficznego, z poziomu aplikacji klienckiej powinna zostać wywołana metoda VDF.Vault.Forms.Library.Login(). Ta metoda pobiera obiekt VDF.Vault.Forms.Settings.LoginSettings, który pozwala klientom dostosować zachowanie funkcji logowania platformy VDF. Logowanie w trybie interfejsu graficznego spowoduje pojawienie się okna dialogowego zawierającego monit o podanie informacji logowania, postęp logowania i umożliwiającego zarządzanie trwałością danych logowania itp. Ilustracje jego użycia można znaleźć w przykładowych aplikacjach dostarczanych z zestawem SDK programu Vault (na przykład aplikacja VaultFileBrowser).

Logowanie w trybie bez interfejsu graficznego umożliwia przesyłanie z poziomu aplikacji klienckich poświadczeń logowania bezpośrednio do platformy VDF bez wyświetlania monitu o wprowadzenie danych przez użytkownika. Logowanie w tym trybie odbywa się za pomocą metody VDF.Vault.Library.ConnectionManager.Login(). Więcej informacji na temat obu metod logowania i ich ustawień/parametrów można znaleźć w dokumentacji zestawu SDK. Po utworzeniu połączenia VDF można rozpocząć używanie go w aplikacjach klienckich do komunikowania się z serwerem Vault za pośrednictwem usług takich jak Menedżer plików lub przez udostępnienie obiektu połączenia metodom biblioteki, które wymagają połączenia.

Przejście z klasy WebServiceManager zestawu SDK programu Vault 2013 do połączenia VDF

Klasa połączenia VDF zapewnia dostęp do wystąpienia klasy WebServiceManager, które współużytkuje to samo połączenie z serwerem Vault, dlatego każdy dotychczasowy kod napisany z zastosowaniem klasy WebServiceManager zestawu SDK 2013 powinien dać się w prosty sposób przekonwertować na klasę połączenia VDF. Wystarczy zastąpić odniesienia do wystąpienia klasy WebServiceManager odwołaniami do właściwości WebServiceManager wystąpienia aktywnego połączenia VDF. Poza tym jedyne wymagane zmiany w aplikacjach klienckich dotyczą sposobu nawiązywania połączenia. Jak wspomniano w sekcji powyżej, w aplikacjach klienckich należy skorzystać z jednej z metod logowania, aby nawiązać połączenie VDF. W przypadku aplikacji klienckich, w których zmiany mają być minimalne, funkcja logowania w trybie bez interfejsu graficznego platformy VDF jest dość podobna do konstruktora klasy WebServiceManager, dlatego w takich aplikacjach wystarczy zamienić tworzenie wystąpienia klasy WebServiceManager na funkcję logowania platformy VDF. Na przykład te dwa fragmenty kodu dadzą w wyniku zasadniczo takie same połączenie z programem Vault:

Z zastosowaniem menedżera usługi sieci WWW (C#):

Z zastosowaniem funkcji logowania platformy VDF (C#):

Ponadto w aplikacjach klienckich należy dostosować sposób wylogowania/kończenia połączenia z programem Vault. Klasa WebServiceManager miała właściwość IDisposable, natomiast połączenie VDF jej nie ma i zaleca się zwolnić połączenie z programem Vault przez przekazanie połączenia VDF, z którego użytkownik chce się wylogować, do metody Logout() klasy ConnectionManager.