Loading
Generar un archivo de asignaciĆ³n por lotes para archivos almacenados de forma externa

Usted estĆ” aquĆ­:

  1. Ayuda de Salesforce
  2. Documentos
  3. Sector pĆŗblico

Generar un archivo de asignaciĆ³n por lotes para archivos almacenados de forma externa

Prepare archivos existentes para Amazon Bedrock o Amazon Kendra generando un archivo de asignaciĆ³n que asocie archivos de Salesforce con sus ubicaciones de Amazon S3. Debe completar esta tarea solo si tiene archivos existentes en Amazon S3 que desea buscar.

Ediciones necesarias

Permisos de usuario necesarios
Para activar BĆŗsqueda de almacenamiento externo: Personalizar aplicaciĆ³n
Para ver conjuntos de permisos: Ver parĆ”metros y configuraciĆ³n
Para asignar conjuntos de permisos: Asignar conjuntos de permisos
Para crear aplicaciones cliente externas locales: Crear, modificar y eliminar aplicaciones cliente externas

Antes de empezar, verifique que tiene:

  • Una organizaciĆ³n de Salesforce con una fuente de datos externa de Amazon S3 del tipo ContentHubAWSS3. Consulte Configurar bĆŗsqueda semĆ”ntica.
  • Una cuenta de AWS con permiso para crear funciones Lambda, funciones IAM y depĆ³sitos S3.
  • Un depĆ³sito de Amazon S3 en el que almacenar el archivo de asignaciĆ³n.

Crear un usuario de integraciĆ³n de Salesforce

  1. Desde ConfiguraciĆ³n de Salesforce, cree un usuario de integraciĆ³n.
  2. Configure el usuario con estos valores.
    Campo Valor
    Licencia de usuario IntegraciĆ³n de Salesforce
    Perfil Acceso mĆ­nimo - Integraciones solo de API
  3. Asigne la licencia de conjunto de permisos IntegraciĆ³n de API de Salesforce al usuario.
  4. Cree un conjunto de permisos que otorgue estos permisos:
    • API activado
    • Consultar todos los archivos
  5. Asigne el conjunto de permisos al usuario de integraciĆ³n.

Para obtener mĆ”s informaciĆ³n, consulte IntegraciĆ³n de usuarios en DocumentaciĆ³n de desarrollador de Salesforce y Crear conjuntos de permisos.

Crear una aplicaciĆ³n cliente externa

Cree una aplicaciĆ³n cliente externa local que utilice el flujo de credenciales de cliente de OAuth 2.0. En la configuraciĆ³n de OAuth, agregue el Ć”mbito Gestionar datos de usuario a travĆ©s de API (api) y configure el usuario de integraciĆ³n de Salesforce como el usuario que ejecuta.

Para obtener instrucciones detalladas, consulte Crear una aplicaciĆ³n cliente externa y Configurar un flujo de credenciales de cliente.

Crear el archivo de asignaciĆ³n

Implemente una funciĆ³n Lambda de AWS que consulte a Salesforce por archivos almacenados de forma externa y genere una asignaciĆ³n entre cada Id. de ContentDocument de Salesforce y su ubicaciĆ³n de Amazon S3.

Configure la funciĆ³n a travĆ©s de variables de entorno. Adjunte una funciĆ³n de ejecuciĆ³n de IAM con s3:PutObject que otorgue permiso para redactar el archivo de asignaciĆ³n en el depĆ³sito de S3 designado y enviar registros a Amazon CloudWatch.

Para obtener instrucciones, consulte Implementar funciones Lambda Python, Uso de variables de entorno Lambda, FunciĆ³n de ejecuciĆ³n Lambda en la documentaciĆ³n de AWS.

Este es el cĆ³digo Lambda de referencia:

# 1. Authenticate to Salesforce (OAuth 2.0 Client Credentials)
token = sf_oauth_token(SF_INSTANCE_URL, SF_CLIENT_ID, SF_CLIENT_SECRET)

# 2. Query ContentVersion -> ContentDocumentId, ExternalDocumentInfo2, ExternalDataSource
soql = ("SELECT ContentDocumentId, ExternalDocumentInfo2, "
        "ExternalDataSource.NamedCredentialId, ExternalDataSource.MasterLabel "
        "FROM ContentVersion WHERE IsLatest=true AND ExternalDocumentInfo2!=null "
        "AND ExternalDataSource.Type='ContentHubAWSS3'")
records = sf_query_all(token, soql)

# 3. Resolve each Named Credential's S3 endpoint URL (Tooling API)
nc_url = {nc_id: sf_named_credential_url(token, nc_id)
          for nc_id in {r["ExternalDataSource"]["NamedCredentialId"] for r in records}}

# 4. Build the mapping keyed by the external document id
mapping = defaultdict(list)
for r in records:
    nc_id = r["ExternalDataSource"]["NamedCredentialId"]
    mapping[r["ExternalDocumentInfo2"]].append({
        "ContentDocumentId": r["ContentDocumentId"],
        "DataSourceLabel": r["ExternalDataSource"]["MasterLabel"],
        "NamedCredentialId": nc_id,
        "S3_Endpoint_URL": nc_url.get(nc_id),
    })

# 5. Upload the mapping JSON to S3
boto3.client("s3").put_object(
    Bucket=S3_BUCKET_NAME, Key=S3_FILE_NAME,
    Body=json.dumps(mapping, indent=4), ContentType="application/json")
 
Cargando
Salesforce Help | Article