[Endast SaaS]{class="badge positive" title="Gäller endast Adobe Commerce as a Cloud Service- och Adobe Commerce Optimizer-projekt (SaaS-infrastruktur som hanteras av Adobe)."}

Lägg till filer i produkter

Adobe Commerce as a Cloud Service har stöd för en produktattributindatatyp som gör att handlare kan bifoga filer - t.ex. PDF-filer, handböcker, certifikat och datablad - direkt till produkter. Filerna lagras i Amazon S3-medielagring och kan nås via butiken via GraphQL eller genom integreringar med REST API.

Det finns tre sätt att överföra filer till produktfilattribut:

Förutsättningar

Innan du överför filer måste du skapa ett filattribut och tilldela det till en attributuppsättning.

Överför filer via administratören

När du har skapat ett filattribut och tilldelat det till en attributuppsättning kan du överföra filer direkt från produktredigeringssidan.

{width="600" modal="regular"}

Om du vill ersätta en fil tar du bort den befintliga filen och överför en ny. Den överförda filen lagras i Amazon S3-medielagring.

Överför via REST API

Använd det S3-försignerade URL-flödet för att överföra filer programmatiskt via REST API. Den här processen fungerar på samma sätt för produktfilattribut som för andra medietyper som kategoribilder och kundattributfiler.

Processen består av fyra steg:

Överför via produktimport

Du kan bifoga flera filer till produkter samtidigt med import-API:t eller gränssnittet för administratörsimporten. Produktfilattribut stöder endast import från externa URL:er, vilket följer samma tillvägagångssätt som metod 2 för import av produktbilder. Commerce hämtar filen från den angivna URL:en och sparar den i medielagring i S3.

Ange URL-adressen i en dedikerad kolumn

Använd attributkoden som CSV-kolumnrubrik och den fullständiga URL:en som värde. Om attributkoden till exempel är file_upload ser CSV-filen ut så här:

sku,name,file_upload
ADB112,"My Product",https://example.com/files/manual.pdf

Ange URL:en i additional_attributes

Du kan även inkludera filattributet i kolumnen additional_attributes:

sku,name,additional_attributes
ADB112,"My Product",file_upload=https://example.com/files/manual.pdf

I båda fallen måste URL:en vara tillgänglig för alla, och filtillägget och filstorleken måste uppfylla de konfigurerade begränsningarna.

Hämta filer via GraphQL

I Adobe Commerce as a Cloud Service skickar katalogtjänstens GraphQL-slutpunkt produktdata. Filattribut visas i fältet attributes på ProductView, där value innehåller den fullständiga offentliga URL:en till filen:

{
  products(skus: ["ADB112"]) {
    sku
    name
    attributes(roles: []) {
      name
      label
      value
    }
  }
}

Svaret innehåller filattributet med dess offentliga URL:

{
  "data": {
    "products": [
      {
        "sku": "ADB112",
        "name": "Example product",
        "attributes": [
          {
            "name": "file",
            "label": "FILE",
            "value": "https://<host>/media/catalog/product_file/manual.pdf",
          }
        ]
      }
    ]
  }
}

Hämta filer via REST API

När en produkt hämtas via REST API (GET /V1/products/{sku}) visas filattribut i arrayen custom_attributes med filnamnet som värde:

{
  "custom_attributes": [
    {
      "attribute_code": "file_upload",
      "value": "manual_7aa0b2d63f6d3dbf.pdf"
    }
  ]
}