Przed skonfigurowaniem integracji GSX zapoznaj się z listą kontrolną, aby potwierdzić, że masz wszystkie wymagane informacje dostępne przed rozpoczęciem. 

Jeśli to nie jest pierwszy raz, gdy wykonujesz ten proces, upewnij się, że zapiszesz swoje aktualne pliki, przechodząc do Ustawienia systemu > Integracje > GSX > Narzędzie certyfikacyjne i klikając ikonę plików w prawym górnym rogu. Skopiuj także hasło.

Po pobraniu plików proszę zakończyć reset certyfikatu. Instrukcje dotyczące tego znajdują się na końcu tego artykułu. 

Po rozpoczęciu procesu i wysłaniu prośby do Apple NIE resetuj narzędzia certyfikacyjnego. 

Dostęp do narzędzia certyfikacyjnego GSX

1. Używając konta administratora, przejdź do Fixably.
   
    
2. Wybierz swoje Menu nazwy użytkownika, a następnie kliknij Ustawienia systemu.
   
   
   
    
3. Z menu Ustawienia wybierz Integracje, a następnie kliknij GSX.
   
   
   
    
4. Przewiń w dół i kliknij przycisk Narzędzie certyfikacyjne.
   
   

Generowanie plików CSR

1. Gdy narzędzie certyfikacyjne jest otwarte, wypełnij wszystkie pola, jak pokazano poniżej. Następnie kliknij Utwórz żądanie certyfikatu, gdy skończysz.
   
   
   
    
2. Po zwalidowaniu wprowadzonych informacji generowany jest plik żądania certyfikatu: certreq_rest.csr. Kliknij link, aby pobrać żądanie certyfikatu REST API.
   
   
    
3. Kliknij szablon e-maila. Postępuj zgodnie z instrukcjami w szablonie, aby wypełnić prośbę e-mailową. Upewnij się, że skopiujesz swojego menedżera konta Apple, administratora GSX (jeśli nie jesteś wymienionym GSX) oraz swojego menedżera sukcesu klienta Fixably. Upewnij się, że plik .csr, który pobrałeś, jest załączony do e-maila. 
   
   Uwaga: Szablon e-maila otworzy się w domyślnym kliencie e-mail. Upewnij się, że wysyłasz e-mail z tego samego adresu e-mail, który jest zarejestrowany w GSX.

***** POCZĄTEK INSTRUKCJI

*

*     1. Dołącz pliki żądania certyfikatu `certreq_rest.csr` i `certreq_soap.csr` z narzędzia certyfikacyjnego do tego e-maila.

*     2. Dodaj swój gsxws@apple.com w polu Do.

*     3. Dodaj swojego menedżera krajowego Apple w polu Cc.

*     4. Dodaj swojego administratora konta GSX w polu Cc (jeśli nie jesteś).

*     5. Usuń te instrukcje szablonu.

*     6. Wyślij e-mail.

*

***** KONIEC INSTRUKCJI

 

Środowisko: Produkcja (REST, SOAP)

GSX Numer konta sprzedającego: 0000123456

Imię i nazwisko głównego kontaktu IT: [IMIĘ KONTAKTU]

E-mail głównego kontaktu IT: [ADRES E-MAILA TUTAJ]

Numer telefonu głównego kontaktu IT: [NUMER TELEFONU TUTAJ]

Imię i nazwisko głównego kontaktu biznesowego w sprawach związanych z API: [IMIĘ KONTAKTU]

Adres e-mail głównego kontaktu biznesowego w sprawach związanych z API: [ADRES E-MAILA TUTAJ]

 

Statyczny adres IP serwera wychodzącego wysyłającego żądania do środowiska produkcyjnego usług internetowych GSX: 209.50.52.238

Statyczny adres IP serwera wychodzącego wysyłającego żądania do środowiska testowego usług internetowych GSX: 209.50.52.238

Statyczny adres IP serwera wychodzącego wysyłającego żądania do produkcji Harmonogramu wizyt: 209.50.52.238

Statyczny adres IP serwera wychodzącego wysyłającego żądania do testowego środowiska Harmonogramu wizyt: 209.50.52.238

Przegląd projektu systemu: [Dotyczy i jest wymagane dla rozwoju wewnętrznego/niestandardowego]

Lista API do zintegrowania: [Dotyczy i jest wymagane dla rozwoju wewnętrznego/niestandardowego]

Rozwiązanie integracji zewnętrznej: Nazwa firmy i produktu: Fixably

Uzupełnienie żądania certyfikatu

Po otrzymaniu ukończonych certyfikatów od Apple, pliki muszą zostać przesłane do narzędzia certyfikacyjnego, aby wygenerować pliki certyfikatów, które mogą być używane z Fixably.
 

1. Wróć do narzędzia certyfikacyjnego, przechodząc do Ustawienia systemu > Integracje > GSX > Narzędzie certyfikacyjne. Wybierz plik .pem, klikając ikonę dokumentu po prawej stronie pola i kliknij Prześlij, gdy skończysz.
   
    
2. Uwaga: Nie zmieniaj ani nie edytuj nazwy pliku. Apple dostarcza go w oczekiwanym formacie. 
    

Instalacja certyfikatów

1. Po przesłaniu pliku certyfikatu pobierz pliki certyfikatu .p12 z kroku 4 i skopiuj hasło certyfikatu.
   
   
   
    
2. Wróć do Ustawień systemu.
3. Z menu Ustawienia wybierz Integracje, a następnie GSX.
4. Wypełnij informacje o Sold-To i Ship-To. Upewnij się, że wybrane jest właściwe środowisko GSX, zazwyczaj Produkcja. Prześlij certyfikat REST wygenerowany w kroku 3 i wprowadź podane hasło w przycisku „Zmień hasło”.
   
   
    
5. Jeśli jesteś w lokalizacji, która używa stanów lub prowincji, zaznacz pole obok Używany stan, jeśli nie jest już zaznaczone.
   
    
6. Wybierz Rodzaje napraw używane przez Twoją firmę. Jakiekolwiek rodzaje napraw, które pozostaną niezaznaczone, nie będą widoczne podczas tworzenia naprawy. 
   
   
7. Po zakończeniu kliknij Zapisz ustawienia.
    

Konfiguracja ustawień użytkownika GSX

1. Z Fixably przejdź do Ustawień użytkownika.
   
   
   
    
2. Kliknij Rozwiń obok nagłówka GSX, aby zobaczyć ustawienia użytkownika GSX. 
   
   
   
    
3. Wprowadź swoje Apple ID i Tech ID jak pokazano powyżej. Wygeneruj Token aktywacyjny, klikając link Zamów nowy token aktywacyjny, klikając tutaj.
   
    
4. Kliknij Zapisz ustawienia, gdy skończysz.
   
   Uwaga: Tokeny aktywacyjne wygasają i będą musiały być okresowo regenerowane.

Konfiguracja wspólnego dostępu do GSX

Jeśli użytkownik nie ma osobistego dostępu do GSX, Fixably umożliwia przeszukiwanie urządzeń i informacji, dzieląc się GSX. Włącz tę funkcję, jeśli korzystasz z Portalu klienta lub masz wewnętrzny personel, który może nie mieć osobistego konta GSX. 

1. Przejdź do Ustawienia systemu/Integracje/GSX.
   
    
2. Kliknij trójkąt rozwijany obok konta użytkownika, które chcesz udostępnić. Następnie kliknij Udostępnij to konto.
   
   
3. Jeśli Twoja firma ma wiele Lokalizacji, upewnij się, że Udostępniane konto ma dostęp do wszystkich lokalizacji w Apple MyAccess. 

Testowanie integracji GSX

Po skonfigurowaniu wszystkich ustawień ostatnim krokiem jest potwierdzenie, że Fixably prawidłowo komunikuje się z GSX. 

1. Przejdź do Ustawienia systemu/Integracje/GSX.
   
    
2. Następnie kliknij Testuj połączenie, aby uruchomić Tester integracji.
   
   
   
    
3. Sprawdź status obok każdego kroku połączenia. 
    

Konfiguracja ustawień GSX opartych na lokalizacji

1. Przejdź do Ustawienia systemu/Lokalizacje.
   
    
2. Kliknij nazwę Lokalizacji.
   
    
3. Wprowadź numery GSX Sold-To i Ship-To w podanych polach. 
   
   
    
4. Po zakończeniu kliknij Zapisz.
    

Rozwiązywanie typowych błędów

• Błąd: 1. Ustawiono adres sprzedaży, nieprawidłowy lub brak numeru adresu sprzedaży.
  • Potwierdź, że poprawny numer adresu sprzedaży został wprowadzony w Kroku 4. Spróbuj ponownie po zweryfikowaniu numeru adresu sprzedaży.
• Błąd: 2. Wybrano środowisko. Nieprawidłowe lub brak ustawienia środowiska.
  • Potwierdź, że poprawne ustawienie środowiska jest skonfigurowane w Kroku 4. Zazwyczaj powinno być ustawione na Produkcję, chyba że inaczej poleci Fixably Support.
• Błąd: 3. Certyfikat jest przesłany. Brak certyfikatu.
  • Plik certyfikatu z Kroku 3 jest nieprawidłowy lub brakujący. Potwierdź, że poprawny certyfikat został przesłany, a hasło jest poprawne.
• Błąd: 4. Testowanie połączenia z GSX w Teście Połączenia.
  • Zazwyczaj występuje to, ponieważ Apple nie dodał adresów IP Fixably do białej listy. Skontaktuj się z zespołem usług internetowych GSX, aby zweryfikować wniosek o dodanie do białej listy złożony w Kroku 2. 
• Błąd: 5. Testowanie autoryzacji przy użyciu współdzielonego konta GSX.
  • Nie ma użytkownika skonfigurowanego dla współdzielonego GSX. Przejdź do Ustawienia systemowe/Integracje/GSX, aby włączyć przynajmniej jedno współdzielone konto.
• Błąd: Token aktywacyjny jest nieprawidłowy. Należy poprosić o nowy.
  • Może to wystąpić, ponieważ identyfikator Apple użytkownika nie ma przypisanych uprawnień do usług internetowych. Zweryfikuj przez MyAccess, że poprawne uprawnienia zostały przypisane, a następnie poproś o nowy token aktywacyjny.
     

Resetowanie narzędzia certyfikacyjnego

1. Jeśli wymagany jest nowy certyfikat lub jeśli zostaniesz o to poproszony przez wsparcie Fixably, administratorzy mogą zresetować narzędzie certyfikacyjne, klikając Zresetuj to narzędzie.
   
   
    
2. Ta akcja nieodwracalnie usuwa wszystkie zapisane dane z narzędzia certyfikacyjnego.
   
    
3. Upewnij się, że pobrałeś i zapisałeś wszystkie pliki certyfikatów i hasła w bezpiecznym miejscu przed zresetowaniem narzędzia.