Dynamics 365 Commerce: clasificaciones y opiniones
Use dynamics 365 Commerce Ratings and Reviews API para importar nuevas revisiones, exportar revisiones existentes, etc.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Dynamics 365 Commerce-Ratings y opiniones |
| URL | https://dynamics.microsoft.com/en-us/support/ |
| Correo Electrónico | d365ratingreviewconn@microsoft.com |
| Metadatos del conector | |
|---|---|
| Publicador | Microsoft |
| Sitio web | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| Directiva de privacidad | https://privacy.microsoft.com/privacystatement |
| Categorías | Comercio; Gestión empresarial |
El conector Dynamics 365 Commerce - Ratings and Reviews proporciona un conjunto de acciones para interactuar con las API de Dynamics 365 Ratings y Review Service. Estas acciones facilitan la importación y exportación de datos de revisiones. Hay dos acciones disponibles: Exportar todas las revisiones y Enviar una revisión.
Prerrequisitos
Necesitará lo siguiente para continuar:
- Suscripción a Microsoft Dynamics 365 Commerce
- Detalles de la solución clasificaciones y revisiones habilitadas
Póngase en contacto con un partner de Dynamics 365 Commerce aquí para obtener más información sobre cómo empezar a trabajar con Microsoft Dynamics 365.
Obtención de credenciales
El primer paso es registrar el conector como una aplicación en microsoft Entra ID. Esto permite que el conector se identifique a sí mismo en el identificador de Microsoft Entra y solicite permisos para acceder a los datos de clasificaciones y opiniones en nombre del usuario final. Obtenga más información sobre esto aquí y siga estos pasos:
1. Cree una aplicación de Id. de Entra de Microsoft:
Esta aplicación de Id. de Microsoft Entra se usará para identificar la conexión del conector a Clasificaciones y Revisiones. Para ello, sigaestos pasos para registrar una aplicación en microsoft Entra ID y habilitar la autenticación.
Durante el registro, capture la siguiente información, ya que se usará para establecer una conexión autenticada con el conector mediante la entidad de servicio:
- Id. de aplicación cliente
- Secreto de cliente (recuerde anotar esto, ya que solo se muestra una vez).
- Identificador del directorio de cliente (inquilino).
Con la aplicación Microsoft Entra ID creada, ahora se puede usar para obtener permisos de los usuarios finales. Use los campos que ha guardado para establecer una conexión autenticada a través de la entidad de servicio mediante el conector Dynamics 365 Commerce - Ratings and Reviews.
El siguiente paso es registrar esta aplicación en la página de configuración de la herramienta de moderación clasificaciones y opiniones.
2. Registrar la aplicación microsoft Entra ID en la Herramienta de moderación de clasificaciones y opiniones
Para que el servicio Clasificaciones y revisiones autentique las operaciones procedentes del conector, los clientes deben registrar su aplicación de id. de Microsoft Entra en la página de configuración de la herramienta de moderación Ratings and Review moderation (Clasificaciones y revisar la moderación). Use el identificador de aplicación cliente y el identificador de directorio de cliente del paso anterior para agregar una entrada de aplicación de servicio a servicio (S2S). Para obtener más información sobre cómo administrar la configuración de clasificaciones y revisiones desde la herramienta de moderación, consulte aquí.
Introducción al conector
Para empezar a trabajar con dynamics 365 Commerce - Ratings and Reviews Connector, basta con agregarlo a un flujo existente o empezar a buscar los flujos de plantilla de ejemplo para importar y exportar revisiones.
Nota: Dynamics 365 Commerce - Ratings and Reviews Connector estará disponible en todas las regiones de Power Automate, pero Las clasificaciones y las revisiones solo procesarán las llamadas en las regiones admitidas para el inquilino. Asegúrese de revisar los requisitos de cumplimiento de su organización y crear el entorno de Power Automate en una región que se ajuste a las necesidades de cumplimiento.
Preguntas más frecuentes
¿Cuál es la longitud máxima de un cuerpo de texto de revisión y el título de revisión?
La longitud máxima de un título de revisión es de 55 caracteres. La longitud máxima del cuerpo del texto de revisión es de 1000 caracteres.
¿Cuál es la estructura del parámetro encodedUser en la acción Enviar revisión?
El codificadorUser agrega seguridad adicional para pasar información de usuario. Codifica un esquema de identidad de usuario en base64. Consulte la estructura de esquema siguiente para componer el objeto en el flujo y, a continuación, use la función integrada toBase64() para codificarla antes de pasarlo en la acción 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" } }Para obtener más información, consulte un ejemplo de esto en nuestro flujo de plantillas de revisiones de importación.
Necesito más apoyo. ¿A quién puedo llegar?
Póngase en contacto con el soporte técnico de Dynamics 365 Commerce para obtener soporte técnico general o correo electrónico d365ratingreviewconn@microsoft.com.
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Enviar revisión de usuario |
Envía una revisión de usuario al inquilino de RnR. |
| Exportar todas las revisiones |
Exporte todas las revisiones como una dirección URL de SAS descargable. |
Enviar revisión de usuario
Envía una revisión de usuario al inquilino de RnR.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. del producto
|
productId | True | string |
Especifique el identificador del producto que se está revisando. |
|
Id. de inquilino de RnR
|
tenantId | True | string |
Especifique el identificador del inquilino de RnR. |
|
Id. de canal
|
channelId | string |
Especifique el identificador del canal para esta revisión. |
|
|
Mercado
|
market | string |
Especifique el mercado asociado a esta revisión. |
|
|
Configuración regional
|
locale | True | string |
Especifique la configuración regional asociada a esta revisión. |
|
encodedUser
|
encodedUser | True | string |
Especifique la cadena de información de usuario codificada en base64 asociada a esta revisión. Consulte la documentación sobre el formato de bloque JSON que contiene el nombre de usuario, el correo electrónico y el identificador. |
|
Rating
|
Rating | True | string |
Especifique la clasificación de la revisión como un entero. |
|
Title
|
Title | True | string |
Especifique el título de la revisión. |
|
ReviewText
|
ReviewText | True | string |
Especifique el cuerpo del texto de la revisión. |
|
Sku
|
Sku | string |
Especifique el número de SKU del producto revisado. |
|
|
ProductName
|
ProductName | True | string |
Especifique el nombre del producto revisado. |
|
LegalEntity
|
LegalEntity | string |
Especifique la entidad jurídica. |
|
|
ExtendedProperties
|
ExtendedProperties | object |
Especifique las propiedades de revisión adicionales como pares clave-valor. Consulte la documentación para el formato JSON. |
|
|
submittedDateTime
|
submittedDateTime | string |
Especifique la fecha y hora enviada de la revisión en formato UTC (el valor predeterminado es la hora UTC actual). |
Devoluciones
Identificador de revisión de la revisión enviada.
- response
- SubmitReviewResponse
Exportar todas las revisiones
Exporte todas las revisiones como una dirección URL de SAS descargable.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Id. de inquilino de RnR
|
tenantId | True | string |
Especifique el identificador del inquilino de RnR. |
Devoluciones
Definiciones
SubmitReviewResponse
Identificador de revisión de la revisión enviada.
Identificador de revisión de la revisión enviada.
- ReviewID
- string
ExportSuccessfulResponse
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Dirección URL de SAS de blobs
|
blobSasUrl | string |
Dirección URL de SAS generada a partir de Blob Storage. |
|
Fecha de expiración
|
expires | string |
Fecha en que expira la dirección URL de SAS. |
|
Fecha de creación
|
created | string |
Fecha en que se creó la dirección URL de SAS. |