Integracja z Dostawca danych działań farmy

Usługa Azure Data Manager for Agriculture obsługuje łączniki w celu wygodnego synchronizowania danych użytkowników końcowych z różnych źródeł danych maszyn rolnych. Konfiguracja obejmuje skonfigurowanie przepływu oAuth jako wstępnie wymaganego do integracji z dowolnym dostawcą danych działania farmy, wraz z krokiem dla poszczególnych kont, przezroczystym krokiem zgody, który obsługuje początkową i przyrostową synchronizację danych w celu zapewnienia aktualności majątku danych USŁUGI ADMA.

Uwaga

Kroki od 1 do 3 są częścią konfiguracji początkowej jednorazowej dla dostawcy. Po zintegrowaniu będzie można umożliwić wszystkim użytkownikom końcowym korzystanie z istniejącego przepływu pracy oAuth i wywołanie interfejsu API konfiguracji (krok 4) dla użytkownika (PartyID) w celu pobrania tokenu dostępu.

Konfiguracja dostawcy

Przykładowy przepływ w tym miejscu używa elementu Climate FieldView

Krok 1. Tworzenie aplikacji

Jeśli aplikacja nie została jeszcze zarejestrowana w aplikacji Climate Fieldview, przejdź do portalu FieldView i prześlij formularz. Gdy usługa FieldView przetworzy twoje żądanie, wyśle żądanie client_id i client_secret będzie używana raz na wystąpienie usługi ADMA dla elementu FieldView.

Krok 2. Konfiguracja dostawcy

Użyj interfejsu oAuthProvider API, aby utworzyć lub zaktualizować dostawcę oAuth (np. FIELDVIEW) przy użyciu odpowiednich poświadczeń nowo utworzonej aplikacji.

Dokumentacja interfejsu API: oAuthProviders — tworzenie lub aktualizowanie

Opcjonalny krok: po zakończeniu operacji możesz uruchomić oAuthProviders_Get , aby sprawdzić, czy aplikacja jest zarejestrowana. Teraz wszystkie strony utworzone w wystąpieniu usługi Azure Data Manager for Agriculture mogą używać elementu FieldView jako dostawcy do pobierania danych działań farmy.

Krok 3. Konfiguracja punktu końcowego

Punkt końcowy przekierowania użytkownika: ten punkt końcowy ma być przekierowywany do użytkowników po zakończeniu przepływu oAuth. Ten punkt końcowy zostanie wygenerowany przez Ciebie i dostarczony do usługi ADMA, tak jak userRedirectLink w interfejsie API oauth/tokens/:connect. Zarejestruj punkt końcowy wywołania zwrotnego oAuth w portalu Climate FieldView w aplikacji.

Konfiguracja konta użytkownika końcowego

Krok 4. Integracja ze stroną (użytkownik końcowy)

Gdy strona (użytkownik końcowy) ląduje na stronie internetowej, na której oczekiwano akcji użytkownika (np. Połączenie do przycisku FieldView), wykonaj wywołanie oauth/tokens/:connect interfejsu API w poniższy sposób, aby uzyskać identyfikator URI logowania dostawcy oAuth (np. Climate FieldView), aby uruchomić przepływ oAuth użytkownika końcowego.

Dokumentacja interfejsu API: oAuthTokens — Uzyskiwanie linku Połączenie ion protokołu OAuth

Po pomyślnym powrocie interfejsu oauth/tokens/:connect oauthAuthorizationLinkAPI użytkownik końcowy kliknie ten link, aby ukończyć przepływ oAuth (np. w przypadku aplikacji Climate FieldView użytkownik jest obsługiwany jako zgoda dostępu do widoku FieldView i strona logowania). Po zakończeniu logowania usługa ADMA przekieruje użytkownika do punktu końcowego dostarczonego przez klienta (userRedirectLink) przy użyciu następujących parametrów zapytania w adresie URL

1. status (powodzenie/niepowodzenie)
2. state (opcjonalny ciąg umożliwiający unikatową identyfikację użytkownika na końcu klienta)
3. message (ciąg opcjonalny)
4. errorCode (opcjonalny ciąg wysłany dla błędu/błędu) w parametrach.

Uwaga

Jeśli interfejs API zwróci wartość 404, oznacza to, że przepływ oAuth zakończył się niepowodzeniem, a usługa ADMA nie może uzyskać tokenu dostępu.

Krok 5. Sprawdzanie informacji o tokenie dostępu (opcjonalnie)

Ten krok jest opcjonalny, tylko w celu potwierdzenia, czy dla danego użytkownika lub listy użytkowników wymagany prawidłowy token dostępu został uzyskany lub nie. Można to zrobić za pomocą wywołania interfejsu oauth/tokens API, aby sprawdzić wpis isValid: true w treści odpowiedzi.

Dokumentacja interfejsu API: oAuthTokens — lista

Ten krok oznacza pomyślne ukończenie przepływu oAuth dla użytkownika. Teraz użytkownik jest ustawiony na wyzwalanie nowego zadania FarmOperationsDataJob , aby rozpocząć ściąganie danych działań farmy z widoku Climate FieldView.