Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Descrizione

Questo metodo può essere utilizzato per modificare uno smartTemplate all'interno del sistema.

Utilizzo

I parametri richiesti da questa funzione sono:

  • templateId: Id del template da modificare.
  • templateName: Array di oggetti che definiscano il nome del template nelle varie lingue così strutturati:
    • languageId: Id della lingua.
    • value: Nome del template nella lingua specificata, lunghezza minima 5 caratteri, massima 100.
  • templateImage: Url dell'immagine di preview del template, false se non necessario.
  • colorPaletteType: Tipologia di palette colore utilizzata nel template.
  • colorPaletteItems: Array di stringhe che contengono i colori presenti nella palette in valori esadecimali #FFFFFF.
  • presetColorId: Id del preset per i colori impostato nel template, false se non necessario.
  • presetFontId: Id del preset per i fonts impostato nel template, false se non necessario.
  • experienceType: Tipologia di interfaccia utente utilizzata nel template.
  • flatWorkingAreatrue se si vogliono rimuovere l'effetto di ombra e il bordo all'area di lavoro, false in caso contrario.
  • workingAreaBackgroundColor: colore di sfondo da applicare all'area di lavoro espresso in valore decimale #FFFFFF, se impostato a false verrà mantenuto il colore di default.
  • googleFonts: Array di oggetti che rappresentano la lista di font associati al template così composti:
    • fontId: Id del font
    • fontName: Nome del font
  • adobeTypeKit: Id del kit di adobe associato al template, false se non necessario.
  • enable: true se la categoria è attiva, false in caso contrario.
  • sortOrder: Numero che rappresenta l'indice di visualizzazione per questo elemento.

 Il metodo non ha nessun valore di ritorno.

Gestione errori

In caso di errore il metodo genererà un'eccezione che riporterà uno dei seguenti codici di errore:

  • ERROR_INVALID_TEMPLATE_ID: L'id del template non è valido.
  • ERROR_INVALID_PARAMS: Uno dei parametri inviati non è valido.
  • ERROR_UNABLE_TO_GET_IMAGE: Si è verificato un errore nel salvataggio dell'immagine associata.
  • ERROR_INVALID_TOKEN: Non è stato effettuato nessun login in precedenza o la sessione è scaduta per inutilizzo.
  • ERROR_INVALID_IP: L'indirizzo ip del server che sta effettuando la chiamata non valido perchè non inserito nella whitelist associata alle credenziali.
  • ERROR_SERVER_UNAVAILABLE: Il server non è disponibile o si è verificato un errore di comunicazione generico.

Status
colourRed
titleAttenzione

Info
titlePossibili tipologie di palette colori

Il campo colorPaletteType può avere i seguenti valori:

  • PALETTE: I colori potranno essere scelti da un palette limitata di valori definita nel template.
  • PICKER: I colori potranno essere scelti trami un colorpicker.

In .NET è possibile utilizzare la struttura statica colorPaletteTypes presente in Structures.

Info
titlePossibili tipologie di interfaccia editor

Il campo experienceType può avere i seguenti valori:

  • 0: Interfaccia professionale senza wizard di caricamento foto.
  • 1: Interfaccia professionale con wizard di caricamento foto.
  • 2: Interfaccia smart senza wizard di caricamento foto.
  • 3: Interfaccia smart con wizard di caricamento foto.

In .NET è possibile utilizzare la struttura statica experienceTypes presente in Structures.

 

Code Block
languagephp
titlePHP
linenumberstrue
require "vendor/autoload.php"
 
try {
    $ezPrintSDK = new ezPrintSDKWrapper('http://demo.ezprint.it');
	$apiToken = $ezPrintSDK->cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG');
 
	$googleFonts = $ezPrintSDK->editor->eGetGoogleFonts();
 	$availableLanguages = $ezPrintSDK->backOffice->bGetAvailableLanguages();
	$smartTemplates = $ezPrintSDK->backOffice->eGetSmartTemplates(false, false, $availableLanguages[0]['languageId'], 200);
 
	$templateName = array();
 
	foreach($availableLanguages as $language) {
        $templateName[] = array(
            'languageId'    => $language['languageId'],
            'value'         => 'Nome ' . $language['languageName']
        );
    }
	
	$ezPrintSDK->editor->eEditSmartTemplate($smartTemplates[0]['templateId'], $templateName, false, 'PICKER', array(), false, false, 0, array_slice($googleFonts, 0, 5), '', true, 0);
} catch (Exception $e) {
    echo 'Error Code: ',  $e->getMessage();
}

Code Block
languagejs
titleNode.js
linenumberstrue
try {
	var ezPrintSDK = require('ezprint-sdk-wrapper');
	ezPrintSDK.initializeWrapper('http://demo.ezprint.it');
    
	var apiToken = ezPrintSDK.cLoginAPI('1WHm0icsupAEm9fil9en','yCHZ0nKiyn1MU0DhpgmG');
	
	var googleFonts = ezPrintSDK.editor.eGetGoogleFonts();
	var availableLanguages = $ezPrintSDK.backOffice.bGetAvailableLanguages();
	var smartTemplates = ezPrintSDK.editor.eGetSmartTemplates(false, false, availableLanguages[0].languageId, 200);
 
	var templateName = [];
 
	availableLanguages.forEach(function(language) {
        templateName.push({
            languageId:     language['languageId'],
            value:          'Nome ' . language['languageName']
        });
    });
 
	 ezPrintSDK.editor.eEditSmartTemplate(smartTemplates[0].templateId, templateName, false, 'PICKER', [], false, false, 0, googleFonts.slice(0, 5), '', true, 0);
} catch (ex) {
	console.log(ex);
}
Code Block
languagec#
title.NET (C#)
linenumberstrue
try {
	ezPrintSDKWrapper.Client ezPrintSDK = new ezPrintSDKWrapper.Client("http://demo.ezprint.it");
	ezPrintSDK.cLoginAPI("1WHm0icsupAEm9fil9en","yCHZ0nKiyn1MU0DhpgmG");
 
	List<ezPrintSDKWrapper.Structures.googleFontItem> googleFonts = ezPrintSDK.Editor.eGetGoogleFonts();
	List<ezPrintSDKWrapper.Structures.languageItem> availableLanguages = ezPrintSDK.BackOffice.bGetAvailableLanguages();
    List<ezPrintSDKWrapper.Structures.localizationItem> templateName = new List<ezPrintSDKWrapper.Structures.localizationItem>();
	List<ezPrintSDKWrapper.Structures.smartTemplateItem> smartTemplates = ezPrintSDK.Editor.eGetSmartTemplates(false, false, availableLanguages[0].languageId, 200);
 
	foreach (ezPrintSDKWrapper.Structures.languageItem language in availableLanguages) {
        templateName.Add(new ezPrintSDKWrapper.Structures.localizationItem() {languageId = language.languageId, value = "Name " + language.languageName});
    }
 
	ezPrintSDK.Editor.eEditSmartTemplate(smartTemplates[0].templateId, templateName, false, ezPrintSDKWrapper.Structures.colorPaletteTypes.pickerType, new string[] {}, false, false, ezPrintSDKWrapper.Structures.experienceTypes.proInterfaceWithoutWizard, googleFonts.Take(5).ToList(), "", true, 0);
} catch (ezPrintException ex) {
	string ErrorMessage = ex.Message;
}