Udostępnij za pośrednictwem


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

Utwórz nową tabelę

  1. Power Apps W portalu utwórz nową tabelę, której chcesz użyć w mapowaniach czynników jako dane referencyjne.

  2. Zmień nazwę kolumny podstawowej na Nazwa.

    W poniższym przykładzie przedstawiono nową tabelę dla regionu niestandardowego.

    Zrzut ekranu przedstawiający nową tabelę o nazwie Region niestandardowy.

    W tym przykładzie utworzono nową tabelę z współczynnikami emisji niestandardowymi dla roku obrachunkowego.

  3. Ustaw kolumnę Nazwa jako element klucz alternatywny o nazwie naturalkey.

    Zrzut ekranu przedstawiający ustawienie kolumny Nazwa jako naturalkey.

Dodaj tabelę do Sustainability Manager

Gdy dodajesz nową tabelę Power Apps, musisz również dodać ją do modułu aplikacji Sustainability Manager.

  1. Power Apps W portalu wybierz Sustainability Manager.

  2. Na kafelku Sustainability Manager wybierz wielokropek (...), a następnie wybierz pozycję OTWÓRZ W PROJEKTANCIE APLIKACJI.

    Zrzut ekranu przedstawiający otwieranie aplikacji w projektancie aplikacji.

  3. W projektancie aplikacji wybierz pozycję Dane , a następnie wybierz pozycję Znajdź nazwę tabeli.

  4. Wybierz wielokropek (...), wybierz pozycję Dodaj do aplikacji, wybierz pozycję Zapisz, a następnie wybierz pozycję Opublikuj.

    Zrzut ekranu przedstawiający dodawanie tabeli do aplikacji.

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.

Zrzut ekranu przedstawiający usunięcie tabeli z nawigacji.

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.

  1. Na stronie Rozwiązania wybierz Nowe rozwiązanie. Wprowadź informacje o nowym rozwiązaniu i wybierz opcję Utwórz.

    Zrzut ekranu przedstawiający tworzenie nowego rozwiązania.

  2. Na stronie Obiekty wybierz Dodaj istniejący, a następnie wybierz Tabela.

    Zrzut ekranu przedstawiający dodawanie tabel do nowego rozwiązania.

  3. 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.

    Zrzut ekranu przedstawiający dodawanie tabeli Zakupiona energia do nowego rozwiązania.

    Zrzut ekranu przedstawiający dodawanie tabeli Region niestandardowy do nowego rozwiązania.

Rozszerzanie tabeli działań przy użyciu wyszukiwania

  1. 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.

    Zrzut ekranu przedstawiający dodawanie relacji wiele-do-jednego.

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.

  1. Dodaj obiekt aplikacji # Sustainability Manager do nowego rozwiązania.

    Zrzut ekranu przedstawiający dodawanie Sustainability Manager.

    W następującym przykładzie przedstawiono nowe rozwiązanie i jego zasoby.

    Zrzut ekranu rozwiązania i jego zasobów.

  2. Wybierz pozycję Sustainability Manager, otwórz ją w tryb edycji, a następnie wybierz pozycję Nowy. W oknie Dodawanie strony wybierz Tabela Dataverse.

    Zrzut ekranu pokazujący dodawanie tabeli Dataverse.

  3. 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 .

    Zrzut ekranu przedstawiający dodawanie tabel Dataverse dla poszczególnych tabel niestandardowych czynników.

    Na wszystkich pozostałych stronach zostaną wyświetlone nowe dodane tabele niestandardowe.

  4. Zapisz i opublikuj swoje zmiany.

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.

Zrzut ekranu przedstawiający relacje tabeli mapowań czynników.

Aby wyeksportować zmiany do innego środowiska, można dołączyć relacje wcześniej do rozwiązania i wyeksportować je.

  1. W tabelach wybierz kartę Wszystkie, a następnie wybierz opcję Dane referencyjne (msdyn_referencedata).

  2. 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.

  1. Przejdź do Rozwiązania > Aplikacja Microsoft Sustainability Manager.

  2. Wybierz role zabezpieczeń, a następnie wybierz pozycję Rola aplikacji usługi zrównoważonego rozwoju — niestandardowe. Zostanie otwarta nowa karta przeglądarki

  3. Na nowej karcie przeglądarki wybierz kartę Encje niestandardowe.

  4. 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.

  5. 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

  1. Upewnij się, że wszystkie dostosowania zostały opublikowane w portalu Power Apps .

  2. Wypełnij niestandardowe tabele danych referencyjnych (Regiony niestandardowe i Rok obrachunkowy w naszym przykładzie).

    Zrzut ekranu przedstawiający rok obrachunkowy danych z wartościami.

  3. Zaimportuj lub wprowadź mapowania czynników za pomocą Sustainability Manager lub portalu Power Apps .

    Zrzut ekranu przedstawiający mapowanie niestandardowych czynników.

  4. 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).

Zrzut ekranu przedstawiający bibliotekę rozszerzonych czynników.

Używanie czynników rozszerzonych w modelach obliczeń

W portalu Power Apps zaprojektuj model obliczania i użyj go w profilu obliczeń.

Zrzut ekranu przedstawiający projektowanie modelu obliczania.

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ń.

Zrzut ekranu przedstawiający używanie atrybutów rozszerzonych.

Często zadawane pytania

Gdy ręcznie tworzę nowe mapowanie czynnikowe, tabela niestandardowa nie jest widoczna jako opcja dla danych referencyjnych

  1. Upewnij się, że użytkownik ma odpowiednie uprawnienia do tabeli niestandardowej.

  2. Upewnij się, że tabela niestandardowa zawiera co najmniej jeden rekord.

  3. Upewnij się, że w programie msdyn_referencedata została dodana nazwa schematu (z uwzględnieniem wielkości liter) tabeli niestandardowej.

  4. Upewnij się, że tabela niestandardowa została dodana do obiektu Sustainability Manager App zgodnie z opisem we wcześniejszej części tego artykułu.

  5. 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

  1. Upewnij się, że użytkownik ma odpowiednie uprawnienia do tabeli niestandardowej.

  2. Upewnij się, że w programie msdyn_referencedata została dodana nazwa schematu (z uwzględnieniem wielkości liter) tabeli niestandardowej.

  3. Upewnij się, że tabela niestandardowa została dodana do obiektu Sustainability Manager App zgodnie z opisem we wcześniejszej części tego artykułu.

  4. 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.

  1. 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).

  2. W zależności od środowiska wykonaj następujące czynności:

    • Dodaj rekordy msdyn_referencedata.

    • Dostosuj rolę zabezpieczeń aplikacji Sustainability Manager.