Efficy Overflow Q&A - Recent questions and answers in Guest

Answered: How to insert a QR code in a template with a dynamic hyperlink to a guest page including the MAILINGCODE

Fri, 14 Apr 2023 06:52:31 +0000

Hi Eric

Flexmail supports the barcode element, that can generate QR codes.
See https://help.efficy.io/edn/projectguides/flexmail_gdpr#send-campaign-registration-reminder-e-mail

Answered: Error in document sharing link

Thu, 08 Jul 2021 14:53:26 +0000

Hello,

You need to modify the property "fileUrl" in the configuration.

Kr,

Eric

Guest page & requirejs : Yes we can!

Fri, 18 Jun 2021 11:48:26 +0000

I know, I know, I know: Guest pages went to the dark side of the force! But since I'm as old as Methuselah, I already had to work on them and still have to, for legacy reasons.

First I have to thank Stéphane & Kristof, our gurus, who opened the Red Sea waters to let me reach the Holy Land.

The first step to activate requirejs framework from a guest page is to call a macro like this one:

DialogScripts {[
  <%UseScript('js/config/require.config.js', fixedpath=T, data-custombase='%%GetFileBase(short=T)')%>
  <%Evaluate("%%Macro('RequireConfigCustom')")%>
  <%UseScript('../../../../lib/js/vendor/require.js', fixedpath=T, data-main='%%Macro("MainJsModule")', data-custom-main='%%Macro("MainJsModuleCustom")')%>
]}

The second one is to copy the standard efficy/js/config/require.config.js file in your guest/myGuest/js/config folder. A few drops of Holy water on this file will then suffice to perform the miracle :

baseUrl: '../guest/myGuest/js',

Since your custom require.config.js is one level deeper than the efficy one, you have to add one ../ to all relative paths:

'domReady':               '../../lib/js/vendor/require.domReady',

becomes

'domReady':             '../../../lib/js/vendor/require.domReady',

Add this ../ to all standard modules relative paths.

And at the end of the file :

if (tagC) {
  attrC = tagC.getAttribute(attrC).replace(/([^\/]*)\/$/, '$1'); // remove trailing slash;
  if (attrC) require.paths.custom = '../' + attrC + '/js/';
}
if (tagD) {
  attrD = tagD.getAttribute(attrD).replace(/([^\/]*)\/$/, '$1'); // remove trailing slash;
  if (attrD && attrD !== '..') require.paths.dealer = '../' + attrD + '/js/';
}

becomes

if (tagC) {
  attrC = tagC.getAttribute(attrC).replace(/([^\/]*)\/$/, '$1'); // remove trailing slash;
if (attrC)
  require.paths.custom = '../../' + attrC + '/js/';
}
if (tagD) {
  attrD = tagD.getAttribute(attrD).replace(/([^\/]*)\/$/, '$1'); // remove trailing slash;
if (attrD && attrD !== '..')
  require.paths.dealer = '../../' + attrD + '/js/';
}

You can now use the requirejs well known syntax from your page :

requirejs(
  ['standardModule', 'custom/misc/customModule'],
  function(StandardModule, CustomModule) {
     ...
  }
);

Meditate on this Psalm III of Chapter II of the Gospel according to Saint Peter and think about it the next time you'll have to work on a guest page.

Amen!

Answered: refresh GetGuestLabel in 12.0

Fri, 28 May 2021 11:34:03 +0000

Hello

It seems very much related to this earlier Overflow post, Stéphane experienced the same issue when trying to refresh guest labels. And, I can also simulate the no-refresh labels issue.

I think the action is no longer executed since the development of the customer profile. So, at the moment, I don't see any easy work around besides the Application Pool recycle.

I created incident CFT-2021-144551, linked to this post and linked to your user account.

Edit: the issue was instantly fixed by R&D, r25003. So, in 3 months it should be rolled out on all Cloud instances of 11.3 and 12.0

Answered: Customize the error message for a Guest page when there are "Invalid parameters"

Sat, 12 Dec 2020 00:06:17 +0000

Hello Jeroen,

It's not possible. It might be a nice suggestion to the R&D team.

Alex.

Answered: Upload documents (files) from a guest page

Fri, 31 May 2019 13:15:34 +0000

Hi Henry

Since 11.2, you can make a ServerJS node script that allows you to read the binary stream of the uploaded file. I quickly made a show case of how you can work both client side and server side.

Note that it's tested with only one file upload in a form post. Tested only with Chrome etc. It's a prototype that needs further improvements, but at least it's a POC that proves we can do it without dotnet

WARNING: Enabling file upload without authentication is a security consideration. The request can be used to SPAM the database with a large amount of files. Malicious files and scripts can be uploaded without any problem. We do recommend to dump each file to disk to have it scanned before exposing it to internal users or at least whitelist only safe extensions. The best design is to limit file upload to the extranet only.

Guest page:
https://mydomain/crm/guest?app=website

<!DOCTYPE>
<html>
<head></head>
<body>
<form method="post" enctype="multipart/form-data" 
  action="node/upload/file">
  <input type="file" name="File1" id="File1" /></br>
  <input type="submit" name="Submit" value="Submit files(s)" />
</form>
</body>
</html>

customs\{customer}\efficy\serverjs\api\node\upload\file.js

function main() {      
  try {        
    var rawContent = Request.rawContent(),
        contentParts = rawContent.split("\n\r\n"),
        headers = contentParts[0],
        byteStream = contentParts[1],
        filename = "",
        matches = headers.match(/filename[^;=\n]*=(?:(\\?['"])(.*?)\1|(?:[^\s]+'.*?')?([^;\n]*))/);

    if (matches.length > 2) {
      filename = matches[2];   
    }

    if (filename && byteStream) {      
      strSaveBinaryFile("c:\\temp\\" + filename, byteStream, false);
    }

    Response.setStatusCode(200); // HTTP_OK
  } catch (e) {
    Response.setStatusCode(400); // HTTP_BADREQUEST
Response.setContent(e.message);
  }
}

Answered: Using readregistry in Efficy 11.2 guest page

Thu, 09 May 2019 13:08:47 +0000

Hello Rob,

You should have defined a Guest Application with a name in the Alias Manager.
You can then use this name in the following URL:

http://127.0.0.1/crm/guest?app=YOUR_GUEST_NAME&action=readregistry

There is no need to put the "customer" parameter in the URL, the guest name sent in the "app" parameter is sufficient.

Answered: Remote API Node - Unauthorized IP for the provided API key

Fri, 08 Mar 2019 08:06:35 +0000

Did you add the full host name, arthurenwillemijn.efficytest.com ?

Answered: Encrypt string parameters in guest page

Tue, 25 Jul 2017 06:03:06 +0000

Another simpler approach is to check server side whether or not the guest contact has access on that record identified by propkey. Throw an exception when access is forbidden. It will lead to the typical guest page error, but that's should not be an issue.

I prefer security serverside instead of obscurity

Answered: Guest Page configuration

Sat, 19 Nov 2016 20:00:58 +0000

After a quick talk with Prince, the real issue was that the file he was trying to access was miss named.

After renamed it, everything is ok :)

Alex.

Answered: Guest configuration : application password start with ?

Wed, 16 Nov 2016 13:43:50 +0000

Reponse from R&D :

As of now, the /guest?action=readregistry uses the first character of
the xxx_password key to determine if the password is already
encrypted.

Therefore, currently a password starting itself with "?" must be
encrypted elsewhere and copied into the key value in the already
encrypted form, prepended with a "?".

It will, maybe, be improved in a futur Efficy release.

Alex.

Answered: REST webservice and Efficy

Thu, 18 Feb 2016 11:01:58 +0000

Hi Henry,

we are running an extensive REST service based on SYMFONY & PHP5 -> Efficy 2012.

Is this something you are interessed in?
we happy to share some knowledge ;-)

Kind regards, Tim

Answered: opencaptcha deprecated

Wed, 06 Jan 2016 10:21:49 +0000

Thank you
I reply to avoid keeping this post in the unanswered :-)
Next time ask the question and replys yourself in case it is not a direct question but an information post

thanks
Yannick

Answered: How to refresh guest labels ?

Wed, 16 Sep 2015 09:23:37 +0000

Now it is working !

I moved my guestlabels file into the wwwroot folder ( as efficylabels file )

Answered: Guest Page or Extranet what is the difference?

Wed, 12 Aug 2015 10:11:08 +0000

Stéphane.

It was not a good idea IMO that the usercode for the extranet was called GUEST. It only makes confusion with Guest pages bigger.

Guest pages

Guest page are anonymous web requests that are executed to efficy.dll/guest. No logon and session are required. Efficy uses a user/pwd combination stored in the registry to logon and in this context API calls are executed. It can be the guest user, but it can also be the admin user. But the best and safest approach is a dedicated user with only the rights required for the guest pages.

When the mailingcode parameter is present in the /guest request, you can use macro's like <%GetField()%>

(Helpdesk) extranet

Helpdesk extranet sessions behave more like normal Efficy sessions. You have to logon to make a session, but instead of logon with user, you logon with the credentials of a contact.
So that is why you need contact licenses. You can use any request /edit, /dialog, /consult

Changes will be seen in the application as being executed by user GUEST, you will not see the contact key anywhere.