Definiowanie pól dla wskazówek usługi sieciowej
Istnieje możliwość dodawania, aktualizowania lub usuwania pól dla poszczególnych usług sieciowych, jakie będą dostępne we wskazówce usług sieciowych.
Polami dostępnymi do użycia będą pola powiązane z usługami sieciowymi zdefiniowanymi na stronie Usługi sieciowe w formatce Wskazówki usługi sieciowej.
Ta formatka nie ma możliwości definiowania tłumaczeń językowych dla wyświetlanych etykiet pól. Jeśli wskazówka jest wykonywana, wyświetlane są etykiety pól wprowadzone w formatce Pola dla wybranej wskazówki usługi sieciowej. Aby wyświetlić wskazówki w wielu językach, konieczne jest utworzenie osobnej wskazówki usługi sieciowej dla każdego języka.
Dla wskazówek usługi sieciowej dostępne są pola użytkownika. Pola te są wyświetlane na liście wszystkich pól dla wybranej usługi sieciowej i umożliwiają wstawianie/aktualizowanie usług sieciowych. Pola użytkownika dziedziczą właściwości skojarzonej formatki odniesienia. Aby zdefiniować opcje pól użytkownika, należy kliknąć prawym przyciskiem w trybie Projektant ekranów. Po wyróżnieniu pola użytkownika w siatce system zabezpieczy pola Typ pola i Kod zapytania. Te informacje są zdefiniowane na ekranie podstawowym, z którym usługa sieciowa jest powiązana.
Encja wyszukiwania pól użytkownika wyświetla na liście organizacji użytkownika rekordy dla wszystkich organizacji, jeśli organizacja kontrolująca jest niedostępna. Rekordu nie można przekazać, jeśli pomiędzy organizacją kontrolującą i organizacją pola użytkownika istnieje konflikt.
- Wybierz kolejno opcje Administracja > Aparat wskazówek usługi sieciowej > Wskazówki usługi sieciowej.
- Wybierz wskazówkę usługi sieciowej, dla której mają zostać zdefiniowane pola usług sieciowych, a następnie kliknij kartę Pola.
- Kliknij przycisk Dodaj Pole.
-
Określ następujące informacje:
- Grupa przetwarzania — usługa sieciowa (Web Service)
- Określ grupę przetwarzania, dla której chcesz dodać pole usługi sieciowej. Wartości w polach Ekran i Karta są wypełniane automatycznie.
- Pole
- Określ pole do dodania do grupy przetwarzania. Dostępne pola zależą od wybranej usługi sieciowej.
- Etykieta pola
- Określ nazwę pola. Dla aparatu wskazówek usług sieciowych te informacje będą wyświetlane jako tekst stały pola. Domyślnie wartość Etykieta pola jest odpowiednim wartości Pole.
- Typ pola
- Określ typ pola na podstawie wybranego pola lub wybranej usługi sieciowej. Domyślnie wartość w polu Typ pola jest wprowadzana przez system dla wybranej wartości Pole. Wartość tą można jednak zmienić. Wartość Typ pola zdefiniowana przez użytkownika jest wyświetlana na ekranie Aparat wskazówek usługi sieciowej. Ustawienie domyślne można zmienić na jedną z następujących opcji:
- Alfabetyczny
- Obliczono
- Data
- Stały
- Wolny tekst
- Pole kluczowe
- Liczbowy
- Pobrane pole
UwagaOpcja Pole kluczowe jest dostępna tylko po wybraniu usługi sieciowej "update" lub "delete". Podczas ustawiania wskazówki usługi sieciowej, która korzysta z usługi sieciowej "update" lub "delete", administrator systemu musi utworzyć wartość Pole dla każdego pola kluczowego wymaganego przez usługę sieciową do unikalnego opisania rekordu. Jako wartość Typ pola należy ustawić Pole kluczowe. Aparat wskazówki usługi sieciowej najpierw udziela wskazówki, aby wprowadzić wartości pola kluczowego do rekordu do przetworzenia, takie jak Obiekty i Organizacja obiektu. W przypadku usług sieciowych aktualizacji system wymaga wyświetlenia wyników w rekordzie. Rekord można zaktualizować, a następnie przekazać. W przypadku usług sieciowych usuwania po wprowadzeniu wszystkich wartości pola kluczowego system usunie rekord.
Opcja Pobrane pole jest dostępna tylko po wybraniu usługi sieciowej "insert". Podczas ustawiania wskazówki usługi sieciowej, która korzysta z usługi sieciowej insert, co najmniej jedna wartość pola kluczowego musi być zostać pobrana z przetworzonej wcześniej usługi sieciowej w bieżącym rekordzie wskazówki. Administrator musi utworzyć wartość Pole typu Pobrane pole dla wszystkich pól kluczowych. Na przykład tworzona jest wskazówka usługi sieciowej, która umożliwia jednoczesne utworzenie zlecenia pracy i czynności zlecenia dla zlecenia pracy. Ma być skojarzona ze zleceniem pracy, które tworzone jest w poprzedniej grupie przetwarzania; jednak dane zostaną wprowadzone do aparatu wskazówki usługi sieciowej i będą przetworzone jednocześnie. Aby mieć pewność, że czynność jest skojarzona z odpowiednim zleceniem pracy, system musi najpierw przetworzyć usługę sieciową zlecenia pracy "insert", a następnie przekazać (pobrać) numer zlecenia pracy i organizację zlecenia prac z powrotem w celu utworzenia usługi sieciowej czynności. Informacje o polu kluczowym wraz z innymi wymaganymi danymi czynności służą do utworzenia czynności i powiązania jej z właściwym zleceniem pracy. Rekordy Pobrane pole (Typ pola = Pobrane pole) zostaną utworzone dla numeru zlecenia pracy czynności i organizacji zlecenia pracy czynności, ponieważ numer i organizacja zlecenia pracy są wymagane do skojarzenia czynności.
W polu Pobierz z grupowej usługi sieciowej powinna być wprowadzona usługa sieciowa, z której pobrane zostaną wartości pola kluczowego. W tym przykładzie są one pobierane z usługi sieciowej zlecenia pracy "insert". Pole pobierania będzie polem kluczowym podczas pobierania z usługi sieciowej, z której pobierane są dane. W tym przykładzie wartość Numer zlecenia pracy jest jednym z pobranych pól. Kolejną wartość Pole należy utworzyć w podobny sposób, aby zdefiniować sposób pobierania organizacji zlecenia pracy do użycia podczas tworzenia czynności. Wartości pola mogą być pobierane tylko z usług sieciowych o niższym numerze grupy przetwarzania. Przykładowo, nie można pobrać wartości do użycia w bieżącej usłudze sieciowej, jeśli poprzednia usługa sieciowa nie została przetworzona w celu udostępnienia informacji.
Wartości Pobrane pole i Pole kluczowe są niedostępne, jeśli pole Niemapowane jest puste.
Wartość Typ pobranego pola nie jest skojarzona z funkcją dostępną na stronie Pobrane wartości.
Jeśli pole jest zdefiniowane jako pole wyboru, na stronie Aparat wskazówek usługi sieciowej jest widoczne jako pole wyboru.
- Typ widoku
- Określ sposób wyświetlania pola przy użyciu aparatu wskazówek usług sieciowych. Wartość domyślna będzie ustawieniem domyślnym systemu dla wybranego pola. Użytkownik może zmienić ustawienie domyślne na jedną z następujących opcji:
- Opcjonalne
- Wymagane
- Ukryte
- Zabezpieczone
UwagaJeśli opcja Typ pola zostanie ustawiona na Stały lub Obliczono, dla wartości Typ widoku dostępne będą tylko opcje Zabezpieczone i Ukryte. Jeśli opcja Typ pola zostanie ustawiona na Pobrane pole, dla wartości Typ widoku dostępna będzie tylko opcja Ukryte.
- Sekwencja
- Podaj wartość liczbową określającą sekwencję. Pola są wyświetlane przy użyciu aparatu wskazówek usług sieciowych rosnąco, zgodnie z określoną kolejnością. Wartość domyślna jest wprowadzana przez system na podstawie parametru INCRLIND.
Uwaga
Ważne jest, aby się upewnić, czy pola wskazówek usług sieciowych są wyświetlane przy użyciu aparatu wskazówek usług sieciowych jako pogrupowane według wartości Grupa przetwarzania — usługa sieciowa. Kontrola dostępnego zakresu ustawienia Sekwencja dla pól odbywa się dla wybranej wartości Grupa przetwarzania — usługa sieciowa (Web Service). Wartość Sekwencja nie może nakładać się na wartość Kolejność skojarzoną z poprzednią lub następną grupą przetwarzania. Na przykład pola wskazówek usług sieciowych są pogrupowane w aparacie wskazówek usług sieciowych według wartości Grupa przetwarzania — usługa sieciowa, a następnie według wartości Sekwencja.
- Minimalna długość
- Określ minimalną liczbę znaków dla pola.
- Maksymalna długość
- Określ maksymalną liczbę znaków dla pola.
- Następna sekwencja
- Określ numer, od którego ma się rozpocząć następna sekwencja.
- Kod zapytania
- Określ kod zapytania. Opcja Kod zapytania definiuje wartości dostępne do wyboru z listy przy dostępnym połączeniu z serwerem. Na przykład zapytania i lista dostępnych wartości zostaną utworzone na podstawie tabel programu Infor EAM.
- Mobile — kod zapytania
- Należy określić kod zapytania Mobile, który definiuje listę wartości dostępnych dla pola.
Uwaga
Urządzenie mobilne korzysta z listy wartości kodu zapytania, jeśli dostępne jest połączenie z serwerem aplikacji; w przeciwnym razie używana jest lista wartości Mobile — kod zapytania. Na przykład na liście wartości dostępne są dane lokalne.
- Pole pobierania
- Wprowadź nazwę pola, z którego mają być pobierane dane. System automatycznie wypełni pola Pobierz z grupowej usługi sieciowej i Pobierz X-Path pola.
- Zapytanie do usługi sieciowej
- Określ zapytanie do usługi sieciowej. Opcja Zapytanie do usługi sieciowej ma zastosowanie tylko podczas definiowania pola kluczowego dla usługi sieciowej "update". Zadaniem opcji Zapytanie do usługi sieciowej jest utworzenie zapytania dla danych w rekordzie w celu wyświetlenia użytkownikowi możliwych aktualizacji.
- Pole niemapowane
- Wybierz tę opcję, jeśli określone pole nie zostało zmapowane do żadnego pola w usłudze sieciowej. Wartość pola może zostać dalej przetworzona przez wskazówkę jako część obliczenia lub pobrane wartości.
- Użyj poprzedniej wartości
- Wybierz tę opcję, aby użyć poprzedniej wartości pola.
- Jeśli dane są
- Określ warunek Przejdź do. To pole opisuje warunki, w jakich system nie uzyskuje dostępu do pola zdefiniowanego przez opcję Następne w kolejności, ale zamiast tego aktywuje pole wartości Kolejność przejścia.
- Schemat
- Określ schemat, jaki ma zostać zastosowany dla warunku Przejdź do.
- Przejdź do
- Określ kolejność pól, jaką system zastosuje w odniesieniu do opcji Następne w kolejności po spełnieniu warunku.
- Usuń poprzednie wartości rozpoczynając od pola wartości docelowej
- Wybierz tę opcję, aby system przeniósł wartości do pól z wybraną opcją Użyj poprzedniej wartości, jeśli sekwencja wskazówek jest mniejsza niż (<) sekwencja pola docelowego "Przejdź do". Na przykład skasowane zostaną poprzednie wartości wskazówek, spełniające warunek >= sekwencja pola docelowego "Przejdź do". W przeciwnym razie system przeniesie wartości do pól z wybraną opcją Użyj poprzedniej wartości, jeśli sekwencja wskazówek jest mniejsza niż (<) sekwencja pola źródłowego "Przejdź do". Na przykład skasowane zostaną poprzednie wartości dla pól wskazówek spełniające warunek <= sekwencja pola źródłowego „Przejdź do”.
- Pobierz z grupowej usługi sieciowej
- Określ usługę sieciową, z której zwracane będą wartości pól kluczowych i które zostaną użyte w kolejnej grupie przetwarzania.
- Dane obliczone
- Określ dane obliczane dla pola, jeśli dla opcji Typ pola wybrana będzie wartość Obliczono.
- Dopasowanie schematu
- Określ schemat stosowany po wybraniu dla opcji Typ pola wartości Alfabetyczne, z którym wprowadzane wartości muszą być zgodne, aby zostały uznane za poprawne. Uwaga
Poniżej przedstawiono znaki wieloznaczne obsługiwane podczas definiowania wartości Dopasowanie schematu:
- . (kropka): pojedyncze litery alfabetu od A do Z
- # (znak funta): dowolna pojedyncza cyfra od 0 do 9
- _ (podkreślenie): dowolny pojedynczy znak alfanumeryczny od A do Z i od 0 do 9
- % (procent): łańcuch znaków alfanumerycznych
- , (przecinek): warunek OR
- : (dwukropek): warunek THROUGHOUT
- ! dowolne znaki lub cyfry: wprowadzane dane nie powinny być takie same, jak te wprowadzone przed symbolem "!" warunek NOT.
Patrz „Definiowanie wartości pobieranych dla wskazówek usługi sieciowej”.
-
Kliknij przycisk Przekaż.
Uwaga
Aby usunąć pole, wybierz pole do usunięcia, a następnie kliknij przycisk Usuń pole. Pola odpowiadające wartości Organizacja kontrolująca dla usługi sieciowej nie mogą być usuwane na tej stronie, ponieważ mają one krytyczne znaczenie w procesie przetwarzania usługi sieciowej. Jeśli jednak dana usługa sieciowa zostanie usunięta na stronie Usługa sieciowa, wszystkie powiązane z nią pola zostaną automatycznie usunięte, w tym Organizacja kontrolująca.
UwagaJeśli wszystkie niezbędne pola, wymagane, kluczowe lub pobrane, nie są zdefiniowane w celu prawidłowego działania wskazówki usługi sieciowej przy użyciu aparatu wskazówek usług sieciowych, na tej stronie nie będą wyświetlane błędy. Błąd zostanie wyświetlony, jeśli aparat wskazówek usług sieciowych przetworzy rekordy z niewystarczającą ilością pól wskazówek. Błąd zostaje również wyświetlony przez aparat wskazówek usług sieciowych, jeśli zdefiniowana następna sekwencja nie istnieje w definicji wskazówki.