Mapowania niestandardowych czynników (wersja zapoznawcza)
Ważne
Niektóre lub wszystkie te funkcje są dostępne w wersji zapoznawczej. Zawartość i funkcjonalność mogą ulec zmianie.
Microsoft Sustainability Manager używa wbudowanych danych odwołania w mapowaniach czynników. Dostępny zestaw mapowań czynników można rozszerzyć o mapowania niestandardowych czynników. Na przykład można przeprowadzać obliczenia działań na podstawie czynników: roku obrachunkowego lub regionu niestandardowego. Ten artykuł zawiera informacje o tej konfiguracji zaawansowanej, która musi zostać ukończona w centrum administracyjnym Power Platform.
Uwaga
Procedury określone w tym artykule wymagają zaawansowanej wiedzy specjalistycznej w zakresie zarządzania i interfejsów API Microsoft Dataverse. W tym artykule nie opisano szczegółowo typowych operacji platformy. Te kroki konfiguracyjne mogą wykonać tylko uprawnieni administratorzy Power Platform, którzy mają pełny dostęp do centrum administracyjnego.
Aby rozszerzyć możliwości Sustainability Manager w celu użycia mapowań niestandardowych czynników, należy wykonać następujące kroki:
- Tworzenie niestandardowych danych referencyjnych
- połączyć czynników do mapowań czynników Sustainability Manager
- połączyć dane referencyjne Sustainability Manager do nowych czynników
- Autoryzuj Sustainability Manager w celu uzyskania dostępu do tabel zewnętrznych
- Autoryzowanie użytkowników w celu uzyskania dostępu do tabel
- Testowanie połączenia między niestandardowymi danymi referencyjnymi a mapowaniami czynników
- Stosowanie rozszerzonych współczynników w modelach obliczeniowych
Tworzenie niestandardowych danych referencyjnych
Utwórz nową tabelę
Power Apps W portalu utwórz nową tabelę, której chcesz użyć w mapowaniach czynników jako dane referencyjne.
Zmień nazwę kolumny podstawowej na Nazwa.
W poniższym przykładzie przedstawiono nową tabelę dla regionu niestandardowego.
W tym przykładzie utworzono nową tabelę z współczynnikami emisji niestandardowymi dla roku obrachunkowego.
Ustaw kolumnę Nazwa jako element klucz alternatywny o nazwie naturalkey.
Dodaj tabelę do Sustainability Manager
Gdy dodajesz nową tabelę Power Apps, musisz również dodać ją do modułu aplikacji Sustainability Manager.
Power Apps W portalu wybierz Sustainability Manager.
Na kafelku Sustainability Manager wybierz wielokropek (...), a następnie wybierz pozycję OTWÓRZ W PROJEKTANCIE APLIKACJI.
W projektancie aplikacji wybierz pozycję Dane , a następnie wybierz pozycję Znajdź nazwę tabeli.
Wybierz wielokropek (...), wybierz pozycję Dodaj do aplikacji, wybierz pozycję Zapisz, a następnie wybierz pozycję Opublikuj.
Tabela zostanie dodana do folderu Sustainability Manager i pojawi się na liście danych referencyjnych oraz w nawigacji.
Jeśli chcesz usunąć go z nawigacji, wybierz pozycję Strony w lewym okienku nawigacji. Wybierz tabelę, wybierz pozycję Usuń z nawigacji, wybierz pozycję Zapisz, a następnie wybierz pozycję Publikuj.
Tworzenie rozwiązania do dostosowań
Ponieważ encje domyślne znajdują się w rozwiązaniu zarządzanym, należy utworzyć nowe rozwiązanie i zaimportować do niego encje działań oraz nowe niestandardowe jednostki danych referencyjnych.
Na stronie Rozwiązania wybierz Nowe rozwiązanie. Wprowadź informacje o nowym rozwiązaniu i wybierz opcję Utwórz.
Na stronie Obiekty wybierz Dodaj istniejący, a następnie wybierz Tabela.
Na stronie Dodawanie istniejących tabel wybierz utworzone działanie i niestandardowe tabele danych referencyjnych. W naszym przykładzie dodaliśmy tabelę Zakupiona aktywność energetyczna i tabelę danych referencyjnych regionu niestandardowego.
Rozszerzanie tabeli działań przy użyciu wyszukiwania
Dodaj nową relację wiele-do-jednego z tabeli działań do tabeli rozszerzonej czynników. W naszym przykładzie dodajemy relację wiele-do-jednego z tabeli Zakupiona aktywność energetyczna do tabeli danych referencyjnych regionu niestandardowego.
Dodawanie niestandardowej tabeli danych referencyjnych do aplikacji
Notatka
Jest to wymagany krok. Nawet jeśli nie chcesz dołączać niestandardowej tabeli danych referencyjnych do menu nawigacji, nadal konieczne jest dodanie tabeli do aplikacji. Jeśli ten krok zostanie pominięty, dane referencyjne nie będą dostępne w imporcie mapowania czynnikowego ani w środowisku wprowadzania ręcznego.
Dodaj obiekt aplikacji # Sustainability Manager do nowego rozwiązania.
W następującym przykładzie przedstawiono nowe rozwiązanie i jego zasoby.
Wybierz pozycję Sustainability Manager, otwórz ją w tryb edycji, a następnie wybierz pozycję Nowy. W oknie Dodawanie strony wybierz Tabela Dataverse.
Wybierz opcję Wybierz istniejącą tabelę. W okienku Wybierz tabelę wybierz każdą z niestandardowych tabel danych referencyjnych, których chcesz użyć do mapowania czynników. Wybierz pozycję Dodaj.
Notatka
Jeśli nie chcesz, aby niestandardowe tabele odwołań były wyświetlane w menu nawigacji, usuń zaznaczenie pola wyboru Pokaż w nawigacji .
Na wszystkich pozostałych stronach zostaną wyświetlone nowe dodane tabele niestandardowe.
Zapisz i opublikuj swoje zmiany.
Łączenie czynników z mapowaniami czynników programu Sustainability Manager
Ta procedura wymaga specjalizacji deweloperów, ponieważ jest dostępna tylko za pośrednictwem interfejsów API Dataverse.
Należy dostosować wyszukiwania dla wielu tabel dla mapowań czynników dla tabel niestandardowych. Interfejs API sieci Web Power Apps można wykorzystać do użycia narzędzia, takiego jak ID lub preferowany klient interfejsu API. Aby uzyskać informacje na temat wysyłania żądań wpisów uwierzytelnionych z pomocą Insomnia, przejdź do strony Korzystanie z Insomnia z API Dataverse sieci Web .
Dla każdej tabeli niestandardowej należy włączyć mapowania czynników w obliczeniach. W naszym przykładzie należy to zrobić w tabelach regionu niestandardowego i roku obrachunkowego. Należy podać logiczną nazwę każdej tabeli. Na przykład nazwa logiczna dla regionu niestandardowego to cr040_newtable, a nazwa logiczna dla Rok obrachunkowy to cr040_newtable1.
Dla każdej tabeli niestandardowej należy zaktualizować wszystkie wyszukiwania używane do mapowania czynników oraz tabelę z nazwą logiczną msdyn_emissionlookup. Te wyszukiwania mają następujące nazwy logiczne:
- msdyn_referencedataid
- msdyn_referencedata2id
- msdyn_referencedata3id
- msdyn_referencedata4id
W przypadku jednej tabeli niestandardowej należy wysłać cztery żądania wpisów, po jednym dla każdego z czterech pól wyszukiwania użytych w mapowaniach czynników. Użyj zaawansowanego narzędzia, takiego jak Insomnia lub preferowanego klienta API, aby wysłać żądania POST do interfejsu API RelationshipDefinitions organizacji.
W naszym przypadku punkt końcowy to https://<orgurl>/api/data/v9.2/RelationshipDefinitions. Użyliśmy następujące przykładowe ładunki dla każdego z ośmiu żądań POST (dwie tabele z czterech żądań):
Uwaga
"SchemaName" musi być unikatowa w danym Dataverse środowisku.
{
"SchemaName": "msdyn_msdyn_emissionlookup_<custom factor table name>",
"@odata.type": "Microsoft.Dynamics.CRM.OneToManyRelationshipMetadata",
"CascadeConfiguration": {
"Assign": "NoCascade",
"Delete": "RemoveLink",
"Merge": "NoCascade",
"Reparent": "NoCascade",
"Share": "NoCascade",
"Unshare": "NoCascade"
},
"ReferencedEntity": "<custom factor table logical name>",
"ReferencingEntity": "msdyn_emissionlookup",
"ReferencingAttribute": "<polymorphic lookup name>",
"Lookup": {
"AttributeType": "Lookup",
"AttributeTypeName": {
"Value": "LookupType"
},
"SchemaName": "<polymorphic lookup name>",
"@odata.type": "Microsoft.Dynamics.CRM.LookupAttributeMetadata"
}
}
W poniższej tabeli przedstawiono wartości używane dla <niestandardowej nazwy tabeli czynników>, <logicznej nazwy tabeli niestandardowej czynników> oraz <polimorficznej nazwy wyszukiwania> w ramach ośmiu żądań wpisu POST.
Zażądaj | Nazwa tabeli niestandardowej czynników | Nazwa logiczna tabeli niestandardowej czynników | Polimorficzna nazwa wyszukiwania |
---|---|---|---|
1 | FiscalYear_RDId | cr040_newtable1 | msdyn_referencedataid |
2 | FiscalYear_RDId2 | cr040_newtable1 | msdyn_referencedata2id |
3 | FiscalYear_RDId3 | cr040_newtable1 | msdyn_referencedata3id |
4 | FiscalYear_RDId4 | cr040_newtable1 | msdyn_referencedata4id |
5 | CustomRegion_RDId | cr040_newtable | msdyn_referencedataid |
6 | CustomRegion_RDId2 | cr040_newtable | msdyn_referencedata2id |
7 | CustomRegion_RDId3 | cr040_newtable | msdyn_referencedata3id |
8 | CustomRegion_RDId4 | cr040_newtable | msdyn_referencedata4id |
Pomyślne żądanie POST daje odpowiedź HTTP 204.
Te operacje można sprawdzić przez inspekcję relacji tabeli mapowania czynników.
Aby wyeksportować zmiany do innego środowiska, można dołączyć relacje wcześniej do rozwiązania i wyeksportować je.
Połącz dane referencyjne Sustainability Manager do nowych czynników
W tabelach wybierz kartę Wszystkie, a następnie wybierz opcję Dane referencyjne (msdyn_referencedata).
Dodaj następujące informacje dla każdego nowego typu czynnika:
Pole Popis Imię i nazwisko Nazwa tabeli w liczbie mnogiej. Na przykład: Regiony niestandardowe lub Lata obrachunkowe. Kategoria Dane referencyjne Nazwa encji Logiczna nazwa tabeli, wszystkie małe litery (a nie nazwa schematu tabeli). Na przykład cr040_newtable lub cr040_newtable1.
Autoryzuj Sustainability Manager w celu uzyskania dostępu do tabel zewnętrznych
Jeśli jeszcze nie podano, należy uzyskać dostęp do tabel zewnętrznych Sustainability Manager, aby można go było używać w obliczeniach.
Przejdź do Rozwiązania > Aplikacja Microsoft Sustainability Manager.
Wybierz role zabezpieczeń, a następnie wybierz pozycję Rola aplikacji usługi zrównoważonego rozwoju — niestandardowe. Zostanie otwarta nowa karta przeglądarki
Na nowej karcie przeglądarki wybierz kartę Encje niestandardowe.
Dla każdej tabeli niestandardowej, której chcesz użyć do mapowania czynników, należy podać uprawnienia Odczyt i Dołączanie do na poziomie organizacyjnym.
Uwaga
Dla każdej tabeli niestandardowej należy również nadać uprawnienia do odczytu dla całej organizacji do dowolnej tabeli, która wskazuje na za pośrednictwem funkcji wyszukiwania. Jeśli na przykład region niestandardowy zawiera odnośnik w tabeli Jednostka SKU Contoso, należy nadać uprawnienia do odczytu do tabeli Jednostka SKU Contoso.
Zapisz i zamknij.
Autoryzuj użytkowników do dostępu do tabel
Dla każdej tabeli niestandardowej, takiej jak Regiony niestandardowe lub Rok obrachunkowy, upewnij się, że użytkownik Power Apps, który korzysta z mapowań czynników lub uruchamia obliczenia, ma następujące uprawnienia dla całej organizacji w tabeli:
Dołącz do do pozyskiwania
Odczyt w celu tworzenia mapowań czynników lub używania mapowań czynników w obliczeniach, w których jest używana tabela niestandardowa
Testowanie połączenia między niestandardowymi danymi referencyjnymi a mapowaniami czynników
Upewnij się, że wszystkie dostosowania zostały opublikowane w portalu Power Apps .
Wypełnij niestandardowe tabele danych referencyjnych (Regiony niestandardowe i Rok obrachunkowy w naszym przykładzie).
Zaimportuj lub wprowadź mapowania czynników za pomocą Sustainability Manager lub portalu Power Apps .
Zaimportuj lub wprowadź dane aktywności za pomocą Sustainability Manager.
Na poniższej ilustracji przedstawiono przykład biblioteka współczynników o nazwie Rozszerzona biblioteka czynników zawierająca mapowania, które używają niestandardowych danych referencyjnych (Niestandardowe regiony i rok obrachunkowy).
Używanie czynników rozszerzonych w modelach obliczeń
W portalu Power Apps zaprojektuj model obliczania i użyj go w profilu obliczeń.
Uwaga
W celu upewniania się, że dane wyszukiwania mają wartość, można użyć filtrowania w profilu obliczeń.
W razie potrzeby można użyć atrybutów rozszerzonego w profilu obliczeń.
Często zadawane pytania
Gdy ręcznie tworzę nowe mapowanie czynnikowe, tabela niestandardowa nie jest widoczna jako opcja dla danych referencyjnych
Upewnij się, że użytkownik ma odpowiednie uprawnienia do tabeli niestandardowej.
Upewnij się, że tabela niestandardowa zawiera co najmniej jeden rekord.
Upewnij się, że w programie msdyn_referencedata została dodana nazwa schematu (z uwzględnieniem wielkości liter) tabeli niestandardowej.
Upewnij się, że tabela niestandardowa została dodana do obiektu Sustainability Manager App zgodnie z opisem we wcześniejszej części tego artykułu.
Odśwież stronę mocno w przeglądarce.
Podczas importowania mapowań czynników nie widzę mojej niestandardowej tabeli danych referencyjnych jako opcji w środowisku mapowania pól
Upewnij się, że użytkownik ma odpowiednie uprawnienia do tabeli niestandardowej.
Upewnij się, że w programie msdyn_referencedata została dodana nazwa schematu (z uwzględnieniem wielkości liter) tabeli niestandardowej.
Upewnij się, że tabela niestandardowa została dodana do obiektu Sustainability Manager App zgodnie z opisem we wcześniejszej części tego artykułu.
Odśwież stronę mocno w przeglądarce.
Czy do celów zatwierdzania danych rekordy w tabelach niestandardowych są traktowane jako "zatwierdzone" lub "oczekujące"?
Wszystkie rekordy w tabelach niestandardowych są traktowane jako "zatwierdzone" do celów zatwierdzania danych w kontekście mapowań czynników do obliczeń.
Importowanie mapowań czynników nie powiodło się z powodu braku uprawnienia prvAppendTo_[tabela niestandardowa] dla użytkownika
Użytkownik aplikacji Sustainability Manager lub bieżący użytkownik nie przyznał uprawnienia Dołączanie do dla tabeli niestandardowej. Upewnij się, że zarówno Sustainability Manager, jak i użytkownik mają odpowiednie uprawnienia, a następnie ponownie spróbuj zaimportować.
W modelu obliczania nie widzę mojej tabeli niestandardowej jako opcji w sekcji mapowania czynników w liście rozwijanej Współczynnik emisji węzła Raport lub liście rozwijanej Współczynnik emisji węzła Współczynnik emisji
Upewnij się, że dodano rekord msdyn_referencedata dla tabeli niestandardowej.
Należy sprawdzić, czy wartość nazwy encji w rekordzie msdyn_referencedata dla tabeli niestandardowej ma logiczną nazwę tabeli (wielkość liter jest uwzględniana), a nie nazwę schematu. Przejdź do menu Tabela > Właściwości, rozwiń Opcje zaawansowane i wyświetl nazwę logiczną.
Upewnij się, że dane działań dla źródła obliczeń mają pole wyszukiwania, które wskazuje na tabelę niestandardową. Jeśli na przykład dostosowano Spalanie stacjonarne dla wyszukiwania regionu niestandardowego, ale nie dla spalania ruchomego, to w obliczeniach dla spalania ruchomego nie można użyć mapowań czynników na podstawie regionu Contoso.
Dostosowywanie wielu środowisk
Może być konieczne dostosowanie w jednym środowisku i zastosowanie ich do innego. Na przykład można wprowadzić wszystkie dostosowania w środowisku dewelopera i zaimportować je do środowiska produkcyjnego. W takim przypadku można wykonać poniższe kroki, aby zminimalizować powielanie pracy.
W przypadku każdego rozwiązania używanego do eksportowania zmian z jednego środowiska do innego należy uwzględnić w tym rozwiązaniu następujące dostosowania:
Dodatki niestandardowych tabel do Sustainability Manager.
Dodanie kolejnych informacji relacje do wyszukiwania danych współczynników.
Następnie można zaimportować rozwiązanie do zarządzania cyklem życia aplikacji (ALM).
W zależności od środowiska wykonaj następujące czynności:
Dodaj rekordy msdyn_referencedata.
Dostosuj rolę zabezpieczeń aplikacji Sustainability Manager.