Loading
Ställa in och bibehålla din Salesforce-organisation
Förbered dina data och AWS S3-miljö för arkivimport

Du är här:

  1. Salesforce-hjälp
  2. Dokument
  3. Ställa in och bibehålla din Salesforce-organisation

Förbered dina data och AWS S3-miljö för arkivimport

Importera avladdade Salesforce-data till appen Arkiv.

Exempel
Exempel För att importera data från en S3-hink, skapa först en S3-hink i en av AWS-regionerna. Mer information finns i Skapa en allmän hink i AWS S3 Användarguide.

Konfigurera S3-hinkbehörigheter

För att etablera en säker anslutning behöver tjänsten specifika behörigheter för åtkomst till din S3-hink. Följ dessa steg för att skapa en dedikerad IAM-policy för IAM-användaren som beviljar nödvändiga behörigheter.

Sammanfattning av nödvändiga behörigheter

  • Listhinkinnehåll
    • Åtgärd: s3:ListBucket
    • Resurs: arn:aws:s3:::my-bucket
    • Villkor: Endast för objekt med prefixet path/to/my/data/*

  • Läs objekt

    • Åtgärd: s3:GetObject
    • Resurs: arn:aws:s3:::my-bucket/path/to/my/data/*

    Använd denna JSON-policymall för att bevilja de behörigheter som behövs.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowListFolder",
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::my-bucket",
      "Condition": {
        "StringLike": {
          "s3:prefix": "path/to/my/data/*"
        }
      }
    },
    {
      "Sid": "AllowReadObjects",
      "Effect": "Allow",
      "Action": "s3:GetObject",
      "Resource": "arn:aws:s3:::my-bucket/path/to/my/data/*"
    }
  ]
}

Uppfyll förkrav för dataimport

Dina importerade datafiler krävs för att uppfylla dessa krav.

  • Datavalidering

    • I ditt aktuella schema, se till att varje CSV-fils sidhuvud innehåller minst 80% av fälten som definieras för det objektet.
    • Den totala storleken på alla data i AWS S3-hinken får inte överstiga 3 TB.

  • Filformat

    • Se till att varje fil är i CSV-format.
    • Varje CSV-fil innehåller poster för endast en Salesforce-objekttyp, till exempel alla kundcaseposter i Case.csv.
    • I ditt aktuella schema, se till att varje CSV-filnamn exakt matchar objektets API-namn.

  • Filrubriker

    • Den första raden i varje CSV är rubrikraden.
    • Sidhuvuden innehåller de exakta API-namnen på fälten för det objektet, till exempel FirstName.
  • Plats
    • Placera alla importerade datafiler i en enda S3-hink.

När din S3-miljö har konfigurerats och dina data har formaterats korrekt, inled datainläsningen från AWS S3 till Arkiv.

  • Strukturfiler och bilagor för arkivimport
    För att importera ContentVersion-filer och bilagor till appen Arkiv, förbered dina fysiska filer och motsvarande metadata som lagras i CSV-filer så att Arkiv kan bearbeta och länka dina data korrekt.
  • Initiera datainläsningen från AWS S3 till arkivappen
    Starta processen med att läsa in dina förberedda data från en AWS S3-hink till det säkra fasningsområdet för Arkivera app. Denna åtgärd är det första aktiva steget i importprocessen och förbereder dina data för det slutgiltiga arkiveringssteget.
  • Skapa en importpolicy i arkivappen
    När dina avladdade data har lästs in i fasningsområdet Arkivera app, skapa och kör en speciell importpolicy för att flytta dina fasade data permanent till ditt arkiv.
  • Vanliga frågor om arkivimport
    Vanliga frågor om arkivimport i appen Arkiv.

Se även:

Strukturfiler och bilagor för arkivimport

För att importera ContentVersion-filer och bilagor till appen Arkiv, förbered dina fysiska filer och motsvarande metadata som lagras i CSV-filer så att Arkiv kan bearbeta och länka dina data korrekt.

Se till att du uppfyller de allmänna kraven för data och AWS S3-miljö för arkivimport.

Allmänna CSV-krav

  • Kolumnen Id, som innehåller ett Salesforce-ID på 18 tecken, är obligatorisk för alla CSV-filer i importprocessen.
  • Ett CSV-sidhuvud som innehåller Id och alla andra relevanta standardfält och egna fält som definierats för objektet i ditt Salesforce-schema.

Importera ContentVersion-filer

Importera ContentVersion-filer:

  1. I din S3-hink, skapa en katalog som heter ContentDocuments.
  2. Placera alla dina fysiska filer, som PDF och PNG, i katalogen ContentDocuments.
    Anteckning
    Anteckning Det är viktigt att varje filnamn matchar det ursprungliga filnamnet som först laddades upp i Salesforce. Om du har två olika filer med samma namn misslyckas denna process.
    Anteckning
    Anteckning Om samma fil är associerad med flera poster i Salesforce, infoga endast en kopia av filen i ContentDocuments-katalogen. Appen Arkivera bifogar den enskilda filen till alla poster som refererar den.
  3. Tillhandahåll dessa CSV-filer. Du importerar dessa filer tillsammans, så det finns ingen obligatorisk importorder.
    • ContentDocument.csv: Denna fil skapar de överordnade ContentDocument-posterna, som fungerar som behållare för filversioner. Dessa CSV-fält är obligatoriska.
      • Id: Filens unika ContentDocument-ID på 18 tecken.
      • Alla standardfält som Description och alla egna fält som My_Custom__c från ditt ContentDocument-schema.
    • ContentVersion.csv: Denna fil länkar filversionen till dess rotpost ContentDocument. Dessa CSV-fält är obligatoriska.
      • Id: Filens unika ContentVersion-ID på 18 tecken.
        Anteckning
        Anteckning Se till att matcha ID:t med filnamnet i din S3-hink.
      • ContentDocumentId: ID från ditt ContentDocument.csv. Detta ID länkar versionen till dess behållare.
      • PathOnClient: Det exakta ursprungliga filnamnet på den motsvarande fysiska filen i ContentDocuments-katalogen.
      • VersionData: Detta fält måste vara tomt.
      • Alla standardfält och egna fält från ditt ContentVersion-schema.
    • ContentDocumentLink.csv: Denna fil länkar ContentDocument-posten och alla dess versioner till dess associerade rotposter i Salesforce, som Konton och Kundcase. Dessa CSV-fält är obligatoriska.
      • Id: Filens unika ContentDocumentLink-ID på 18 tecken.
      • ContentDocumentId: ID för ditt ContentDocument.csv. Detta ID länkar filversionen till dess behållare.
      • LinkedEntityId: Salesforce-ID för posten som är associerad med filen.
      • Alla standardfält och egna fält från ditt ContentDocumentLink-schema.

Importera bilagorposter

Processen för att importera standardbilagor följer en enklare logik än ContentVersions.

  1. I din S3-hink, skapa en katalog som heter Bilagor.
  2. Placera alla dina bifogade filer i katalogen Bilagor.
    Anteckning
    Anteckning Varje fil måste matcha det ursprungliga filnamnet som laddades upp till Salesforce. Om du har två olika filer med samma namn misslyckas denna process.
  3. Skapa en CSV-fil som heter Attachment.csv. Denna fil innehåller metadata och rotpostlänken för varje bifogad fil i katalogen. Dessa CSV-fält är obligatoriska.
    • Id: Bilagans unika Bilaga-ID på 18 tecken.
    • ParentId: Salesforce-ID för posten som är associerad med denna bilaga.
    • Name: Detta fält är obligatoriskt för att innehålla det exakta ursprungliga filnamnet på den motsvarande fysiska filen i katalogen Bilagor.
    • Alla standardfält och egna fält från ditt schema för bilagor.
    Anteckning
    Anteckning Om du har en stor mängd bilagor kan du dela upp metadata i flera indexerade filer, som Attachment_1.csv och Attachment_2.csv.
    Anteckning
    Anteckning Alla CSV-filer måste finnas kvar i rotmappen. Placera dem inte i underkatalogerna ContentDocuments eller Attachments.

Lös filnamnskollisioner

En filnamnskollision inträffar när två olika fysiska filer delar det ursprungliga namnet. Du kan inte placera båda filerna i samma S3-katalog. För att lösa denna konflikt:

  1. Byt namn på den fysiska filen i din S3-hink från dess ursprungliga namn till dess unika Salesforce-ID på 18 tecken följt av filsuffixet. Till exempel:
    • Bilagans postfaktura.pdf blir 00P5g000002aBCDEFGA.pdf
    • ContentVersion-filrapport.pdf blir 0685g000001ABCDEFE.pdf
  2. Lägg till detta nya ID-baserade filnamn i lämpligt CSV-fält så att arkivappen kan hitta det.

    För ContentVersion-filer, uppdatera fältet PathOnClient.

    För bilagor uppdaterar du Name.

Validera och initiera datainläsningen

När du har strukturerat dina S3-kataloger och placerat dina motsvarande CSV i roten av S3-hinken kan du inleda datainläsningen.

Vi rekommenderar att du validerar importprocessen först.

  1. Gå till fliken Aktiviteter i Arkiv.
  2. Innan du startar arkiveringen kan du ladda ner aktivitetsloggen för att bekräfta att alla CSV:er och filer har lästs in.
    Denna logg visar antalet poster, som Kundcase och bilagor, och en lista över de fysiska filer som är redo att importeras. Du kan använda denna logg för att identifiera fel, till exempel filer som saknas, innan du överlämnar dig till arkivet.

Initiera datainläsningen från AWS S3 till arkivappen

Starta processen med att läsa in dina förberedda data från en AWS S3-hink till det säkra fasningsområdet för Arkivera app. Denna åtgärd är det första aktiva steget i importprocessen och förbereder dina data för det slutgiltiga arkiveringssteget.

Viktig
Viktig S3-import är inte tillgänglig för Hyperforce. Om din organisation använder Hyperforce, använd lokal hårddiskimport istället. S3-import för Hyperforce planeras till utgåvan Winter '27.
  • Konfigurera din AWS S3-hink och förbered dina datafiler för arkivimport.
  • Kontrollera att filerna som ska importeras har rätt struktur.
  • Kontrollera att ingen annan dataimport eller policyprocess körs. En ny process kan endast startas efter att den föregående har slutförts helt.

Initiera datainläsningen

Varning
Varning För att förhindra fel, se till att din S3-källmapp endast innehåller de CSV-filer du planerar att importera. Ta bort testfiler, säkerhetskopior eller orelaterade rapporter innan du börjar.
  1. Från startsidan för Arkivera, klicka på ikonen Importera data.
  2. Ange dessa anslutningsdetaljer för din S3-hink.
    • Nyckel-ID för AWS Access
    • AWS Secret Access Key
    • S3-hinksökväg

      Exempel: //my-example-bucket/path/to/folder

    • S3 Region

      Exempel: us-east-2

  3. För att starta processen, klicka på Importera.

Övervaka datainläsningsprocessen

Systemet validerar först S3-anslutningen och filformaten. Om ett fel uppstår stoppas processen och ett felmeddelande beskriver problemet.

För att se status för aktiviteten Importera-data-ladda, gå till fliken Aktiviteter. Förloppet mäts genom antalet filer som behandlas.

Anteckning
Anteckning Åtgärden Importera-data-ladda är endast synlig på fliken Aktiviteter och visas inte i sektionen Senaste aktiviteter på startsidan.

När aktiviteten Importera-data-ladda är klar kan du visa eller rensa poster i fasningsområdet innan du skapar och kör en importpolicy.

Skapa en importpolicy i arkivappen

När dina avladdade data har lästs in i fasningsområdet Arkivera app, skapa och kör en speciell importpolicy för att flytta dina fasade data permanent till ditt arkiv.

Importpolicyer är endast tillgängliga efter att data har lästs in i fasningsområdet. Kontrollera att aktiviteten Importera-data-ladda har slutförts innan du fortsätter med en ny.

  1. Gå till fliken Policyer.
  2. Välj Ny.
  3. Välj Arkivera från importerade data.
  4. Konfigurera dina inställningar för importpolicyer.
    Viktig
    Viktig

    För att arkivera 1-2 miljoner poster dagligen, arkivera hela objektträdet som en enskild process. I din importpolicy, välj Arkivera alla relaterade poster som urvalsmetod för relaterade objekt. Detta alternativ minskar bearbetningsoverhead och optimerar skapandet av S3-filer.

Viktiga egenskaper för en importpolicy

  • Schemaläggaren är avstängd. Använd alternativet Kör nu.
  • Policyn bearbetar automatiskt alla fasade poster för det valda rotobjektet. Filter är inte tillgängliga.
  • Policyn bearbetar data från fasningsområdet, inte din liveorganisation, så det påverkar inte prestandan.

Inställningar för relationsarkivering

  • Inställning Beskrivning
    Arkivera alla relaterade poster Detta alternativ arkiverar automatiskt alla underordnade poster som är anslutna till rotposten via en sökrelation.
    Arkivera inte relaterade poster Detta alternativ utför en riktad arkivering. Det riktade arkivet inkluderar endast de primära poster som matchar din sökfråga och deras direkt beroende underordnade poster i en kaskad-raderingsrelation. Alla andra relaterade poster, som de i standardsökrelationer som Kontakter i ett konto, utesluts från Arkiv.
    Välj relationer manuellt Detta alternativ ger kontroll för att välja exakt vilka direkta underordnade relationer som inkluderas under arkiveringen. När du har valt detta alternativ visas en lista över tillgängliga underordnade relationer och du väljer de specifika objekt som ska arkiveras tillsammans med rotobjektet.

Kör och övervaka importpolicyn

  1. För att starta den slutgiltiga arkiveringsprocessen, klicka på Kör nu i importpolicyn.
  2. Följ statusen på fliken Aktiviteter.
    Processen loggas med åtgärdstypen Import-data-arkiv.
Anteckning
Anteckning Varje arkivprocess tilldelas upp till 1 miljon rotposter. Om du planerar att importera mer än 1 miljon rotposter delas arkiveringsprocessen upp i så många separata processer, var och en med sin egen aktivitet, som krävs tills importpolicyn är färdig.

Systemet krävs för att slutföra hela cykeln för import-data-inläsning och import-data-arkivering för den aktuella datauppsättningen innan en ny import kan påbörjas. När aktiviteten Importera-dataarkivera är klar lagras dina data säkert och du kan starta en ny importcykel.

Lagringspolicy

Välj kriterierna från dessa källor.

  • Arkiveringsdatum
  • Datum för skapande
  • Senaste ändringsdatum

Välj hur lång tid du vill behålla de arkiverade data. Den kortaste lagringsperioden är en månad och den längsta är 99 år och 11 månader.

Att skapa en lagringsperiod på noll år och noll månader innebär att data rensas automatiskt inom 24 timmar.

Vanliga frågor om arkivimport

Vanliga frågor om arkivimport i appen Arkiv.

Q: Vad gör jag om jag inte kan ansluta till min AWS S3-hink?

A: Om du inte kan ansluta till din S3-hink, bekräfta dina inloggningsuppgifter och behörigheter. Se till att du har rätt åtkomstnyckel, hemlig nyckel och sökväg.

Q: Vad händer om filnamnen eller datan är felaktiga under inläsningsfasen för Importera data?

A: Om filnamn eller data är felaktiga, identifiera dem från en lista i granskningsfilen på fliken Aktiviteter. Åtgärda felen och försök läsa in processen igen.

Q: Om en import pågår, kan jag starta en ny?

A: Nej, om en import körs kan du inte starta en ny. Ett felmeddelande visas i användargränssnittet som säger att en annan process pågår. Vänta tills den aktuella importen är klar eller kontakta Salesforces support. När du har arkiverat alla importerade poster kan du starta en ny import. Se till att importera alla data som behövs i samma process.

Q: Ska jag dela upp min import i flera jobb efter filtyp, som att läsa in uppgifter först och sedan bilder?

A: Nej. För optimal prestanda, inkludera alla CSV och innehållsfiler i ett enda importjobb. Att köra separata jobb för olika filtyper, som att läsa in uppgifter i ett jobb och bilder i ett annat jobb, kräver att Arkiv överför databasen till och från S3 upprepade gånger. Denna upprepning saktar ner inläsningsprocessen betydligt.

Q: Kan jag köra flera arkivpolicyer samtidigt?

A: Nej, du kan endast köra en arkiveringspolicy åt gången. Om du försöker köra en annan policy får du ett felmeddelande i användargränssnittet. Eftersom du arbetar i samma databas kan du inte låta en arkiveringsprocess ta bort data medan en annan process läser dem.

Q: Hur väljer jag relationer vid arkivering av importerade data?

A: När du definierar din policy, specificera vilka sökrelationer som ska inkluderas. Huvud-detalj-relationer inkluderas automatiskt.

Om du inte är säker på vilka sökrelationer du ska inkludera, välj Alla relationer. Detta alternativ säkerställer att appen arkiverar rotposten och alla dess relaterade underordnade poster. Om du senare avarkiverar en relaterad underordnad post återställer appen hela posthierarkin, med början från rotposten.

Q: Hur kan jag övervaka förloppet för min arkivprocess?

A: Du kan övervaka förloppet för din arkiveringsprocess genom att granska förloppsstapeln på fliken Aktiviteter. Förloppsstapeln visar procentandelen arkiverade poster av det totala antalet poster.

Q: Vad händer om arkiveringsprocessen inte tar bort poster från det säkra fasningsområdet?

A: Om arkiveringsprocessen misslyckas med att ta bort poster från fasningsområdet visas ett felmeddelande i granskningsfilen, men arkiveringen fortsätter att slutföras. För att förhindra dubbletter arkiverar inte systemet samma post mer än en gång, även om ett rensningsfel inträffar efter arkiveringsprocessen.

Q: Om arkiveringsprocessen fastnar, kan jag starta om den manuellt?

A: Ja, om arkiveringsprocessen fastnar och en ny process inte startar automatiskt kan du starta om den manuellt. Om du upplever detta problem, kontakta Salesforces support för att bekräfta att allt fungerar korrekt.

Q: Vad gör jag om jag inte ser granskningsfilen på fliken Aktiviteter?

A: Om du inte ser granskningsfilen eller aktivitetsloggarna på fliken Aktiviteter, kontrollera dina filter. Kontrollera att du inte filtrerar efter ett start- eller slutdatum som utesluter den aktuella aktiviteten. Om problemet kvarstår, kontakta Salesforces support för att få hjälp.

Q: Hur många poster kan jag arkivera i en enda arkiveringsprocess?

A: En enskild arkiveringsprocess kan hantera upp till en miljon poster. Om du har mer än en miljon poster att arkivera delas processen upp i flera processer, var och en med en miljon poster. Denna process är automatiserad.

Q: Om det finns överblivna poster från ett tidigare arkiv, kan jag starta en ny import?

A: Nej, du måste arkivera de överblivna posterna först innan du påbörjar en ny import. Om du fastnar kan Salesforces support tillhandahålla information om vilka poster som saknas och som kräver arkivering.

Q: Hur lång tid tar arkiveringsprocessen?

A: Tiden det tar att arkivera poster från fasningsområdena beror på antalet poster i din databas och hur många du arkiverar. Förloppsstapeln på fliken Aktiviteter kan hjälpa dig uppskatta tiden.

Q: Vad händer om jag ser ett meddelande som säger att ett objekt är arkiverat, men det var det inte?

A: Detta meddelande visas inte om objektet inte har arkiverats. Om du ser detta fel är det från en tidigare misslyckad borttagningsåtgärd. Kontakta Salesforces support för att lösa problemet och verifiera att posterna arkiveras korrekt.

Q: Hur ser jag vad som finns i fasningsområdet?

A: På startsidan för Arkiv, klicka på ikonen Importera och klicka sedan på Skapa sammanfattning. I fönstret Skapa sammanfattning, klicka på Skapa. När skapandet är klart, gå till fliken Aktiviteter och ladda ner sammanfattningsrapporten. Rapporten innehåller postantal efter objekttyp för alla poster i fasningsområdet som inte har arkiverats ännu.

Q: Hur rensar jag fasningsområdet?

A: På startsidan för Arkivera, klicka på ikonen Importera och klicka sedan på Ta bort fasade data. I fönstret Ta bort fasade data?, granska varningen och klicka på Ta bort för att bekräfta. Denna åtgärd tar permanent bort alla importerade poster som inte har arkiverats ännu.

Q: Vad händer om jag rensar fasningsområdet av misstag?

A: Om du rensar fasningsområdet av misstag tas alla importerade poster som inte har arkiverats bort permanent. Denna åtgärd kan inte ångras. Importera dina data igen från källan (lokal hårddisk eller AWS S3) för att återställa posterna till mellanlagringsområdet.

Q: Kan jag visa eller rensa fasningsområdet medan en import körs?

A: Nej. Om en import- eller arkiveringsprocess körs kan du inte visa eller rensa fasningsområdet. Vänta tills den aktuella processen är klar innan du hanterar fasade data.

 
Laddar
Salesforce Help | Article