Udostępnij przez


Dynamics 365 Commerce — oceny i recenzje

Skorzystaj z interfejsów API klasyfikacji i przeglądów handlowych usługi Dynamics 365, aby zaimportować nowe recenzje, wyeksportować istniejące recenzje i nie tylko!

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Dynamics 365 Commerce-Ratings i przeglądy
adres URL https://dynamics.microsoft.com/en-us/support/
Email d365ratingreviewconn@microsoft.com
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://dynamics.microsoft.com/en-us/commerce/overview/
Zasady ochrony prywatności https://privacy.microsoft.com/privacystatement
Kategorie Handel; Zarządzanie biznesem

Łącznik Dynamics 365 Commerce — Ratings and Reviews (Handel w usłudze Dynamics 365 — oceny i przeglądy) udostępnia zestaw akcji, które umożliwiają interakcję z interfejsami API usługi Dynamics 365 Ratings and Review Service. Te akcje ułatwiają importowanie i eksportowanie danych przeglądów. Dostępne są dwie akcje: Eksportuj wszystkie recenzje i Prześlij recenzję.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

  • Subskrypcja usługi Microsoft Dynamics 365 Commerce
  • Szczegóły rozwiązania z włączonymi ocenami i przeglądami

Skontaktuj się z partnerem handlowym usługi Dynamics 365 tutaj , aby uzyskać szczegółowe informacje na temat rozpoczynania pracy z usługą Microsoft Dynamics 365.

Jak uzyskać poświadczenia

Pierwszym krokiem jest zarejestrowanie łącznika jako aplikacji w identyfikatorze Entra firmy Microsoft. Dzięki temu łącznik może zidentyfikować się jako identyfikator Entra firmy Microsoft i poprosić o uprawnienia dostępu do danych klasyfikacji i przeglądów w imieniu użytkownika końcowego. Przeczytaj więcej na ten temat tutaj i wykonaj poniższe kroki:

1. Utwórz aplikację Microsoft Entra ID:

Ta aplikacja Microsoft Entra ID będzie używana do identyfikowania połączenia łącznika z ocenami i recenzjami. Można to zrobić przy użyciu witryny Azure Portal, wykonując kroki opisane tutaj , aby zarejestrować aplikację w witrynie Microsoft Entra ID i włączyć uwierzytelnianie.

Podczas rejestracji przechwyć następujące informacje, ponieważ będą używane do nawiązywania uwierzytelnionego połączenia z łącznikiem przy użyciu jednostki usługi:

  • Identyfikator aplikacji klienckiej
  • Klucz tajny klienta (pamiętaj, aby to zanotować, ponieważ jest wyświetlany tylko raz).
  • Identyfikator katalogu klienta (dzierżawy).

Po utworzeniu aplikacji Microsoft Entra ID można ją teraz użyć do uzyskiwania uprawnień od użytkowników końcowych. Użyj zapisanych pól, aby ustanowić uwierzytelnione połączenie za pośrednictwem jednostki usługi przy użyciu łącznika Dynamics 365 Commerce — Ratings and Reviews Connector.

Następnym krokiem jest zarejestrowanie tej aplikacji na stronie ustawień narzędzia klasyfikacji i przeglądów.

2. Rejestrowanie aplikacji Microsoft Entra ID w narzędziu klasyfikacji i przeglądów

Aby usługa Klasyfikacje i przeglądy mogły uwierzytelniać operacje pochodzące z łącznika, klienci muszą zarejestrować swoją aplikację Microsoft Entra ID na stronie ustawień narzędzia klasyfikacji i przeglądu. Użyj identyfikatora aplikacji klienta i identyfikatora katalogu klienta z poprzedniego kroku, aby dodać wpis aplikacji Service to Service to Service (S2S). Aby uzyskać więcej informacji na temat zarządzania ustawieniami klasyfikacji i przeglądów z narzędzia moderowania, zobacz tutaj.

Wprowadzenie do łącznika

Aby rozpocząć pracę z łącznikiem Dynamics 365 Commerce — Ratings and Reviews Connector, po prostu dodaj go do istniejącego przepływu lub zacznij od wyszukania przykładowych przepływów szablonów na potrzeby importowania i eksportowania przeglądów.

Uwaga: Łącznik Dynamics 365 Commerce — Ratings and Reviews Connector będzie dostępny we wszystkich regionach usługi Power Automate, ale klasyfikacje i przeglądy będą przetwarzać tylko wywołania w regionach obsługiwanych przez dzierżawę. Pamiętaj, aby zapoznać się z wymaganiami dotyczącymi zgodności w organizacji i utworzyć środowisko usługi Power Automate w regionie, który spełnia wymagania dotyczące zgodności.

Często zadawane pytania

  • Jaka jest maksymalna długość treści tekstu przeglądu i tytuł recenzji?

    Maksymalna długość tytułu przeglądu wynosi 55 znaków. Maksymalna długość treści tekstu przeglądu wynosi 1000 znaków.

  • Jaka jest struktura zakodowanego parametruUser w akcji Prześlij recenzję?

    Zakodowany użytkownik dodaje dodatkowe zabezpieczenia w celu przekazania informacji o użytkowniku. Koduje schemat tożsamości użytkownika do base64. Zapoznaj się z poniższą strukturą schematu, aby utworzyć obiekt w przepływie, a następnie za pomocą wbudowanej funkcji toBase64() zakodować go przed przekazaniem go w akcji SubmitReview.

    {
        "p" : {
                "t" : "Unix epoch in seconds (should be within an hour of current time)",
                "email" : "Reviewer User Email Here",
                "name" : "Reviewer User Name Here",
                "id" : "Reviewer User Id Here"
            }
    }
    

    Aby uzyskać więcej informacji, zapoznaj się z przykładem tego w naszym przepływie szablonu przeglądów importu.

  • Potrzebuję więcej wsparcia. Z kim mogę się skontaktować?

    Skontaktuj się z pomocą techniczną usługi Dynamics 365 Commerce w celu uzyskania ogólnej pomocy technicznej lub wiadomości e-mail d365ratingreviewconn@microsoft.com.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Eksportuj wszystkie recenzje

Eksportuj wszystkie recenzje jako adres URL sygnatury dostępu współdzielonego do pobrania.

Prześlij recenzję użytkownika

Przesyła recenzję użytkownika do dzierżawy usługi RnR.

Eksportuj wszystkie recenzje

Eksportuj wszystkie recenzje jako adres URL sygnatury dostępu współdzielonego do pobrania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator dzierżawy usługi RnR
tenantId True string

Określ identyfikator dzierżawy usługi RnR.

Zwraca

Prześlij recenzję użytkownika

Przesyła recenzję użytkownika do dzierżawy usługi RnR.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator produktu
productId True string

Określ identyfikator przeglądanego produktu.

Identyfikator dzierżawy usługi RnR
tenantId True string

Określ identyfikator dzierżawy usługi RnR.

Identyfikator kanału
channelId string

Określ identyfikator kanału dla tej recenzji.

Rynek
market string

Określ rynek skojarzony z tą recenzją.

Lokalizacja
locale True string

Określ ustawienia regionalne skojarzone z tą recenzją.

zakodowanyuser
encodedUser True string

Określ zakodowany w formacie base64 ciąg informacji o użytkowniku skojarzony z tą recenzją. Zapoznaj się z dokumentacją dotyczącą formatu bloku JSON zawierającego nazwę użytkownika, adres e-mail i identyfikator.

Rating
Rating True string

Określ ocenę przeglądu jako liczbę całkowitą.

Title
Title True string

Określ tytuł recenzji.

Tekst przeglądu
ReviewText True string

Określ treść tekstu przeglądu.

Sku
Sku string

Określ numer jednostki SKU przeglądanego produktu.

ProductName
ProductName True string

Określ nazwę przejeżonego produktu

LegalEntity
LegalEntity string

Określ jednostkę prawną.

Właściwości rozszerzone
ExtendedProperties object

Określ wszelkie dodatkowe właściwości przeglądu jako pary klucz-wartość. Zobacz dokumentację dotyczącą formatu JSON.

submittedDateTime
submittedDateTime string

Określ przesłaną datę/godzinę przeglądu w formacie UTC (wartość domyślna to bieżąca godzina UTC).

Zwraca

Identyfikator przeglądu przesłanej przeglądu.

Definicje

SubmitReviewResponse

Identyfikator przeglądu przesłanej przeglądu.

Identyfikator przeglądu przesłanej przeglądu.

Identyfikator przeglądu
string

ExportSuccessfulResponse

Nazwa Ścieżka Typ Opis
Adres URL sygnatury dostępu współdzielonego obiektu blob
blobSasUrl string

Adres URL sygnatury dostępu współdzielonego wygenerowany z magazynu obiektów blob.

Data wygaśnięcia
expires string

Data wygaśnięcia adresu URL sygnatury dostępu współdzielonego.

Data utworzenia
created string

Data utworzenia adresu URL sygnatury dostępu współdzielonego.